Skip to main content
Outside service Partner
Hitachi Vantara Knowledge

Working with the HCP internal logs


In addition to the HCP system log, which is displayed in the System Management Console, HCP maintains internal logs. These logs record the processing activity of various components of the HCP system. If a problem with the system occurs, the internal logs can help HCP support personnel diagnose and resolve it.

Internal logs can be generated for both HCP General Nodes and HCP S Series Nodes. The logs can be created separately for the two types of nodes or together.

There are four different types of logs. Each is responsible for capturing information about a different component of the HCP system. If you request logs for S Series Nodes, you get all of the S Series Node logs regardless of whether you selected specific log types for the HCP system.

At any time, you can insert a comment into the internal logs. You can use this capability, for example, to note unusual events that occur in the HCP system. This can later help support personnel understand the symptoms that indicate a possible problem. It can also help them determine when a problem started.

To help with troubleshooting, you can download the internal logs and send them to your HCP support center. For ease of handling, HCP downloads the logs into a single file.

HCP keeps internal logs for at most 90 days. You can download the logs for any length of time within that period. When taking this action, be sure to include all the days on which you observed problems with the system.

When downloading the logs, you can provide a message for the support center. This message should include a description of the problem, your contact information, the applicable case number (if one has been assigned), and any other information that can help support personnel resolve the problem.

Encryption for logs is disabled by default. In order to enable encryption contact your HCP support provider. If encryption is enabled, only HCP support personnel have the key required to decrypt the logs.

ImportantWebHelp.png

Important: Downloading the internal logs puts a heavy load on the HCP system. Do not take this action unless explicitly told to do so by HCP support personnel.

You use the Internal Logs page in the HCP System Management Console to insert comments into and download the HCP internal logs. To display this page, in the top-level menu of the System Management Console, select Monitoring Internal Logs.

RoleWebHelp.png

Roles: To insert comments into the internal logs, you need the monitor, administrator, or security role. To download the HCP internal logs, you need the administrator role.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Adding a comment to the internal logs


To insert a comment into the HCP internal logs:

1.On the Internal Logs page, click on Mark Internal Logs.

2.In the Insert this message into the internal logs field in the Mark Internal Logs panel, type the comment text. This text can be up to 1,024 characters long and can contain any valid UTF-8 characters, including white space.

3.Click on Mark Internal Logs.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Downloading the internal logs for one or more storage nodes


You can download the internal logs for both HCP General and S Series Nodes. For HCP S Series Node logs, you cannot choose what type of log to download; they are all downloaded at once. S Series Node logs appear in their own separate Storage Preparation Status panel. If the HCP system doesn’t use S Series Nodes, this panel is not visible.

To prepare and download the HCP Software logs:

1.On the Internal Logs page, click on Download Internal Logs to expand that section on the page.

2.In the Download Internal Logs section:

oUse the Start Date and End Date fields to specify the start and end dates for the time period for which you want to generate the internal logs. For the date format, use mm/dd/yyyy.

NoteWebHelp.png

Note: The time period for which HCP generates the internal logs includes the specified start and end dates.

oOptionally, in the Insert this message into the internal logs field, type a message to be inserted into the logs before they’re downloaded and to be included in the manifest that accompanies the downloaded logs. This text can be up to 1,024 characters long and can contain any valid UTF-8 characters, including white space.

3.Click on Prepare Internal Logs.

HCP prepares the logs for downloading. During this process, in the Download Internal Logs panel, the active Prepare Internal Logs button changes to a grayed-out Download Internal Logs button, and the panel displays the Preparation Status table, which lists the nodes in the HCP system in numeric order (by node number), and reports on the status of the log preparation process on each node. You do not need to remain on the Internal Logs page during the log preparation process.

NoteWebHelp.png

Note: HCP can perform only one log preparation operation at a time.

When HCP finishes preparing the logs, the node and S Series Node Preparation Status tables show the status of each node in the HCP system, and the checkboxes at the end of each row become selectable.

TipWebHelp.png

Tip: If you want to prepare the logs again before you download them (for example, to prepare the logs for a different time period), click on Cancel to reactivate the Prepare Internal Logs button.

4.In the Choose type of log for download panel, select the type or types of logs you want to download. The possible log types are:

oAccess — These logs capture all user requests related to the HTTP-based APIs (REST, S3 compatible, HSwift, MAPI), such as object GET, PUT, and DELETE requests.

oSystem State — These logs capture the current state of the HCP system OS and application states and provide useful information for diagnosing issues related to node restarts and unexpected service behaviors.

oService Procedure — These logs capture information about service procedures performed on HCP such as the add node procedure, upgrade procedure, or add LUN procedure.

oHCP Software —These logs collect information about HCP software not listed in the other log types.

5.In the General Node Preparation Status panel, select the General Nodes you want to download logs for.

6.Optionally, if you have HCP S Series Nodes in your system, in the S Series Node Preparation Status panel, select the S Series Nodes you want to download logs for.

7.Optionally, insert a message into the logs before downloading them:

a.Click on Mark Internal Logs to expand that section on the page.

b.In the Insert this message into the internal logs field, type a message to be inserted into the logs before they’re downloaded and to be included in the manifest that accompanies the downloaded logs. This text can be up to 1,024 characters long and can contain any valid UTF-8 characters, including white space.

8.In the Download Internal Logs section, use the checkboxes in the last column in the Preparation Status table to select the nodes for which you want to download the internal logs:

NoteWebHelp.png

Note: By default, all nodes for which the logs were successfully prepared are automatically selected.

9.When you finish selecting the nodes for which you want to download the internal logs, click on Download Internal Logs.

HCP downloads the logs from the selected nodes and creates a .zip file that contains all of the internal logs for those nodes. For each selected node, HCP reports the progress of the log download in the Download Internal Logs panel. You do not need to remain on the Internal Logs page during this process.

10.When prompted, save the .zip file containing the downloaded logs in the location of your choice.

NoteWebHelp.png

Note: If the System Management Console session times out due to inactivity before the prompt to save the file appears, the download fails. If this happens, increase the inactivity timeout interval; then try the download again. For information on changing the inactivity timeout interval, see Changing user account and login settings.

11.Take one of these actions:

oTo create another .zip file that contains the internal logs you just generated for any or all of the HCP storage nodes, repeat step 4 through step 7 above.

NoteWebHelp.png

Note: You can perform any number of log download procedures for the time frame that you selected in step 2, and you can download these logs for each node any number of times.

oIf you’re finished downloading all of the internal logs you need, or if you need to prepare the logs again before downloading any additional logs, click on Cancel.

The Internal Logs page displays a success message and collapses the Mark Internal Logs and Download Internal Logs panels on the page.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.