“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.

1. 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

Figure 1:

Once the code is downloaded and expanded, change to the code directory:

cd /tmp/w14.0.0-115243_full_linux_multi

At this point, run:

./install.sh

Figure 2:

Figure 3:

Select English, Enter

Figure 4: Select English, Enter

Select Installation, Enter

Figure 5: Select Installation, Enter

Select Agree, by typing 'A'

Figure 6: Type 'A' to Agree

Select GroupWise Server, Enter

Figure 7: Select GroupWise Server, Enter

Select Install, Enter

Figure 8: 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:

1. Shut down agents running

• Load/Read repository data
  
  
  
  1. 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
  
  
  
  1. 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:
  
  
  
  1. gwadminservice
  
  
• gwdva

• po.dom

Figure 9: Installation process for GroupWise Server, part 1

Figure 10: Installation process for GroupWise Server, part 2

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

Type:

rpm -qa | grep novell

ps -eaf | grep gw

1. gwadminservice

• gwdva
  
  
  
  1. 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.

     
     
  
  
  

Changing gwdva to run on Post Offices IP Address

Type:

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.

Figure 11: Various commands to show GroupWise 2014 Services are running

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:

1. Stop/Start the POA Agent from the GAC

• No maintenance of the Post Office from the GAC

So let's finish up.

1. In a browser:

• Go to the IP Address of the POA, port 9710, gwadmin-console/install
  
  
  
  1. https://192.168.91.142: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
  
  
  
  1. 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.

• Success!!

Figure 12: IP Address of the Upgraded POA, port 9710, gwadmin-console/install

Figure 13: gwadmin-ipc authorize on Post Office Server

Figure 14: gwadmin-console/install, Select Upgrade an Existing Domain or Post Office

Figure 15: Upgrade of Post Office, Note the Admin Port for the POA, Select Next

Figure 16: Credentials, Add the Primary Domain MTA IP Address, Admin Port, Admin Name and Password

Figure 17: Summary, Note the information about the Post Office, Select Finish

Figure 18: Success! At this point, you have successfully upgraded the post office

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.

Figure 19: System Overview showing PO2 upgraded to GroupWise 2014

Figure 20: Properties of PO2, Database Version 1400

Next, while in the GAC, you will want to add the DVA.

Go to:

System, Document Viewer Agent, New

Figure 21: Add new Document Viewer Agent

Figure 22: Add new GWDVA information

Fill in the information:

1. [PO Name] DVA

• Description

• IP Address
  
  
  
  1. which may be the servers or the secondary if you changed the DVA configuration file.
  
  

• Port
  
  
  
  1. which should be the default or the SSL default
  
  

Next go to:

Post Office Agents, Select a POA, go to Document Viewer Agent tab

Figure 23: Properties of POA, Document Viewer Agent tab

1. Select the Add Document Viewer Agent

• Select the Document Viewer Agent
  
  
  
  1. The one for that post office per your previous setup in System, Document Viewer Agents.
  
  

• Save

Figure 24: Set the new DVA

Done, or repeat for next post office.

Now you can run the Configure, if you want.

1. 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.

Figure 25: Select Configure

Figure 26: URL's for Install and Administration

1. First drop a copy of your configuration file in the post office directory.

• Second go to:
  
  
  
  1. /etc/opt/novell/groupwise/gwha.conf
     
     
     
     1. and change the “STARTUP” path to the post office directory.
     
     

• Stop/Start the post office.

• Type:
  
  
  
  1. gwadminutil services -l
  
  
• and verify the path.

• That's it.

Figure 27: Shows the Startup Path to the POA file changed

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.”