This article outlines the commands used to control the Uptime Infrastructure Monitor agent on Solaris 10 and 11. These commands are not applicable for Solaris 8 or 9.

Changing the agent port

To change the agent port

  1. Open the file /etc/inet/services in a text editor.
  2. Find the following entry in the file:
    uptimeagent 9998/tcp # up.time agent
  3. Change the value of 9998/tcp to the port on which you want the agent to listen.

Change the agent user permissions

To change agent user permissions

Enter the following command at the command line:

inetadm -m svc:/network/uptimeagent/tcp:default user="username"

Where username is the name of the new agent user. 

Start the agent service

To start the agent service

Enter the following command at the command line:

 svcadm enable network/uptimeagent/tcp

Stop the agent service

To stop the agent service

Enter the following command at the command line:

 svcadm disable network/uptimeagent/tcp

Confirm that the agent service is running

To confirm that the agent is running

At the command line, enter one of the following:

svcs -l network/uptimeagent/tcp 

OR

inetadm

 Confirm that the inetd service is running properly

To verify that the inetd-dependent services are running

Enter the following command at the command line:

svcs -l network/inetd

Confirm the status of security restrictions on the agent service

To confirm the status of any security restrictions on the agent service

Enter the following commands at the command line:

# inetadm -l network/uptimeagent/tcp | grep wrappers 
# svcprop -p defaults inetd | grep wrappers
# cat /etc/hosts.allow 
# cat /etc/hosts.deny

Add the agent service manually

To manually add an agent

Enter the following commands at the command line:

# cp uptimeagent-tcp.xml /var/svc/manifest/network
# svccfg import /var/svc/manifest/network/uptimeagent-tcp.xml

Where uptimeagent-tcp.xml is the file that contains the settings for the uptimeagent service. 

Delete the agent service manually

The first command stops the agent service and the subsequent commands remove the agent service.

To manually delete an agent

# svcadm disable network/uptimeagent/tcp 
# svccfg delete network/uptimeagent/tcp
# rm ?f /var/svc/manifest/network/uptimeagent-tcp.xml

Refresh the agent settings

To refresh the agent settings

 svcadm refresh network/uptimeagent/tcp

Set a service to start at boot

To set the agent service to start with the operating system

svcadm enable <FMRI> 

Where <FMRI> is the Fault Management Resource Identifier, which is the formal name for a resource on which Solaris 10 can perform automated fault management.

  • No labels