Creating a File System

• Console
• CLI
• API

• To create a file system, follow these steps:

  1. On the Lustre file systems list page, select Create. If you need help finding the list page, see Listing File Systems.
  2. In the Create Lustre file system panel, enter the following information:
     • File system name: Accept the default name or enter a friendly name for the file system. Avoid entering confidential information.
     • Mount name: Accept the default or enter a friendly name for use when mounting the file system. Lustre clients will use this name to reference the file system when mounting. Avoid entering confidential information.
     • File system description: Enter a description for the file system. Avoid entering confidential information.
     • Compartment: Accept the default compartment or select the list to change compartments.
     • Tags: (Optional) Add one or more tags to the file system. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
     • Availability domain: Accept the default AD or select the list to change availability domains.
     • Cluster placement group: We recommend selecting a cluster placement group to physically place file systems and other resources together in an availability domain to ensure low latency. The cluster placement group can't be changed after the file system is created. For more information, see Cluster Placement Groups
     • Performance tier: Select the performance tier for the file system. The performance tier controls the throughput of the file system. Throughput is specified per terabyte (TB) of provisioned storage. The performance tier can't be changed after the file system is created.
     • Capacity: Select the storage capacity of the file system. If you select a capacity larger than the service limit, you might be prompted to request an increase. For more information, see Increasing File System Capacity.

       The aggregate throughput of the file system is calculated from performance tier and capacity.

     • Networking: Select the VCN and subnet in which to mount the file system. We recommend that mounting the file system in the VCN and subnet where your workloads are running. By default, the Console shows a list of VCNs and subnets in the compartment you're working in.
     • Use network security groups to control traffic: Enable this option and select a network security group (NSG) to act as a virtual firewall for the file system. Select + Another network security group to add the file system to up to five NSGs. For more information, see Network Security Groups.
     • Root squash: These settings control whether clients accessing the file system have their User ID (UID) and Group ID (GID) remapped to Squash UID and Squash GID.
       • Squash: Select None or Root. The default value is None, so no remapping is done by default.
       • Squash UID: If Squash is set to Root, the root user (UID 0) is remapped to this value. The default value is 65534.
       • Squash GID: If Squash is set to Root, the root group user (GID 0) is remapped to this value. The default value is 65534.

       If you're squashing the root user, you can provide Root squash exceptions to exclude specific clients from the squash configuration. Enter the Client address that you want to exclude as a valid IP address or range. For example, 10.0.2.4 or 10.0.[2-10].[1-255]. Select + Another client address to add up to 10 exceptions.

     • Encryption key: By default, Oracle manages the keys that encrypt a file system. If you want greater control over the key's lifecycle and how it's used, you can select your own Vault encryption key.
  3. Select Create.

• Use the oci lfs lustre-file-system create command and required parameters to create a file system:

  oci lfs lustre-file-system create [OPTIONS]

  For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

• Run the CreateLustreFileSystem operation with required attributes to create a file system.

  For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.