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
andmetrics.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