Chapter 7. Using the ESP Logbook

This chapter describes the ESP logbook, how to view it, and how to add entries to it.

About the ESP Logbook

Use the ESP logbook to record changes that you make to a system: Create a logbook entry each time that you perform a service-related activity on a system. Then, if necessary, any ESP user with the “view logbook” permission can view the entries to review the activities at a later time.

Viewing Logbook Entries

You can view any logbook entries to review previous system activities.

Using the Web-based Interface (Single System Manager Mode)

Perform the following procedure to use the Web-based interface to view logbook entries in single system manager mode:

  1. Click on the Logbook button.

  2. Click on the View Log button.

    The interface displays the View Logbook Entries window. (Refer to Figure 7-1.)

    Figure 7-1. View Logbook Entries Window (Single System Manager Mode)

    Figure 7-1 View Logbook Entries Window (Single System Manager Mode)

  3. Specify the range of dates to view.

  4. Click on the View Log Entries button.

    The interface displays the specified logbook entries. (Refer to Figure 7-2.)

    Figure 7-2. Specified Logbook Entries (Single System Manager Mode)

    Figure 7-2 Specified Logbook Entries (Single System Manager Mode)

  5. Perform one the following actions to view a log entry:

    • Set the check mark next to entry number, and click on the Generate Report button.

    • Click on the subject link for the entry.

    The interface displays the logbook entry information. (Refer to Figure 7-3.)

    Figure 7-3. Logbook Entry Information (Single System Manager Mode)

    Figure 7-3 Logbook Entry Information (Single System Manager Mode)

Using the Web-based Interface (System Group Manager Mode)

Perform the following procedure to use the Web-based interface to view logbook entries in system group manager mode:

  1. Click on the Logbook button.

  2. Click on the View Log button.

    The interface displays the View Logbook Entries window. (Refer to Figure 7-4.)

    Figure 7-4. View Logbook Entries Window (System Group Manager Mode)

    Figure 7-4 View Logbook Entries Window (System Group Manager Mode)

  3. Specify the range of dates to view.

  4. Select the systems to view.

  5. Click on the View Log Entries button.

    The interface displays the specified logbook entries. (Refer to Figure 7-5.)

    Figure 7-5. Specified Logbook Entries (System Group Manager Mode)

    Figure 7-5 Specified Logbook Entries (System Group Manager Mode)

  6. Perform one the following actions to view a log entry:

    • Set the check mark next to entry number, and click on the Generate Report button.

    • Click on the subject link for the entry.

    The interface displays the logbook entry information. (Refer to Figure 7-6.)

    Figure 7-6. Logbook Entry Information (System Group Manager Mode)

    Figure 7-6 Logbook Entry Information (System Group Manager Mode)

Using the Command Line Interface

Use the following syntax of the espreport command to view logbook entries:

/usr/sbin/espreport logbook  [-sysid <system id>|-host <host name>]
                             [-from mm/dd/yyyy] [-to mm/dd/yyyy]

Use the -sysid and -host options to select a system. Use the -from and -to options to specify a range of dates. If you do not use these options, the report includes all available data.

Adding a Logbook Entry

You should add logbook entries any time that you modify a system.

Using the Web-based Interface (Single System Manager Mode)

Perform the following procedure to use the Web-based interface to add a logbook entry in single system manager mode:

  1. Click on the Logbook button.

  2. Click on the Add Log button.

    The interface displays the Create Log window. (Refer to Figure 7-7.)

    Figure 7-7. Create Log Window (Single System Manager Mode)

    Figure 7-7 Create Log Window (Single System Manager Mode)


    Note: ESP automatically sets the User field to the user account that you are using.


  3. Enter a subject for the entry. (This required field can hold up to 128 characters.)

  4. Enter a log entry. (This required field can hold up to 4 Kbytes of data.)

  5. Click on the Submit Log button.

    The interface displays the information that you entered. (Refer to Figure 7-8.)

    Figure 7-8. Logbook Entry Confirmation Window (Single System Manager Mode)

    Figure 7-8 Logbook Entry Confirmation Window (Single System Manager Mode)

  6. Click on the Commit button to create the entry.

    The interface displays the information that was added to the logbook. (Refer to Figure 7-9.)

    Figure 7-9. Completed Logbook Entry (Single System Manager Mode)

    Figure 7-9 Completed Logbook Entry (Single System Manager Mode)

Using the Web-based Interface (System Group Manager Mode)

Perform the following procedure to use the Web-based interface to add a logbook entry in system group manager mode:

  1. Click on the Logbook button.

  2. Click on the Add Log button.

    The interface displays the Create Log window. (Refer to Figure 7-10.)

    Figure 7-10. Create Log Window (System Group Manager Mode)

    Figure 7-10 Create Log Window (System Group Manager Mode)


    Note: ESP automatically sets the User field to the user account that you are using.


  3. Select the system that the log entry is for.

  4. Enter a subject for the entry. (This required field can hold up to 128 characters.)

  5. Enter a log entry. (This required field can hold up to 4 Kbytes of data.)

  6. Click on the Submit Log button.

    The interface displays the information that you entered. (Refer to Figure 7-11.)

    Figure 7-11. Logbook Entry Confirmation Window (System Group Manager Mode)

    Figure 7-11 Logbook Entry Confirmation Window (System Group Manager Mode)

  7. Click on the Commit button to create the entry.


    Note: All log entries are stored on the SGM server.

    The interface displays the information that was added to the logbook. (Refer to Figure 7-12.)

    Figure 7-12. Completed Logbook Entry (System Group Manager Mode)

    Figure 7-12 Completed Logbook Entry (System Group Manager Mode)

Using the Command Line Interface

Use the /usr/sbin/esplognote command to add a logbook entry. This command prompts you for the information that is required in a logbook entry.