Skip to content
Sosivio

Installation

Installing Sosivio is really simple and requires minimal prerequisites. Below is a quick start guide to start using Sosivio.

Installation Notes

Sosivio is installed as “Yet Another Application” on Kubernetes, meaning upon installation a Namespace “sosivio” will be created in which the Sosivio microservices will run. Please note, it may take up to 10 minutes for Sosivio to collect all necesery cluster information for optimal performence. Enabling Failure Resolution through the Sosivio dashboard, while not mandatory, is strongly encouraged and requires an elevated permission service account in order to perform actions (be it manual, i.e. at the push of a button or automatic).

The information Sosivio reads and analyzes is not transmitted, nor used in any manner outside of the Kubernetes cluster on which Sosivio is deployed. The information NEVER leaves your cluster, ensuring no security threats.

Downloading the Installer

The installer can be downloaded from the Sosivio website in your customer account. On www.sosiv.io go to Try Sosivio Free and follow the instructions until you arrive at the Download Sosivio page. Click on Download to download the Sosivio Installer.


Downloading the Sosivio Installer

Read-Only Permissions

If your environment requires Sosivio to have a cluster-reader role (Sosivio can only read information but can not apply recommendations) then run the following command prior to running the installer:

export SOSIVIO_ENABLE_READ_MODE=true ./installer

If you have installed Sosivio already and need to convert Sosivio to have a cluster-reader role:

kubectl delete clusterrolebinding sosivio-cluster-rolebinding
unset SOSIVIO_ENABLE_READ_MODE
./installer

Cluster-Reader Restrictions:

  • Users will not be able to execute commands from the command center for both Performance and Optimizations.

Run the Installer

On your terminal, ensure you have checked and met the environmental prerequisites and your current context is set to a user with a cluster-admin role. Then run the command:

./installer

NOTE: If using a Mac, you might get the error: "cannot be opened because the developer cannot be verified." You can simply go to System Preferences -> Security & Privavcy -> Open Anyway. For more details, see Apple's documentation.

NOTE: Currently minishift, minikube, and kind are not supported platforms.

You will get the following 6 options:

  1. Openshift 4
  2. Amazon EKS
  3. Azure AKS
  4. Google GKE
  5. Kubernetes (1.18 or lower)
  6. Kubernetes (1.19 or higher)


Installation Options

Choose the appropriate Kubernetes platform for installation. If you are installing on more than one cluster, then choose the appropriate Kubernetes platform for the current installation.

After choosing your installation platform you will be asked for your domain name (e.g. example.test.com).

After you enter in your domain name, you will then be asked for the location of the docker repository you wish to use. If you leave it blank, it will default to Sosivio’s registry (this requires an internet connection). If you are using a private registry, please ensure you have the correct images hosted on there. This can be done by following the instructions for the offline installer here. You will then be asked for the name of your cluster.


Sosivio Docker Repository

After the installation is complete a URL to Sosivio on your environment will be generated. The following output will be displayed:


Sosivio Dashboard URL

NOTE: The Sosivio Dashboard URL will be different than the image above.

Sosivio is a web-based application. It is accessible via the following web browsers:

  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox
  • Apple Safari

Please note that access via mobile phones or tablets is not supported at this time.

To verify the installation, open your web browser and point it to the URL given at the end of the installation.

Installing from Amazon Web Services Marketplace for EKS

Prerequisites:

  • Subscribed to Sosivio on AWS Marketplace
  • Have latest Helm version installed

When installing Sosivio from the AWS Marketplace on AWS EKS run the following commands:

helm repo add sosivio https://helm.sosiv.io

CLUSTER_NAME=<your-cluster-name>
helm upgrade --install --set platform=eks --set cluster_name=$CLUSTER_NAME sosivio sosivio/sosivio

Default Login Credentials

The default password should immediately be changed after logging into the Sosivio Dashboard for the first time.

  • Username: admin
  • Password:
    • Will be displayed after a successful installation if using the automated installer.
    • Can be retrieved by running the command oc/kubectl get secret -n sosivio sosivio-admin-otp -o jsonpath='{.data.password}' | base64 -d

Reset Password

If you need to reset the admin password, follow the instructions here.