Oracle Linux Storage Appliance Image
The Oracle Linux Storage Appliance provides a fast and easy way to build a shared storage system on Oracle Cloud Infrastructure. It enables you to export files by using the protocols Network File System (NFS) v3 and v4, and Windows Server Message Block (SMB) v3 (Samba).
The Oracle Linux Storage Appliance is intended for use on Oracle Cloud Infrastructure only. If you are managing compute instances not on Oracle Cloud Infrastructure, use the standard tools provided in Oracle Linux to manage NFS and SMB configuration. For more information, see the chapter on administering shared file systems in Oracle Linux 7: Managing File Systems .
Creating an Instance
Follow the instructions in Creating an Instance, but note the following exceptions:
- Shape Selection: The Oracle Linux Storage Appliance can run on all Oracle Cloud Infrastructure shapes. However, depending on if the image has NVMe disks affects the storage pool configuration. See Configuring the Storage Pool.
- Network Configuration: When configuring the instance's network, select the VCN that has its ports configured with the appropriate information as defined in Configuring Ports for the Virtual Cloud Network.
Configuring Ports for the Virtual Cloud Network
To access the appliance and its services, add the required ports to the stateful ingress rules in the default security list for the Virtual Cloud Network (VCN).
List of Ports to Configure
Configure the VCN ingress rules for these ports to allow traffic for the specified protocol, service, and function.
Service |
Destination Port Range |
Protocol Type |
Function |
---|---|---|---|
|
|
TCP |
NFS |
|
|
TCP |
NFS |
|
|
UDP |
Autofs/Showmount |
|
|
TCP |
HTTPS |
|
|
TCP |
NFS |
|
|
TCP |
Autofs/Showmount |
|
|
TCP |
NFS |
|
|
TCP |
SSH |
|
|
TCP |
|
|
|
TCP |
|
|
|
TCP |
|
|
|
UDP |
|
|
|
UDP |
|
Format for Port Configuration
When adding the port configuration, you must use a specific format.
Source: CIDR-range-of-your-VCN
IP Protocol: IP-protocol
Source Port Range: All
Destination Port Range: port-range
For example, if your VCN Classless Inter-Domain Routing (CIDR) range is 172.16.0.0/16
, you would use the following port configuration:
Source:
172.16.0.0/16
IP Protocol: TCP
Source Port Range: All
Destination Port Range:
111
The port configuration in the previous example provides access to the appliance from any instance within your VCN. You can restrict access to a smaller set of instances by changing the source CIDR, as required. For more details, see Security Lists.
The source CIDR range for SSH should be 0.0.0.0/0
so that you can access SSH remotely. See Accessing the Web Interface.
Using the Web Interface
The web interface of the Oracle Linux Storage Appliance allows you to manage shares and monitor the storage appliance.
Supported browsers include:
- Google Chrome version 63 and later
- Mozilla Firefox Extended Support Release (ESR) version 52 and later
Using the command line to modify the appliance is not supported. Per Oracle support, only use the command line for recovery purposes. Refer to the recovery instructions that are described in the online help in the web interface for more information. See also Security Lists in the Oracle Cloud Infrastructure documentation.
What can I do with the web interface?
-
View the storage capacity available for shares.
-
Display status and configuration information about the appliance.
-
Create and manage shares that use the NFS and SMB protocols.
-
Migrate an appliance storage pool from one Oracle Cloud Infrastructure compute instance to another Oracle Cloud Infrastructure compute instance.
-
Perform backup and recovery operations.
-
Perform autonomous actions (if using the Autonomous Linux version of the appliance). For more information, see Oracle Autonomous Linux Image.
-
Perform the following system and user administrative actions on the appliance: reboot and update the appliance, restart NFS and SMB services, enable and configure supported features, view system, boot, service, and autonomous logs.
Accessing the Web Interface
Connect to the web interface by using SSH to port forward. The first time you connect, you must set the admin password and define the storage pool.
Changing the Admin Password
You must set the password the first time you access the interface, but you can change the password at any time.
Managing the Appliance
After deploying the appliance and configuring the web interface, you can configure and monitor the file server by using the web interface.
Configuring the Storage Pool
Instances with NVMe disks, automatically have the storage pool created. Instances without NVMe disks, require you to attach block volumes and select them for the storage pool after you initially log into the web interface.
You cannot modify the block volumes after defining the storage pool. Detaching and reattaching block volumes while the appliance is running is not supported and will cause data corruption or loss.
- Instances with NVMe Disks
-
For Oracle Cloud Infrastructure Compute instances with NVMe disks attached, the storage pool is created automatically.
When you create an Oracle Linux Storage Appliance instance on a Dense I/O shape or a Compute instance with attached NVMe devices, any block volumes that are attached to the instance are not available for share creation. Mixed NVMe and block volume per instance is not supported.
- Instances that use Block Volumes only
-
For Oracle Cloud Infrastructure instances without NVMe disks attached, you must attach block volumes to the instance and then select them for the storage pool.
-
Create and attach the block volumes to the instance. For instructions, see Adding a Block Volume in the Oracle Cloud Infrastructure documentation.
When attaching the volumes within the Oracle Cloud Infrastructure Console, you do not need to run iSCSI commands. You can ignore the iSCSI instructions as the storage appliance attaches and mounts the volumes automatically.
Important
You cannot modify the block volumes after creating the storage pool. Ensure you have attached all the volumes that you want to use before defining the storage pool within the web interface. -
Log into the web interface. See Accessing the Web Interface.
-
The appliance automatically detects the attached volumes. Select the volumes to use for the storage pool, and then click Create.
-
Viewing Storage Appliance Status
Use the Dashboard page to view high-level status information. Or use the Appliance page to view more detailed status information.
Green items indicate okay status, while red indicates a potential problem. If you need to troubleshoot common issues, go to the Administration page, where you can view log files and perform several administrative actions.
For high-level status information:
-
Within the web interface, click Dashboard in the top menu.
-
Review the status of the appliance.
The Storage Status section displays:
- Number of NFS and SMB clients that are currently connected to the appliance
The Appliance Status section displays:
- Configuration information
- Status of appliance resources (such as CPU, memory, disk, and network usage)
For detailed status information:
-
Click Appliance in the top menu.
-
Review the status of the appliance. The Appliance page displays:
-
Platform information (version, shape, CPU, memory, swap usage, and so on)
-
Utilization of the
root
file system -
State of key services
-
Viewing System Logs
Use the system, boot, service, and autonomous logs to troubleshoot issues.
- Within the web interface, click Administration in the upper menu.
-
Within the System Logs section, click the tab for the log you want to view.
- System logs
- Boot logs
- Service logs
- Autonomous logs (this tab is only available for Autonomous Linux instances)
Rebooting the Appliance
Rebooting immediately disconnects all currently running client sessions and restarts the system.
- Within the web interface, click Administration in the upper menu.
- Within the System Actions section, click Reboot appliance.
Using Autonomous Linux
You can select an Oracle Linux Storage Appliance image configured with Oracle Autonomous Linux when creating the instance. Autonomous Linux provides autonomous package updates and automated Oracle Ksplice patching with zero downtime, and known exploit detection, to keep the appliance instance highly secure, reliable, and up to date.
The Autonomous Linux version of the appliance includes autonomous actions in the web interface.
-
Within the web interface, click Administration in the upper menu.
-
Under the Autonomous Actions section, you can:
-
View and modify the Oracle Cloud Infrastructure Notifications service topic OCID (Oracle Cloud Identifier) used for receiving auto-update messages.
For information about configuring topics using the Oracle Cloud Infrastructure Notifications service, see Notifications Overview in the Oracle Cloud Infrastructure documentation.
-
View and modify the time window for auto-updates.
-
Enabling Ksplice Auto Updates
Ksplice allows you to update the operating system without requiring a reboot. Use the web interface to enable or disable automatic Ksplice updates for the appliance.
For Autonomous Linux versions of the appliance, Ksplice automatically updates by default. You cannot enable or disable it.
- Within the web interface, click Administration in the upper menu.
- Within the System Actions section, click Enable Ksplice.
Updating the SSH Keys
Update the list of SSH public keys that are allowed to connect through SSH as the default user (opc) for the OCI instance. Direct SSH login to the appliance is not supported, but you can use SSH for port forward access to the web interface.
- Within the web interface, click Administration in the top menu.
- Under the User Actions, click Update ssh keys.
- Paste the SSH public key within the field.
- Click Update keys.
Migrating an Appliance Instance
Migrate an existing appliance from one Oracle Cloud Infrastructure Compute instance to a new Compute instance.
Before migrating your appliance instance, understand that the migration process:
-
Reconfigures the block volume storage pool on the newly migrated Compute instance.
-
Does not migrate shared file systems (these file systems remain on the existing block volumes).
-
Only works for Compute instances that have remotely attached block volumes. You cannot migrate DenseIO shapes with local NVMe devices.
Migration is useful if you need to deploy your appliance on a new Compute instance with more Oracle OCPU and memory resources, as it eliminates the need to rebuild your existing file system server. Migration is required if you need to upgrade your appliance from version 1 to version 2 or from an Oracle Linux to an Oracle Autonomous Linux version of the appliance.
Before migrating, first back up your appliance instance, including Samba global settings, ssh keys, and OCI service access configuration on the Administration page.
- Ensure you have backed up your appliance instance before starting migration.
- In the web interface for the source instance, click the Administration tab, then click Prepare for migration.
-
In the Oracle Cloud Infrastructure Console for the source instance, do the following:
-
In the Oracle Cloud Infrastructure console for the destination instance, do the following:
Working with NFS and SMB Shares
You can add, manage, and access the NFS or SMB shares associated with the appliance.
Adding a Share
Add NFS or SMB exports to the Storage Appliance. Supported protocols include: NFSv3, NFSv4, and SMB version 3.
Configuring Samba Global Settings
You must define the Samba settings when using SMB exports.
- Within the web interface, click Administration in the upper menu.
- Within the System Actions section, click Configure Samba global settings.
Modifying, Duplicating, and Deleting Shares
- Within the web interface, click Storage in the upper menu.
- Click the Actions menu next to the share.
-
Select an action:
- View/Modify
- Duplicate
- Delete
Backing up and Restoring Shares
The appliance backs up shares to the Oracle Cloud Infrastructure Object Storage service.
Prerequisites
-
You can do either of the following:
- Provide Oracle Cloud Infrastructure credentials on the Administration page by clicking Configure access to OCI services. Ensure you have configured API Keys. See Generating an API Signing Key or run
oci setup config
on the instance. Once created, the credentials are located in$HOME/.oci/config
. - Make the Oracle Linux Storage Appliance instance part of a dynamic group. In this case, Oracle Cloud Infrastructure credentials aren't required.
- Provide Oracle Cloud Infrastructure credentials on the Administration page by clicking Configure access to OCI services. Ensure you have configured API Keys. See Generating an API Signing Key or run
- Create a bucket (or reuse an existing bucket) to store the archived objects in the Oracle Cloud Infrastructure Object Store. See Managing Buckets.
Backing up a Share
The appliance backs up the share as an object within an Oracle Cloud Infrastructure object bucket.
- Within the web interface, click Storage in the upper menu.
- Click the Actions menu next to the share.
- Select Backup.
- Click Backup.
Restoring a Share
Restore the share from the Oracle Cloud Infrastructure object storage. Restoring overwrites the current content for the share.
- Within the web interface, click Storage in the upper menu.
- Click the Actions menu next to the share.
- Select Restore.
-
Enter the object information:
- Object Name: See Object Names for more information.
- Bucket Name: The bucket name can be found within the bucket details on the Console. See To view bucket details.
- Bucket Namespace: The bucket namespace can be found within the bucket details on the Console. See To view bucket details.
- Click Restore.
Accessing Shares Over the NFS and SMB Protocols
You can access the Storage Appliance shares using NFS or SMB.
See Oracle Linux 7: Managing File Systems and Oracle Linux 8: Managing Shared File Systems for more information about configuring NFS or SMB shares.
- Viewing Share Mount and Map Instructions
-
- Within the web interface, click Storage in the upper menu.
- Click the Actions menu next to the share.
- Select Mount Information.
- Use the commands listed to access the shares.
- Accessing NFS Shares
-
-
Starting with Oracle Linux 7.3, the installation image does not install NFS packages by default. You must install the
nfs-utils
package on the client:sudo yum install -y nfs-utils
-
Mount the export. For example:
sudo mount appliance_ip:share_path destination_path
-
- Accessing SMB Shares
-
-
Mount the export. For example:
sudo mount -t cifs -o guest //server_address/share_name mountpoint
-
If you want to make automount directories available, such as
/net
, you must first install theautofs
package.
-
Restarting the NFS or SMB Service
Use the web interface to restart the NFS or Samba and related services.
- Within the web interface, click Administration in the upper menu.
- Within the System Actions section, click either Restart NFS services or Restart SMB services.
Upgrading an Appliance Instance
You can upgrade the Storage Appliance from Version 1.7.1 to 1.8 using the web interface. To upgrade from Version 1 to Version 2, you must migrate the instance.
Update From Version 1.7.1 to Version 1.8
If you previously deployed an earlier version of the Oracle Linux Storage Appliance, you can upgrade to the latest package version for the appliance by using the appliance's web interface.
-
Click Administration in the upper menu.
-
Within the System Actions section, click Update appliance.
-
To enable Active Directory support after you upgrade from version 1.7.1 to version 1.8, you must update all SMB exports that are present on the system.
For each SMB export on the system, do the following:
-
In the web interface, click Storage in the upper menu,
- Select the SMB export to modify, then from the Actions menu, select View/Modify.
-
Under Export Protocols, change the name of the SMB export using the SMB share name field.
-
Click Modify to validate the change.
-
Open the View/Modify dialog box for the SMB export again, then revert the change that you made in Step c.
-
Click Modify to validate the change.
-
Update From Version 1 to Version 2 or to Autonomous Linux
You cannot upgrade directly from version 1 to version 2 or to an Autonomous Linux version of the instance. Instead, you must migrate the appliance instance.
Before migrating an appliance instance, back up the existing appliance instance's Samba global settings, ssh keys, and OCI service access configuration on the Administration page.
-
Create a new Compute instance based on the latest 2.x version of the Oracle Linux Storage Appliance. For more information, see Creating an Instance.
-
Migrate the existing appliance instance to a Compute instance that is running version 2.x. For more information, see Migrating an Appliance Instance.