grpwise - GroupWise Script
grpwise start [agent_location_name] grpwise status [agent_location_name] grpwise stop [agent_location_name] grpwise restart [agent_location_name] grpwise print [agent_location_name]
The agent location names are:
POA: post_office_name.domain_name MTA: domain_name Internet Agent: gwia.domain_name WebAccess Agent: webac80a.domain Document Viewer Agent: gwdva.hostname
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 know 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. A /usr/sbin/grpwise-ma link is also created.
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, then 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 “done” indicates that an agent is running. A black “unused” indicates than 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 than 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 than an agent is not running and, therefore, cannot be stopped. Then starts the agents 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.
Specifies the Internet Agent to stop. The syntax allows for multiple Internet Agents running on the same server and specifies which Internet Agent to stop.
Specifies the eDirectory object name of the WebAccess Agent to stop. The syntax allows for multiple WebAccess Agents running on the same server and specifies which WebAccess Agent to stop.
Stops the Document Viewer Agent. The syntax stops all Document View Agents on the server.
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.
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 program 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.
Start all GroupWise agents that are installed on the server
Show the status of the Development post office POA. The Development post office belongs to the Provo1 domain.
Stop the Internet Agent that belongs to the Provo1 domain.
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-2010, Novell, Inc.. All rights reserved.
gwpoa (1), gwmta (1), gwia (1), gwinter (1).
To report problems with this software or its documentation, visit Novell Bugzilla..