Install MinIO S3-Proxy
When using a local storage solution, S3-Proxy software is required to handle the Model9 S3 requests to the storage. The following steps describe the installation of MinIO as the S3-Proxy. Mount the MinIO filesystem on a directory different from the Model9 home directory. For example:
1
# Use a separate filesystem mount on /minio
2
/minio
Copied!
Make sure there is enough free space to accommodate the expected number of backups and archives. It is recommended to use the ‘xfs’ filesystem type. Contact your Linux administrator to allocate adequate space and ensure it is mounted.
Warning
This procedure is intended for new and unmounted block devices only, it will overwrite any data that might already exist on the device.
For a <block device>, it is recommended to use the partition type and not the disk, as shown in the following example:
1
sudo su –
2
export MINIO_HOME=/minio
3
mkdir -p $MINIO_HOME
4
mkfs.xfs /dev/<block device>
5
# add the following line to your /etc/fstab
6
/dev/<block device> /minio xfs defaults 0 0
7
mount $MINIO_HOME
Copied!
UTC Date and Time
The object storage protocol requires the z/OS USS and object storage UTC times to match.
When using MinIO as object storage, the Linux server UTC must match the z/OS USS UTC. Use the following command to verify the MF UTC date/time on USS:
1
date -u
Copied!
Run the same command on the management server Linux system to verify that the date and time match. If they do not, contact the Linux administrator to update the Linux UTC date and time.
Optional - Enabling data-in-flight encryption
Enable the optional Data-In-Flight encryption between the mainframe and storage system as follows:
The default Model9 installation provides a self-signed certificate. For production-level workloads it is strongly advised to generate a site-defined certificate. Copy the default keys to the certificates directory using the following commands:
1
cp $MODEL9_HOME/keys/minio_private.key $MODEL9_HOME/conf/minio/certs/private.key
2
cp $MODEL9_HOME/keys/minio_public.crt $MODEL9_HOME/conf/minio/certs/public.crt
Copied!
Warning
Enabling Data-In-Flight encryption requires excessive ZIIP CPU usage.
MinIO deployment
Deploy the MinIO application components using the following commands:
1
cd $MODEL9_HOME
2
# On Linux on z issue:
3
sudo docker load -i $MODEL9_HOME/minio-s390x-2018-01-02T23-07-00Z.docker
4
# On Linux issue:
5
sudo docker load -i $MODEL9_HOME/minio-x86-2018-01-02T23-07-00Z.docker
Copied!
To initialize the MinIO container:
1. Start the MinIO container using the following command:
1
sudo docker run -d -p 0.0.0.0:9000:9000 -v $MINIO_HOME:/export:z \
2
-v $MODEL9_HOME/conf/minio:/root/.minio:z --restart unless-stopped \
3
--name minio minio/minio server /export
Copied!
Note
Make sure to edit time zone settings to ensure proper scheduling.
2. Determine the health status of the container using the following command:
1
docker ps -a
Copied!
3. Verify that the command returns a value of “(healthy)” as shown in the following example:
4. Extract the Access Key and Secret from MinIO using the following command:
1
docker logs minio
Copied!
5. Verify that the command returns the AccessKey and SecretKey as shown in the following example:
The displayed details are required for completion of the installation process.
6. Once the MinIO installation is complete, use the following commands to stop, start, or restart the container as required:
1
docker stop|start|restart minio
Copied!
7. Display the Model9 Server’s resource consumption using the following command:
1
docker stats minio
Copied!
Last modified 3mo ago
Export as PDF
Copy link