{"type":"doc","content":[{"type":"paragraph","content":[{"text":"To use the Swarm Storage UI with Swarm Metrics, you need all enabling components, including a simplified Gateway (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"Service Proxy","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"link","attrs":{"href":"/wiki/spaces/public/pages/2443816750"}}]},{"text":") 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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caution","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not use the Platform Server embedded ES server as the target of a Swarm Search feed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not change the preconfigured defaults for Metrics, which are set in ","type":"text"},{"text":"/opt/platform/curator/metrics.cfg","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"metrics.target","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"metrics.port","type":"text","marks":[{"type":"code"}]},{"text":" are preconfigured for the Service Proxy.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Metrics are checked every 15 minutes and are retained for 120 days.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you have any scaling concerns, consult Support about whether you need a dedicated Elasticsearch cluster.","type":"text"}]}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the Platform Server. See ","type":"text"},{"text":"Platform Installation","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/public/pages/2443827854"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a Swarm license and start up the Storage nodes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the integration script as root to configure the Service Gateway, adding arguments as appropriate:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"sudo configure_storage_webui_with_serviceproxy.sh","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

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.

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.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[282.59]},"content":[{"type":"paragraph","content":[{"text":"Optional arguments","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[724.62]},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[282.59]},"content":[{"type":"paragraph","content":[{"text":"-h","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[724.62]},"content":[{"type":"paragraph","content":[{"text":"Display help summary and then exit.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[282.59]},"content":[{"type":"paragraph","content":[{"text":"-e INDEXER·HOST [INDEXER·HOST]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[724.62]},"content":[{"type":"paragraph","content":[{"text":"Specify one or more remote Elasticsearch hostnames or IPs, disabling (and preventing creation of) a local ES instance.","type":"text"}]},{"type":"paragraph","content":[{"text":"Important","type":"text","marks":[{"type":"strong"}]},{"text":": If you have an existing ES cluster, specify it here to avoid creating an extra local instance.","type":"text"}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On completion, the script attempts to start all services with the new configurations.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"0ef370f5-754e-4566-8713-9ce68cc18797"}}]},{"text":" to the Swarm UI. Browse to the Platform server and it redirects to the UI:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"http://PLATFORM·IP\nhttp://PLATFORM·IP/_admin/storage","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Important

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

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"paragraph","content":[{"text":"platform restart proxy","type":"text","marks":[{"type":"code"}]}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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. ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"File Locations","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0c936ce8-f70d-427c-8ab5-1adfb45a61c4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[148.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[359.0]},"content":[{"type":"paragraph","content":[{"text":"Configuration","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Logs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[148.0]},"content":[{"type":"paragraph","content":[{"text":"Elasticsearch","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[359.0]},"content":[{"type":"paragraph","content":[{"text":"/opt/platform/metrics/config *","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/var/log/elasticsearch","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[148.0]},"content":[{"type":"paragraph","content":[{"text":"Curator","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[359.0]},"content":[{"type":"paragraph","content":[{"text":"/opt/platform/curator","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/var/log/caringo","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"* Important","type":"text","marks":[{"type":"strong"}]},{"text":": Restart the Elasticsearch service if any changes are made to the Elasticsearch configuration files:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"sudo systemctl restart es","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"9611eae1-b640-45f1-ab77-9e8a2d7c141f"},"schemaVersion":{"value":"2"},"title":"Children Display"}},"localId":"89dfe286-bad0-4e04-aab4-788305675d2a"}}],"version":1}

Browser not supported