The topics below help you plan and set up the GroupWise NetWare agents:
Before installing the GroupWise NetWare agents, you should complete the planning tasks listed below:
These planning tasks provide concepts and information you will need as you install and set up the NetWare agents. Be sure to print the NetWare Agent Worksheet to record your installation and setup information.
Use the NetWare Agent Worksheet to record your decisions about where to install the GroupWise NetWare agents as you review the following considerations:
Each NetWare server where you run the GroupWise NetWare agents must meet the following system requirements:
The required disk space accommodates both GroupWise agents because both are automatically installed together. The required memory would be adequate for the most basic configuration of a single NetWare agent on the server. Additional free memory can significantly increase agent performance. Multiple agents on the same server require additional memory.
For assistance in figuring the required memory for more complex agent configurations, see the following sections in the GroupWise 6 Administration guide at the Novell Documentation Web site :
Record the following information about the domains and post offices you are installing and setting up the GroupWise NetWare agents for:
| WORKSHEET |
|---|
Under Item 6: Domains, record the domain name and path to the domain directory for the new domain. Under Item 7: Post Offices, record the post office name and path to the post office directory for the new post office. |
Record which GroupWise NetWare agents you will be running on the NetWare server (POA, MTA, or both) and whether you want to install the agents locally or remotely in relation to their directories and databases, as described in Agent Location.
| WORKSHEET |
|---|
Under Item 1: Agents and Locations, mark the agents to install and their locations relative to the directories and databases they need to access. |
If the NetWare agents need to access their directories and databases on remote NetWare servers, you must add configuration information to the agent startup files to provide the needed access. You can choose from two access methods:
| WORKSHEET |
|---|
Under Item 1: Agents and Locations, record the startup switches and settings you'll need to add to the agent startup files after installation if you are installing the NetWare agents on a different NetWare server from where their directories and databases are located. |
How to edit the startup files after installation is described in Editing the NetWare Agent Startup Files.
For the easiest installation and setup, install the NetWare agents in the sys:\system directory. This simplifies the use of startup files and ensures that the agent NetWare programs are on the server search path.
If you use a different directory, you will need to add that directory to the server search path.
| WORKSHEET |
|---|
Under Item 2: Installation Path, record the directory where you want to install the NetWare agent software. |
Both the MTA and the POA will be installed to the specified directory.
Novell Cluster ServicesTM is a server clustering system that ensures high availability and manageability of critical network resources including volumes (where GroupWise domains and post offices reside) and applications (such as the GroupWise agents). Novell Cluster Services supports failover, failback, and migration of individually managed cluster resources.
The GroupWise NetWare agents can be configured to take advantage of the fault tolerant environment provided by Novell Cluster Services if the following requirements are met:
When the agents are configured for clustering, their startup files are configured with shared volume names rather than specific server names. In addition, the POA is configured to more effectively re-establish logins with GroupWise clients when a failover or migration situation arises.
| WORKSHEET |
|---|
Under Item 3: Configuring GroupWise Agents for Clustering, mark whether or not you want to configure the NetWare agents for clustering. If you are using clustering, under Item 11: Launch in Protected Mode, mark that you want the Agent Installation program to start the agents in Protected Mode. This is required in a clustering environment. For more information, see Launching the NetWare Agents in Protected Mode. |
Additional configuration of the Agent objects in ConsoleOne is required to complete the agent setup in a clustering environment, as described in the following sections of the GroupWise 6 Administration guide at the Novell Documentation Web site :
You can monitor agent functioning in a variety of ways, as described in the following sections of the GroupWise 6 Administration guide at the Novell Documentation Web site :
The agent Web consoles enable you to conveniently monitor the agents from your Web browser. If you want to use agent Web consoles, record the information required to set them up.
| WORKSHEET |
|---|
Under Item 6: Domains and Item 7: Post Offices, specify a unique HTTP port for each agent to use when communicating with your Web browser. |
To limit access to the agent Web consoles, you can provide a unique user name and password. Do not use an eDirectory user name and password because the information passes over the insecure connection between your Web browser and the agents.
| WORKSHEET |
|---|
Under Item 4: Enable Web Console, specify a unique user name and password if you want to restrict access to the agent Web consoles. |
If you have users with various language preferences, you can install the GroupWise NetWare agents in multiple languages, provided you have a multi-lingual version of the GroupWise software.
| WORKSHEET |
|---|
Under Item 5: Languages, list the languages you want to install the agents for. |
By default, the agents will start in the language selected for the domain. If that language has not been installed, the agents will start in the language used by the operating system. If that language has not been installed, the agents will start in English.
The Agent Installation program can help you start the GroupWise NetWare agents by creating and modifying system files and by launching the agents for you at the end of the installation process.
The Agent Installation program will automatically create a grpwise.ncf file that contains the commands to start the GroupWise NetWare agents on the NetWare server. If you are installing the agents for the first time on the server, skip to Modifying the Autoexec.ncf File.
If the agents have been previously installed on the server, the grpwise.ncf file already exists. You can have the Agent Installation program overwrite the existing file, append new lines to it, or create a new file named grpwisn.ncf.
| WORKSHEET |
|---|
Under Item 8: If grpwise.ncf Exists, mark what you want the Agent Installation program to do about the existing file. |
The Agent Installation program can add a grpwise.ncf line to the autoexec.ncf file so the GroupWise NetWare agents start automatically each time the server restarts.
| WORKSHEET |
|---|
Under Item 9: Update autoexec.ncf File, mark whether or not you want the Agent Installation program to update the autoexec.ncf file. |
Be aware that if you choose to create a grpwisn.ncf file during an update, a grpwisn.ncf line will be added, resulting in multiple grpwisn.ncf lines. Make sure you are not starting redundant agents.
If you are installing the GroupWise NetWare agents on the same NetWare server where their directories and databases are located, the Agent Installation program can launch the agents at the end of the installation process.
If you are installing the agents remotely in relation to their directories and databases, you must manually edit the agent startup files to configure them to access the remote servers. This configuration procedure is explained in Editing the NetWare Agent Startup Files.
| WORKSHEET |
|---|
Under Item 10: Launch GroupWise Agents Now, mark whether or not the Agent Installation program can start the agents for you at the end of the installation process. |
If you want the Agent Installation program to launch the agents for you, you can indicate that you want them launched in Protected Mode on NetWare 5.x and above.
| WORKSHEET |
|---|
Under Item 11: Launch in Protected Mode, mark whether or not you want the Agent Installation program to start the agents in Protected Mode. |
If you choose to have the Agent Installation program start the agents in Protected Mode at the end of the installation process, this also adds the following command to the autoexec.ncf file:
protect grpwise.ncf
This line will automatically start the agents in Protected Mode in the future.
Complete the following tasks to set up the GroupWise NetWare agents. These tasks are designed to help you get the agents up and running as quickly as possible.
Make sure the NetWare server where you will be installing the GroupWise NetWare agents has been properly prepared to run the agents:
The NetWare server where the GroupWise NetWare agents run must have a static IP address. DHCP cannot be used to dynamically assign an IP address for it. Make sure the server where you plan to install the agents has a static IP address.
When the GroupWise NetWare agents run on a different NetWare server from where their directories and databases are located, and they are not set up to authenticate through eDirectory (using the /dn startup switch), the agents must use a specific eDirectory user name and password to log in to that server.
To create a user for the agents to log in as:
In ConsoleOne, create a new user (such as GWAgents).
Provide a password for that user (such as GWise).
Grant that user the following rights to all domain, post office, and document storage directories:
If you have selected a directory other than sys:\system to install the agents to, add the agent installation directory to the server search path by adding a SEARCH command to the autoexec.ncf file.
After you have prepared the NetWare server to run the GroupWise NetWare agents, you are ready to install them.
At a Windows machine:
Make sure the machine from which you will perform the installation has the Novell ClientTM installed.
The Installation program creates GroupWise objects in eDirectory. The Novell Client is required to access eDirectory.
Map a drive to the NetWare server where you want to install the agents.
Make sure you have sufficient rights to install software in the desired directory.
Run setup.exe at the root of the GroupWise 6 CD, click Install Products, click GroupWise Agents, then click Install GroupWise Agents.
or
Run install.exe from the agents subdirectory on the CD or in your software distribution directory if you have updated it with GroupWise 6 software.
Follow the on-screen instructions to install the GroupWise NetWare agents on the NetWare server, supplying the information you gathered on the NetWare Agent Worksheet.
If necessary, modify the agent startup files as described in Editing the NetWare Agent Startup Files.
If you encounter any problems starting the agents, refer to Post Office Agent and Message Transfer Agent in the GroupWise 6 Administration guide at the Novell Documentation Web site for additional instructions.
To monitor an agent from your Web browser, view the URL where the agent is located by supplying the IP address and port number. For example:
http://123.456.78.90:1677
http://123.456.78.90:7100
http://123.456.78.90:7180
When viewing the agent Web console, you can specify either the standard TCP port or the HTTP port you specified during installation.
The Agent Installation program creates a customized agent startup file for each domain and post office location. The first eight characters of the post office and domain names became the names of the agent startup files, along with an agent-specific extension. For example, if the post office name is acctpo, then the POA startup file is named acctpo.poa. The Agent Installation program also customizes each startup file with the correct /home switch setting, pointing to the domain or post office directory.
Each startup file also provides a comprehensive list of startup switches, with all but the /home switch commented out. You can use any ASCII text editor to set the startup switches required by the access method you recorded under Worksheet Item 1: Agents and Locations. The agent startup files are located in the agent installation directory.
After modifying the startup files, use the grpwise.ncf file to start the NetWare agents.