To use the Swarm Storage UI with Swarm Metrics, you need all 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 packages and scripts needed to perform the installation and configuration of these components.

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 metrics.port are preconfigured for the Service Proxy.

    • Metrics are checked every 15 minutes and 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:

    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 attempts to start all services with the new configurations.

  5. Log in to the Swarm UI. Browse to the Platform server and it redirects to the UI:

    http://PLATFORM·IP
http://PLATFORM·IP/_admin/storage

    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

  6. Allow at least 30 minutes to pass to verify Metrics data is being collected. This is the minimum amount of time for new Storage data to be added and a Metrics collection cycle to occur. 

File Locations


Configuration

Logs

Elasticsearch

/opt/platform/metrics/config * 

/var/log/elasticsearch

Curator

/opt/platform/curator

/var/log/caringo

* Important: Restart the Elasticsearch service if any changes are made to the Elasticsearch configuration files:

sudo systemctl restart es