Install Synchro Foundation¶

Supported Platforms¶

For hardware and platform details, please refer to Requirements.

Updating from previous versions

If you already installed previous versions of Synchro Foundation and you are updating to newer versions, there are a few steps you must execute before proceed:

Execute the command to stop Foundation: foundation down
Remove previous installation: yum remove synchro-foundation

or update mannualy.

Video¶

Installing Foundation¶

Checking your distribution

To check and make sure what is yout linux distro, run:

cat /etc/os-release

Red Hat Enterprise Linux¶

Red Hat requires subscription and internet access to install/upgrade packages. CentoOS is a community distro Red Hat compatible.

If the host does not have internet access or has expired subscription, you may have to download the package manually at CentOS repo.

Considerations in adopting RHEL 9.

Change user to sudo
```
sudo su -
```

Install required packages

yum install -y yum-utils device-mapper-persistent-data lvm2

Enable RHEL extras or EPEL for RHEL 8 and 9.
For RHEL 7 or later:

yum-config-manager --enable rhel-7-server-extras-rpms

Depending on cloud provider, you may also need to enable another repository. For AWS:

yum-config-manager --enable rhui-REGION-rhel-server-extras

For RHEL 8:

subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms

dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

For RHEL9:

subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms

dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

Update the yum package index.
For RHEL 7 or later:
```
yum makecache fast
```
For REHL 8 or newer:
```
yum update
```
Download Synchro Foundation RPM.
Install Synchro Foundation
```
yum install <FOUNDATION-FILE>.rpm
```

Problem: libcgroup RHEL 9

[...]
Problem: conflicting requests
- nothing provides libcgroup needed by synchro-foundation-23.08.11-7dd20394.x86_64

Check update

CentOS¶

Change user to sudo
```
sudo su -
```

Install required packages

yum install -y yum-utils device-mapper-persistent-data lvm2

Update the yum package index.
```
yum makecache fast
```
Download Synchro Foundation RPM.
Install Synchro Foundation
```
yum install <FOUNDATION-FILE>.rpm
```

Ubuntu¶

Change user to sudo
```
sudo su -
```
Install required packages
```
apt-get install libltdl7
```
You need to install it before proceeding:
```
apt-get install alien
```
Distro: "Ubuntu 14.04 LTS"?
```
apt-get install libsystemd-journal0
```
Download Synchro Foundation RPM.
Run following command to change the format of the package.
```
alien <FOUNDATION-FILE>.rpm
```
Install .deb Synchro Foundation
```
dpkg -i <FOUNDATION-FILE>.deb
```

Version

Notice that Foundation works with two different versions of Ubuntu: Artful and Trusty. Make sure to download the right version for your system.

Ubuntu 16.04 LTS

This version of Ubuntu will very likely raise the following error:

Error: Failed to setup foundation config (code 4006) Synchronizing state of docker.service with SysV init with /lib/systemd/systemd-sysv-install...
Executing /lib/systemd/systemd-sysv-install enable docker

A workaround is to run the following command: mv /etc/init.d/ /etc/systemd/system

Oracle Linux¶

Change user to sudo
```
sudo su -
```
Install required packages
```
yum install libtool-ltdl
```
Download Synchro Foundation RPM.
Install Synchro Foundation
```
yum install <FOUNDATION-FILE>.rpm
```

Observation

In case you has any issues with the installation, please take a look at troubleshooting page.

Installing Foundation Mannualy

In case you has any problems with your distro, you can install foundation manually, to see how follows the link.

Foundation Config¶

After installing Foundation by following the instructions above, let's config foundation in the next section.