Upgrading Your GroupWise Internet Agent

Upgrading your GroupWise Internet Agent is a fairly simple process. However, there are some challenges that are presented if you intend to have a “mixed” system (i.e., GroupWise 2012 AND older post offices) for any length of time. Here are the issues at hand:

  • Your GWIA cannot be upgraded to GroupWise 2012 until the domain that owns it is upgraded to GroupWise 2012.
  • When using the GWIA as a POP3 or IMAP4 “client”, it is indeed a client. You cannot access a GroupWise 8 or earlier post office with the GWIA via IMAP4 or POP3, If it is attempted, you will see a “login failed: D058” in your GWIA log.
  • On the other hand, if the GWIA is being used only for SMTP services, there are no issues with a mixed system.

So, as you can see, it’s a good idea to get your post offices upgraded to GroupWise 2012 on a scheduled roll-out so that you are not surprised by any of the possible issues with mixed post offices. That said, may sites operate in a “mixed” system quite nicely for an extended period of time. You must simply make sure that your plans take the above caveats into account. If you need to have POP3 services for all users in your system, you might consider having two GWIAs – one for the GroupWise 2012 users, and one for your older post office users. If you are using IMAP4, you might consider opening up IMAP4 directly from the post office agent, rather than using the GWIA if you have a mixed system (versions 6.0 and later of GroupWise allow for IMAP4 at the post office agent).


Preparing for the Upgrade

Before you can install the new software for the GWIA, you must shut down any and all agents on your server. Since this is a GWIA, you most likely at least have an MTA for the GWIA’s domain on the same server. Shut down any GroupWise components on this server before we proceed.



On Linux, you must upgrade all GroupWise components at the same time, so you need to stop all processes that are GroupWise related. This includes all GroupWise agents and gateways and GroupWise Monitor. We are assuming that you are running your agents as daemons. If, however, you are running them with their GUI consoles, unload all of the agents by shutting down the GUI consoles. Close the GroupWise Linux client if it is running on the server. Finally, to be certain that all agents and gateways are closed, type the following commands at a terminal prompt:


/etc/init.d/grpwise stop

/etc/init.d/grpwise-wa stop

/etc/init.d/grpwise-ma stop


You may receive errors if you are not using the grpwise-ma or grpwise-wa scripts, but it does not hurt to attempt to stop them even if you do not have these scripts installed.

After all GroupWise components have been shut down, type the following into the terminal prompt to verify that no GroupWise components are running:


ps -A | grep gw


If at this point you still see GroupWise components loaded you can kill them individually, either by pid or name – for example:


kill 9860

(if you show a GroupWise component with the pid 9860 running)



killall gwia



For Windows, you must also shut down all of your agents that access the domain database. If you are running the agents as services, go into the services console from the Control Panel, right click on the GroupWise agents, and choose stop (see Figure 6-1). If you are not running the agents as services, go to the agent consoles and exit via F7 or from the agent menus.


    1. services1.tiffStopping a Windows service


After your agents are shut down, leave them down until you are instructed to reload them below.


Installing your Agent Software

For a GroupWise Internet Agent, upgrading is essentially just installing the new software. For the Windows installation, those administrators who have been around awhile will notice something different right away. Under the SDD/INTERNET/GWIA directory there is no longer an install.exe program. Instead, we will use the setup.exe found at the root of the SDD.



In the root of the Master SDD, you will see the setup.exe program that will be used for this upgrade. If you are installing the GWIA on a Windows server, you must run the installation routine on that server.

When you run this program, you see the Window in Figure 6-2.


    1. install1.tiffThe main installation screen
  • Click on Install GroupWise System.
  • Click Yes on the next screen to accept the license agreement.
  1. Click Next on the next screen to do a standard install. You will see the window in Figure 6-3.


    1. installgwia.tiffInstall Wizard – GroupWise Components
  • Choose Install individual components, and then uncheck everything except GroupWise Internet Agent.
  • The next screen seems to be a holdover from the combined Windows and NetWare installation routines of the past, and has a single radio button for Windows. Just click next.
  1. The next screen will give you the option of where to install your files on your Windows server, and options for the installation. Notice that in our example in Figure 6-4 we have chosen the option to “Install the software files, but do not configure the Internet Agent”. This is because we are performing an upgrade, and that assumes that you already have configuration files for your GWIA, and that you have your server set to automatically load your GroupWise components on startup.



    1. Install Wizard – Installation Path Screen
  • Again, it is very important to note in this screen that the default installation path is c:\program files\novell\groupwise server\gwia. Of course, the biggest problem with this location is that since we are reading an upgrade guide, we know that prior to GroupWise 8 the GWIA has been installed by default in c:\grpwise\gwia, This could cause big problems that can easily be avoided by just changing this to the location of your current GroupWise agent files (default c:\grpwise). Of course, this will mean that your server will not have its agent software in the location that Novell is now designating as the new default. You need to decide if this is an important issue for you. We here at Caledonia will gladly admit that we didn’t care a bit, and decided it was easier to just leave the agents in our default location of c:\grpwise on our Windows server. This avoided having to remove existing services and reconfigure the agents during the installation. For an upgrade it’s much easier to leave your GWIA software where it is.
  1. Next you will be presented with a summary screen showing your choices for the install, and the installation will proceed.

Load the GWIA on the Windows Server

If you installed your GWIA as a service, you load it by going to the Services panel, right-clicking on the GWIA service, and choosing “Start”. If you did not choose to load the GWIA as a service, there will be an icon for the application in your Programs menu.



Running the Linux installation routine is a bit different, in that you are not allowed to pick and choose what you install when running this installation script. The script will detect what GroupWise components are already installed on this server, and it will insist that they all be updated at the same time.


In your Master Linux SDD (in our case /grpwise/gw12soft), run the install script. For example:


gwlinux:/grpwise # ./install

After choosing your installation language, you will see the screen in Figure 6-5.

    1. lnxinstall1.tiffThe Linux Install Screen.


  • Choose install products.
  • Choose GroupWise Internet Agent
    1. Choose Install Internet Agent. If you have more than one GroupWise object on this server, you should see a screen similar to Figure 6-6. This screen will show all components on this particular Linux server that must be upgraded.
      1. update.tiffComponents to Upgrade on Linux

NOTE: Figure 6-6 shows a number of agents installed on this server. If you have a simple, single server system, you may see all of these. If you have multiple servers, you will only see the agents required for the particular server being upgraded. With the changes to WebAccess, not only do you not see the WebAccess Agent listed (as it is now obsolete), but you do not see the WebAccess Application either. You will be required to do a separate installation for WebAccess if it is on the same server.


  1. You must choose Yes for this option, otherwise the installation will simply close. Choosing Yes starts the update of all agents required on this server. If there are a number of agents, this can take awhile. Once the agents are installed,, exit the installation.
  2. At this point we are not configuring anything with this installation routine. You are upgrading an existing GroupWise system, and thus you already have startup files and startup scripts for your server.

member about moving a GWIA.

  • You may need to change your MX records if the public IP address for your GWIA will change due to the move to the new server. Otherwise, you may have to change the natting at your firewall, or change the IP address that an anti-spam appliance or other GWIA front-end sends to.
  • You may need to change the firewall settings for outbound SMTP if you limit the IP addresses on your network that are allow to sent mail on port 25.
  • If your outbound IP address will change for your GWIA, you should also have your PTR (reverse dns lookup) changed to reflect this, as well as any SPF records that are maintained for your domain.



There are very few things that can go wrong during a GWIA upgrade. The only problems we typically see have to do with the following:

  • You attempt to upgrade the GWIA before upgrading your Domain
  • You change the location of the GWIA installation files during the installation (either accidentally, or on purpose) and then do not reconfigure the agent to update the startup files for the server.


New Options of Note

Delayed Message Notification

Beginning with GroupWise 8, when mail going out the GWIA is delayed, the GWIA generates a “transfer delayed” status that is entered into the properties of the senders sent item. GroupWise 2012 will allow you to configure your GWIA to send a “delayed message notification” to the inbox of the sender. This setting is found on the SMTP/MIME tab of the GWIA configuration in ConsoleOne. Check the box that says “Return Notification to Sender When a Message Is Delayed”.

Rule-Generated Messages

As with GroupWise 8, you can now configure the GWIA to block either rule generated replies, rule generated forwards, or both.

Internet Agent Web Console

As with the other agent Web Consoles, you can now control most GWIA settings directly from the Web Console. This makes it more important to put a user and password on your GWIA Web Console.


Once you are ready to continue, just turn to the next chapter in your upgrade plan.