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 softwareThe 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:
Now you have successfully uninstalled and reinstalled GroupWise Agents without the loss of configuration data. |