How to upgrade GroupWise Domain and Post Office databases

  • 7024580
  • 23-Apr-2020
  • 27-Apr-2020


GroupWise 18.2.x
GroupWise 18.1.x
GroupWise 18.x

SUSE Linux Enterprise Server
Micro Focus Open Enterprise Server


After the GroupWise Server installation completes, Domain and Post Office database versions are still the same as before the install.


Upgrading the Domain and Post Office Servers does not upgrade the databases.  This must be done in a separate step after the install, as stated in the GroupWise Documentation section:  Domain and Post Office Upgrades

Assuming you have followed the steps listed in the GroupWise Documentation for preparing your existing GroupWise System for upgrade, here are the steps to upgrade the databases:

1.  Select the GroupWise Install icon on the desktop of the server to open the GroupWise Web Install Console in your browser.  
- You can also access the Web Install Console in the browser of your workstation at:
- If you are required to authorize your install, copy the full string provided in the box:
gwadmin-ipc authorize <token> 
Paste or enter that line into a terminal session on the GroupWise Server and hit enter.  You should then have access to the console.

2.  Select 'Upgrade an Existing Domain or Post Office to GroupWise 18'
- The available Domains and Post Offices should be listed
- If they are not, select 'Add' and browse to the directory location
- Note the version number listed in the far right column

3.  Click 'Next' on the bottom right of the page

4.  Enter the GroupWise Admin name and password

5.  Confirm the GroupWise System and Agents information listed on the summary page is correct

6.  Click 'Finish' on the bottom right of the page

7.  Restart all POA's and MTA's by either following the link provided on the page to the GroupWise Web Admin Console and manually stopping then starting each agent, stopping and starting each agent in Services (Windows), or by using the 'rcgrpwise restart' command in a terminal session on the server (Linux)

8.  You can confirm the Domain and Post Office database versions are correct after this upgrade process by checking the 'General' tab for each Domain and Post Office in the GroupWise Web Admin Console.  You will see 'Database Version: <xxx>'