Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To use the Swarm Storage UI with Swarm Metrics, you need all of the enabling components, including a simplified Gateway (Service Proxy) to provide the needed access and an Elasticsearch (ES) service and curator. Your Platform Server download includes all of the packages and scripts needed to perform the installation and configuration of these components.

Info
title

Caution

  • Do not use the Platform Server embedded ES server as the target of a Swarm Search feed.

  • Do not change the preconfigured defaults for Metrics, which are set in /opt/platform/curator/metrics.cfg

    • metrics.target

       and 

       and metrics.port

       are

       are preconfigured for the Service Proxy.

    • Metrics

      are checked

      are checked every 15 minutes and

      are retained

      are retained for 120 days.

  • If you have any scaling concerns, consult Support about whether you need a dedicated Elasticsearch cluster.

  1. Install the Platform Server. See Platform Installation.

  2. Add a Swarm license and start up the Storage nodes.

  3. Run the integration script as root to configure the Service Gateway, adding arguments as appropriate:

    Code Block
    languagebash
    sudo configure_storage_webui_with_serviceproxy.sh
    Optional arguments
    Purpose

    -h

    Display help summary and then exit.

    -e INDEXER·HOST [INDEXER·HOST]

    Specify one or more remote Elasticsearch hostnames or IPs, disabling (and preventing creation of) a local ES instance.

    Important: If you have an existing ES cluster, specify it here to avoid creating an extra local instance.

  4. On completion, the script

...

  1. attempts to start all of the services with their new configurations.

  2. Log in to the Swarm UI.

...

  1. Browse to the Platform server and it

...

  1. redirects to the UI:

    Code Block
    languagebash
    http://PLATFORM·IP
    http://PLATFORM·IP/_admin/storage
    Info
    titleImportant

    If you later modify the password for the admin user or modify the membership of the storage cluster by adding or removing nodes/chassis, restart the Service Proxy so that it will register the changes:

    platform restart proxy

  2. To verify that Metrics data is being collected, first allow at least 30 minutes to pass, which is the minimum it would take for new Storage data to be added and a Metrics collection cycle to have occurred. 

File Locations


Configuration

Logs

Elasticsearch

/opt/platform/metrics/config * 

/var/log/elasticsearch

Curator

/opt/platform/curator

/var/log/caringo

* Important: If you make any changes to the Elasticsearch configuration files, restart the Elasticsearch service:

Code Block
languagebash
sudo systemctl restart es
Child pages (Children Display)