24.1 Manually Migrating the Monitor Agent to Linux

  1. On the Linux server, become root in a terminal window.

  2. Make sure that the Web server where the Monitor Application is installed is up and running.

  3. Provide access to a domain directory and its associated domain database (wpdomain.db).

    If the domain directory is located on another Linux server, use your mount command of choice. If the domain directory is located on a NetWare® or Windows server, see Section 19.2.1, Making a NetWare or Windows Server Visible from Linux for suggested mount commands.

  4. If your Linux environment includes the X Window System, run the GUI GroupWise® Installation program to install the Linux WebAccess Agent software, as described in Installing the Linux Monitor Agent.

    or

    If the X Window System is not available, run the text-based GroupWise Installation program instead, as described in Installing the GroupWise Agents Using the Text-Based Installation Program.

  5. Configure the Linux Monitor Agent, as described in Configuring the Linux Monitor Agent.

  6. Restart the Web server, as described in Restarting the Web Server.

  7. Start the Linux Monitor Agent, as described in Starting the Linux Monitor Agent as a Daemon.

  8. Make sure that the Linux Monitor Agent can communicate with the Monitor Application by viewing the URL for the platform of your Web server:

    NetWare or Windows Web Server:

    		 
    http://web_server_network_address/gw

    Linux Web Server:

    		 
    http://web_server_network_address/gwmon

    If the Monitor Web console does not appear, review the preceding steps to verify that all steps have been followed. For additional assistance, see Monitor Agent Problems in Strategies for Agent Problems in the GroupWise 7 Troubleshooting 2: Solutions to Common Problems.

  9. Stop the Linux Monitor Agent, as described in Stopping the Linux GroupWise Agents

  10. Copy the Monitor Agent configuration file (monitor.xml) from its Windows location:

    c:\gwmon

    to its location on Linux:

    /opt/novell/groupwise/agents/share

  11. Edit the monitor.xml file for its new location:

    1. Change the HOME_PATH setting to the full path to the domain directory that you made accessible in Step 3.

    2. Change the LOG_PATH setting to the typical location for Monitor Agent log files on Linux (/var/log/novell/groupwise/gwmon).

    3. Change the LOG_ACCOUNTING_PATH setting to the typical location for Monitor Agent accounting file on Linux (/var/log/novell/groupwise/gwmon/acct).

    4. Change the LOG_EDITOR setting to '' '' (an empty setting).

  12. Start the Linux Monitor Agent with its new configuration file.

  13. Make sure that the Linux Monitor Agent can still communicate with the Monitor Application by viewing the Monitor URL for the platform of your Web server:

    NetWare or Windows Web Server:

    		 
    http://web_server_network_address/gw

    Linux Web Server:

    		 
    http://web_server_network_address/gwmon

  14. Stop the old Windows Monitor Agent, as described in Stopping the Linux GroupWise Agents.

  15. If desired, uninstall the old Monitor Agent software to reclaim disk space on the Windows server. See Uninstalling the Windows GroupWise Agents.