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 Linux: Setting Up a Basic GroupWise System

You should have already reviewed Section 3.2, Planning a Basic GroupWise System and filled out the worksheet. 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 2012 Interoperability Guide before starting to set up your GroupWise system.

If you are new to Linux, you might want to review Linux Commands, Directories, and Files for GroupWise Administration in the GroupWise 2012 Administration Guide before beginning to set up your GroupWise system on Linux.

Preparing the Linux Server for Your Basic GroupWise System

  1. Ensure that the Linux server for your basic GroupWise system meets the system requirements listed in Section 2.1, GroupWise Administration Requirements.

  2. Ensure that the Linux operating system media is available, in case the GroupWise Installation program needs to install supporting packages on the Linux server.

  3. Ensure that the Linux server has a static IP address.

  4. Ensure that the firewall on the Linux server has the ports open that are used by the GroupWise Post Office Agent (POA) and Message Transfer Agent (MTA).

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

  5. Ensure that the directories exist where you want to create your domain and post office directory structures, as described in Domain Directory Name and Post Office Directory Name.

  6. Ensure that ConsoleOne is installed on the Linux server, as described in ConsoleOne.

  7. Ensure that eDirectory User objects exist for the GroupWise accounts that you want to create, as described in User Objects in eDirectory.

  8. Ensure that the eDirectory container objects exist where you want to create the Domain object and Post Office objects for your Basic GroupWise system, as described in Domain Context.

  9. Continue with Starting the Linux GroupWise Installation Program.

Starting the Linux GroupWise Installation Program

  1. In a terminal window, become root by entering su - and the root password.

  2. Run the GroupWise Installation program at the root of the downloaded GroupWise 2012 software image

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

    GroupWise Installation program on Linux
  4. (Optional) Review the Readme, Quick Start, and Installation Guide to better prepare yourself for setting up your basic GroupWise system.

  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 Worksheet.

    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.

    Create a New GroupWise System page

    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 for future domains in your GroupWise system.

  1. In the Linux Mount Directory dialog box, browse to and select the Linux mount directory from your Basic GroupWise System Worksheet, then click OK.

    Linux Mount Directory dialog box

    The mount directory information is stored in a user-specific preferences file (.consoleone/SnapinPrefs.ser) in each GroupWise administrator’s home directory. If necessary, you can later select a different mount directory in ConsoleOne, as described in Changing the Linux Mount Directory in System in the GroupWise 2012 Administration Guide

    For instructions on using the Linux mount directory after creating your basic GroupWise system, see Mounting a Linux File System for a Domain or a Post Office in System in the GroupWise 2012 Administration Guide.

    After you select the Linux mount directory, the New System Utility provides some instructions for creating your basic GroupWise system.

    GroupWise System Setup dialog box
  2. Click OK to proceed into ConsoleOne.

  3. 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 fields in the Login window from your Basic GroupWise System Worksheet, 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. Under some circumstances, you might need to specify the IP address of the server instead of the tree name.

    ConsoleOne with the GroupWIse Administrator snap-ins installed

    Because the GroupWise Administrator snap-ins have been installed to ConsoleOne, a GroupWise System object is displayed. As you add domains and post offices to your GroupWise system, they are listed under the GroupWise System object.

  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 Worksheet.

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

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

    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 yourself and a test user 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.

Introduction Page
  1. Review the Introduction, then click Next.

    The DVA is configured for high availability separately from the MTA and the POA.

  2. (Conditional) If you want to configure the DVA for high availability, click Yes.

    or

    Click No.

  3. 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.

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

  5. Click Exit to complete the agent configuration.

  6. For convenience, leave ConsoleOne running while you start the agents in a terminal window.

  7. 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 Windows MTAs when they run as Windows applications. 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.

  4. In ConsoleOne, check to see that the domain as been updated:

    1. Browse to and right-click the Domain object, then click Properties.

    2. Verify that the Database Version field displays 12 (short for 2012), then click Cancel.

  5. In the terminal window, 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.

  6. In ConsoleOne, check to see that the post office database as been updated:

    1. Browse to and right-click the Post Office object, then click Properties.

    2. Verify that the Database Version field displays 12 (short for 2012), then click Cancel.

      After the post office database has been updated, users can connect to the post office using the GroupWise Windows client or GroupWise WebAccess.

  7. If you want to finish setting up your basic GroupWise system so that users can access it, continue with Section 3.4, Testing Your Basic GroupWise System.

    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:

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 downloaded GroupWise 2012 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.

3.3.2 Windows: Setting Up a Basic GroupWise System

You should have already reviewed Section 3.2, Planning a Basic GroupWise System and filled out the worksheet. 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 2012 Interoperability Guide before starting to set up your GroupWise system.

Preparing the Windows Server for Your Basic GroupWise System

  1. Make sure that the Windows server for your basic GroupWise system meets the system requirements listed in Section 2.1, GroupWise Administration Requirements.

  2. Make sure that the Windows server has a static IP address.

  3. Make sure that the firewall on the Windows server has the ports open that are used by the GroupWise Post Office Agent (POA) and Message Transfer Agent (MTA).

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

  4. Make sure that the directories exist where you want to create your domain and post office directory structures, as described in Domain Directory Name and Post Office Directory Name.

  5. Make sure that eDirectory User objects exist for the GroupWise accounts that you want to create, as described in User Objects in eDirectory.

  6. Make sure that the eDirectory container objects exist where you want to create the Domain object and Post Office objects for your Basic GroupWise system, as described in Domain Context.

  7. Configure the Windows server 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.

  8. (Optional) Enable SNMP.

    If you want to monitor the GroupWise Windows agents from an SNMP manager program, SNMP must be enabled on the Windows server where the agents are installed. If it is not already enabled, you must enable it before you run the Installation program.

    For example, in Windows Server 2008:

    1. In the Server Manager, right-click Features, then click Add Features.

    2. Select SNMP Services., then click Next.

    3. Click Install.

  9. Continue with Starting the Windows GroupWise Installation Program.

Starting the Windows GroupWise Installation Program

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

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

  3. (Conditional) If prompted, select the language in which you want to run the GroupWise Installation program, then click OK.

    On Windows, the GroupWise 2012 software image can be downloaded in a multilanguage version or an English-only version. When you install from the multilanguage version, all languages are always installed, regardless of the specific language that you select for running the Installation program.

    The main GroupWise System Installation page appears.

    GroupWise Installation program main page
  4. 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.

  5. Click Next to accept the default of Standard.

    GroupWise Components page
  6. Make sure that Create a new system is selected, then click Next.

  7. 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 Worksheet.

    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 Worksheet.

    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 Worksheet.

    POA Network Address page
  4. On the Summary and Modification page:

    1. Review the installation information you have provided.

    2. (Conditional) If you need to change information, select the information to change, then click Edit setting.

    3. Specify the desired information, then click OK.

  5. Click Install to start the installation.

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

  6. 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 Starting the Windows GroupWise Agents.

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

Setting Up and Testing the GroupWise Windows Client on the GroupWise Server

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:

  1. Create a 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.

  2. Make sure that you can log in to the test GroupWise account.

  3. As a further test, create a second test account, install the client on a second machine, and exchange messages between the two users.

  4. Skip to Section 4.5, What’s Next.

    or

    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 7 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 downloaded GroupWise 2012 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.5, 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 (the MTA, POA, and DVA as a group), and the GWIA.

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.

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 file name for the installation configuration file.

    The configuration file name 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 the 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.