19.4 Installing the GroupWise Monitor Software

As you install the Monitor software, use the GroupWise Monitor Installation Worksheets that you filled out in Planning GroupWise Monitor to provide the required information.

IMPORTANT:If you are installing GroupWise Monitor in a clustered server environment, see the Setting up a GroupWise Cluster in the GroupWise 18 Interoperability Guide before you install Monitor.

19.4.1 Linux: Installing the GroupWise Monitor Software

These sections contain information for installing GroupWise Monitor on a Linux Server.

Preparing the Linux Server for GroupWise Monitor

To prepare the Linux Server for GroupWise Monitor installation:

  1. Ensure that the server where you are installing the Monitor Agent meets the system requirements listed in GroupWise Monitor Installation Worksheets.

  2. Ensure that the web server where you are installing the Monitor Application meets the system requirements.

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

  4. Ensure that the firewall on the server has the ports open that are used by the Monitor Agent and/or the Monitor Application and the web server.

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

  5. Continue with Installing and Configuring the Linux Monitor Agent.

Installing and Configuring the Linux Monitor Agent

To install and configure the Linux Monitor Agent:

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

  2. Browse to the location of the extracted software, and run the following command to start the install:

    ./install.sh
  3. Type the number for the language in which you want to run the GroupWise Installation Wizard, and press Enter to select OK.

  4. (Optional) Type 1 for Documentation, and then press Enter to review the Readme, Quick Start, and Installation Guide to better prepare yourself for the installation.

  5. Type 2 for Installation and press Enter.

  6. Enter a to accept the License Agreement and to display the Software list.

  7. Type 4 for GroupWise Monitor Agent, to display the Actions list.

  8. Enter 1 for Install and to install the Monitor Agent.

    The Monitor Agent package is installed on the server. If any supporting packages are not available on the server, the Installation Wizard automatically installs them from the operating system media.

    During the installation, any other GroupWise agents on the server are stopped and then started again after the Monitor software has been installed.

  9. Enter 2 for Configure to configure the Monitor Agent.

  10. Follow the prompts to configure the Monitor Agent, using the following information from the GroupWise Monitor Agent Installation Worksheet:

  11. Type 1 for Yes, and then press Enter, to configure the Monitor Agent to automatically start when the server restarts.

    IMPORTANT:The Monitor Agent must be running in order for the GroupWise High Availability Service (gwha) to automatically restart the GroupWise agents if they stop unexpectedly. For more information, see Automatically Restarting the Linux GroupWise Agents with the GroupWise High Availability Service.

  12. Press any key to exit the Monitor Agent Configuration.

  13. Type b for Back to return to the Software list.

  14. In a terminal window, start the Monitor Agent:

    rcgrpwise-ma start

    NOTE:Unlike the other GroupWise agents, you do not need to be logged in as root in order to start the Monitor Agent.

  15. Continue with Installing and Configuring the Linux Monitor Application.

Installing and Configuring the Linux Monitor Application

To install and configure the Linux Monitor application:

  1. If you are installing the Monitor Application on the same server where you just installed the Monitor Agent, continue with Step 2.

    or

    If you are installing the Monitor Application on a different server from where you installed the Monitor Agent:

    1. Access the web server where you want to install the Monitor Application.

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

    3. Browse to the location of the extracted software, and run the following command to start the install:

      ./install.sh
    4. Type the number for the language in which you want to run the GroupWise Installation Wizard, and press Enter to select OK.

    5. Type 2 for Installation and press Enter.

    6. Enter a to accept the License Agreement and to display the Software list.

  2. Type 5 for GroupWise Monitor Application, to display the Actions list.

  3. Enter 1 for Install and to install the Monitor Application.

    The Monitor Application is installed on the server. If any supporting packages are not available on the server, the Installation Wizard automatically installs them from the operating system media.

  4. When the installation is finished, press any key to return to the Installation Options list.

  5. Enter 2 for Configure to configure the Monitor Application.

  6. Follow the prompts to configure the Monitor Application, using the following information from the GroupWise Monitor Application Installation Worksheet:

  7. Press any key to exit Monitor Application Configuration.

  8. Exit the GroupWise Installation Wizard.

  9. (Conditional) If you use a proxy service, follow the instructions in Configuring Proxy Service Support for the Monitor Console in the GroupWise 18 Administration Guide.

  10. Continue with Starting the Linux Monitor Agent.

Starting the Linux Monitor Agent

  1. Use the following commands to manage the Monitor Agent:

    rcgrpwise-ma start
    rcgrpwise-ma restart
    rcgrpwise-ma stop
    rcgrpwise-ma status
  2. (Optional) If desired, you can run the Monitor Agent executable directly:

    1. Change to the GroupWise agent bin folder.

      cd /opt/novell/groupwise/agents/bin
    2. Use one of the following commands to start the Monitor Agent:

      ./gwmon --home /domain_folder &
      ./gwmon --ipa domain_server_ip_address --ipp mta_port_number &
  3. For instructions on using the Monitor consoles, continue with Testing GroupWise Monitor.

19.4.2 Windows: Installing the GroupWise Monitor Software

These sections contain information for installing GroupWise Monitor on Windows.

Preparing the Windows Server for GroupWise Monitor

To prepare the Windows Server for GroupWise Monitor installation:

  1. Ensure that the server where you are installing the Monitor Agent meets the system requirements listed in GroupWise Monitor Installation Worksheets.

  2. Ensure that the web server where you are installing the Monitor Application meets the system requirements.

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

  4. Ensure that no GroupWise agents are currently running on the Windows server where you plan to install the Monitor Agent.

  5. Ensure that the firewall on the server has the ports open that are used by the Monitor Agent and/or the Monitor Application and the web server.

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

  6. Continue with Installing the Windows GroupWise Monitor Software.

Installing the Windows GroupWise Monitor Software

To install GroupWise Monitor on a Windows Server:

  1. Run setup.exe at the root of the extracted GroupWise software to start the GroupWise Installation Wizard.

  2. Click GroupWise Monitor, accept the License Agreement, and then click Next.

  3. Click Next to display the GroupWise Monitor Components page.

    The Installation Wizard provides diagrams that help you understand how the various components interact with each other. Review the diagrams as you provide the requested information.

  4. (Conditional) If you are installing the Monitor Agent, follow the prompts to provide the information from your GroupWise Monitor Agent Installation Worksheet:

  5. (Conditional) If you are installing the Monitor Application, follow the prompts to provide the information from your GroupWise Monitor Application Installation Worksheet:

    Monitor Agent Information (This page does not appear when you install the Monitor Agent and the Monitor Application together on the same server.)

    Web Server Information

  6. Review the Installation Summary, and then click Install.

  7. (Conditional) If prompts appear because your web server is running, decide whether you want the Installation Wizard to stop your web server.

  8. When the installation is complete, click Finish to exit the Monitor Installation program.

    You can choose to have the Monitor Installation program start the Monitor Agent and restart the web server for you.

  9. Click Finish to exit the GroupWise Installation program.

    If you chose to start the Monitor Agent immediately, the Monitor Agent server console displays on the Windows server.

    If the Monitor Agent does not start successfully, see Manually Starting the Windows Agents As Applications for Troubleshooting.

  10. (Conditional) If you use a proxy service, follow the instructions in Configuring Proxy Service Support for the Monitor Console in the GroupWise 18 Administration Guide.

  11. Continue with Testing GroupWise Monitor.

Starting the Windows Monitor Agent

To start the Windows Monitor Agent:

  1. If you installed the Monitor Agent as a Windows service, use the Services administrative tool to start and stop it.

    or

    If you installed the Monitor Agent as an application, start it on the Windows Start menu, or create a desktop icon to start it.

  2. Continue with Testing GroupWise Monitor.