You can install the SaltStack Config service in your vRealize Automation environment using one of two installation methods. Once installed, you can configure a SaltStack Config integration and complete the necessary post-installation tasks.

Important: SaltStack Config runs on Salt, an open-source automation and configuration management engine. In order to begin using SaltStack Config for configuration management, you also need to install and run the Salt minion service on any nodes that you intend to manage using SaltStack Config. You can deploy the Salt minion service to your nodes using either vRealize Automation cloud templates or by installing the service through Secure Shell (SSH).

This installation guide explains the standard process for installing SaltStack Config from the beginning to the end. It is intended for network system administrators with the general knowledge and experience required in that field, such as experience working with Linux and the command line. You do not necessarily need advanced knowledge of Salt or SaltStack Config before installing.

If at any time you encounter difficulties with the installation that are not addressed by this guide, Contact Support.

Installation overview

The installation process has five main phases:

  • Preinstallation
  • Installation
  • Post-installation
  • Integrate with vRealize Automation
  • Install Salt on the nodes you want to manage with SaltStack Config

This guide provides content to support each phase, as described in the following sections.

Preinstallation

Before you begin the pre-installation phase, ensure you are roughly familiar with the SaltStack Config system architecture and with the Salt system architecture.

During the preinstallation phase, you make key decisions as you plan your SaltStack Config installation project. In this phase, you will:

  • Decide which installation scenario is best for your network.
  • Determine the hardware and software you need for your SaltStack Config installation, such as how many nodes you need to allocate, which operating systems these nodes or virtual machines (VMs) need, etc.
  • Plan any necessary workarounds if your network does not have access to the Internet.
  • Install Salt on the nodes or VMs that will host the necessary SaltStack Config architecture.
  • Download, verify, and import the required installation files.

By the end of this phase, ensure that you have requested the necessary nodes and virtual machines (VMs) needed for your installation scenario.

Installation

SaltStack Config supports two installation methods:

  • Standard installation - Installs the architectural components needed for SaltStack Config in four or more separate nodes.
  • vRealize Suite Lifecycle Manager (vRLCM) installation - Installs SaltStack Config and all of its architectural components on a single node. This method also installs the Salt master host and configures a required vRealize Automation property group.
Caution: If you are unsure which installation method is best for your system, the standard installation is recommended. The vRealize Suite Lifecycle Manager installation method is not recommended for production grade systems with more than 1,000 nodes.

Post-installation

After the core installation scenarios are complete, there are a number of post-installation steps, some of which are optional:

Integrate with vRealize Automation

In this phase, you create an integration in vRealize Automation to access the SaltStack Config service in your network.

Install Salt on the nodes you want to manage with SaltStack Config

SaltStack Config runs on Salt, an open-source automation and configuration management engine.

In order to begin using SaltStack Config for configuration management, you also need to install and run the Salt minion service on any nodes that you intend to manage using SaltStack Config.

You can deploy the Salt minion service to your nodes using either vRealize Automation cloud templates or by installing the service through Secure Shell (SSH).