3.3 Setting Up a Basic GroupWise System

Follow the setup instructions for the platform where you are creating your basic GroupWise system:

3.3.1 NetWare and Windows: Setting Up a Basic GroupWise System

You should have already reviewed Section 3.2, Planning a Basic GroupWise System and filled out the summary sheet. The following sections step you through the GroupWise Installation program for creating a new GroupWise system.

IMPORTANT:If you plan to install GroupWise in a clustered server environment, see the GroupWise 8 Interoperability Guide before starting to set up your GroupWise system.

Starting the Windows GroupWise Installation Program

  1. Select an appropriate location to run the GroupWise Installation program.

    NetWare:

    If you are setting up your basic GroupWise system on NetWare, you can run the Installation program from any Windows machine that meets the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

    Windows:

    If you are setting up your basic GroupWise system on Windows, you must run the Installation program from the Windows server where you want to create your initial domain and post office and install the Windows agents. The server must meet the administrator machine requirements as well as the server operating system requirements listed in Section 2.1, GroupWise Administration Requirements.

  2. Configure the Windows machine to ensure GroupWise database integrity across the network:

    1. At the selected Windows machine, right-click the Novell Client icon (the Red N) on the toolbar at the bottom of your screen, then click Novell Client Properties.

    2. Click Advanced Settings.

    3. Set File Caching to Off.

    4. Set File Commit to On.

    5. Click OK to save the new Novell Client settings.

    6. Reboot the Windows machine to put the new settings into effect.

  3. If you are setting up your basic GroupWise system on NetWare, map a drive to the NetWare server where you want to create your initial domain and post office and install the GroupWise agents.

  4. Log in as an Admin equivalent to the eDirectory tree in which you are creating your GroupWise system.

  5. Insert the GroupWise 8 DVD into the DVD drive to start the GroupWise Installation program.

    or

    Run setup.exe at the root of the downloaded GroupWise 8 software image.

  6. Select the language in which you want to run the GroupWise Installation program, then click OK.

    NOTE:All available languages are included on the GroupWise 8 DVD and the multilanguage version of the downloaded GroupWise 8 software image, but you can select which languages you want to install.

    The main GroupWise System Installation page appears.

    GroupWise Installation program main page
  7. Click Install GroupWise System, then click Yes to accept the License Agreement and display the Installation Type page.

    Installation Type page

    When you create a new GroupWise system, you are performing a Standard installation. Other installation options on this page are described in Setting Up Predefined Installations.

  8. Click Next to accept the default of Standard.

    GroupWise Components page
  9. Make sure that Create a New System is selected, then click Next.

  10. Continue with Installing Your Basic GroupWise System.

Installing Your Basic GroupWise System

  1. Follow the prompts to provide the following information from your Basic GroupWise System Summary Sheet.

    Agent Software Platform page

    After the GroupWise Installation program has gathered this administrative information, it is ready to gather information about the eDirectory tree and the GroupWise objects to create.

  2. Follow the prompts to provide the following information from your Basic GroupWise System Summary Sheet.

    System Settings page

    After the GroupWise Installation program has gathered eDirectory information, it is ready to gather GroupWise agent information.

  3. Follow the prompts to provide the following information from your Basic GroupWise System Summary Sheet.

    POA Network Address page
  4. If you are installing to a Windows server, provide the following information from your Basic GroupWise System Summary Sheet.

  5. On the Summary and Modification page:

    1. Review the installation information you have provided.

    2. If you need to change information, select the information to change, then click Edit Setting.

    3. Specify the desired information, then click OK.

  6. Click Install to start the installation.

    Status messages keep you informed about the installation and system creation progress.

  7. Click Finish when the installation and system creation is completed.

Starting the GroupWise Agents

The GroupWise Installation program does not start the agent for you. For instructions, see the instructions for your agent platform:

IMPORTANT:The GroupWise agents must be running in order to access your GroupWise mailbox to send and receive messages.

Setting Up and Running the GroupWise Windows Client on Your Local Machine

To test your new GroupWise system, you can install and run the GroupWise Windows client on your local machine. To accomplish this test quickly, follow the instructions in the specific sections of Section 9.0, Installing the GroupWise Clients that are listed below, in order to create test GroupWise user accounts and mailboxes.

As an easy test, create the test GroupWise account for your own eDirectory user. You can delete it after the test if you want your permanent mailbox elsewhere in the GroupWise system. Make sure that you can log in to the test GroupWise account. As a further test, create a second test account, install the client on a second machine, and exchange messages between the two users. Then skip to Section 4.5, What’s Next. Or you can install the GroupWise Administrator snap-ins to additional locations, as described in Installing the GroupWise Administrator Snap-Ins to Additional Windows Machines.

Installing the GroupWise Administrator Snap-Ins to Additional Windows Machines

As part of creating your basic GroupWise system, the GroupWise Administrator snap-ins to ConsoleOne were installed in one location. If ConsoleOne is installed in multiple locations and if you want to be able to administer GroupWise from those locations, you need to install the GroupWise snap-ins to each ConsoleOne installation.

  1. Go to the Windows machine where you want to install the GroupWise snap-ins to ConsoleOne.

  2. Configure the Windows machine, as described in Step 2 in Starting the Windows GroupWise Installation Program.

  3. Make sure you are logged in as an Admin equivalent and have network access to a software distribution directory (or the GroupWise 8 DVD or downloaded software image) and the domain directory.

  4. Start the GroupWise Installation program (setup.exe).

  5. Click Install GroupWise System, click Yes to accept the License Agreement, then click Next to display the GroupWise Components page.

    GroupWise Components page
  6. Select Install Individual Components.

  7. Deselect GroupWise Agents, then click Next.

    Administrative Options page
  8. Deselect Copy Files to a Software Distribution Directory, then click Next.

  9. Follow the prompts to install the GroupWise Administrator snap-ins to ConsoleOne on your current Windows machine.

  10. Repeat Step 1 through Step 9 for each location where you want to install the GroupWise snap-ins.

  11. Skip to Section 3.4, What’s Next.

Setting Up Predefined Installations

Whenever you run any installation using the Windows GroupWise Installation program, from a full system creation to installation of a single GroupWise component, you can save all the information you provide during the installation into a configuration file. You then have the option of performing that installation again and again using the previous installation information as defaults for the next installation, or performing an express installation with no intervention on your part.

You can create installation configuration files to create a new GroupWise system, update an existing GroupWise system, and install GroupWise administration, agents (POA and MTA), and the Internet Agent.

NOTE:You cannot currently create installation configuration files to install GroupWise WebAccess, GroupWise Monitor, the GroupWise Calendar Publishing Host, or the GroupWise Windows client. Predefined installations are not available when you run the Linux Installation program. Additional predefined installations will be available in a future GroupWise release.

Deciding Where to Store Installation Configuration Files

You can store installation configuration files in any convenient location, taking into account the following:

  • If you run the GroupWise Installation program only from your own workstation, you can store the configuration files locally. However, if you want them to be available from multiple locations or to multiple users, you should store them on the network.

  • For the least amount of interaction during predefined installations, you can create the configuration files with passwords stored in them. Passwords are stored in clear text. Therefore, if you store the configuration files with passwords, you should store them in a secure location.

Creating an Installation Configuration File
  1. Create a directory where you want to store installation configuration files.

  2. Run an installation that you want to repeat.

    The final Installation program page allows you to create the configuration file.

    Installation Complete page
  3. Select Save Settings for a Future Installation.

  4. Specify the full path and filename for the installation configuration file.

    The configuration filename automatically receives a .cfg extension

  5. Select Save Passwords in the Configuration File if you store your configuration files in a secure location and you do not want to be prompted for passwords during an express installation.

  6. Click Finish to complete the current installation.

Running a Predefined Installation
  1. Start the GroupWise Installation program, click Install GroupWise System, then click Yes to accept the License Agreement.

    Installation Type page
  2. Select Predefined.

  3. Browse to and select the installation configuration file from a previous installation that you want to repeat.

  4. If you want to run the predefined installation without intervention or if you want to stop only for providing passwords, select Use Predefined Settings in an Express Install.

    or

    If you want to use the settings in the installation configuration file as default as you run the Installation program yourself, do not select Use Predefined Settings in an Express Install.

    This option allows you to quickly click through the Installation program pages, while adjusting only a few settings for the current installation.

  5. Click Next to start the predefined installation.

3.3.2 Linux: Setting Up a Basic GroupWise System

You should have already reviewed Section 3.2, Planning a Basic GroupWise System and filled out the summary sheet. The following sections step you through the GroupWise Installation program.

IMPORTANT:If you plan to install GroupWise in a clustered server environment, see the GroupWise 8 Interoperability Guide before starting to set up your GroupWise system.

If you are new to Linux, you might want to review Appendix A: Useful Linux Commands for Administering a GroupWise System in the GroupWise 8 Administration Guide before beginning to set up your GroupWise system on Linux.

Starting the Linux GroupWise Installation Program

  1. Make sure that ConsoleOne is installed on your Linux server.

    ConsoleOne is installed in /usr/ConsoleOne. If ConsoleOne and eDirectory have not yet been installed on your system, see Novell eDirectory.

  2. At a Linux server that meets the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements, insert the GroupWise 8 DVD.

    or

    Run ./install at the root of the downloaded GroupWise 8 software image.

  3. Specify the root password, then click OK.

    The X Window System is required for running the GUI GroupWise Installation program. If you are not using the X Window System, you can install GroupWise components individually, as described in Installing the GroupWise Agents Using the Text-Based Installation Program. However, you must use the GUI GroupWise Installation program to create your basic GroupWise system.

  4. Select the language in which you want to run the GroupWise Installation program, then click OK.

    NOTE:On Linux, all available languages are included in the GroupWise RPMs, so all languages are always installed.

    GroupWise Installation program on Linux
  5. Continue with Installing the GroupWise Software.

Installing the GroupWise Software

  1. Click Create or Update a GroupWise System.

    Introduction page in the GroupWise Installation page on Linux

    The list on the left details the steps the Installation program performs for you.

  2. Click Next, accept the License Agreement, then click Next.

  3. Follow the prompts to provide the following information from your Basic GroupWise System Summary Sheet.

    The Installation program automatically installs the GroupWise Administrator snap-ins to ConsoleOne under /usr/ConsoleOne. Then, the Installation program copies the selected software components into your software distribution directory.

  4. When the copying is complete, click Next.

    Next Step page in the GroupWise Installation program on Linux
  5. Select Creating a New GroupWise System, then click Next.

    You use the New System utility in ConsoleOne to create your basic GroupWise system.

  6. Click Run to start ConsoleOne.

  7. Continue with Selecting a Linux Mount Directory.

Selecting a Linux Mount Directory

The first time you start ConsoleOne with the GroupWise Administrator snap-ins installed, you are prompted to specify a Linux mount directory under which you create mount points. Typically, Linux servers and workstations use /mnt for this purpose. In the future as your system grows, this information helps ConsoleOne resolve the UNC paths of GroupWise database locations into Linux paths. Although the mount directory information is not used when you are creating your basic GroupWise system, it is gathered at this time for later reference.

GroupWise databases can be located on Linux servers, NetWare servers, or Windows servers. In the Linux mount directory, you will eventually create mount points that have the same names as the servers that are mounted to those mount points. You will need to do this for each server where a domain or post office is located that you want to access from ConsoleOne on Linux. The following table illustrates the correspondence between UNC paths and mount points for GroupWise database locations on Linux, NetWare, and Windows, assuming the typical mount directory of /mnt:

Table 3-1 Correspondence between UNC Paths and Mount Points

Platform

GroupWise Domain UNC Path

Corresponding Linux Mount Point

Linux

\\linux_server\gw_partition\
                domain_directory
/mnt/linux_server/
               gw_partition

NetWare

\\netware_server\gw_volume\
                domain_directory
/mnt/netware_server/
               gw_volume

Windows

\\windows_server\gw_share\
                domain_directory
/mnt/windows_server/
               gw_share

IMPORTANT:Although NetWare and Windows are not case-sensitive operating systems, the case of characters in pathnames becomes significant when the directory structure is mounted to a Linux machine.

  1. In the Linux Mount Directory dialog box, browse to and select the Linux mount directory, then click OK.

    Linux Mount Directory dialog box

    The typical Linux mount directory is /mnt.

    In the future, you and other GroupWise administrators might have different mount points depending on the workstation or server where ConsoleOne runs. To change the mount directory later in ConsoleOne, click Tools > GroupWise System Operations > System Preferences > Linux Settings. The mount directory information is stored in a user-specific preferences file (.consoleone/SnapinPrefs.ser) in each GroupWise administrator’s home directory.

  2. Continue with Using ConsoleOne to Create Your Basic GroupWise System.

Using ConsoleOne to Create Your Basic GroupWise System

ConsoleOne automatically attempts to authenticate to an eDirectory tree when it starts.

  1. Fill in the following fields, then click Login to start ConsoleOne:

    ConsoleOne Login dialog box

    If the Login dialog box does not appear automatically, select the NDS object, then click File > Authenticate.

    Login Name: Provide a Novell eDirectory username that has rights to create eDirectory objects.

    Password: Provide the password for the username.

    Tree: Type or select the eDirectory tree where you want to create GroupWise objects.

    If the eDirectory tree is located on a Windows server, you might need to specify the IP address of the server instead of the tree name.

    Context: Provide the full context of the User object associated with the username you provided.

  2. Under the NDS object, select the tree where you want to create the GroupWise system, then click Tools > GroupWise Utilities > New System.

    GroupWise Setup Progress page
  3. Follow the prompts to provide the GroupWise system and domain information from your Basic GroupWise System Summary Sheet.

  4. Follow the prompts to provide the GroupWise post office information from your Basic GroupWise System Summary Sheet.

  5. Follow the prompts to provide information about how to link the domain and the post office from your Basic GroupWise System Summary Sheet.

    When you have provided the system, domain, post office, and agent information for your GroupWise system, you are ready to create users. However, adding users at this point is optional. After the Installation program has finished, you can add users to the post office at any time by using ConsoleOne. We recommend that you just add two test users at this time.

    Post Office Users page
  6. Add users as needed, then click Next.

    The Installation program summarizes your overall progress.

    GroupWise Setup Progress: Create System page
  7. Click Next to display a summary of the system, domain, post office, and agent information you entered.

    Summary page

    After you have verified that the information you entered is correct, you are ready to create your GroupWise system.

  8. Click Next to create your GroupWise system.

    The Installation program summarizes your overall progress.

    GroupWise Setup Progress: Install Agent Software
  9. Click Next to install the MTA and POA software.

  10. Continue with Installing and Starting the Linux GroupWise Agents.

Installing and Starting the Linux GroupWise Agents

At this point, the Installation program has created eDirectory objects and network server directories associated with your GroupWise system. You now need to install and start the MTA and POA on your Linux server.

Installing the Linux Agents

The GroupWise Installation program starts the Agent Configuration program for you.

Figure 3-14 Introduction Page

  1. Review the Introduction, then click Next.

    On the Configuration Complete page, Launch GroupWise Agents on System Startup is selected by default.

    IMPORTANT:If you want to configure the agents for high availability, as described in Enabling the Groupwise High Availability Service for the Linux GroupWise Agents, they must be configured to start automatically on system startup.

  2. If you do not want the agents to start automatically when the server restarts, deselect Launch GroupWise Agents on System Startup.

  3. Click Exit to complete the agent configuration.

  4. Continue with Starting the Linux Agents with a User Interface.

Starting the Linux Agents with a User Interface
  1. In a terminal window, become root by entering su - and the root password.

  2. Change to the GroupWise agent bin directory.

    cd /opt/novell/groupwise/agents/bin
    
  3. Use one of the following commands to start the MTA:

    Syntax:
    ./gwmta --show --home domain_directory &
    ./gwmta --show @domain_name.mta &
    
    Example:
    ./gwmta --show --home /gwsystem/domlnx &
    ./gwmta --show @provo.mta &
    

    The --show startup switch starts the MTA with a server console interface similar to that provided for the NetWare and Windows MTAs. This user interface requires that the X Window System and Open Motif be running on the Linux server.

    The --home startup switch specifies the domain directory and is required to start the MTA.

    The @domain.mta startup switch specifies the MTA startup files, which contains the --home startup switch.

    To remind yourself of these commands when you are at your Linux server, view the gwmta man page.

    The ampersand (&) causes the MTA to run in the background, so that the terminal window you started it in is again available for use.

    MTA agent console

    The status messages displayed on the MTA server console are also written to the MTA log file (mmddmta.nnn) in the /var/log/novell/groupwise/domain.mta directory. The log file name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day.

    In ConsoleOne, you can see that the domain database has been updated by the MTA because the Version field on the Identification page of the Domain object shows 8 when the database update is complete.

  4. Wait until the domain has been updated before you start the POA.

  5. Use one of the following commands to start the POA:

    Syntax:
    ./gwpoa --show --home post_office_directory &
    ./gwpoa --show @post_office_name.poa &
    
    Example:
    ./gwpoa --show --home /gwsystem/polnx &
    ./gwpoa --show @polnx.poa &
    

    To remind yourself of these commands when you are at your Linux server, view the gwpoa man page.

    POA agent console

    The status messages displayed on the POA server console are also written to the POA log file (mmddpoa.nnn) in the /var/log/novell/groupwise/post_office.poa directory. The log file name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day.

    In ConsoleOne, you can see that the post office database has been updated by the POA because the Version field on the Identification page of the Post Office object shows 8 when the database update is complete.

    After the post office database has been updated, you can install the GroupWise Linux client and connect to the post office.

  6. If you want to finish setting up your basic GroupWise system, continue with Setting Up and Running the GroupWise Linux Client on Your Local Machine.

    or

    If you want to learn more about managing the GroupWise agents on Linux, skip to the following sections in Section 8.0, Installing GroupWise Agents:

Setting Up and Running the GroupWise Linux Client on Your Local Machine

To test your new GroupWise system, you can install and run the GroupWise Linux client on your local machine. To accomplish this test quickly, follow the instructions in the specific sections of Section 9.0, Installing the GroupWise Clients that are listed below, in order to create test GroupWise user accounts and mailboxes.

As an easy test, create the test GroupWise account for your own eDirectory user. You can delete it after the test if you want your permanent mailbox elsewhere in the GroupWise system. Make sure that you can log in to the test GroupWise account. As a further test, create a second test account, install the client software on a second machine, and exchange messages between the two users. Then skip to Section 4.5, What’s Next. Or you can install the GroupWise Administrator snap-ins to additional locations, as described in Installing the GroupWise Administrator Snap-Ins to Additional Linux Machines.

Installing the GroupWise Administrator Snap-Ins to Additional Linux Machines

As part of creating your basic GroupWise system, the GroupWise Administrator snap-ins to ConsoleOne were installed under /usr/ConsoleOne of the server where you ran the GroupWise Installation program. If ConsoleOne is installed in multiple locations and if you want to be able to administer GroupWise from those locations, you need to install the GroupWise snap-ins to each ConsoleOne installation.

  1. Go to the Linux machine where you want to install the GroupWise snap-ins to ConsoleOne.

  2. Make sure you are logged in as root and have network access to the software distribution directory (or GroupWise 8 DVD or downloaded software image) and the domain directory.

  3. Start the GroupWise Installation program (install), then click Install Products > GroupWise Administration > Install Administration.

  4. When the installation is complete, click OK, then click Configure GroupWise Administration.

  5. Accept the License Agreement, then follow the prompts to provide the necessary information.

  6. Repeat Step 1 through Step 5 for each location where you want to install the GroupWise snap-ins.

  7. Skip to What’s Next.