Diagnosing client errors

Edit online

You can access client log files from the Operations Center and get recommendations about how to solve client errors.

Before you begin

Ensure that the IBM® Storage Protect client management service is installed and started on the client system.

Procedure

To diagnose client errors, complete the following steps:

  1. On the Clients page of the Operations Center, select the client.
  2. Click Details.
  3. On the client Summary page, click the Diagnosis tab.
  4. If an error message indicates that the client does not have a remote access URL or a remote diagnostics URL specified, complete the following steps:
    1. Click the Properties tab.
    2. On the Properties page, open the General section.
    3. Specify the URL for accessing the client management service on the client system. The property that you update to specify the URL depends on the version of the backup-archive client.
      • If the client is running version 8.1.13 or later, use the Remote access URL property to access the client management service. In the Remote access URL field, enter the URL of the client management service that is configured on the client system. The URL must start with "https". The address includes the DNS host name or IP address of the client, and the port number that is defined on the client system for the IBM Storage Protect client management service. For example, https://client.mycorp.com:9081. If you omit the port number, the Operations Center uses the default port number, 9081.
      • If the client is running version 8.1.12 or earlier, consider upgrading to the latest version. In version 8.1.13, changes were made that were designed to simplify the installation of the client management service. In version 8.1.12 and earlier, a separate package had to be installed, which deployed an additional application server. In version 8.1.13, the client management service uses a web server that is part of the client's installation package. To use the client management service, you include the Client Web Server feature when you install the IBM Storage Protect client. For more information about installing the client management service, see the documentation.

        If the client is running version 8.1.12 or earlier, but you do not want to upgrade to a later version, use the Remote diagnostics URL property to access the client management service. In the Remote diagnostics URL field, enter the URL of the client management service that is configured on the client system. The URL must start with "https". The address includes the DNS host name or IP address of the client, and the port number that is defined on the client system for the IBM Storage Protect client management service. For example, https://client.mycorp.com:9028. If you omit the port number, the Operations Center uses the default port number, 9028.

    4. Click Save.
    5. Click the Diagnosis tab.
  5. The IBM Storage Protect client management service scans the log files on the client, for log messages from the last 24 hours. If the log files are large, the scan might take a number of minutes. The retrieved log messages are displayed in the Client Logs panel on the Diagnosis page of the Operations Center.
    Tips:
    • To show or hide the Client Logs panel, double-click the Client Logs bar.
    • To resize the Client Logs panel, click and drag the Client Logs bar.
    Note: Only the dsmerror.log ERROR log is available in Backup-Archive Client diagnosis data and the dsmsched.log SCHED log is not available.

    If recommendations are displayed on the Diagnosis page, select a recommendation.

    In the Client Logs panel, client log messages to which the recommendation relates are highlighted.

  6. Consider the recommendations when you are resolving the problems that are indicated by the error messages in the client logs.
    Restriction: Recommendations are provided only for a subset of client messages.
    Note: When trying to access UNIX or Linux Backup-Archive client diagnosis data, and the client version is 8.1.13 or above, the client must use HTTPPORT 1581 (default value). If a value other than 1581 is used, the following error message is displayed. 'ANS5060E Invalid parameter passed'. To fix the error, you must use the default value (HTTPPORT 1581) in the client dsm.sys stanza and restart the dsmcad process.