gwadminutil-installcfg (1)

Name

gwadminutil-installcfg - The GroupWise Administration Utility installation configuration option.

Syntax

gwadminutil installcfg --mode user -u user_name -p [password]
gwadminutil installcfg --mode disabled | token

Description

Sets the authentication mode for the GroupWise Installation console.

By default, the GroupWise Installation Wizard passes a token to the Installation console to allow access. The token is valid for one hour. If the installation process is interrupted and more than an hour passes, your session in the Installation console is terminated. You can start a new session by reusing the Configure option in the Installation Wizard to generate a new token.

As an alternative, you can configure the GroupWise server so that a user name and password can be used to access the Installation console, instead of the token generated by the Installation Wizard. You can also prevent further installations on the GroupWise server until you establish a different authentication mode.

Options

Usage Options:

-m , --mode token|user|disabled

Specifies the authentication mode that is required to access the Installation console on the server.

-p , --password [password]

When the authentication mode is set to user, specifies the password that must be given in order to access the Installation console. Do not specify the password on the command line if you want to be prompted for it.

-u , --username user_name

When the authentication mode is set to user, specifies the user name that must be given in order to access the Installation console.

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 installcfg --mode user -u gsmith -p

Changes from token authentication to user authentication, and specifies the user name that is required to access the Installation console. Because no password is specified with the -p option, you are prompted to provide the password in order to put the authentication method into affect.

gwadminutil installcfg --disabled

Prevents future access to the Installation console.

gwadminutil installcfg --token

Returns to the original authentication method for the Installation console, so that you must use the Configure option in the Installation Wizard in order to access the Installation console.