Installing Storage Software Appliance

Before You Begin

Steps for Installing Oracle Cloud Infrastructure Storage Software Appliance

  1. Log in to the server on which you want to install Oracle Cloud Infrastructure Storage Software Appliance.
  2. Edit /etc/yum.repos.d/public-yum-ol7.repo on the host on which you want to install the appliance.
    • Change the value of enable to 1 in addons.
    • Change the value of enable to 1 in optional_latest.
  3. Install docker using yum:

    sudo yum install docker-engine

  4. Restart the server:

    shutdown -r now

  5. Enable non-root users to use docker client.
    1. Add a new group (docker) to the host:

      sudo groupadd docker

    2. Modify your user account and add your user name to the docker group:

      sudo usermod -a –G docker username

    3. Log out and log in again.
  6. Run the following commands to set up the appliance host to work around the docker socket:

    NO_PROXY=localhost,127.0.0.1/8,/var/run/docker.sock

    no_proxy=$NO_PROXY

  7. Start docker and ensure that docker is running by entering the following commands:
    • sudo systemctl start docker

    • sudo systemctl enable docker

  8. Install nfs-utils using yum:

    sudo yum install nfs-utils

    The nfs-utils package enables NFS protocol on your host.

  9. Start rpcbind and nfs-server and ensure the NFS protocol is running by entering the following commands:
    • sudo systemctl start rpcbind
    • sudo systemctl start nfs-server
    • sudo systemctl enable rpcbind
    • sudo systemctl enable nfs-server
  10. Check if the NFS protocol version is 4:

    sudo rpcinfo -p | grep nfs

  11. Extract the files from the installer to a directory on the appliance host by entering the command:

    tar -xvf installer_tar.gz

  12. Change the permission of the oscsa-install.sh file:

    chmod +x oscsa-install.sh

  13. Check the status of docker:

    sudo systemctl status docker

  14. Verify the information in docker:

    docker info

  15. Run the oscsa-install.sh file:

    sudo ./oscsa-install.sh -a

    The default installation location on the appliance host is /opt/oscsa_gateway. During the installation, you can enter a different installation path.

    -a: Specifies the advanced setup.

    The appliance creates local copies of the files in the local buffer until the files are copied to your account. By default, the location of the buffer is in a subdirectory of /var/lib. However, if there isn’t sufficient storage space in /var/lib, then use this option and specify a location for data storage, metadata, and log storage.

    (Optional) Alternatively, you can run the oscsa-install.sh file with any of the following options:
    • -p: To specify that Oracle Cloud Infrastructure Storage Software Appliance is running with a proxy server.
    • -q: To run the installation in quiet mode. 
    • -d: To install at the specified installation path.
    • -h: To display the help information.

    Sample output

    Checking that docker is installed and using the correct version
    Pass found docker version Docker version 1.8.3, build aa9b234 
    WARNING: bridge-nf-call-iptables is disabled 
    WARNING: bridge-nf-call-ip6tables is disabled
    *************************************
    Checking host prerequisites
    *************************************
    Detected linux operating system
    Checking kernel version
    Pass kernel version
    3.10.0-123.el7.x86_64 found 
    Checking NFS version 
    Pass found NFS version 4
    ************************************* 
    All prerequisites have been met 
    *************************************
    *************************************
    Begin install
    *************************************  
    Installing to destination /opt/oscsa_gateway/ 
    Copied install scripts
    Copied OSCSA image
    Starting configuration script
    Enter the mount location for data cache
    /oscsa/cache
    Enter the mount location for metadata
    /oscsa/md 
    Enter the mount location for log file information
    /oscsa/logs 
    Enter the docker network mode (host or bridge), Hit <Enter> for the default bridge mode.  
    Enter the host port to use for the Administrative Web Interface. Hit <Enter> to use dynamic port mapping  
    Enter the host port to use for NFS access. Hit <Enter> to use dynamic port mapping  
    Enter the host port to use for the optional HTTP REST service. Hit <Enter> to use dynamic port mapping  
    Writing configuration 
    Importing image Please run 'oscsa up' to start the software appliance  
    *************************************
    For additional details, please see (/opt/oscsa_gateway/OSCSA_GATEWAY_README.txt) file
    *************************************
    
    In the advanced setup, you can configure the following additional parameters:
    • DATASTORAGE: Specifies the disk location or mount path where the Oracle Cloud Infrastructure Storage Software Appliance disk cache will be stored.
    • MDSTORAGE: Specifies the disk location or mount path where the Oracle Cloud Infrastructure Storage Software Appliance metadata will be stored.
    • LOGSTORAGE: Specifies the disk location or mount path where the Oracle Cloud Infrastructure Storage Software Appliance logs will be stored.
    • ADMINPORT: Specifies the port on the appliance host to access the management console.
    • NFSPORT: Specifies the port on the appliance host to access NFS.
  16. Check the status of the firewall:

    sudo firewall-cmd --state

  17. Open the firewall ports on the appliance host by entering the following commands:
    • sudo firewall-cmd --zone=public --add-port=nfs_port/tcp --permanent
    • sudo firewall-cmd --zone=public --add-port=management_web_ui_port/tcp --permanent
    • sudo firewall-cmd --reload

    Example:

    sudo firewall-cmd --zone=public --add-port= 32774/tcp --permanent

    sudo firewall-cmd --zone=public --add-port= 32775/tcp --permanent

    sudo firewall-cmd --zone=public --add-port= 32776/tcp --permanent

    sudo firewall-cmd --reload

  18. Start the appliance:

    oscsa up

The installation might take up to 30 minutes to run, download images, and import the images into the docker.

When the installation is complete, you can see the details of Oracle Cloud Infrastructure Storage Software Appliance as shown in the following sample output.

Make a note of the management console URL, which has the following format:

https://appliance_host_name:port_number

Sample output

Starting NFS on docker host
Applying configuration file to container
Starting OSCSA [oscsa_gw:1.3]

Management Console: https://myApplianceHost.example.com:32771


If you have already configured an OSCSA FileSystem via the Management Console,
you can access the NFS share using the following port.

NFS Port: 32770

Example: mount -t nfs -o vers=4,port=32770 myApplianceHost.example.com:/OSCSA_filesystem_name /local_mount_point
In the sample output,
  • myApplianceHost.example.com is the appliance host name
  • 32771 is the management console port number

Tip:

You can use either the appliance host name or the IP address in the management console URL.

  • You can find the name of the appliance host by entering the following command:

    hostname

  • You can find the IP address of the appliance host by entering the following command:

    ip addr

The management console is a web application running within Oracle Cloud Infrastructure Storage Software Appliance. You can open the management console by using a web browser. Then you can create your administrator and log in to the management console to create your first filesystem. For more information, see Creating Your First FileSystem.