gwadminutil-services (1)

Name

gwadminutil-services - The GroupWise Administration Utility agent services option.

Syntax

gwadminutil services [-i path] [-dva [name] [path]] [-s name]]
                     [-l [types] [-q [name]]
                     [-start [name]] [-stop [name]] [-n name] [-show]

Description

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

Installs the DVA service on a server where no post office is located.
Installs the POA service on a server where no post office is located.
Lists agent service information as it appears in the gwha.conf file.
Starts and stops the agent services, and lists agent status, similar to the functionality of the grpwise script.
Starts the agents with a user interface on the server console. An agent that runs with a user interface cannot be managed in the GroupWise Admin console because it is not running as a service.

Options

Usage Options:

-dva [object_name] [/path_to_startup_file]: Installs the DVA service on a server where no post office is located. Use with the -i option. If there are multiple DVAs for the post office, specify the DVA object name. If the DVA startup file is not local with the running DVA, such as in a clustering environment where the DVA fails over with the POA, specify the path to the DVA startup file. Specify a unique startup file name to accommodate multiple DVAs on a single cluster node.
-i , --install /path_to_database: Installs the POA service for a post office database. Installs the MTA service for a domain database. Installs the GWIA software for a GWIA database. Add the -dva option to install the DVA service. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.
-l , --list types: Lists agent service information as it appears in the gwha.conf file. Optionally, include one or more agent types in a comma-separated list (POA,MTA,GWIA,DVA).
-n , --name poa_name: Specifies the object name of the POA when multiple POAs run for a single post office.
-q , --query name: Displays current status information for all agents on the server. Optionally, specify a service name, partial service name, or wildcard pattern. This is similar to grpwise status.
-s , --service name: Specifies an agent service name. Use with the -u option to uninstall a service by its name rather than by its database location.
-show: Starts an agent with a user interface. Use with the -start option. An agent that runs with a user interface cannot be managed in the GroupWise Admin console because it is not running as a service.
-start agent_name: Starts the specified agent service. You can specify a full agent name, a partial agent name, or a wildcard pattern. This is similar to grwpise start object, but is more flexible.
-stop agent_name: Starts the specified agent service. You can specify a full agent name, a partial agent name, or a wildcard pattern. This is similar to grwpise start object, but is more flexible.
-u , --uninstall /path_to_database | -s agent_service: Uninstalls the agent service associated with the specified database or service name. This removes the agent service information from the gwha.conf file. Do this after you have deleted the domain or post office that the agent serviced.
-upgrade: Upgrades Windows service definitions for the agents. Not applicable on Linux

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 services -l

Lists all agent information in the gwha.conf file.

gwadminutil services -l mta,poa

Lists MTA and POA information in the gwha.conf file, but not the information for other agents on the server.

gwadminutil services -i -dva

Installs the DVA service on a server where no post office is located. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.

gwadminutil services -i -dva /media/nss/VOL1/dva1.dva

Installs a DVA service named dva1 in a Novell Cluster Services cluster where the startup file is located in the /media/nss/VOL1 folder. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.

gwadminutil services -i /gwsystem/engineering

Installs the POA service for the Engineering post office. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.

If you are installing a second POA service on a different server from where the post office is located, you must be able to specify the post office database location across a file system mount.

gwadminutil services -i /gwsystem/provo1

Installs the MTA service for the Provo1 domain. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.

gwadminutil services -i /gwsystem/provo1/wpgate/gwia

Installs the GWIA service for the Provo1 domain. You must use the GroupWise Installation Wizard to install the GroupWise Server software on the server, and start the Admin Service, before you can install agent services.

gwadminutil services -q

Displays current status information for all agents on the server. This is similar to grpwise status.

gwadminutil services -q poa

Displays current status information for the POA. This is similar to grpwise status engineering.provo1.

gwadminutil services -start provo1

Starts the MTA for the Provo1 domain. This is similar to grpwise start provo1.

gwadminutil services -stop engineering

Stops the POA for the Engineering post office. This is similar to grpwise stop provo1.engineering.

gwadminutil services -u /gwsystem/provo1

Removes the Provo1 MTA information from the gwha.conf file. Do this after you have deleted the Provo1 domain.

gwadminutil services -u -s gwia

Removes the GWIA information from the gwha.conf file.