gwadminutil-rebuild (1)

Name

gwadminutil-rebuild - The GroupWise Administration Utility database rebuild option

Syntax

          gwadminutil rebuild -d path -n name -o path [-cd]
        

Description

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.

When you rebuild a domain database, you must be connected to the primary domain in order to rebuild the secondary domain. Rebuilding the primary domain database is not recommended, but can be necessary in a single-domain system.

When you rebuild a post office database, you must be connected to the domain that owns the post office.

This task requires exclusive access to the owning domain database. Stop the agents and the Admin Service for the domain before rebuilding the database.

Options

Usage Options:

-cd , --create-directory

Creates a new domain or post office folder structure, along with the rebuilt database and the accompanying dictionary (.dc) files.

-d , --domain /path_to_domain_database

Specifies the path to the domain database from which the domain or post office database will be rebuilt.

-n , --name object

Specifies the name of the domain or post office that is being rebuilt. For a post office, use the domain.post_office format.

-o /path_to_output_folder

Specifies the location for the rebuilt database. After the database has been rebuilt, copy it into the original domain or post office folder.

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 rebuild -d /gwsystem/provo1 -n provo2 -o /tmp

Rebuilds the Provo2 secondary domain database, based on the Provo1 primary domain database in the /gwsystem/provo1 folder, and places the rebuilt secondary domain database in the /tmp folder.

gwadminutil rebuild -d /gwsystem/provo1 -n provo1 -o /tmp

Rebuilds the Provo1 primary domain database, and places the rebuilt primary domain database in the /tmp folder. Rebuilding the primary domain database is not recommended. If the primary domain database is sufficiently damaged, the rebuilt version not viable. Regular backups of the primary domain database in a single-domain system are critical.

gwadminutil rebuild -d /gwsystem/provo2 -n provo2.sales -o /tmp

Rebuilds the Sales post office that belongs to the Provo2 domain, and places the rebuilt post office database in the /tmp folder.

gwadminutil rebuild -d /gwsystem/provo1 -n provo2 -o /tmp -cd

Rebuilds the Provo2 domain, places the rebuilt domain database in the /tmp folder, and provides all the supporting folder structure and files to create a new domain directory.

gwadminutil rebuild -d /gwsystem/provo2 -n provo2.sales -o /tmp -cd

Rebuilds the Sales post office that belongs to the Provo2 domain, places the rebuilt post office database in the /tmp folder, and provides all the supporting folder structure and files to create a new post office directory. This process does not rebuild user databases (userxxx.db) and message databases (msgnnn.db).