Installing SphereEx-Boot Offline #

Making an offline image installation package allows you to install and deploy boot tools on hosts in isolated extranet environments. There are two ways to do offline installation.

Offline Package Installation #

Application Scenarios

When the deployment environment is a Python 2.7 environment for the Linux operating system, and you cannot access the Extranet, you can use offline installation, which contains the dependent packages of the corresponding version.

Related Concepts

Source host: A manager node that can connect to the Internet, with Python and pip installed.
Target host: A manager node that cannot connect to the Internet, and has the same version of Python as the Source Host. The Source and Target Hosts require the same operating system and architecture as the system.

Offline Package Description

Download the SphereEx-Boot offline installation package “spex-boot-offline-1.0.tar.gz” from the url https://download.sphere-ex.com/boot/spex-boot-offline-1.0.tar.gz, which already contains the relevant installation package software that supports Linux systems and Python2.7 environments.

$ tar -zxvf spex-boot-offline-1.0.tar.gz
$ cd spex-boot-offline-1.0
$ ls -l 
total 152704
drwxr-xr-x  30 root  staff       960  3 17 14:49 package
-rw-r--r--@  1 root  staff   1530646  3 17 14:23 pip-20.3.4.tar.gz
-rw-r--r--   1 root  staff  75819309  3 17 15:09 prometheus-2.33.3.linux-amd64.tar.gz
-rw-r--r--   1 root  staff       159  3 17 15:13 requirements.txt
-rw-r--r--   1 root  staff    783964  3 21 14:49 setuptools-41.0.1.tar.gz
-rw-r--r--   1 root  staff     37995  3 17 11:35 spex-boot-1.0.tar.gz

package holds the SphereEx-Boot dependency package.
pip-20.3.4.tar.gz is the pip source installation package.
prometheus-2.33.3.linux-amd64.tar.gz is Prometheus installation package.
requirements.txt is the SphereEx-Boot dependency package manifest.
setuptools-41.0.1.tar.gz is the setuptools source installation package.
spex-boot-1.0.tar.gz is a SphereEx-Boot installation package.

Prerequisites

Has sent spex-boot-offline-1.0.tar.gz installation package to target host.
The Target Host needs to have a Python 2.7 environment.
Pip is installed, if not installed, you can install it using the pip source package within the offline package.

Procedure

Install setuptools.

cd spex-boot-offline-1.0
tar -xf setuptools-41.0.1.tar.gz
cd setuptools-41.0.1
python setup.py install

Install pip (you can skip this step if it’s already installed).

$ tar -zxvf pip-20.3.4.tar.gz
$ cd pip-20.3.4
$ python setup.py install

The Target Host installs the dependent package.

$ pip install --no-index --find-links=./package -r requirements.txt

The target host installs the Boot.

$ pip install spex-boot-1.0.tar.gz

Make a Dependency Package Installation #

Application Scenarios

When the SphereEx-Boot dependency version in the offline installation package does not match the actual situation, you can take the production dependency package for installation.

Procedure

The Source Host installs the Boot tools.
Get the Boot tool dependency manifest file. There are two ways to obtain the boot dependency manifest file requirements .txt:

Use the “spex mirror clone –requirement” command in the source host to export the Boot dependency manifest.

$ spex mirror clone --requirement
$ ls 
requirements.txt

Execute the “spex mirror clone” command on the Source Host to export all mirror installation packages, including the dependent manifest files.

$ spex mirror clone
$  ls -l
total 126008
-rw-r--r--  1 root  staff  49822163 Feb 23 16:23 apache-shardingsphere-x.x.x-shardingsphere-proxy-bin.tar.gz
-rw-r--r--  1 root  staff  12516362 Feb 23 16:24 apache-zookeeper-x.x.x-bin.tar.gz
-rw-r--r--  1 root  staff   1007502 Feb 23 16:24 mysql-connector-java-x.x.x.jar
-rw-r--r--  1 root  staff       148 Feb 23 16:23 requirements.txt
-rw-r--r--  1 root  staff     34132 Feb 23 16:24 spex-boot-1.0.tar.gz

Get the Boot dependency installation package.

Execute the following command on the Source Host, and all dependent installation packages in the dependency manifest are downloaded to the specified export directory.

$ pip download -r requirements.txt -d ./package

The Target Host installs the Boot dependency package.

Send the dependent manifest file and the dependent installation package to the Target Host.

Run the following command on the Target Host:

$ pip install --no-index --find-links=./package -r requirements.txt

The Target Host installs the Boot.

Send the Boot installation package to the Target Host and execute the installation command on the Target Host.

$ pip install spex-boot-1.0.tar.gz