gwadminutil-merge (1)

Name

gwadminutil-merge - The GroupWise Administration Utility system merge option

Syntax

gwadminutil merge [-mergesync] -d path -p path

Description

Merges an external domain into the local GroupWise system as a new secondary domain. The external domain must be the only domain in the other GroupWise system.

This task requires direct file access to both databases. For that reason, it is not available in the Admin console, which provides direct file access to one domain database through the Admin Service for that domain.

After you merge an external domain into your GroupWise system, you must perform the following additional steps in order to complete the setup of the new secondary domain and its post offices:

  1. On the secondary domain server, install a new server certificate so that the local Admin Service can communicate with the primary domain Admin Service:

    gwadminutil certinst -d /path_to_secondary_domain 
                -ca ip_address_of_primary_domain_server:9710 -a admin_user_name -p
  2. Wait for replication of the domain information to the post office.

    On each post office server, you can use the following command to view the owning domain name in the post office database:

    gwadminutil dbinfo /path_to_post_office
  3. On each post office server, install a new server certificate so that the local Admin Service can communicate with the primary domain Admin Service:

    gwadminutil certinst -d /path_to_post_office 
                -ca ip_address_of_primary_domain_server:9710 -a admin_user_name -p

Options

Usage Options:

-d , --domain /path_to_external_domain

Specifies the path to the external domain that you want to merge into the local GroupWise system.

-mergesync

Merges external system synchronization information from the external domain into the local GroupWise system.

-p , --primary /path_to_primary_domain

Specifies the path to the primary domain of your local GroupWise system.

Help Options:

--help , -?

Displays the help information and exits.

Files

/opt/novell/groupwise/admin/gwadminutil

Script file that runs GWAdminUtil.

Examples

gwadminutil merge -p /gwsystem/provo1 -d /gwmail/orem4

Merges the Orem4 external domain into the local GroupWise system where Provo1 is the primary domain.

gwadminutil merge -mergesync -p /gwsystem/provo1 -d /gwmail/orem4

Merges the Orem4 external domain into the local GroupWise system were Provo1 is the primary domain, and establishes external system synchronization between the local GroupWise system and any other external systems that were syncing with the Orem4 domain.