Oracle Cloud Infrastructure Documentation

Troubleshooting Storage Gateway

This section provides troubleshooting solutions for problems you might encounter using Storage Gateway.

I installed docker and NFS on my host, but I can’t install Storage Gateway

  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 Storage Gateway installation script:

    sudo ./ocisg-install.sh

I can’t access the management console

  1. Run the ocisg info command:

    sudo ocisg info

    If Storage Gateway is not running, then start Storage Gateway:

    sudo ocisg up
  2. Make a note of the management console port number from the output:

    Management Console: https://myStorageGatewayHost.example.com:32775
    
    If you have already configured a OCISG File System via the Management Console, you can access the NFS share using the following port.
    
    NFS Port: 32774
    
    Example: mount -t nfs -o vers=4,port=32774 myStorageGatewayHost.example.com:/<OCISG File System name> /local_mount_point

    In the example, myStorageGatewayHost.example.com is the Storage Gateway host name and 32775 is the management console port number.

  3. Ensure that Storage Gateway is running docker on the Storage Gateway host.
  4. Check that the management console port number in the output (from ocisg 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 am unable to mount a file system

  1. Run the ocisg info command:

    sudo ocisg info

    If Storage Gateway is not running, then start Storage Gateway:

    sudo ocisg up
  2. Make a note of the management console port number and NFS port number from the output:

    Management Console: https://myStorageGatewayHost.example.com:32775
    
    If you have already configured a OCISG File System via the Management Console, you can access the NFS share using the following port.
    
    NFS Port: 32774
    
    Example: mount -t nfs -o vers=4,port=32774 myStorageGatewayHost.example.com:/<OCISG File System name> /local_mount_point

    In the sample output:

    • myStorageGatewayHost.example.com is the Storage Gateway host name
    • 32775 is the management console port number
    • 32774 is the NFS port

  3. Log in to the NFS client from which you want to access your service instance through Storage Gateway.
  4. Create a directory on the NFS client.
  5. Mount the file system on the directory which you created on the NFS client:

    sudo mount -t nfs -o vers=4,port=32770 myStorageGatewayHost.example.com:/<ocisg_file system_name>/<local_mount_point>

    In this command:

    • Replace myStorageGatewayHost.example.com with the server name or IP address of the server on which Storage Gateway is installed.
    • Replace <ocisg_file system_name> with the file system name that you want to mount.
    • Replace <local_mount_point> with the path to the directory you created on the NFS client.

    For example:

    sudo mount -t nfs -o vers=4, port=32774 myStorageGatewayHost.example.com:/myFirstFS /home/xyz/abc

    In this example,

    • 32774 is the NFS port
    • myStorageGatewayHost.example.com is the Storage Gateway host name
    • myFirstFS is the file system name
    • /home/xyz/abc is the path to the directory abc on the NFS client
  6. Ensure that Storage Gateway is running docker on the Storage Gateway host.
  7. Ensure that the NFS protocol is running:

    sudo systemctl enable nfs-server
  8. Check that the NFS port number in the output (from ocisg info) matches the port you’re using to connect to with your NFS client.

Contacting Oracle Support

If you need technical support or help with Storage Gateway, you can go to My Oracle Support and create a service request. See Creating a Service Request for information on creating a service request.