Application Delivery Management
Application Modernization & Connectivity
CyberRes by OpenText
IT Operations Management
"Already know you that which you need..." Yoda. Very true if you have read the Part 1 of my series of 5 on Upgrading to GroupWise 8. If you recall, part 1 covered the upgrade process (which I have repeated here) as well as Installing ConsoleOne, Installing GroupWise 8 Snapins, Schema Extension for GroupWise 8 and building a Software Distribution Directory (SDD). In part 2, I will walk you through upgrading your Primary domain and Secondary domains.
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.
We made it to upgrading a domain and its MTA! The Primary domain is your GroupWise system, without a Primary domain, your GroupWise system is unmanageable. Saying that, I am sure Novell has some tools that can help you use a restored older version of your Primary Domain and use it. That is why it's Best Practice to have at least 2 domains in any GroupWise environment.
There are a few things I like to do before you upgrade. One is to backup important files and the second is to run a bit of maintenance on the domain.
The first in ConsoleOne do the following:
Domain|{Right Click}| GroupWise Utilities| System Maintenance| Recover Database
This can also be run from the MTA screen:
F10| Admin Status| Perform DB Recover| Now?| Enter
This will give you a nice clean wpdomain.db. This process should be run for every domain you upgrade, just before you upgrade.
The following files should be backed up, or make a copy of them. Before you do, however, make sure the Primary domain MTA is unloaded and that there is NO FILE LOCK on the wpdomain.db. Test your exclusive access by renaming the wpdomain.db to wpdomain.db- -if you get a file lock message then make sure the MTA is unloaded and ConsoleOne is closed.
The files to back up:
With a clean copy and backed up files it's time to upgrade. As always, there are two ways to upgrade a domain, using the Installation Wizard or manually. I prefer manually but will present both methods. First, the wizard.
Here is the process to upgrade the Primary Domain:
Ok now you can go and load the agent MTA for the Primary domain. In the NetWare world the load would be something like: load sys:\system\gw8\gwmta @domain.mta. Here I assume you installed the agents to a "GW8" directory and let the Installation file create an MTA configuration file for you. You may also use the "grpwise.ncf" file the Installation creates.
Once the MTA loads a process is started that will pull all the new GroupWise 8 information into the wpdomain.db. This can be seen by using the F10| Admin Status| screen and looking to the "Recovering" statement. Or, if you missed it you will see a "Recovery Count" of 1. Next, to verify you have a GroupWise 8 Primary domain, launch ConsoleOne, connect to the Primary domain, select "Properties", you will see "8" for version.
Here are couple of the installation screens:
And now you are done upgrading the Primary domain using the Installation program. Now, how can we do the upgrade manually? Let me show you.
Here is the manual process:
load sys:\system\gw8\gwmta @primary.mta
Of course, this assumes you are loading from sys:\system\gw8. If you are not, then use your 'load' directory where the GWMTA.NLM file is located.
Now if you are going to use Protected Memory for your GroupWise Agents, you will type the following for NetWare 6.5 sp4 to sp6, and sp8:
load restart address space=primary sys:\system\gw8\gwmta @primary.mta
This assumes you call your address space primary and assumes the 'load' directory on sys:\system.
If you are using NetWare 6.5 sp7 then your lines will be:
load address space=primary sys:\system\gw8\gwmta @primary.mta
protection restart primary
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 MTA agent using the following command:
unload address space=primary
sys:\system\gw8\GRPWISE.NCF
Ok all that remains is to add the GRPWISE.NCF to the AUTOEXEC.NCF for auto start up of the MTA Agent.
If you look at the screen shot below you will see on the left side my old GroupWise 7sp3 HP1 domain directory. On the right side of the screen shot is my new upgraded GroupWise 8 domain directory. First, do not get freaked about the dates. Remember GroupWise 8 was in 'lock down' for quite some time. What matters is that I used the correctly dated GroupWise 8 DC files from the SDD. Also, you will notice 2 new files: rl.dbg and pb.dbg. To quote a Novell source:
"These are debug files that created by the Validate process in ConsoleOne. The rl.dbg file will list any invalid or orphaned Client Option records that were removed by Validate. The pb.dbg file will list any invalid or orphaned Group Membership records that were removed by Validate."
Just make note of them.
Also, the GroupWise 8 MTA does have a SOAP port. It will be used for Administration in future releases of GroupWise. No need to worry about it at this time. It's not activated. It cannot be configured in either the MTA configuration file or in ConsoleOne. And it will not create a port conflict if you are using multiple MTA's on the same IP Address and same server. So says my Novell source.
Ok you have the Primary domain and its MTA upgraded and running. Now it's time to turn your attention to upgrading your Secondary domains. I hope you have at least 1 Secondary domain, as it's Best Practice to have at least 2 domains in your environment for fault tolerance and recovery. Ideally, your Secondary domain(s) will hold either post offices or gateways and hopefully not both, again for fault tolerance/recovery reasons. In my case, I will assume my Secondary domain (GateDom) holds my gateways and my Primary holds my post office. My system is just a test system not a production system so do not take my design as what is best for your email system. I have several articles on GroupWise design. Please review them.
The best and easiest way to upgrade your secondary domains is to follow the manual process that I showed under the Primary domain upgrade.
Here is the manual process again for Secondary Domains:
load sys:\system\gw8\gwmta @gatedom.mta
load restart address space=primary sys:\system\gw8\gwmta @gatedom.mta
load address space=primary sys:\system\gw8\gwmta @gatedom.mta
protection restart primary
unload address space=gatedom
sys:\system\gw8\GRPWISE.NCF
Whew! I don't know about you but that was a lot of information. Now you are an expert in upgrading domains. As you can see, it's not too difficult and with good planning and process, the upgrade flows well. In the next article, I will show you how to upgrade a post office to GroupWise 8. 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."