Photon OS#
These instructions explain how to install Salt on Photon OS operating systems.
Before you start#
Before installing Salt on your operating system, ensure that you first:
Install Salt on Photon OS 5#
To install Salt on Photon OS 5:
Run the following commands to install the Salt Project repository and key:
Click the tab for the Salt version you would like to pin for updates:
To pin your Salt upgrades to the Latest Onedir package of Salt for Photon OS 5:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
To pin your Salt upgrades to the Major Onedir package of Salt for Photon OS 5:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
To pin your Salt upgrades to the Minor Onedir package of Salt for Photon OS 5:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/minor/3007.1.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Install packages from the Photon OS repository, such as the salt-minion, salt-master, or other Salt components:
Click the tab for the Salt version you would like to pin for updates:
To install the latest release of Salt packages that are available in the Photon OS repository, run these commands:
sudo tdnf install salt-master sudo tdnf install salt-minion sudo tdnf install salt-ssh sudo tdnf install salt-syndic sudo tdnf install salt-cloud sudo tdnf install salt-api
The following is an example of how to install a specific release of Salt based on the list of packages available in the Photon OS repository:
sudo tdnf install salt3-master-3005-1.ph5 sudo tdnf install salt3-minion-3005-1.ph5 sudo tdnf install salt3-ssh-3005-1.ph5 sudo tdnf install salt3-syndic-3005-1.ph5 sudo tdnf install salt3-cloud-3005-1.ph5 sudo tdnf install salt3-api-3005-1.ph5
Note
The file extensions are based on which version of Photon OS you are installing Salt services on. For example, the extension for Photon OS 3 is
.ph3
and the extension for Photon OS 4 is.ph4
.Enable and start the services for salt-minion, salt-master, or other Salt components:
sudo systemctl enable salt-master && sudo systemctl start salt-master sudo systemctl enable salt-minion && sudo systemctl start salt-minion sudo systemctl enable salt-syndic && sudo systemctl start salt-syndic sudo systemctl enable salt-api && sudo systemctl start salt-api
Note
When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.
After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.
After installing Salt on your operating system, you need to complete the following post-installation steps:
Install Salt on Photon OS 4#
To install Salt on Photon OS 4:
Run the following commands to install the Salt Project repository and key:
Click the tab for the Salt version you would like to pin for updates:
To pin your Salt upgrades to the Latest Onedir package of Salt for Photon OS 4:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
To pin your Salt upgrades to the Major Onedir package of Salt for Photon OS 4:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
To pin your Salt upgrades to the Minor Onedir package of Salt for Photon OS 4:
sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/minor/3007.1.repo | sudo tee /etc/yum.repos.d/salt.repo tdnf clean all
GPG key change
The GPG key for the 3007.1 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Install packages from the Photon OS repository, such as the salt-minion, salt-master, or other Salt components:
Click the tab for the Salt version you would like to pin for updates:
To install the latest release of Salt packages that are available in the Photon OS repository, run these commands:
sudo tdnf install salt-master sudo tdnf install salt-minion sudo tdnf install salt-ssh sudo tdnf install salt-syndic sudo tdnf install salt-cloud sudo tdnf install salt-api
The following is an example of how to install a specific release of Salt based on the list of packages available in the Photon OS repository:
sudo tdnf install salt3-master-3005-1.ph4 sudo tdnf install salt3-minion-3005-1.ph4 sudo tdnf install salt3-ssh-3005-1.ph4 sudo tdnf install salt3-syndic-3005-1.ph4 sudo tdnf install salt3-cloud-3005-1.ph4 sudo tdnf install salt3-api-3005-1.ph4
Note
The file extensions are based on which version of Photon OS you are installing Salt services on. For example, the extension for Photon OS 3 is
.ph3
and the extension for Photon OS 4 is.ph4
.Enable and start the services for salt-minion, salt-master, or other Salt components:
sudo systemctl enable salt-master && sudo systemctl start salt-master sudo systemctl enable salt-minion && sudo systemctl start salt-minion sudo systemctl enable salt-syndic && sudo systemctl start salt-syndic sudo systemctl enable salt-api && sudo systemctl start salt-api
Note
When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.
After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.
After installing Salt on your operating system, you need to complete the following post-installation steps: