Selecting Log Files for Monitoring

Perform the following task to register a log file to select it for monitoring. Common Tuxedo and PeopleSoft log files can be registered from a pick list using the LOG AutoScan Registration command. Any other log file can be registered using the Monitor Another LOG command.

Each registered log file creates a log instance icon under the APPS_LOG application class. A log file must be registered before it can be monitored. Two procedures are described below, one for the common Tuxedo and PeopleSoft log files found by the AutoScan process (see Managing Log Files), and the other for any other type of log file.

This task will select for monitoring all Tuxedo server output files produced by specifying -o servopts in server's CLOPT, or all log files under the PeopleSoft $PS_HOME/appserv//LOGS* and $PS_HOME/appserv/prcs//LOGS* directories.

Before you begin

Ensure that you have completed the following items:

• installed the PATROL for Oracle Tuxedo PATROL for Oracle Tuxedo and PATROL for Oracle Tuxedo and have them running
• loaded and configured the PATROL for Oracle Tuxedo PATROL for Oracle Tuxedo for Tuxedo

To Register Common Tuxedo or PeopleSoft AutoScan Log Files

1. Access one of the following menu commands based on your environment:
   • For Tuxedo, perform the following steps:
     • double-click the Tuxedo APPS_LOGS icon
     • right-click the log instance icon
     • choose KM Commands => Administration => LOG AutoScan Registration
   • For PeopleSoft, perform the following steps:
     • double-click the PeopleSoft instance
     • double-click the APPS_LOGS icon
     • right-click LogAdmin

     • choose LOG AutoScan Registration 

       Warning

       Note

       For PeopleSoft LogAdmin, you will be prompted for the PS_HOME directory the first time you View, Register, or Refresh the autoscan log list.

       The Select Log File dialog box appears.
       

2. Highlight the log file that you want to monitor.
3. Click OK.
    The Monitor Another Log dialog box appears.
   

4. In Log Alias Name, type a unique alias name for this log file.
    This alias is used as the instance name (icon label). 

   Warning

   Note

   If you are monitoring a PeopleSoft log, the LogAdmin icon will disappear after you do this step and a new instance of the APPS_LOG icon will appear using the alias name that you entered.

5. Click OK.
    The log file you selected is now the currently monitored log file.

To Register Other Log Files

1. Double-click the APPS_LOGS icon.
2. Right-click the log instance icon.
3. Choose KM Commands => Administration => Monitor Another LOG.
    The Monitor Another Log dialog box appears.
   
4. Complete the dialog box as follows:
   • In Log Alias Name, type a unique alias name for this log file; this alias is used as the instance name (icon label).
   • In Log File with Full Path, type the full directory and file name path for the log file you want monitored.
   • In File Access User Name, type a user name and password for an account having privileges to read the log file.

   • In File Access Password, type the password for an account having privileges to read the log file. 

     Warning

     Note

     The user name and password fields are not required when registering an AutoScan log file because the security attributes are obtained during PATROL KM configuration. Log files other than Tuxedo and PeopleSoft can be specified in this task, so authentication of an account having permission to access the log file is required.

5. Click OK.
    The specified log file is now the currently registered log file.

Where to go from here

You are ready to monitor the configured Tuxedo environment.