6 Troubleshooting Storage Software Appliance

This section provides solutions for problems you may encounter while using Oracle Cloud Infrastructure Storage Software Appliance.

Topics:

• I installed docker and NFS in my host, but can’t install Oracle Cloud Infrastructure Storage Software Appliance
• Can’t access the management console
• I provided my Oracle Cloud Infrastructure Object Storage Classic account details in the management console, but can’t create a filesystem
• Unable to mount a filesystem
• Contacting Oracle for Support

I installed docker and NFS in my host, but can’t install Oracle Cloud Infrastructure Storage Software Appliance

1. Add the docker group to the existing groups in your host:

   sudo groupadd docker

2. Add your user id to the docker group:

   usermod -a -G docker username

3. Shut down your host:

   shutdown –r now

4. Log in to your host and run the Oracle Cloud Infrastructure Storage Software Appliance script:

   sudo ./oscsa-install.sh

Can’t access the management console

1. Check if Oracle Cloud Infrastructure Storage Software Appliance is running:

   oscsa info

2. If the appliance is not running, then start the appliance:

   oscsa up

   Make a note of the management console port number.

   Sample output

   Creating OSCSA Volume
   Starting OSCSA [oscsa_gw:1.0]
   Management Console: https://myApplianceHost.example.com:32771
   
   If you have already configured an OCISSA 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:/OCISSA_filesystem_name/local_mount_point
   

   In the sample output,

   - myApplianceHost.example.com is the appliance host name

   -32771 is the management console port number

3. Check if the appliance is running on docker on the appliance host.
4. Check that the management console port number in the output (from oscsa info) matches the port you’re using to access the management console.
5. Ensure that you are using https if you have enabled SSL. By default, SSL is enabled.

I provided my Oracle Cloud Infrastructure Object Storage Classic account details in the management console, but can’t create a filesystem

Check your user credentials in your Oracle Cloud Infrastructure Object Storage Classic account and update them in the management console.

Unable to mount a filesystem

1. Check if Oracle Cloud Infrastructure Storage Software Appliance is running:

   oscsa info

2. If the appliance is not running, then start the appliance:

   oscsa up

   Make a note of the management console port number and NFS port number.

   Sample output

   Creating OSCSA Volume
   Starting OSCSA [oscsa_gw:1.0]
   Management Console: https://myApplianceHost.example.com:32771
   
   If you have already configured an OCISSA 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:/OCISSA_filesystem_name/local_mount_point
   

3. Check if the appliance is running on docker on the appliance host.
4. Ensure that the NFS protocol is running:

   sudo systemctl enable nfs-server

5. Check that the NFS port number in the output (from oscsa info) matches the port you’re using to connect to with your NFS client.

Contacting Oracle for Support

1. Go to https://support.oracle.com.
2. In the Sign In pane, select Cloud Portal as the portal and click Sign In.
3. On the Dashboard page, click Create Service Request.
4. In the Create Service Request wizard, do the following:
   1. In the Service Type field, select Oracle Cloud Infrastructure Object Storage Classic.
   2. In the Problem Type field, Select Issues accessing a Storage Software Appliance or Issues installing or upgrading a Storage Software Appliance, and select the appropriate problem subtype.
5. Follow the prompts in the wizard to complete the service request.