{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"9c635a9a-d887-4538-901f-964d6caf7ddd"},"schemaVersion":{"value":"1"},"title":"org.randombits.confluence.toc.toc.label"}},"localId":"4354c2a7-d52b-41d9-b6f5-315e68e88e21"}},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important","type":"text"}]},{"type":"paragraph","content":[{"text":"If the SCS environment is ever expected to be offline or air-gapped in the future, follow the ","type":"text"},{"text":"instructions for offline installation","type":"text","marks":[{"type":"link","attrs":{"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2957705412"}}]},{"text":" instead. Several dependencies must be put into place to support future upgrades.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Refer to the following steps to install SCS RPM with Internet access:","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Installation on Red Hat/Rocky Linux 8","type":"text"}]},{"type":"paragraph","content":[{"text":"For SCS installation on Red Hat/Rocky Linux 8, please skip to ","type":"text"},{"text":"Installing SCS Software","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Preparing Red Hat/CentOS 7 System","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"For SCS 1.7.1 and onward, Red Hat/CentOS 7 support is deprecated and will be removed in the next release. SCS 1.7.1 should ","type":"text"},{"text":"only","type":"text","marks":[{"type":"strong"}]},{"text":" be installed on these systems as an ","type":"text"},{"text":"upgrade to an existing SCS","type":"text","marks":[{"type":"link","attrs":{"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/3459351012"}}]},{"text":" installation, and solely for the purpose of ","type":"text"},{"text":"generating a full backup","type":"text","marks":[{"type":"link","attrs":{"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/1223491667/SCS+Administration#Backing-Up-SCS"}}]},{"text":" for migrating to a newer supported operating system.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"These instructions assume the Swarm zip file- downloaded from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://datacore.custhelp.com/app/downloads/downloads"}}]},{"text":"- that looks like ","type":"text"},{"text":"Swarm-v-.zip","type":"text","marks":[{"type":"code"}]},{"text":" is unzipped to a new directory called ","type":"text"},{"text":"/root/datacore","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When installing on RHEL, the best practice is to run the following command first of all:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo subscription-manager refresh","type":"text"}]},{"type":"paragraph","content":[{"text":"Install the EPEL release.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the latest EPEL package.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl -fLO https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the downloaded RPM. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"yum install -y epel-release-latest-7.noarch.rpm","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If running Red Hat, enable the server extras repository.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"subscription-manager repos --enable=rhel-7-server-extras-rpms","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy","type":"text"},{"text":" '","type":"text","marks":[{"type":"em"}]},{"text":"/root/datacore/Swarm-/SCS/podman-packages-scs-.tar","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"’","type":"text","marks":[{"type":"em"}]},{"text":" and place it into the folder","type":"text"},{"text":" ‘/root/datacore’","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"cp /root/datacore/Swarm-/SCS/podman-packages-scs-.tar /root/datacore/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract the file ‘podman-packages-scs-.tar’.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd /root/datacore/\ntar xvf podman-packages-scs-.tar","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"This creates the ‘podman_packages’ directory under the ‘/root/datacore/’ directory. This location is used in the next step to set up the podman repo.","type":"text"}]}]},{"type":"orderedList","attrs":{"order":5},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a new local repo.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"printf \"[podman]\nname=Dependencies for install podman 3.0.1\nbaseurl=file:///root/datacore/podman_packages\nenabled=true\ngpgcheck=0\" > /etc/yum.repos.d/podman.repo","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable the new Podman repo.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CentOS (no additional steps are required)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Red Hat","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"yum install -y yum-utils\nyum-config-manager enable podman.repo\nyum repolist enabled","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify Podman is listed as an enabled repo.","type":"text"}]},{"type":"codeBlock","content":[{"text":"# yum repolist enabled\nrepo id repo name status\nbase/7/x86_64 CentOS-7 - Base 10,072\nepel/x86_64 Extra Packages for Enterprise Linux 7 - x86_64 13,768\nextras/7/x86_64 CentOS-7 - Extras 518\npodman Dependencies for install podman 3.0.1 12\nupdates/7/x86_64 CentOS-7 - Updates 5,283\nrepolist: 29,653","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change back to the /root/datacore/Swarm-/SCS/ directory","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd /root/datacore/Swarm-/SCS/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import the GPG key if needed.","type":"text"}]},{"type":"codeBlock","content":[{"text":"rpm --import RPM-GPG-KEY","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing SCS Software","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the SCS RPM.","type":"text"},{"type":"hardBreak"},{"text":"Red Hat/CentOS 7:","type":"text"}]},{"type":"codeBlock","content":[{"text":"yum -y install swarm-scs-.el7.x86_64.rpm","type":"text"}]},{"type":"paragraph","content":[{"text":"Red Hat/Rocky Linux 8:","type":"text"}]},{"type":"codeBlock","content":[{"text":"yum -y install swarm-scs-.el8.x86_64.rpm","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify SCS is installed properly. The message about being unable to connect to the Swarm Cluster Services API is expected at this step and is not cause for concern.","type":"text"}]},{"type":"codeBlock","content":[{"text":"scsctl help","type":"text"}]},{"type":"paragraph","content":[{"text":"Example output:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"none"},"content":[{"text":"usage: scsctl [-v | --info-log | --debug-log | --trace-log] options: ...\n\nProvides basic control and visibility into Swarm Cluster Services (SCS).\n\noutput options:\n These options affect the way output is displayed.\n\n -v, --verbose Increase output verbosity (ex: -v, -vv, -vvv). Verbose output\n is always sent to stdout. (default: None)\n --info-log Set info-level verbosity (equivalent to -v). (default: None)\n --debug-log Set debug-level verbosity (equivalent to -vv). (default:\n None)\n --trace-log Set trace-level verbosity (equivalent to -vvv). (default:\n None)\n\nsubcommands:\n Which action you wish to perform. To get detailed help, add 'help' to the\n end. For example: 'scsctl auth help'\n\n options:\n auth Manages persisted credentials for contacting the Swarm\n Cluster Services API.\n backup Manages backing up and restoring Swarm Cluster Services.\n diagnostics Performs diagnostics on the SCS server setup.\n init Utilities for setting up a Swarm environment.\n license Manages the license for this Swarm ecosystem installation.\n repo Manages the Swarm Cluster Services repository. The repository\n contains installed component versions and other third-party\n software.\n system Performs administrative operations on the system.\n help Outputs this help and exits.\n\nERROR: Cannot connect to the Swarm Cluster Services API service at\n172.30.4.103:8095. Please ensure the service is up and running.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Next, ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://perifery.atlassian.net/wiki/spaces/public/pages/3316056129"}},{"text":".","type":"text"}]}]}],"version":1}

Browser not supported