grpwise - GroupWise Script
grpwise start [object] grpwise status [object] grpwise stop [object] grpwise restart [object] grpwise print [object]
The agent objects are:
POA: post_office_name.domain_name MTA: domain_name DVA: gwdva GWIA: gwia.domain_name
NOTE:The Monitor Agent is not controlled by the grpwise script. It has its own script named grpwise-ma, which works essentially the same as the grpwise script.
The grpwise script is created during installation and can control any agents installed on the local server. It is created in the /etc/init.d directory. It works in conjunction with the gwha.conf file, which is created in the /etc/opt/novell/groupwise directory. The gwha.conf file lists the agents installed on the local server so that the grpwise script knows what agents to start.
The GroupWise agents are Run Control compliant. During installation, a symbolic link is created from /etc/init.d/grpwise to /usr/sbin/rcgrpwise. Typically, /usr/sbin is already on your path, so you can run rcgrpwise from any directory, rather than changing to /etc/init.d in order to run the grpwise script.
Starts all GroupWise agents on the local server or the GroupWise agent specified in the grpwise command. A green “done” indicates that an agent is running. If a green “done” does not appear, the agent was unable to start.
Displays status for all GroupWise agents on the local server or for the GroupWise agent specified in the grpwise command. A green “running” indicates that an agent is running. A black “unused” indicates that an agent is not running.
Stops all GroupWise agents on the local server or the GroupWise agent specified in the grpwise command. A green “done” indicates that an agent is stopped. A black “unused” indicates that an agent is not running and therefore cannot be stopped.
Stops all GroupWise agents on the local server or the GroupWise agent specified in the grpwise command. A green “done” indicates that an agent is stopped. A black “unused” indicates that an agent is not running and therefore cannot be stopped. The agents then start again with the standard start status indicators.
Lists settings for all GroupWise agents in the gwha.conf file or for the GroupWise agent specified in the grpwise command.
Specifies the POA to stop. The syntax allows for multiple POAs running on the same server and specifies which POA to stop.
Specifies the MTA to stop. The syntax allows for multiple MTAs running on the same server and specifies which MTA to stop.
Stops the DVA. The syntax stops all DVAs on the server.
Specifies the GWIA to stop. The syntax allows for multiple GWIAs running on the same server and specifies which GWIA to stop.
Displays the help information and exits.
GroupWise High Availability service configuration file. This configuration file lists all information necessary to start and stop each GroupWise agent that is installed on the server. For example, an entry for an MTA might look similar to this example:
server = /opt/novell/groupwise/agents/bin/gwmta command = /etc/init.d/grpwise startup = provo1.mta delay = 2 wait = 10
The server = setting specifies the full path to the agent executable.
The command = setting specifies the full path to the grpwise script.
The startup = setting specifies the name of the agent startup file. All agent startup files are located in the /opt/novell/groupwise/agents/share directory. In a cluster, the startup files are on the shared resource.
The delay = setting controls the length of time between when the script issues the command to start an agent and when the script displays a message indicating that the agent has started. The default delay time is 2 seconds.
The wait = setting controls the length of time between when the script issues the command to stop an agent and when the script kills the agent if the agent has not yet stopped. The default wait time is 10 seconds.
By default, the grpwise script starts the agents as daemons with no user interface. If you want a user interface, you can add a show = yes line for each agent that you want to have a user interface.
This script must be run as root. If you have configured the GroupWise agents to run as a non-root user, they switch over to that user after they have started.
Starts all GroupWise agents that are installed on the server.
Shows the status of the Development post office POA. The Development post office belongs to the Provo1 domain.
Stops the GWIA that belongs to the Provo1 domain.
NOTE:In all examples, /etc/init.d/grpwise can be replaced with rcgrpwise to run the script from any directory.
If a GroupWise agent fails to start when using the grpwise script, try starting the agent manually, as described in the man page for each agent. You might receive an error message indicating why the agent is failing to start.
If you have changed the non-root user that you want the agent to run by modifying the /etc/opt/novell/groupwise/agents/uid.conf file, you might have forgotten to delete the corresponding uid.run file in the domain or post office directory that the agent services. Delete the uid.run file, then use the grpwise script to try to start the agent again.
Copyright 2004-2012, Novell, Inc.. All rights reserved.
gwpoa (1), gwmta (1), gwia (1), gwdva (1).
To report problems with this software or its documentation, visit Novell Bugzilla..