“I’ve heard it called by different names. All over the world, but it’s all the same.” We interrupt your summer cruisin’ with this flash. GroupWise 2014 is simple to upgrade and the ‘dot oh’ release is proving very stable indeed!!
This article will present the process for upgrading a GroupWise 2012 post office which is running alone on a server. Alone, in this case means there are no domains/gateways running on the server. Also assumed here is the parent domain for the post office to be upgraded exists on a different server from the GroupWise 2012 post office and that it has already been upgraded to GroupWise 2014. Finally, this article assumes the upgrade is an in-place upgrade on a SLES11 server with no OES.
Why no OES? Because what’s the point?! OES for GroupWise was great when you needed ConsoleOne to connect to NSS volumes, but now with GroupWise 2014 there is no need for ConsoleOne. And who needs the overhead, besides EXT3 performs very well on SLES11. Does that mean you must move your GroupWise system from OES11? NO. But when the time comes consider SLES over OES for GroupWise.
The first task is to download and expand the GroupWise 2014 code.
- Current code for GroupWise 2014 is: gw14.0.0_full_linux_multi.tar.gz
- Save in a temporary location such as: servername:/tmp
- To expand, open a terminal and type:
tar -xzf gw14w14.0.0_full_linux_multi.tar.gz
Once the code is downloaded and expanded, change to the code directory:
At this point, run:
Select English, Enter
Select Installation, Enter
Select Agree, by typing ‘A’
Select GroupWise Server, Enter
Select Install, Enter
At this point, the installation will shut down the GroupWise 2012 post office and Document Viewer Agent. It will then install the gwadminservice and rpm’s for GroupWise 2014. Precisely it will:
- Shut down agents running
- Load/Read repository data
- This will look to the SLES11 repository locations. If it cannot reach them it will error out. This may mean either disable repositories or set Proxy Server.
- Install new novell-groupwise-server
- Remove old: novell-groupwise-agents and novell-groupwise-dva
- It will upgrade: novell-groupwise-gwha and openmotif22-libs
- These two items will undergo an architecture change to x86_64
- Once these are stated, it will run through the installation.
- At the end of the installation, it will load up the new:
Then a “Press any key to return . . .” will be left behind.
Press Any Key
Now you can run an rcgrpwise status which will show all agents running
rpm -qa | grep novell
You will find the 2 new packages running
ps -eaf | grep gw
You will see the configuration and service information for both the:
- and its 5 workers
Note: The gwdva appears to bind to the IP of the server and not the secondary IP of the post office.
- and its 5 workers
Changing gwdva to run on Post Offices IP Address
How to make the GWDVA to listen on the same IP Address as its post office. This may be a secondary IP Address. This is done by going to the gwdva configuration file located at:
- Open the gwdva.dva
- Find the remarked line: /ip-[address]
- Below it, unremarked, Type in:
- – ip-IPofDVA
This line is ‘dash dash ip dash Secondary IP Address for Post Office
- Save, Exit
- In a Terminal Type:
- rcgrpwise stop
- Then when the agents have stopped, type:
- rcgrpwise start
- Finally, to verify the change was taken, type:
- ps -eaf | grep gw
gwadminutil services -l
This will provide you a list of services running for GroupWise 2014 as well as the path to the executable and the startup.
Its at this point, we get to use a bit of the new GroupWise 2014 console to finish the upgrade. Technically, the upgrade is finished in the sense the database will register as 1400. But we still need to activate the admin port on the server with the post office we just upgraded. And without an admin port, you lose some of the features of GroupWise 2014.
You will not be able to:
- Stop/Start the POA Agent from the GAC
- No maintenance of the Post Office from the GAC
So let’s finish up.
- In a browser:
- Go to the IP Address of the POA, port 9710, gwadmin-console/install
- At the authorize screen, go to the server of the Post Office,
- Open a Terminal and Type the gwadmin-ipc authorize with the code given
- gwadmin-ipc authorize uqscqn4nXbY
- This will return you the code in the terminal
- Next go back to the browser where you will see the gwadmin-console/install screen
- Select the “Upgrade an Existing Domain or Post Office to GroupWise 2014
- In the Upgrade screen you will see the Post Office listed. Specifically, you will see the Admin Port.
- Select Next
- In Credentials, Add the Primary Domain MTA IP Address, Admin Port, Admin Name and Password
- Select Next
- In Summary, Note the information about the Post Office
- Select Finish.
Now let’s verify we actually had success.
Go to the GroupWise Administration Console, Overview.
You will now see the post office no longer has the (2012) next to it.
Its been upgraded at this point both database and service.
Next, while in the GAC, you will want to add the DVA.
System, Document Viewer Agent, New
Fill in the information:
- [PO Name] DVA
- IP Address
- which may be the servers or the secondary if you changed the DVA configuration file.
- which should be the default or the SSL default
Next go to:
Post Office Agents, Select a POA, go to Document Viewer Agent tab
- Select the Add Document Viewer Agent
- Select the Document Viewer Agent
- The one for that post office per your previous setup in System, Document Viewer Agents.
Done, or repeat for next post office.
Now you can run the Configure, if you want.
- Select Configure, Enter
- You will have a URL listed. The first one is the /install/login.
- Nothing will really get configured per se.
- If you want to configure the gwha to call your *.POA configuration files from the post office directory, you will have to manually set that up.
- You can back out/exit from the ./install.sh at this point.
- First drop a copy of your configuration file in the post office directory.
- Second go to:
- and change the “STARTUP” path to the post office directory.
- Stop/Start the post office.
- gwadminutil services -l
- and verify the path.
- That’s it.
Now the last step. Stop/Start the agents and reboot the server and verify all comes up as expected. Then verify end user login with client, webaccess and mobile devices.
Rinse and Repeat for the next post office that has a GroupWise 2014 parent domain.
As you can see, upgrading a GroupWise post office to 2014 is very easy on Linux. And because its so easy it will get you back to your summer fun so you can sing along with: “There’s only one way to rock.”
Got comments or article ideas? Need help GroupWise? Drop me a line at: Gregg@HinchmanConsulting.com. “The Force is strong in this one.”