Installing Veeam Backup for Salesforce on RedHat, Oracle and CentOS Machines
You can install Veeam Backup for Salesforce on a RedHat, Oracle or CentOS machine automatically using the installation script or manually.
Installing Product Using Script
To install Veeam Backup for Salesforce, complete the following steps:
- Set the Linux system locale to UTF-8 running the following command:
sudo localectl set-locale LANG=en_US.UTF-8 |
- Log out of the current session and log back in to apply the new locale settings.
- Download the installation script to the machine where you want to deploy Veeam Backup for Salesforce running the following command:
sudo curl https://repository.veeam.com/yum/el/vbsf-install-script.sh --output ./vbsf-install-script.sh |
- Run the script:
sudo sh ./vbsf-install-script.sh |
The Linux package manager will install the Veeam software repository. When the repository is installed, the manager will start installation of Veeam Backup for Salesforce and dependencies, and run configuration checks.
After all configuration checks complete successfully, you will be prompted to run the server configuration script on the Linux host. For more information, see Configuring Server Settings.
Installing Product Manually
To install Veeam Backup for Salesforce, complete the following steps:
- Update all installed Linux packages and their dependencies running the following command:
sudo yum update -y |
- Set the Linux system locale to UTF-8 running the following command:
sudo localectl set-locale LANG=en_US.UTF-8 |
- Log out of the current session and log back in to apply the new locale settings.
- Download the Veeam software repository installation package (veeam-release) from the Veeam Download page:
sudo curl http://repository.veeam.com/yum/el/veeam-repo-1.0.1-6.x86_64.rpm --output veeam-repo.rpm |
- Install the Veeam software repository:
sudo yum install -y ./veeam-repo.rpm |
- Install the product from the Veeam software repository:
sudo yum install -y vbsf |
The Linux package manager will start installation of Veeam Backup for Salesforce and dependencies, and then run configuration checks.
After all configuration checks complete successfully, you will be prompted to run the server configuration script. For more information, see Configuring Server Settings.
To perform server configuration, run the configuration script:
sudo sh /opt/vbsf/server-configuration.sh |
To complete server configuration, do the following:
- Confirm that you have enough disk space to store backup data.
Note |
To store backups of Salesforce files and metadata, Veeam Backup for Salesforce will create a file repository per each protected Salesforce organization on the management server in the following folder: /opt/vbsf/data. If you want to change the folder, modify the data.storage.location parameter value as described in section Configuring Advanced Settings. |
- Choose whether you want to install PostgreSQL on the management server.
When installing PostgreSQL locally on the management server, Veeam Backup for Salesforce will run the installation script and create two users: the postgres user — the root database user, and the vbsf user — the local user. The vbsf user will be automatically provisioned into the default application configuration.
User credentials will be automatically generated and saved to the /opt/vbsf/vbsf-backend/vbsf_default_credentials.properties file. If you change the created passwords using the PostgreSQL standard methods, the passwords stored in the file will not automatically change and will become invalid.
Note |
You may want to install PostgreSQL locally on the management server to host the configuration database which will help you avoid connectivity issues. It is recommended that you create databases that will be used to protect production and sandbox Salesforce organizations on remote PostgreSQL servers. Creating the databases on the management server may cause disk space issues. |
- Confirm that you want to configure Firewalld to allow incoming HTTPS connections through port 443. This is required to access the Web UI component from a user workstation. For more information, see Ports.
- Choose whether you want to automatically configure nginx settings required for the management server to work properly.
It is recommended that you allow Veeam Backup for Salesforce to configure nginx automatically. To learn how to configure nginx manually, see this Veeam KB article.
After the automatic nginx configuration completes, Veeam Backup for Salesforce displays the web address that will be used to launch the initial configuration wizard. The address contains an IPv4 address of the server and a token used to authorize the user access.
Tip |
If you accidentally close the terminal or the connection session during installation, or if you configure nginx manually, you can find the web address URL in the /opt/vbsf/access_token.txt file on the machine where Veeam Backup for Salesforce is installed. |
- Copy the automatically generated URL and paste it into a web browser to proceed with the initial configuration of Veeam Backup for Salesforce.
Important |
By default, the URL contains an IP address of the management server. If the specified IP address is not available over HTTPS, replace it with the public IP of the management server or the DNS name configured for the machine where the Veeam Backup for Salesforce is installed. |
