Oracle Linux Storage Appliance
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).
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 |
|
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 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.
-
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.
-
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.
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.
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.
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.
-
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
-
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 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.
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.
-
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.
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.
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.
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.
- 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
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.
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.
-
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.