When you install the UNIX agent on your computer, the agent starts automatically. The UNIX agent installation adds the UNIX agent to the server startup profile to be automatically started or stopped when you restart or shut down the UNIX system. You can also start or stop the UNIX agent using the UNIX Agent Manager console or the UNIX agent startup script, nqmdaemon. If you start the agent from UNIX Agent Manager, you can enter additional startup options.
You can manually start the process at any time by running the nqmdaemon start command. The path for running this command can vary, depending on the UNIX platform and information you entered during installation. The complete path for the current platform is always displayed at the end of the UNIX agent installation. For example, on Solaris, the command typically looks like this:
/etc/init.d/nqmdaemon start
NOTE:To start the UNIX agent, log in as the user you specified during installation before issuing the nqmdaemon start command.
To start or stop nqmdaemon, the UNIX agent user account must have root access by either running as the root account or using a command such as uroot or sudo. Depending on your environment, you might need to specify the path to the directory where the command resides. For example, if the uroot command is installed in the location /usr/netiq/vsau/bin:
/usr/netiq/vsau/bin/uroot /etc/init.d/nqmdaemon start
Use the following commands to start or stop the UNIX agent from a command line.
|
Option |
Description |
|---|---|
cold |
Also called cold start. Starts the UNIX agent using the default settings. Pending jobs do not run, but the agent can connect to the management server. This options removes job information from the configuration file. |
discover |
Runs the Discovery_UNIX Knowledge Script to discover configuration and resource information. |
frozen |
Also called frozen start. Starts the UNIX agent without any settings. This options deletes the existing NqmCfg.xml configuration file. Pending jobs do not run immediately, and the agent cannot connect to the management server right after starting. However, the connection is restored after a few minutes, and pending jobs are restarted at that time. Use the option only with the assistance of NetIQ Technical Support. |
restart |
Stops then starts the UNIX agent using the settings in the configuration file. |
start |
Starts the UNIX agent. If you do not include an argument, the agent starts normally using the settings in the configuration file. |
stop |
Stops the UNIX agent. The UNIX agent preserves information about any running jobs, but does not actively stop jobs. |
The UNIX agent provides a set of scripts or commands that facilitate automatic startup and shutdown when the computer is rebooted. These commands vary depending on the operating system of the computer on which they are run. The following table lists the location of these automatic startup and shutdown scripts for some of the key platforms where you run the UNIX agent:
|
UNIX Operating System |
Location and Commands |
|---|---|
|
Startup Commands |
|
|
Solaris |
/etc/rc3.d/S91nqmdaemon |
|
AIX |
/etc/rc.d/rc2.d/S99nqmademon |
|
HP-UX |
/sbin/rc3.d/S991nqmdaemon |
|
Red Hat Linux Enterprise Server 4 |
chkconfig --list | grep nqm Use this command to ensure the rc2, rc3, rc4, and rc5 are on and the S95nqmdaemon is present in each of the following directories: /etc/rc5.d /etc/rc4.d /etc/rc3.d /etc/rc2.d |
|
Red Hat Linux Advanced Server 4 (Itanium) |
The location and commands are the same as Red Hat Linux Enterprise Server 4 except you must verify whether the S95nqmdaemon is present in each of the following directories: /etc/rc.d/rc5.d/ /etc/rc.d/rc4.d/ /etc/rc.d/rc3.d/ /etc/rc.d/rc2.d/ |
|
Shutdown Commands |
|
|
Solaris |
/etc/rc0.d/K09nqmdaemon |
|
AIX |
/etc/rc.d/rc2.d/K05nqmdaemon |
|
HP-UX |
/sbin/rc0.d/K009nqmdaemon |
|
Red Hat Linux Enterprise Server 4 |
chkconfig --list | grep nqm Use this command to ensure the rc2, rc3, rc4, and rc5 are on and the K08nqmdaemon is present in each of the following directories: /etc/rc5.d /etc/rc4.d /etc/rc3.d /etc/rc2.d |
|
Red Hat Linux Advanced Server 4 (Itanium) |
The location and commands are the same as Red Hat Linux Enterprise Server 4 except you must verify whether the K05nqmdaemon is present in each of the following directories: /etc/rc.d/rc1.d/ /etc/rc.d/rc0.d/ /etc/rc.d/rc6.d/ |
|
NOTE:Startup and shutdown scripts for the Linux operating system are generated automatically. Therefore, the daemon name might not always be S14nqmdaemon and K05nqmdaemon. |
|
If you are starting the agent from UNIX Agent Manager, using the manual installation, or using the silent installation script, you can enter the following additional start up options.
|
Option |
Description |
|---|---|
-a PortNumber |
Sets the default port for communication with all management servers. The suggested port is 9001. |
-C |
Also called cold start. Starts the UNIX agent using the default settings. Pending jobs do not run, but the agent can connect to the management server. You cannot use this option with any other option. |
-d AgentLogDirectory |
Sets the directory where the UNIX agent stores log information. Log files in this directory include a timestamp as part of the filename, which is NqmAgt.log or NqmAgt_#.log, depending on how many logs are configured to be kept. For example, a log file named NqmAgt20120412180531.log indicates that the file was created on April 12, 2012, 18:05:31 hrs. The most recently created log file is linked to NqmAgt.log. The default log directory is $NQMAGT_HOME/log. If you are running the UNIX agent as a non-root user, ensure that the account has permission to read the log directory. If the user running the agent cannot read the log directory, then the UNIX agent cannot start. |
-F |
Also called frozen start. Starts the UNIX agent without any default settings. Pending jobs do not run, and the agent cannot connect to the management server. You cannot use this option with any other option. Use the option only with the assistance of NetIQ Technical Support. |
-H <AgentIPAddress> |
Sets an IP address for the UNIX agent. The agent listens on the specified IP address instead of any IP address associated with the agent computer. Use this option to bind the UNIX agent to specific address if your UNIX computer has multiple network interface cards (NICs) with unique IP addresses. |
NetIQ recommends that you accept the default, rclink. However, the following start methods are available:.
|
Option |
Description |
|---|---|
|
rclink |
Starts the agent daemons immediately after the deployment process and adds a startup script to the /etc/rc.d directory. This startup script starts the agent daemons after each reboot when the master rc script runs. This is the default method, and should be used in nearly all environments. |
|
inittab |
Starts the agent daemons immediately after the deployment process and adds an entry to the /etc/inittab file. This inittab file entry starts the agent daemons at the default run level after each reboot. |