gwadminutil (1)

Name

gwadminutil - GroupWise Administration Utility

Syntax

gwadminutil option [arguments]

Description

The GroupWise Administration Utility (GWAdminUtil) includes the following capabilities:

  • Command-line alternatives to the domain and post office database maintenance tasks available in the GroupWise Admin console.

  • Domain database maintenance tasks that are not available in the Admin console because they require simultaneous direct file access to two domain databases.

  • Security tasks for managing passwords and certificates.

  • Installation of agents on GroupWise servers where no domain or post office is located.

  • Management of agents similar to the grpwise script.

Options

Database Usage Options That Are Also Available in the Admin Console:

validate

Checks a database to determine if there are any physical problems with the database.

See gwadminutil-validate(1) for detailed syntax and examples.

recover

Corrects physical problems in a domain or post office database, but does not update incorrect information. After you perform a Recover Database operation, you can update information by synchronizing the database.

See gwadminutil-recover(1) for detailed syntax and examples.

rebuild

Corrects physical problems in a domain or post office database, and updates incorrect information. It is useful to rebuild a database when you have many user deletions or when GroupWise information has been lost.

See gwadminutil-rebuild(1) for detailed syntax and examples.

reclaim

Reclaims unused database space. As you add information to a GroupWise system, the databases increase in size. If you delete information, the space that was created in the databases for the deleted information is not immediately released. When you reclaim the disk space, it can reduce the size of the database.

See gwadminutil-reclaim(1) for detailed syntax and examples.

reindex

Rebuilds the listing indexes in the database that are used for sorting users in the Admin console.

See gwadminutil-reindex(1) for detailed syntax and examples.

Database Usage Options That Are Not Available in the Admin Console:

sync

Updates the primary domain database from a secondary domain database.

This process usually takes place automatically. However, if the link between the two domains has been down, you might want to run the synchronization manually. Any records owned by the secondary domain, such as post offices or users, are replicated from the secondary domain database to the primary domain database.

See gwadminutil-sync(1) for detailed syntax and examples.

convert

Promotes a secondary domain to a primary domain in your GroupWise system. When you do this, the current primary domain is demoted to a secondary domain. The MTA and POA must be running to perform this conversion.

See gwadminutil-convert(1) for detailed syntax and examples.

release

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.

See gwadminutil-release(1) for detailed syntax and examples.

merge

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.

See gwadminutil-merge(1) for detailed syntax and examples.

upgrade

Upgrades the version of a domain or post office database.

See gwadminutil-upgrade(1) for detailed syntax and examples.

Security Usage Options

setadmin

Changes the user name and password for the GroupWise Super Admin.

See gwadminutil-setadmin(1) for detailed syntax and examples.

installcfg

Sets the authentication mode for the GroupWise Installation console.

See gwadminutil-installcfg(1) for detailed syntax and examples.

ca

Interacts with the GroupWise Admin Service certificate authority (CA) to generate, issue, list, and revoke certificates for use with GroupWise domains, post offices, and agents.

See gwadminutil-ca(1) for detailed syntax and examples.

certinst

Contacts the primary domain Admin Service certificate authority (CA) and installs a new certificate for the Admin Service on the local domain or post office server.

See gwadminutil-certinst(1) for detailed syntax and examples.

Other Usage Options

services

Manages the GroupWise agent services. (Some functionality overlaps with the grpwise script.)

See gwadminutil-services(1) for detailed syntax and examples.

config

Provides configuration alternatives for the following aspects of the GroupWise Admin Service:

  • Support in the GroupWise Admin console for clustering of the GroupWise agents

  • Default port for the GroupWise Admin console

See gwadminutil-config (1) for detailed syntax and examples.

dbinfo

Displays information about a GroupWise domain or post office database.

See gwadminutil-dbinfo(1) for detailed syntax and examples.

Help Options:

--help , -?

Displays the help information and exits.

Files

/opt/novell/groupwise/admin/gwadminutil

Script file that runs GWAdminUtil.