Creating a File System

• Console
• CLI
• API

• 1. In the Compute Cloud@Customer Console navigation menu, click File Storage, then click File Systems.

  2. Ensure that the correct compartment is selected in the compartment drop-down menu above the file systems list. The file system and mount target must be in the same compartment and the same backing store pool when you create an export.

  3. Click Create File System.

  4. In the Create File System dialog box, enter the following information:

     • Name: It doesn't have to be unique. An Oracle Cloud Identifier (OCID) uniquely identifies the file system. Avoid entering confidential information.

     • Create in Compartment: Select the compartment where the file system is created.

     • Tagging: (Optional) Add one or more tags to this resource. Tags can also be applied later. For more information about tagging resources, see Resource Tags.

       To use nondefault values for the quota, database record size, or backend store pool, specify the appropriate tags to set the values for these attributes. See Adding Tags at Resource Creation.

  5. Click Create File System.

     The file system is created.

     Next, create an export for the file system. See Creating an Export for a File System.

• Use the oci fs file-system create command and required parameters to create a new file system in the specified compartment and availability domain.

  oci fs file-system create --availability-domain <availability_domain_name>  --compartment-id <compartment_id> --display-name <fs_display_name>  [OPTIONS]

  For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  Procedure

  1. Gather the information that you need to run the command:

     • Availability Domain Name (oci iam availability-domain list)

     • Compartment OCID (oci iam compartment list)

     • File System Name: The display name you want assigned to this file system

  2. To use nondefault values for the quota, database record size, or backend store pool, specify the appropriate tags to set the values for these attributes. See Adding Tags at Resource Creation.

     See the following step for an example of setting these values.

  3. Run the create file system command.

     Example:

     oci fs file-system create --availability-domain AD-1 --compartment-id ocid1.compartment.unique_ID --display-name MyFileSystem
     
     {
       "data": {
         "availability-domain": "AD-1",
         "compartment-id": "ocid1.compartment.unique_ID",
         "defined-tags": {
           "Oracle-Tags": {
             "CreatedBy": "pca_user",
             "CreatedOn": "2024-07-05T13:15:11.19Z"
           }
         },
         "display-name": "MyFileSystem",
         "freeform-tags": {},
         "id": "ocid1.filesystem.unique_ID",
         "is-clone-parent": false,
         "is-hydrated": true,
         "is-targetable": null,
         "kms-key-id": "",
         "lifecycle-details": "",
         "lifecycle-state": "CREATING",
         "metered-bytes": 0,
         "source-details": {
           "parent-file-system-id": "",
           "source-snapshot-id": ""
         },
         "time-created": "2024-07-05T13:15:11.234434+00:00"
       },
       "etag": "58dec47e-4732-4730-9e18-6b5db1ac30d6"
     }

     Example using defined tags to set additional properties:

     To set a quota for the file system, change the default database record size, or specify a high performance pool for the file system backing store, use OraclePCA defined tags as shown in the following example.

     oci fs file-system create --availability-domain AD-1 --compartment-id ocid1.compartment.unique_ID  --display-name myfilesystem --defined-tags '{"OraclePCA":{"quota":100000,"databaseRecordSize":8192,"poolName":"PCA_POOL_HIGH"}}'

     Alternatively, you can specify these properties in a JSON file.

     {
       "OraclePCA": {
         "quota": 100000,
         "databaseRecordSize": 8192,
         "poolName": "PCA_POOL_HIGH"
       }
     }

     Then specify the file as the argument of the --defined-tags option.

     --defined-tags file://./fs_options.json

  4. Next, create an export for the file system. See Creating an Export for a File System.

• Use the CreateFileSystem operation to create a new file system in the specified compartment and availability domain.

  For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.