Privilege Manager for Unix 7.1.1 - Administration Guide

Displaying profile-based policy debug information

To view debug information for profile-based policy, set the value for the pf_tracelevel variable either globally in global_profile.conf, or in an individual profile.

To set the pf_tracelevel variable in the profile

1. Enable the pf_tracelevel option. For example:

   # Variable: pf_tracelevel: Enables tracing/debugging output at different levels: 
   # 1:show reason for reject, 2: verbose output, 3: show debug trace 
   pf_tracelevel=2;

2. To view the trace output, run a command with pmrun, like this:

   $ pmrun id 
   ******************************************************************** 
   ** One Identity Privilege Manager for Unix Version 6.0.0 (006) ** 
   ** This request is being authorized on master :<HostName> 
   ** User "luser" has submitted a request from host "<HostName>" 
   ** to run the command "id" 
   ******************************************************************** 
      User : luser 
      Host : <HostName> 
      Command : id 
   * Check profile:profiles/admin.profile 
   ** Profile:admin does not match user 
   ** Profile:admin does not match UNIX group 
   ** Profile:admin does not match AD group list 
   * Check profile:profiles/demo.profile 
   ** Validate command:id 
   ** Profile:demo cmd[0] matches command:id Request accepted by the "demo" profile 
   
   All interactions with this command will be recorded in the file: 
      /var/opt/quest/qpm4u/iolog/demo/luser/id_20121023_1038_qu3zcf 
   
   Executing "id" as user "root" ... 
   ******************************************************************************** 
   
   uid=0(root) gid=0(root) groups=0(root)

Enabling program-level tracing

Technical Support may ask you to create a trace file when you run a program by using the -z option. The -z option enables tracing on a specific program or currently running process.

To display program-level tracing

1. Run a program with the -z option, like this:

   # <CommandName> -z on

   The -z option creates a <CommandName>.ini file which then creates a <CommandName>.trc file when you run the command. The .trc file contains the debug information. Both the .ini and the .trc files are created in the /tmp directory.

2. Once you have finished getting the trace output you need, run the program with the -z off option so the log will not continue to grow.

Load balancing and policy updates

pmloadcheck is both a command and a background daemon (run with the –i flag). When run as a command, it checks, updates, and reports on the status of the policy server. You can use pmloadcheck from a policy server or PM Agent.

When run as a daemon process, it keeps track of the status of the policy servers for failover and load-balancing purposes. On policy servers, pmloadcheck is responsible for keeping the production policy file up to date.

See pmloadcheck for more information about the syntax and usage of this command.

Policy servers are failing

The primary and secondary policy servers must be able to communicate with each other and the remote hosts must be able to communicate with the policy servers in the policy group.

For example, if you run the pmloadcheck command on a policy server or PM Agent to determine that it can communicate with other policy servers in the policy group, you may get output similar to the following:

++ Checking host:myhost.example.com (10.10.181.87) ... [FAIL]

There are several possible reasons for failure:

• Policy server host is down
• Network outage
• Service not running on policy server host