Ask The Experts: GroupWise [34]

by Rob van Kooten and Jan-Arie Snijders

Just one topic to discuss this time round, but it’s an important one if you wish to test your GroupWise production system in a lab environment.  Below you will find a step-by-step procedure for doing this.

For this procedure, we are going to assume that the primary domain is named “dom1”, that it owns one post office named “po1”, that there is one secondary domain named “dom2” with one post office named “po2”.  We’ll also are assume that the GroupWise Server component has already been installed on the lab server.

  • Copy the primary domain database to a folder on the lab server named /opt/novell/groupwise/dom1 and make sure the dc files are copied to the folder as well. If needed, the dc files can be copied from the /opt/novell/groupwise/admin/data folder of the lab server.
  • Assuming you wish to change (or do not know) the administrator’s username and password, the administrator’s username and password can be changed via the command

/novell/groupwise/admin/gwadminutil setadmin -d /opt/novell/groupwise/dom1 -a admin -p microfocus.

In this command, -d represents the path to the primary domain’s database folder, -a represents the new administrator’s username and -p represents the new administrator’s password.

  • Start the gwadminservice in detached mode via the command

/opt/novell/groupwise/admin/gwadminservice --detached --home /opt/novell/groupwise/dom1 --ip  192.168.0.50 --adminPort 9999

The GroupWise Administration Console can now be accessed via https://192.168.0.50:9999/gwadmin-console/login.jsp and, after logging in, settings such as the IP addresses of the various agents and the LDAP servers and directories can be modified.

Note that you will not yet be able to start and stop agents or perform rebuilds from the GroupWise Administration Console as the gwadminservice is running using a set of temporary certificates.

  • Once the desired settings have been modified, rebuild the various domains and post offices via the command

/opt/novell/groupwise/admin/gwadminutil rebuild -cd -d /opt/novell/groupwise/dom1 -n po1 -o /opt/novell/groupwise/po1

In this command, -cd represents the option to create the directory structure and to copy the .dc files, -d represents the path to the owning domain’s database folder, -n represents the domain or post office that needs to be rebuilt and -o represents the folder to which  the domain or post office needs to be rebuilt.

  • When the various domains and post offices have been rebuilt, create an entry in the /etc/opt/novell/groupwise/gwha.conf file and an agent startup file for the various domains and post offices via the command

/opt/novell/groupwise/admin/gwadminutil services -i /opt/novell/groupwise/dom1

  • Create a new set of certificates for the primary domain via the command

/opt/novell/groupwise/admin/gwadminutil ca -d /opt/novell/groupwise/dom1 -g -f

In this command, -g represents the option to generate a new set of certificates and -f overwrites any existing set of certificates.

  • Start the gwadminservice via the command rcgrpwise start gwadminservice and start the MTA for dom1 via the command rcgrpwise start dom1
  • Download the new set of certificates to the various domains and post offices via the command

/opt/novell/groupwise/admin/gwadminutil certinst -db /opt/novell/groupwise/po1 -ca 192.168.0.50:9710 -a admin -p microfocus

In this command, 192.168.50:9710 represents the IP address and port number for the gwadminservice for the primary domain.

  • Start the MTA’s and POA’s for the various domains and post offices via the command rcgrpwise start.

The GroupWise Administration Console can now be accessed via https://192.168.0.50:9710/gwadmin-console/login.jsp and you will now be able to start and stop agents or perform rebuilds from the GroupWise Administration Console as the gwadminservice is running using the new set of certificates.

 

This article was first published in OH Mgazine Issue 34, 2016/3, p37.

Leave a Reply