Installing the Storage UI

You need all the enabling components to use the Swarm Storage UI with Swarm Metrics, such as a simplified Gateway (Service Proxy) to provide the needed access and an Elasticsearch service and curator. Your CSN download includes all of the RPMs and scripts needed to install and configure these components.

Caution

Do not use the CSN-embedded ES server as a Swarm Search Feed target.
Do not change the preconfigured defaults for Metrics, which are set in /etc/caringo-elasticsearch-metrics/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.

Install the CSN bundle as usual (the new RPMs will install for you).
Add a Swarm license and start up the Storage nodes.

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

/usr/bin/configure_storage_webui_with_serviceproxy.py

Optional arguments	Default	Purpose
-h, --help		Display help summary and then exit.
-v, --verbose	INFO	Add to generate more extensive logging output.
-d DIR, --directory DIR	/var/log/caringo	Specify a different working directory for logs and output.
-s, --start_services	yes	Disable automatic enabling and start up of services after configuration.
-n NUM_HOSTS, --num_hosts NUM_HOSTS	5	Specify a different number of hosts to add to the Gateway configuration.
--indexer_host INDEXER_HOST [INDEXER_HOST ...]		Specify remote Elasticsearch hostnames or IPs, disabling (and preventing creation of) a local ES instance. Important: If you have an existing ES cluster, be sure to specify it here to avoid creating an extra local instance.

Each time the script prompts you for a configuration setting, press Enter to accept the suggested value, or enter your own.
On completion, the script will attempt to start all of the services with their new configurations, logging the output to the integration.log file (which defaults to /var/log/caringo).
When the script provides you with your URL and credentials, log into the Storage UI with a JavaScript-enabled browser (development and testing were conducted using the most recent versions of Firefox and Chrome).

Note

Metrics data will not appear until new storage data is added and metrics collection cycles have occurred, which is a minimum of 30 minutes.

The script creates a "caringoadmin" user (password "caringo"), which is a user that is local to the CSN. These user credentials are required to login to the Storage UI through the Service Gateway.

Note

This caringoadmin user is only used by the Service Gateway and not by the Swarm cluster.

To change the caringoadmin password on the local CSN, run the password command and follow the prompts:
```
passwd caringoadmin
```
The user caringoadmin user is defined as the administrator for the Service Gateway in this file on the CSN: /etc/caringo/cloudgateway/policy.json. The user can be changed according to your requirements, just as in the Content Gateway.
See Gateway Access Control Policies.

With CSN 8.3, all of these interfaces remain available and may be used concurrently:

Legacy CSN Console http://{CSN·host}:8090
Legacy Admin Console http://{CSN·host}:8090/services/storage
Swarm Storage UI http://{CSN·host}/_admin/storage

Legacy CSN Console	`http://{CSN·host}:8090`
Legacy Admin Console	`http://{CSN·host}:8090/services/storage`
Swarm Storage UI	`http://{CSN·host}/_admin/storage`