Installing the VSP One SDS Block installer

Install the VSP One SDS Block installer (hsdsinstall).

You can download the VSP One SDS Block installer package.

To copy the VSP One SDS Block installer package to the controller node, you can, for example, store the package obtained from the download server in Amazon S3, and then copy the file from Amazon S3 by using the AWS CLI. For example operations, see Example Amazon S3 operations.

Note:

When you upgrade or downgrade the storage software, verify that the VSP One SDS Block installer installed in the controller node matches the storage software version.

If you want to upgrade the VSP One SDS Block installer, you can perform an update installation using the same procedure as a new installation. When the update-source version of the storage software is 01.14.0x.40 or earlier, install the installer because the VSP One SDS Block installer has not been installed.

If you want to downgrade the VSP One SDS Block installer, perform a new installation after following the uninstall procedure.

For Windows:
```
> py -m pip uninstall hsds_installer
```

For Linux:

# python3 -m pip uninstall hsds_installer

Before you begin

The OS of the controller node in which the VSP One SDS Block installer is to be installed must meet the OS requirements described in Deploying a controller node.
Python3 must be installed. (Python2 is not supported.)
python3-pip must be installed.
The VSP One SDS Block installer package is required.
The controller node should be able to access the python repository.

If the controller node cannot access the python repository, obtain all required dependent packages required by the VSP One SDS Block installer at another terminal that can access the python repository, transfer them to the controller node, and then install them in the controller node.

For the list and versions of the dependent packages of the VSP One SDS Block installer, see Dependent packages that the VSP One SDS Block installer requires and version requirements.

Log in to the EC2 instance for a controller node.
In the case of Linux, switch to a root user. In the case of Windows, switch to a user having administrative privilege.

Upgrade installed pip.

For Windows:
```
> py -m pip install --upgrade pip
```
For Linux:
```
# python3 -m pip install --upgrade pip
```

Install the VSP One SDS Block installer package.
- For Windows:
```
> py -m pip install <directory-storing-VSP-One-SDS-Block-installer-package>/hsds_installer-<version>.<number>-py3-none-any.whl
```
- For Linux:
```
# python3 -m pip install <directory-storing-VSP-One-SDS-Block-installer-package>/hsds_installer-<version>.<number>-py3-none-any.whl
```
CAUTION:
- To install a VSP One SDS Block installer package, make sure to perform operation as a root user (Linux) or a user having administrative privilege (Windows). If you install a VSP One SDS Block installer package as a user other than those, uninstall the VSP One SDS Block installer package by running the following command as the user who installed the package.
  - For Windows:
    
    > py -m pip uninstall hsds_installer
  - For Linux:
    
    # python3 -m pip uninstall hsds_installer
- If a warning message appears or failure occurs when installing the package as a root user (Linux) or a user having administrative privilege (Windows), use the virtual environment.
Note:
If the controller node can access the python repository, the latest versions of the VSP One SDS Block installer dependent packages are automatically installed upon execution of the command.
Run the following command to verify the version of the VSP One SDS Block installer matches that of the configured storage cluster.
If the command cannot be run or these versions do not match, reperform the procedures from Installing the prerequisite packages.
```
hsdsinstall --version
```