CliQr is now part of Cisco Learn More About Cisco

Download Log Files

Overview

Effective CloudCenter 4.7.0, the CloudCenter platform administrators can configure the ability to download consolidated log files for the CloudCenter platform for subsequent troubleshooting purposes.

  • Identifies issues that span multiple the CCM and CCO servers without having to login to those systems. The default time range includes the last 3 days. To configure the time range, configure the ccm.log.lastNDays=3 property in the CCM server.properties file.

Requirements

To download CloudCenter log files, adhere to these requirements:

  • Install the Health Monitor component.
  • Follow the port dependencies identified in Phase 2: Configure Network Rules > Monitor Network Rules.
  • Configure the ELK stack's port and IP credentials by using the CCM Properties wizard and the CCO Properties wizard.
  • Users with the following permissions can download log files:

    ServerAPI Permissions
    CCMOnly root admin
    CCOAny tenant admin with the following permissions:
    • Has access to the cloud region
    • Has a user cloud account configured on the CCO

Download CCM Logs

Once you meet the tasks listed in the Requirements section above, follow this procedure to download the CCM logs:

  1. Access the CCM UI > Admin tab using administrator credentials. The Admin Dashboard displays.
  2. In the Tenant Information section, under Logs, you have two options:
    1. Download CloudCenter CCM Logs: When you click this link, the CCM log file is downloaded and saved using the following syntax: CCM_UTCtimestamp.txt
      For example: CCM_2016-11-29_08_20_12.738_UTC.txt 

      Icon

      If your deployment uses the HA mode, each log statement is prepended with the unique host ID that is issued when you create an instance.


    2. View logs on Kibana: When you click this link, you see the Kibana popup prompting you for credentials.

      1. Enter the following default credentials:
        • Username = logreader
        • Password = re@d0nly (zero between d and n)
        Icon

        Be sure to change the email address and password for the admin account after your first login. See the Change Default ELK Credentials section below for additional context.

      2. Once you enter the credentials, you see the Kibana page – first time users see the Configure an index pattern page, click Create:
      3. In the next screen, enter the job name or job ID in the search bar.

        For example: If the job name at the time of submission is ELKTest and the child job name is AppServer that uses the ID 9 and 10 respectively, then the search pattern can be:
        DeploymentJobName="ELKTest" OR DeploymentJobName="AppServer" OR DeploymentJobId="9" OR DeploymentJobId="10"

Download CCO Logs

Once you meet the tasks listed in the Requirements section above, follow this procedure to download the CCO logs:

  1. Access the CCM UI > Admin > Clouds > Configure Clouds > Region tab using administrator credentials – just as you would to Register the CCO with the CCM. The corresponding cloud region page displays.

  2. Click the Download Logs link as displayed in the following image:

    Icon

    If you do not configure the ELK stack to enable log file download, the link changes to a grey Download Logs text with a mouseover display of Configure ELK stack to enable download of logs as displayed in the following image:

    Once you configure the ELK stack, the grey text changes to a clickable Download Logs link.

    When you click the Download logs link, the CCO log file is downloaded and saved using the following syntax: CCO_cloud_region_name_timestamp.txt
    For example:
    amazon_cloud_US West (Northern California)_2016-12-16 09_48_37_UTC.txt

Changing Default ELK Credentials and Configuring Log Files

Be sure to change the email address and password for the account after your first login. You can change the ELK password when configuring the log file download using one of two wizards – the CCM Wizard or the Monitor Wizard.

  •  Change Credentials in the CCM Wizard

    CCM Wizard Properties

    To configure the CCM wizard properties, follow this procedure.

      1. SSH into the CCM instance as a centos user.
      2. Run the following command:

    1. Invoke the CCM wizard.

      CCM Wizard Path
    2. Configure the basic properties. The wizard includes several menu groups with different properties.

      Write this down for future reference!

      Icon
      Write down the Field details in a printed version of the Your Notes section for later use.

      CCM Properties

      Field

      Description

      Mail

      • SMTP Host
      • SMTP Port
      • SMTP Auth

      SMTP server details to send mail notifications.

      Mail_User

      • Mail User
      • Password
      • From User
      • Display Name

      Mail authentication and configuration details to send mail notifications. If you retain the default settings, the mail functionality will not be configured.

      Server_info (Required)
      • Public DNS
      • DNS or IP of the CCM.
      • Used by the CCO VM to communicate with the CCM VM.
      • Monitor URL
      • Monitor VM's complete URL. For example, https://<MON or MON_LB IP address>:8443.
      • Must use HTTPS protocol.
      • Used by the CCM VM to retrieve the health status from the Monitor VM.
      • Hazelcast IP
      • Private IP address of the CCM VM.
      • Used internally by the CloudCenter platform.
      • External URL
      • Optional for non-HA CCM scenarios.

      Config_App_Logo

      No fields listed

      Used by the application profile templates.

      ESB_InfoNo fields listed

      Required only if you installed Enterprise Service Bus (ESB), an optional component that is not installed in CloudCenter appliances by default.

      Network

      • Hostname
      • Interface

      Use the defaults if you are not making any changes to these settings.

      DB
      (Effective CloudCenter 4.7.0)
      • IP or Hostname
      • Username
      • Password
      • DNS or IP of the Database
        • Local host: Default, does not include the flyway migrate configuration
        • Remote host, includes the flyway migrate configuration – see the last bullet in this row.
      • Authentication credentials (username and Password) for the database (either local or remote).
      • Optional – Flyway Migrate. Remote Host Configure the CCM to a remote database by providing the IP address of the remote database. When you provide the IP address, you see an additional screen to configure the flyway migrate process.
        • Yes: Flyway migration takes place.
        • No: Only the configuration files are updated.
        Icon

        DB configuration is required for standalone database deployments.

      ELK_Info
      (Effective CloudCenter 4.7.0)
      • ELK Host
      • Elasticearch Port
      • Logstash Port
      • Kibana Port
      • ELK Password
      • ELK Username
      • Host Identifier
      • Host Identifier List
      • Specify the IP address for the ELK/Monitor host.
      • The Elasticearch Port displays 8881 by default.
      • The Logstash Port displays 4560 by default.
      • The Kibana Port displays 8882 by default.
      • The default ELK Password is re@d0nly (zero between d and n) (change this password after the initial login – see Download Log File for additional context).
      • The default ELK Username = logreader.
      • The Host Identifier is a Unique ID for the server – be sure to prefix the unique identifier with CCM_ for example, CCM_1
      • The Host Identifier List field only applies to environments using the HA mode – provide a list of comma separated unique host identifiers for all ELK/Monitor hosts in a HA setup = for example, CCM_1,CCM_2,myCCM.

        Icon

        In an environment operating in HA mode, if you have two CCM instances with unique IDs configured as CCM_1,CCM_2 in their respective server.properties file, then this property should state CCM_1,CCM_2 in both CCM instances. Each CCM must be aware of the unique ID of the other CCM(s) when in HA mode.

    3. Exit the CCM configuration wizard.

    4. Select Yes, to restart the Tomcat service for the changes to be effective.

    You have successfully installed the CCM component! You can now proceed to the next step – Per CloudCenter Region Installation.

     

  •  Change Credentials in the Monitor Wizard

    Monitor – Configure Monitor Properties

      1. SSH into the MONITOR instance as a centos user.
      2. Run the following command:

    1. Invoke the wizard.

      Monitor Wizard Path
    2. Configure the basic properties for each MONITOR server. The wizard includes several menu groups with different properties.

      Write this down for future reference!

      Icon

       Write down the Field details in a printed version of the Your Notes section for later use.

      GroupPropertiesNotes
      CCM_Info
      • Monitor ID
      • CCM Hostname/URL
      • Monitor User
      • Monitor ID – A unique (alphanumeric) identifier used as the name for the health check instances and volumes created on the cloud provider
      • CCM Hostname/URL – REQUIRED!
        • CCM_IP or 
        • CCM_SA_IP or
        • CCM_LB_IP
      • Monitor User – The User ID configured on the CCM server (to enable health check for cloud  regions).
        • To perform a health check on all activated cloud regions, set this value as 2 (2 is the CloudCenter’s root administrator’s User ID).
        • To perform a health check on specific cloud regions, create and activate a new user with those specific regions and use that user’s User ID as value for this property. To get the User ID, use the v1 User Management APIs.
      ELK_Login
      • Elasticsearch
      • Logstash
      • Kibana
      For the ELK/Monitor host.
      • ELK username = logreader (default)
      • ELK password = re@d0nly (zero between d and n) (see Download Log File > Change Default ELK Password for additional context)
    3. Exit the Monitor wizard.

    You have successfully configured the Monitor! You can now proceed to the next step.

Searching within the Log File

You can search within each downloaded log file based on the DeploymentJobName or DeploymentJobID to retrieve information about a particular deployment. For example, you can search for:

  • DeploymentJobName=Testing
  • DeploymentJobID=12

 

 

 

 

  • No labels