Installing the cluster¶
After you have determined the initial topology for your Anaconda Enterprise cluster, and verified that your system meets all of the installation requirements, you’re ready to install the cluster.
Note
If you haven’t already, please complete our pre-install checklist to ensure that you have accounted for all implementation prerequisites before you begin.
Additional installation notes:
These instructions should be executed by a non-root user, configured with
sudo
access. You may wish to create a separate account for this purpose, as the instructions below configure Gravity to execute its system processes under this UID.The installer uses the directory that is specified by the environment variable
TMPDIR
on the master node to store working files. Be sure this directory contains sufficient space, or create an alternate directory (with sufficient space) for the installer to use. If you choose to use an alternate directory, ensure it has the correct permissions enabled (drwxrwxrwx
), and either add it to/etc/environment
or explicitly specify the directory during installation.
Basic installation¶
To complete the basic installation, you will need a single open terminal on the master node, logged into the service account.
Download and decompress the installer, replacing
<INSTALLER_LOCATION>
with the location of the installer, and<VERSION>
with your installer version:If you are in an airgapped environment, deliver the installer to the master node in an alternate manner, and proceed with the
tar
/cd
steps in the same fashion.Run the Gravity pre-installation system check for the master node:
If the system checks pass and all requirements are met, the output from the above commands will be empty. If the system checks fail and some requirements are not met, the output will indicate which system checks failed.
Note
These checks are not fully comprehensive, and are not intended to serve as a substitute for completing our pre-install checklist and otherwise verifying that your nodes meet the installation requirements.
Create a file named
values.yaml
with the following content, replacing<HOSTNAME>
with the fully-qualified domain name (FQDN) of the host server:If you wish to enable Managed Persistence with your initial installation, please review the managed persistence section of the AE5 system requirements. Then add a new section to your
values
field, calledpersistence:
, indented identically to thehostname
field. Replace<SERVER_FQDN>
and<SERVER_PATH>
with the server address and path, respectively, of the shared NFS volume; and<GID>
with the group ID to use to enable read-write access to that volume:For single-node clusters only, you may re-use the
/opt/anaconda/storage
volume for managed persistence. In this case, thepersistence:
section can be significantly simplified:Note
The direct use of
/opt/anaconda/storage
for managed persistence works only for single-node installations. It must be replaced with an NFS configuration before adding additional nodes to the cluster. Otherwise, sessions and deployments launched on the additional nodes will fail to start.Run the gravity installation command. The typical command will look like this:
Before running this command, replace the bracketed values as follows:
<ADVERTISE-ADDR>
: the IP address with the address you want to be visible to the other nodes. If your cluster has both a private and public network, and all nodes can speak to each other over that private network, use the private network address.<CLUSTERNAME>
: a name of your choosing; e.g.,AnacondaEnterprise
. The name must consist of alphanumeric characters or periods; e.g.,test.cluster1
.<VALUES_PATH>
: the path to thevalues.yaml
file you created above.
Here is an example for a single-node cluster:
If you are using an alternate
TMPDIR
, prepend the command with this new value; for example:Monitor the progress from the command line. You should see something like this:
Wait for the process to complete, approximately 20-30 minutes.
Create a local user account and password to log into the Gravity Operations Center. To do so, enter the Gravity environment from any of the nodes:
Then run the following command to create a local user account and password. Replace
<EMAIL>
and<PASSWORD>
with the email address and password that you wish to use. Your password must be six characters long:Finally, run the following command, also within the Gravity environment, to tell Gravity that you have completed the installation:
Proceed to the post-install configuration steps.
Note
The AE5 application itself will likely require another 30 minutes or so to fully load. The post-install configuration steps describe how to confirm that this process is fully complete.
Wizard installation (deprecated)¶
Prior versions of this documentation recommended the use of Gravity’s web-based wizard. We now strongly recommend the command-line approach offered above, as it is simpler, more reliable, and more flexible. If you prefer the web-based approach, we have moved those instructions to a separate page.