Basic agent monitoring and management is most easily performed on the System Overview page in the Admin console. For instructions, see Making the Most of the System Overview. Refer to the following additional tasks as you maintain all the GroupWise agents on Windows:
This section has information for options you can use to manually start and stop Windows GroupWise agents.
There are two ways to start or stop GroupWise agents as services on Windows.
You can manage the GroupWise agents just as you would any other Windows services.
For example, on Windows Server 2012 R2:
From the Windows desktop, click Start > Administrative Tools > Services.
Select the agent service, and then click Start.
or
Select the agent service, and then click Stop.
When the agents run without a user interface, you can monitor them by using their agent consoles. See Monitoring the Agents from Your Web Browser.
You can also manage the GroupWise agents by using the gwsc command, which is short for the gwadminutil services command.
For the gwsc command, each agent is designated in terms of its object name or of the name of the domain and post office associated with it:
|
|
Use the following set of gwsc commands to start and stop the agents as services and verify their status:
gwsc -query |
Displays the status of the GroupWise agents that are configured to run on the server. |
gwsc -query name |
Displays the status of the specified agent. |
gwsc -start |
Starts the GroupWise agents that are configured to run on the server. |
gwsc -start name |
Starts the specified agent. |
gwsc -stop |
Stops the GroupWise agents that are configured to run on the server. |
gwsc -stop name |
Stops the specified agent. |
gwsc -list |
Lists the agent services that are configured on the server. |
In general, you should run the Windows agents as services without a user interface, so that they can be managed in the Admin console.
Occasionally, when troubleshooting a problem that occurs at agent startup, the problem can occur before the agent console can be displayed and before error messages can be written to the agent log file. Under such circumstances, you can start an agent with a user interface in order to view any errors that the agent displays on the server console before the agent stops again.
IMPORTANT:When an agent is running with a user interface, it cannot be managed in the Admin console.
To run the agents as applications, you can create desktop shortcuts for them. The desktop shortcuts need to contain the following commands:
c:\Program Files\Novell\GroupWise Server\agents\gwpoa.exe /home \post_office_folder c:\Program Files\Novell\GroupWise Server\agents\gwmta.exe /home \domain_folder c:\Program Files\Novell\GroupWise Server\agents\gwia.exe /home /gwia_folder c:\Program Files\Novell\GroupWise Server\agents\Monitor\gwmon.exe /home \domain_folder
c:\Program Files\Novell\GroupWise Server\agents\gwpoa.exe /home \mail\powin c:\Program Files\Novell\GroupWise Server\agents\gwmta.exe /home \mail\domwin c:\Program Files\Novell\GroupWise Server\agents\gwia.exe /home \mail\domwin\gwia c:\Program Files\Novell\GroupWise Server\agents\Monitor\gwmon.exe /home \mail\domwin
Agent status messages and error messages are written to the agent log files (mmddagent.nnn) in the following directories:
|
|
NOTE:On some versions of Windows Server, the ProgramData folder is not visible by default. To display it in File Explorer, click View, and then select Hidden items.
If you move the GroupWise agents to a different server, you can uninstall the agent software from the old location to reclaim disk space.
Agents: |
In the Control Panel, click Programs and Features. Right-click Micro Focus GroupWise Server, and click Uninstall. |
Monitor: |
Stop the Monitor Agent, and then delete the c:\Program Files\Novell\GroupWise Server\Monitor folder. |
Applications: |
Stop Tomcat, and then delete the following folder: c:\Novell |