"If an enemy exists not, obstructed you cannot be" Yoda The GWIA has long been a sore point for GroupWise Administrators when it comes to upgrading. It's not that it's a difficult component to upgrade, its just got so much going on that changes to it sometimes show up in the end users face. And no Administrator likes such things.
A quick recall from part 1, 2, 3 and 4. We upgraded our ConsoleOne, extended our eDirectory Tree schema, and upgraded our domains -Primary first, and any/all secondary domains then we upgraded post offices. Finally we upgraded WebAccess. This follows our upgrade process and leads us to the next logical step -upgrading GWIA. Please review the upgrade process below then we will get to it.
Here is the Best Practice process for upgrading GroupWise, in general. Here is my process outline for upgrading. Note those items in BOLD are what is covered in this article.
GWIA upgrade is a very easy process whether it's using the Wizard or doing it manually. As you may recall in older versions of GroupWise, the INSTALL.EXE was located in SDD| INTERNET| GWIA. Well no more. Now if you want to upgrade the GWIA using the Wizard, you must do so from the SDD| SETUP.EXE -the main Wizard.
While using the Wizard has a nice face to it, you can speed the upgrade of GWIA using the manual process. Therefore, I will do both a Wizard Upgrade and a manual, then you can choose. Before we start, let me mention one file that I would backup just to be safe. In the GWIA domain directory, under WPGATE| GWIA| is the GWAC.DB file. This file has all of the Access Control settings as well as a few other configured settings. Backing this up is more of a nicety then a necessity. If you have GWIA running under its own domain, you must upgrade the domain before you can upgrade GWIA, so make sure that is done. Lastly, if you are running GWIA on the same box as other GroupWise components, you will want to unload those components before you run the upgrade. Alright here we go.
Here is the GWIA Upgrade process using the Wizard:
In the NetWare, the load would be something like:
load sys:\system\gw8\gwia @gwia.cfg
Here I assume you installed the agents to a "GW8" directory and configuration file for you. You may also use the "GWIA.ncf" file. Now let's look at loading the GWIA Gateway into Protected Memory. You can either add the lines given below into the GWIA.NCF or type them out. In either case, you will need to update your AUTOEXEC.NCF.
Now if you are going to use Protected Memory for your GWIA Agent, you will type the following for NetWare 6.5 sp4 to sp6, and sp8:
load restart address space=GWIA sys:\system\gw8\gwia @gwia.cfg
If you are using NetWare 6.5 sp7 then your lines will be:
load address space=GWIA sys:\system\gw8\gwia @gwia.cfg
protection restart GWIA
The reason for the difference is in the syntax that was left out in NetWare 6.5 sp7.
Finally if you load in Protected Memory, then you need to make sure to ONLY unload the gateway agent using the following command:
unload address space=GWIA
Here are few of the installation screens:
Figure 1: GroupWise 8 Wizard GWIA Upgrade: Individual Components and GWIA
Figure 2: GroupWise 8 Wizard GWIA Upgrade: NLM Install Path and Do NOT Configure
Figure 3: GroupWise 8 Wizard GWIA Upgrade: Summary Screen with Edit Settings
Figure 4: GroupWise 8 Wizard GWIA Upgrade: Set the Database Version to 8
Figure 5: GroupWise 8 Wizard GWIA Upgrade: New GWIA 8 Agent Running
Now that I have shown you the Wizard Installation, let me show you the manual process. Here is the manual process:
load sys:\system\gw8\gwia @gwia.cfg
If you are using Protected Memory, then just use the commands I have shown you earlier in the article.
As you can see the manual process for upgrading the GWIA is quicker, less settings and gets you the same results. The manual upgrade process method for all GroupWise components is my preferred method when upgrading my customers. In a single small GroupWise system, it's very easy to get prepared for the upgrade during day time hours then just fire away at the upgrade at night and minimize downtime for GroupWise. With large GroupWise systems, the same applies, but I can also create all configuration files (POA/MTA/GWIA) in advance and I can prepare the GW8 directory as well. Then I just have to copy the GW8 directory along with all configuration files to the appropriate locations on the numerous servers. So I get continuity of files and I speed the upgrade process, minimizing downtime.
Well, that's it. GWIA is upgraded and the last of this 5 part series. Hopefully, it has helped you to upgrade your current GroupWise system to version 8. 8 really is great! Sales pitch ON: If you find you do not want to tackle an upgrade to GroupWise 8 or just do not have the time, I am offering a discount on my rates to upgrade an organizations GroupWise system to version 8. Contact me and mention "8 is Great!" to take advantage of the discount :Sales pitch OFF. In the meantime, "Mind what you have learned. Save you it can!"
Got comments or article ideas? Need help with GroupWise? Drop me a line at: Gregg@HinchmanConsulting.com . "The Force is strong in this one."