GroupWise Agent Code Installation, Configuration Files, and Agent Startup


The GroupWise Linux agents are installed to the following path on a Linux server:

/opt/novell/groupwise/agents/bin

The startup files for the GroupWise MTA, POA, WebAccess Agent, and GWIA are all kept in the following path:

opt/novell/groupwise/agents/share

All GroupWise Agents share similar library code. This code is kept in the following directory:

/opt/novell/groupwise/agents/lib

To see the version of GroupWise Agent code you are running, issue the following command in a shell prompt at the Linux server:

rpm qa | grep groupwise

Figure 14.1 shows the results of this command on a SUSE SLES9 server.

Figure 14.1. Determining installed GroupWise software


The challenge with using library code is that if you go to install a newer version of GroupWise code, you often will get an error, which means that the new code cannot install because of the older code that exists. In our experience the error is typically an "error 7," as shown in Figure 14.2.

Figure 14.2. An error 7 from a GroupWise library mismatch


Resolving this problem can be a little tricky. You need to uninstall all the GroupWise code that is conflicting, and then reinstall all the GroupWise code at the same release level. Kind of a painful exercise! What makes this exercise even more interesting is that the uninstall method removes configuration files too. So if you have much invested in a startup file, you will lose your work if you don't back it up prior to uninstalling the code. For most agents there isn't much invested in the startup file; however, the gwia.cfg file, which is the configuration file for the GWIA, gets deleted if you uninstall the GWIA code. Let's quickly outline the steps you could take to uninstall GroupWise Agent code without losing your current configuration.

To make this task easier, let's talk through this procedure as if it were a real-world scenario.

The GroupWise 7 Support Pack #2 came out recently. The GroupWise administrator sets out to install the new GroupWise Agent code and the GroupWise GWIA on a Linux server. When attempting to install the GroupWise Agent code, the administrator encounters an error 7, as shown in Figure 14.2. These are the steps the administrator could take to resolve the problem:

1.

Back up the contents of the following directory:

/opt/novell/groupwise/agents/share

You can do so by making a directory and then copying the files to this directory (see Figure 14.3).

Figure 14.3. GroupWise software uninstallation steps


2.

In a terminal session enter the following command to see the name of GroupWise Agent code that is installed:

rpm qa | grep groupwise

The output of the command is shown in Figure 14.3.

3.

In our sample scenario, the GroupWise Agent and GWIA software are installed. So the next step is to uninstall the GroupWise Agent and GWIA software with the following commands:

rpm e novell-groupwise-gwia rpm e novell-groupwise-agents rpm e novell-groupwise-gwha

Figure 14.3 shows the use of these commands.

4.

Install the GroupWise Linux agent software. Be sure to install the Linux agent software, and configure it also.

5.

Install the GroupWise GWIA software. Be sure to install the software and configure it also.

6.

Restore the files that you backed up from the ../ share directory.

Now you have successfully uninstalled and reinstalled GroupWise Agents without the loss of configuration data.



NOVELL GroupWise 7 Administrator Solutions Guide
Novell GroupWise 7 Administrator Solutions Guide
ISBN: 0672327880
EAN: 2147483647
Year: 2003
Pages: 320
Authors: Tay Kratzer

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net