Transfer and import files¶
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
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¶
On the Downloads page, the files needed for the Single-node installation and Multi-node installation are listed in the SaltStack Config: 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 master node. Place the files in the root folder.
For a single-node installation, transfer the files to the node on which you are installing a master, SaltStack Config, Redis, and PostgreSQL.
For a multi-node installation, transfer the files to the 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:
On the machine containing the files, open a terminal and navigate to the directory that contains the files.
If needed, use
lsto list the exact file names.
Enter the following command, replacing the exact name of the file you want to verify:
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 Config installer rather than the tarball.
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:
In the terminal, install an application to extract the .zip file. For example:
sudo yum install unzip
Once the unzip tool is installed, enter the following command, replacing the exact file name of the installation file:
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 Config installer into the RPM packaging system. To import the keyfiles on the nodes where you intend to install SaltStack Config components:
Navigate to the
To import the
.asckeyfiles you extracted from the installer .zip file into the RPM packaging system, run the following command:
sudo rpmkeys --import keys/*.asc
Repeat these steps for all nodes.
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.