Updating the Primary Domain

To update the primary domain, you need to install and start the GroupWise 6.5 MTA. The MTA uses the new domain dictionary file (gwdom.dc) to update the domain database to version 6.5.

IMPORTANT:  The MTA cannot be running while you update the MTA files. If you are updating a GroupWise system that still uses the ADA (Administration Agent), the ADA cannot be running. In addition, after you've updated to the GroupWise 6.5 MTA, do not run the ADA again. The ADA became obsolete with GroupWise 5.5. Running the ADA in combination with a GroupWise 6.5 MTA results in the loss of GroupWise 6.5 information.

To install and start the GroupWise 6.5 MTA:

1. To install the MTA to a NetWare^® server, make sure the workstation has access to both the primary domain directory and the NetWare server where you want to install the MTA, enter the path to the primary domain directory, then click Update to launch the Agent Installation program.

   or

   To install the MTA to a Windows server, click Finish, go to the Windows server, ensure that you have access to the primary domain directory, then start the Agent Installation program (install.exe). The Agent Installation program is located in the \agents directory in the GroupWise 6.5 software distribution directory or on the GroupWise 6.5 Administrator CD.

2. Click Yes to accept the license agreement and display the Overview dialog box.

   
   

3. Click Next to display the Install/Uninstall dialog box.

   
   

4. Make sure Install is selected, then click Next to display the Select Platform dialog box.

   
   

5. In the Select Platform dialog box, select NetWare or Windows, then click Next to display the Installation Path dialog box.

   
   

   The default NetWare installation directory is sys:\system and the default Windows directory is c:\grpwise. You can, however, install the agent files to any directory. On NetWare, if you don't install to the sys:\system directory, you must define the agent directory in the server's search path. For example, you could add SEARCH ADD sys:\system\agent_directory to the autoexec.ncf file, where agent_directory is the actual name of the installation directory.

   If you are installing to Windows, the dialog box displays the following options:

   Install GroupWise Agent Software: This option must be selected to install the agent files. You would only want to deselect it if you previously installed the GroupWise 6.5 MTA without configuring it for SNMP or as a Windows service and now want to perform those configuration tasks.

   Install and Configure SNMP for GroupWise Agents: Select this option to enable the MTA to be monitored through an SNMP management program. This option is available only if the SNMP service is enabled on the Windows server.

   Install as Windows Services: Select this option to install the MTA as a Windows service.

6. Select the directory where you want to install the agent files, then click Next to display the Language dialog box.

   
   

   If multiple languages are displayed, you can install one or more of the languages. By default, the MTA starts in the language selected for the domain. If that language has not been installed, the MTA starts in the language used by the operating system. If that language has not been installed, the MTA starts in English.

7. Select the languages you want to install, then click Next to display the Domains / Post Offices dialog box.

   
   

   To simplify the process of loading the MTA, the Agent Installation program uses the domain information you enter in the Domains / Post Offices dialog box to create an MTA startup file. The startup file includes a required switch (/home-path) that points to the domain directory. The Agent Installation program also creates a grpwise.ncf file on NetWare or a Startup menu shortcut on Windows. The .ncf file or shortcut includes the command to load the MTA using the MTA startup file.

8. To specify the location of your domain, click Add, enter the domain name, enter the path to the domain directory, then click OK to add the domain to the list.

   In addition to the MTA, the POA is automatically installed to the installation directory. If you plan to run the POA on the same server as the MTA, specify the location of the post office (or post offices) the POA will service. The Agent Installation program creates a POA startup file with a /home switch that points to the post office directory. It then includes the command to load the POA in the grpwise.ncf file on NetWare or in a Startup menu shortcut on Windows.

9. Click Next. If you are installing the NetWare MTA or the Windows MTA (as a regular Windows application, not as a Windows service), the Summary dialog box is displayed. Skip to Step 11.

   or

   If you are installing the MTA as a Windows service, the Windows Service Information dialog box is displayed.

   
   

   The MTA requires a user account that provides access to the domain directory.

   • If the domain directory is on the Windows server, you can use the local system user account to provide the access; the Use Local System Account option is available only if the domain directory is on the local server.
   • If the domain directory is on another Windows server, you need to specify a Windows user account that provides access to that server.
   • If the domain directory is on a NetWare server, you need to specify a username and password that is valid as both a Windows user account and an eDirectory user account.

   If you are also planning to run the POA on this server, the user account you specify must also provide access to the post office directory.

10. Provide the appropriate user account information, then click Next to display the Summary dialog box.

    
    

11. Click Install to install the agent files.

    After the files are installed, the Agent Installation program creates the MTA startup file and the grpwise.ncf file (NetWare) or Startup menu shortcut (Windows).

    MTA Startup File: If an MTA startup file already exists, the Agent Installation program renames the existing file with a .mt1 extension. For example, an existing provo.mta file would be renamed to provo.mt1 before the new provo.mta file is created. If you've made modifications to the existing MTA startup file, you might want to use it instead of the new MTA file. The same is true for the POA (if you defined a post office in the Domains / Post Office dialog box).

    grpwise.ncf File (NetWare only): If a grpwise.ncf file already exists, the Agent Installation program gives you the option of 1) overwriting the existing grpwise.ncf file, 2) appending the new MTA load commands to the existing grpwise.ncf file, or 3) creating a new file named grpwis1.ncf. If you have modified the existing grpwise.ncf file and want to save the modifications, you should append to the existing file or create a new grpwis1.ncf file. If you append to the file, make sure you review it later to ensure that it includes only the commands you want.

    Shortcut: If a shortcut already exists on the Start menu (Start > Programs > GroupWise Agents), the Agent Installation program replaces the shortcut with the new shortcut.

    After the startup file and grpwise.ncf file or Windows shortcut have been created, the Installation Complete dialog box is displayed.

    
    

12. Select from the following options:

    Update AUTOEXEC File: This option applies only to the NetWare agents. Select this option to reference the grpwise.ncf file from the NetWare server's autoexec.ncf file so that the MTA loads automatically whenever the server starts. If you specified a post office in the Domains / Post Offices dialog box (Step 8), the POA is also loaded.

    Delete Obsolete Administration Agent (ADA) Files and References to ADA: The Administration Agent (ADA) is no longer necessary and should not be used with the GroupWise 6.5 MTA. Select this option to delete the ADA program and startup files.

    Launch GroupWise Agents Now: Select this option to start the MTA. After you start the MTA, it updates the domain database to version 6.5. You can verify that the database version has been updated by viewing the Domain object's Identification page in ConsoleOne^®. If you specified a post office in the Domains / Post Offices dialog box (Step 8), the POA is also started. After the domain database is updated, the POA updates the post office database. You can view the Post Office object's Identification page in ConsoleOne to verify that the database version has been updated. If for some reason it has not been updated, restart the POA.

    IMPORTANT:  If you specified a post office in the Domains / Post Offices page (Step 8) so that the POA will be running on the same server as the MTA, do not select this option. Start the MTA manually and wait until it has updated the domain database. For a large domain database, you might need to wait 20 minutes or more. When the Domain object's Identification page in ConsoleOne shows that the database version has been updated to 6.5, then start the POA to update the post office database. You can check the Post Office object's Identification page in ConsoleOne to verify that the database version has been updated to 6.5. If for some reason it has not been updated, see "POA Fails to Update the Post Office Database Version" in "Strategies for Agent Problems" in GroupWise 6.5 Troubleshooting 2: Solutions to Common Problems.

    If you've installed the NetWare MTA and want it to run in protected mode on the NetWare server, select the Launch in Protected Mode option.

13. Click Finish to perform the selected options.

14. To update post offices in the domain, continue with the next section, Updating Post Offices.

    or

    To update other domains, skip to Updating Secondary Domains.