Transfer and import files

Overview

The final pre-installation step is to download the installation files and send them to the Salt Master node. This page explains how to:

  • Download installation files
  • Transfer the files
  • Verify that the installation files are valid
  • Extract the files (optional)
  • Import the .asc keyfiles

Prerequisites

This step is part of the pre-installation process. Before reading this page, ensure that you have first read the following pages:

Download files for your installation scenario

Download the files for your installation scenario from the Downloads page. If you’re not sure which installation scenario you need, see Which installation scenario should you use?.

On the Downloads page, the files needed for the Single-node installation and Multi-node installation are listed in the SaltStack Enterprise: Automated installation section. Both installation scenarios require the same files.

The Automated Installation table contains both a .zip file and a tarball file. You only need one of the files, not both. The tarball is recommended if your nodes do not have an application to unzip the files.

After you’ve downloaded the files, proceed to the next section to transfer the files.

Transfer the files

You will need to transfer the files to the Salt Master node. Place the files in the root folder.

Note

For a single-node installation, transfer the files to the node on which you are installing a Salt Master, SaltStack Enterprise, Redis, and PostgreSQL.

For a multi-node installation, transfer the files to the Salt Master from which you are running the installation orchestration.

Verify the installation files

As a best practice, validate that the downloaded file was not altered after being created by SaltStack. You can validate the file by comparing the SHA-256 hash for your copy against the SHA-256 listed for that file in the downloads table.

To verify the installation files on RedHat or CentOS:

  1. On the machine containing the files, open a terminal and navigate to the directory that contains the files.

  2. If needed, use ls to list the exact file names.

  3. Enter the following command, replacing the exact name of the file you want to verify:

    sha256sum file-name.zip
    
  4. The previous command returns the SHA-256 for the file. Compare the output of this command to the SHA-256 listed for that file in the Downloads table.

After verifying that the file is legitimate, proceed to the next section.

Extract the files

Extracting the installation files is an optional step. It is only required if you downloaded the .zip version of the SaltStack Enterprise installer rather than the tarball.

Note

If the machine doesn’t have this application or if it is air-gapped, download the tarball instead.

To extract the files on RedHat or CentOS:

  1. In the terminal, install an application to extract the .zip file. For example:

    Note

    sudo yum install unzip

  2. Once the unzip tool is installed, enter the following command, replacing the exact file name of the installation file:

    unzip SaltStack_Enterprise-<version>_Installer.zip
    

After you have extracted the files, proceed to the next section.

Import the .asc keyfiles

You need to import the .asc keyfiles from the SaltStack Enterprise installer into the RPM packaging system. To import the keyfiles on the nodes where you intend to install SaltStack Enterprise components:

  1. Navigate to the sse-installer directory.

  2. To import the .asc keyfiles you extracted from the installer .zip file into the RPM packaging system, run the following command:

    sudo rpmkeys --import keys/*.asc
    
  3. Repeat these steps for all nodes.

Next steps

Once you have downloaded, transferred, verified, and imported the installation files, you can begin the installation process. Proceed to either the Single-node installation or the Multi-node installation scenario.