The Oracle Linux Storage Appliance is a web interface that enables you to configure, monitor, and administer an Oracle Cloud Infrastructure compute instance.
To learn more about provisioning a compute instance in the Oracle Cloud Infrastructure, refer to the information that is provided at Oracle Cloud Infrastructure.
This web interface has the following four pages that you can access from the Navigation bar of your browser:
Provides a quick overview of the storage capacity of the appliance, as well as status information.
Provides the ability to create and manage NFS and SMB shares on the appliance.
Provides more detailed information about the appliance's configuration and current status.
Provides access to administrative actions that you can perform.
You can also obtain more information by selecting the Help option in the Admin drop-down list that is located at the top right corner of each page.
Click the right arrow to advance to the next help topic. Clicking the left arrow takes you to the previous help topic.
After logging in to the browser interface for the appliance, the landing page (also called the Dashboard page) for the appliance is displayed. This page provides an overview of the storage capacity and the status of the appliance.
Storage Status
Provides information about the overall RAID storage usage on the appliance, which does not include the appliance's individual storage space. This page also displays the number of NFS and SMB clients that are currently connected to the appliance.
Appliance Status
Provides a visual overview of the main resource usage for the appliance, which includes the following:
root
file system utilizationNote: You can view additional information on the Appliance page.
The Storage page enables you to administer shares for the appliance. The page also provides information about the RAID health status of the appliance.
A share represents storage space that can be accessed by users using multiple export protocols. Currently the NFS and SMB protocols are supported.
The following information is displayed for each share:
The Add button enables you to add a new share.
The Actions drop-down list enables you to view/modify, duplicate, delete, back up and restore shares.
The Mount Information provides information about how to access exports from client instances.
For instructions, see "Adding and Deleting Export Protocols".
Note: To add an export protocol to an existing share, modify the share by using the View/Modify dialog.
A confirmation message is displayed
Warning: Deleting the share also deletes the associated data for the share on the appliance.
The Modify operation enables you to modify the settings of an existing share. The Duplicate operation creates a new share by copying all of the settings of an existing share, except for the share's name.
A message indicating the new share has been successfully created is displayed.
When creating a new share on the Storage page of the appliance, you can optionally associate the NFS or SMB export protocol with the share by clicking the Add export... button in the Add New Share dialog. To add an export protocol to an existing share, use the View/Modify dialog.
Note: When adding an SMB export, you must configure the Samba global settings on the Administration page in order for the export to work.
Note that contextual help is provided for these entries.
A confirmation message is displayed.
See the relevant information regarding NFS and SMB configuration in the Oracle Linux 7 System Administrator's Guide.
Shares can be archived and restored by using the OCI object storage service.
1. You can do either of the following:
$HOME/.oci/config
.2. Create a new bucket, or reuse an existing bucket, to store the archived objects in the OCI Object Store. See the Documentation for further details.
To archive a share, first select the share, then select the Backup option in the Actions drop-down list that is located on the Storage page.
The archive is then stored as a object in an OCI object store bucket.
Note: You do not need to modify the share's read or write settings in preparation for backup, as a temporary snapshot of the share is created, which enables the share to be used normally during backup.
Namespace information can be found on the Bucket Details page in the OCI console.
To restore a share, select the share, then select the Restore option in the Actions drop-down list that is located on the Storage page.
The archive will overwrite the current content for that share.
The Appliance page displays configuration information about the appliance, which includes the status of its main resources and the state of key services.
On the Appliance page, you can view the following information about the platform status for the appliance:
root
file system utilizationItems shown in Green indicate an Okay status for the appliance. Items shown in Red indicate a potential problem. To troubleshoot common issues, go to the Administration page. On this page, you can view log files and perform administrative actions such as reboot the appliance and restart NFS and SMB services.
The Administration page enables you to perform administrative actions, such as migrating one OCI compute instance to another OCI compute instance. You can also access and monitor log files for the appliance on this page, as well as perform several other administrative actions on the appliance.
System Logs
Provides access to the following log files and their location:
Note: Only the last 20 log entries are displayed.
System Actions
Enables you to perform the following actions on the appliance by clicking the button that corresponds to the specified option:
Click this button to immediately disconnect all of the currently running client sessions and reboot the system.
Click this button to update the system with the latest available security updates and appliance package version.
Click this button to prepare the appliance storage for safe migration to a new instance. Refer to the help for details about the migration procedure.
Click this button to restart the NFS service for the appliance.
Click this button to restart the SMB services for the appliance.
Click this button to enable a Ksplice auto update.
Click this button to set Samba-related global settings. Refer to inline help for more information.
User Actions
Enables you to perform the following actions on the appliance by clicking the button next to the specified option:
Click this button to change the Admin password.
Click this button to update the list of SSH public keys that are allowed to connect through SSH as the default user (opc) for the OCI instance.
Click this button to enter tenant credential details. These credentials are required to back up shares. See the Backup and Restore section for details.
Note: Modifying the appliance by using the command line is not supported. Only use this feature for recovery purposes or as directed by Oracle Support.
You can migrate one OCI compute instance to another OCI compute instance.
This feature is useful if any initial instance resources, such as OCPU or memory, are running out.
Caution: The initial instance will be unusable when the 'Prepare for migration' action is confirmed.
Caution: Migration only works for shapes that have remotely attached block volumes, not for DenseIO shapes with local NVMe devices.
The instance must meet the following requirements:
Note: The process of attaching the volumes may take a few minutes.
To enable Active Directory support after you upgrade from version 1.7.1 to version 1.8, all of the SMB exports that are present on the appliance must be updated.
For each SMB export on the appliance, do the following: