gwadminutil-release (1)

Name

gwadminutil-release - The GroupWise Administration Utility database release option

Syntax

gwadminutil release -d path -p path -n name

Description

Removes a secondary domain from the current GroupWise system and creates a new GroupWise system. The released domain becomes the new primary domain in its own single-domain GroupWise system.

After you release a domain, you must perform the following additional steps in order to complete the setup of the new GroupWise system:

On the server where you performed the release, set up the GroupWise Super Admin user for the new GroupWise system:
```
gwadminutil setadmin /path_to_primary_domain_database -a admin_user_name -p
```
On the new primary domain server, set up the GroupWise certificate authority for the new GroupWise system:
```
gwadminutil ca -d /path_to_primary_domain_database -g
```
Wait for replication of the new GroupWise system information from the primary domain to the post office.

On each post office server, you can use the following command to view the system name in the post office database:
```
gwadminutil dbinfo /path_to_post_office
```

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_domain_to_release: Specifies the path to the secondary domain that you want to release from one GroupWise system so that it can be merged into another GroupWise system.
-n , --name name_of_new_system: Specifies the name of the new GroupWise system that is created when the domain is released.
-p , --primary /path_to_new_primary_domain: Specifies the path to the new primary domain that is created when you release the secondary domain from the original GroupWise system.

Help Options:

--help , -?: Displays the help information and exits.

Files

/opt/novell/groupwise/admin/gwadminutil: Script file that runs GWAdminUtil.

Examples

This program normally runs as root.

gwadminutil release -p /gwsystem/provo1 -d /gwmail/provo4 -n orem1: Releases the Provo4 domain from its GroupWise system and creates a new, single-domain GroupWise system named Orem1.