Checking PM Agent host for installation readiness
To check a PM Agent host for installation readiness
- Log on to the remote host system as the root user and navigate to the files you extracted on the primary policy server.
- From the root directory, run a readiness check to verify the host meets the requirements for installing and using the PM Agent, by running:
# sh preflight.sh –-pmpolicy –-policyserver <primary_policy_server>
where <primary_policy_server> is the hostname of the primary policy server.
NOTE: Running preflight.sh –-pmpolicy performs these tests:
- Basic Network Conditions:
- Hostname is configured
- Hostname can be resolved
- Reverse lookup returns it own IP
- Privilege Manager for Unix Client Network Requirements
- PM Agent port is available (TCP/IP port 12346)
- Tunnel port is available (TCP/IP port 12347)
- Policy Server Connectivity
- Hostname of policy server can be resolved
- Can ping the policy server
- Can make a connection to policy server
- Policy server is eligible for a join
- Policy server can make a connection to the PM Agent on port 12346
- Resolve any reported issues and rerun pmpreflight until all tests pass.
Installing a PM Agent on a remote host
To install an agent on a remote host
- Log on as the root user.
- Change to the directory containing the qpm-agent package for your specific platform. For example, on a 64-bit Red Hat Linux, enter:
# cd agent/linux-x86_64
- Run the platform-specific installer. For example, on Red Hat Linux run:
# rpm --install qpm-agent-*.rpm
Once you install the Privilege Manager agent package, the next task is to join the agent to the policy server.
Joining the PM Agent to the primary policy server
Once you have installed a Privilege Manager agent on a remote host you are ready to join it to the primary policy server.
To join a PM Agent to the primary policy server
- From the command line of the remote host, run:
# /opt/quest/sbin/pmjoin <primary_policy_server>.example.com
where <primary_policy_server> is the name of the primary policy server host.
If you are not running the pmjoin command on a policy server, it requires that you specify the name of a policy server within a policy group.
NOTE: The pmjoin command supports many command line options. See pmjoin for details or run pmjoin with the -h option to display the help.
When you run pmjoin with no options, the configuration script automatically configures the agent with default settings. See Agent configuration settings for details about the default and alternate agent configuration settings.
NOTE: You can modify the /etc/opt/quest/qpm4u/pm.settings file later, if you want to change one of the settings. See PM settings variables for details.
- When you run pmjoin with the -i (interactive) option, the configuration script gathers information from you by asking you a series of questions. During this interview, you are allowed to either accept a default setting or set an alternate setting.
Once you have completed the configuration script interview, it configures the agent and joins it to the policy server.
Running pmjoin performs the configuration of the Privilege Manager agent, including modifying the pm.settings file and starting up the pmserviced daemon.
- When you run pmjoin for the first time, it asks you to read and accept the End User License Agreement (EULA).
Once you complete the agent configuration script (by running the pmjoin command), it:
- Enables the pmlocald service
- Updates the pm.settings file
- Creates wrappers for the installed shells
- Updates /etc/shells
- Reloads the pmserviced configuration
- Checks the connection to the policy server host
- To verify that the agent installation has been successful, run
This returns displays configuration information about a client host. See pmclientinfo for details.
Verifying PM Agent configuration
To verify the PM Agent configuration
- From the command line, run:
The pmclientinfo command displays the current configuration settings. For example:
[root@host1 /]# pmclientinfo
- Joined to a policy group : YES
- Name of policy group : polsrv1.example.com
- Hostname of primary policy server : polsrv1.example.com
- Policy type configured on policy group : pmpolicy
The secondary server PM Agent will be joined to the secondary server. This is unique because all other PM Agent hosts must join to the primary server.