Skip to main content

Service Management

The Service Management function contains a table of specific information related to all IO services. You can also use this tab to download logs, generate JMX or memory dumps, and change log levels.

Follow these steps to access the Service Management page.

  1. From the Settings screen, click Service Management.

    svcmgmt.png

    The Service Management page displays.

    VW674_Service_Management.png

    The Column Headings on this page are defined as follows:

    Column Headings

    Definition

    Name

    Name of the service.

    Enabled

    Enabled services have a checkmark in their boxes. Greyed out checkboxes indicate services that can neither be disabled nor have their statuses altered. Enable a service by clicking on its checkbox and then clicking on the Save button.

    Status

    Status of the service. Values are Running, Inaccessible, Starting, or Stopped. Running means that the service is running. Inaccessible means that the service is running, but not responding to requests. Starting means that the service is starting and not yet ready to accept requests. Stopped means that the service is stopped.

    Log Level

    Level of debug logging that the service is generating. Valid debug levels are: Trace, Debug, Info, Warning, and Error. If log levels for a service have been disabled by Virtana, nothing displays in the Log Level column.

    # of Properties

    Some services have properties that can be modified. This field contains the number of properties that have been modified for the service.

    Heap Size (GB)

    The current Heap Size setting. Only administrative users may alter heap sizes with a special property in consultation with Virtana Support. Heap size is read-only by default.

    Last Memory Dump

    Time stamp of the last user-generated Memory dump. If no memory dump has ever been generated, this field contains - -.

    Last JMX Dump

    Time stamp of the last user-generated JMX dump. If no JMX dump has ever been generated, this field contains - -.

  2. You can export the Services list by clicking on the hamburger icon then selecting Export.

    exportsvcslist.png

Download All Services Logs

You can download all logs associated with the IO services. These logs include data on crash and core dumps and are occasionally requested by Virtana Support for troubleshooting. These log files are encrypted during download.

  1. Click the Download All Logs button to view a drop-down menu.

    downloadalllogs.png

  2. Select Generate Log to generate the log files.

    genalllogs.png

    A banner message is displayed indicating that log file generation is in process.

    genloginproc.png

  3. When the log file has been generated, the lettering on the Download All Logs button changes to the color blue. To download the generated log file, select Download from the Download All Logs drop-down menu and select the log file. The drop-down menu also includes the size of the log and the date and time that the log was generated.

    downloadalllogs2.png

    The log file is downloaded as an encrypted zip file.

    downloadalllogs3.png

  4. You can now send this file to Virtana Support for analysis.

Download Services Audit Log Files

IO tracks user actions and saves these actions in audit logs. You can download these audit logs from the Service Management page.

  1. Click the Download Audit Log button.

    downloadauditlogs.png

  2. The log file is downloaded as a zip file.

    downloadauditlogs2.png

  3. You can now send this file to Virtana Support for analysis or unpack and review it.

Download Database

You can download encrypted portions of the IO database for support purposes.

  1. Click the Download Database button.

    downloadauditlogs.png

  2. A dialog with a Collect Database File button will be displayed. Click on that button to begin the collection/encryption process. If a database had been previously collected, click on the Collect New File button as shown below.

    service-mgmt-db-collect.png

    The dialog contents will change to a progress indicator. In this dialog, you may choose to be notified and you can then close the dialog. You may also click on the Cancel button to abort the collection process.

    A banner message will be displayed indicating that database file collection is in progress.

  3. Once the database file has been generated, clicking on the Download Database button will display a dialog containing a Download Results button.The size of the file is also given as shown above. Click on this button to download the file.

  4. You can now send this file to Virtana Support for analysis.

Change the Log Level on a Service

If log levels for a service have been enabled, you can change the log level for that service.

  1. Click the down arrow in the Log Level field of the service to modify the level.

    setloglevel.png

  2. Choose the new log level for the service. Allow approximately thirty seconds for the Log Level to refresh.

Generate a Memory or JMX Dump

Virtana Support may request a memory or JMX dump for a service as part of a support ticket. You can use the Services Management page to generate and download the file.

  1. Click the down arrow in the service's row and select Generate Memory Dump or Generate JMX Dump.

    gendump.png

    A dialog box confirms the dump has been started.

    gendump2.png

    Note

    Generating a memory dump could take some time. A spinner is displayed on the page while the dump is in process.

    Note

    JMX is not available for Kubernetes installations.

    Check the Auto Refresh box to refresh the Services list every 30 seconds.

    autorefresh.png

  2. The Last Memory Dump or Last JMX Dump field is updated with the date and time of the dump.

    gendump3.png

  3. Download the dump by selecting Download Memory Dump or Download JMX Dump using the drop-down menu for the row.

Overriding Entity Types

If you want to change the assignments made to ports, you can override the HBA [port and storage port entity types for Brocade SAN or for Cisco SAN by setting a software proxy. Overriding the entity type allows you to set the initiator host HBA Port as the storage or set the Storage Port as the initiator host.

About This Task

  • You can use wildcards to set properties for either STORAGE or INITIATOR HOST.

  • You can only use a Property Name once.

    For example, storagePortWWNPattern and hostPortWWNPattern can only be listed one time, although each property can have multiple values, separated by commas, associate with it.

Steps

  1. Identify and make note of the World Wide Names (WWNs) of the ports to override:

    • Select Inventory > Compute > Hosts > Network > HBA Port to identify initiator host port WWNs.

    • Select Inventory > Storage > SAN > Storage Port to identify storage WWNs.

    You need to provide the WWNs in succeeding steps.

  2. Select Settings > Service Management and locate Cisco SAN / Brocade SAN Integrations in the Service Management table.

  3. Click the Actions icon vw-icon-action-menu.png for Cisco SAN / Brocade San Integrations and then click Set Properties.

  4. Follow these steps to override from HOST (Server) to STORAGE:

    1. Set Property Name to storagePortWWNPattern

    2. Set the Value to the INITIATOR HOST PORT (HBA) WWNs you selected in step 1.

      For example:

      200000110dc81500,200200110dc81300.

      There is no space after the comma between WWNs.

      You can also use wildcards. For example:

      10008c7cff21c8*,10008c7cff33d2*,10008c7cff33d3*

  5. Click Add and Save.

  6. Follow these steps to override from STORAGE to HOST (Server):

    1. Set Property Name to hostPortWWNPattern.

    2. Set the Value to the STORAGE PORT WWNs you selected in step 1.

  7. Click Add and Save.

  8. Rediscover the appropriate SAN integration.

    1. Go to Settings > Integrations and click the View button for Brocade SAN or Cisco SAN.

    2. Click on a SAN integration instance in the table.

    3. Click Start Discovery.

      Wait for discovery to complete.

    4. Click Save.

  9. Verify the modified host HBA port has been overridden to storage.

    For each WWN that was overridden:

    1. Select Inventory > Storage > Storage Port.

    2. Search for a WWN that overridden and click on the port name.

    3. Verify that the Entity Type property is changed to StoragePort.

  10. Verify the modified storage has been overridden to server:

    For each WWN that was overridden:

    1. Select Inventory > Compute > Hosts > Network > HBA Port.

    2. Search for a WWN that was overridden and click on the port name.

    3. Verify that the Entity Type is changed to HostPort.

Set Service Properties

Warning

Except for the previous topic, use the Set Properties option only in conjunction with Virtana Support.

Procedure to set, modify, or unset a property on a service.

  1. Navigate to Settings > Service Management.

  2. Find the service you wish to modify in the Service Management list view.

  3. Click on the circled triangle icon in the service's far left column and then click on Set Properties.

  4. Fill in the Property Name and Value fields in the popup.

  5. Click Add.

  6. Click Save.

In this section: