Before You Begin

This 30-minute tutorial shows you how to create a file server for PeopleSoft Cloud Manager using the Oracle Cloud Infrastructure File Storage service.

Background

The PeopleSoft Cloud Manager file server is used with the Cloud Manager Repository feature to automatically download updates. You use the Cloud Manager Infrastructure Settings page to create a File Storage service file system.

The file system created in File Storage service is a cluster file system for managing general purpose file data stored outside an Oracle Database. The file system is accessed through a mount target. The file system must have at least one export in one mount target in order for instances to mount the file system.
The mount target provides the IP address or DNS name that is used in the mount command when connecting NFS clients to a file system. A single mount target can export many file systems. The export path controls how NFS clients access file systems when they connect to a mount target.

For more detailed explanations of the File Storage service concepts, see Overview of File Storage in the Oracle Cloud Infrastructure documentation.

Important!

You cannot use the File Storage service file system that you create for the Cloud Manager repository as the file system for a mid-tier node in a provisioned environment. See the tutorial Prepare to Install PeopleSoft Cloud Manager, Create a File Storage Service File System for Mid-tier Nodes.

Use one of the three methods in this tutorial to create the file server for Cloud Manager:

  • Create a new File Storage service file system, mount target, and export path
  • Create a new File Storage service file system on an existing mount target
  • Use an existing file system

The recommended approach is the first, to create a new file system, mount target, and export path. After you create the file system, see the PeopleSoft Cloud Manager documentation for information on working with the repository and file server.  To locate the documentation, select Online Help (HTML) or PeopleBooks (PDF) on the PeopleSoft Cloud Manager page on the Oracle Help Center.

Note:

You may see the abbreviation "FSS" in the documentation and on Cloud Manager pages. In those cases, FSS refers to the file system created in File Storage service for use with the Cloud Manager repository.

This is the thirteenth tutorial in the Install PeopleSoft Cloud Manager series. Read the tutorials in the order listed. The optional tutorials offer alternate methods for setup.

What Do You Need?

See the prerequisites in the tutorial Prepare to Install PeopleSoft Cloud Manager, Use the File Storage Service for the Repository.

This tutorial assumes that you have set up Cloud Manager and supplied the necessary information on the Settings and Infrastructure Settings pages, as described in the previous tutorials.

The following ports must be opened in the subnet for the File Storage service mount target.

  • TCP ports 111, 2048, 2049, and 2050
  • UDP ports 111 and 2048

See Configuring VCN Security List Rules for File Storage in the Oracle Cloud Infrastructure documentation.

Create a New File System, Mount Target, and Export Path

When you create a new file system, mount target, and export path for the Cloud Manager file server, the resources are created in the same compartment, availability domain, VCN, and subnet as the PeopleSoft Cloud Manager instance.

  1. Sign in to Cloud Manager in a browser using the Cloud Administrator user ID and password.
  2. On the home page, select the Cloud Manager Settings tile, and then select File Server from the left-hand panel.
  3. On the File Server page, select No for the Use existing file system switch.
  4. Enter a name for the file system.

    Use only lower-case letters, with no numbers or special characters. Initially, the field displays a default name based on the Cloud Manager instance name and domain. In the following illustration the name is cm-filesystem-infodev.

  5. Enter an export path, beginning with a slash (/).

    The field displays a default name based on the Cloud Manager instance name and domain. In the following illustration the Export is /cm-filesystem-export-infodev.

  6. Select No for the Use existing Mount Target switch.
  7. Enter a path for the new Mount Target.

    In the following illustration the mount target is mount-target.

  8. Click Create.
    File Server page, set up a new file system
    Description of this illustration (fileserverpage_new_filesystem.png)
  9. To monitor the status of the process, click More Info.

    The More Info Page lists the task and a status, such as Complete or Running, as shown in this example.

    More Info Page
    Description of this illustration (file_server_new_more_info.png)

    Note:

    If the file system creation failed, check the More Info page for information about the failure. If the mount process failed, you may be able to click a Reset button on the File Server page, so that you can reenter values and try again. The Reset feature does not remove any file system instances that the process has started to create. You must remove the failed file systems in the Oracle Cloud Infrastructure console.

    The file system is ready when the Fss Status on the File Server page changes to FSS Configured.

  10. If you want to view the file system in the Oracle Cloud Infrastructure Console, under Core Infrastructure, select File Storage > File Systems, and select the compartment.

Create a New File System on an Existing Mount Target

Use this procedure if you already have an existing mount target that you want to use for the file system. You may need to use an existing mount target, for example, if you have reached the mount target limit in your tenancy. 

See Service Limits in the Oracle Cloud Infrastructure Documentation.

You must ensure that the existing File Storage service mount target is in the same availability domain, VCN, and availability domain-specific subnet as the Cloud Manager instance.

If the existing File Storage service mount target is within a regional subnet, however, you can create the Cloud Manager instance in any of the availability domains spanned by the regional subnet.

  1. Make a note of the mount target name.

    See Managing Mount Targets in the Oracle Cloud Infrastructure Documentation.

  2. Sign in to Cloud Manager in a browser using the Cloud Administrator user ID and password.
  3. On the home page, select the Cloud Manager Settings tile, and then select Infrastructure Settings from the left-hand panel.
  4. Verify that the information on the page is correct, and then click Save and Refresh OCI Metadata, so that the existing Mount Targets will be available in the next step.
  5. Select File Server from the left-hand panel.
  6. On the File Server page, select No for the Use existing file system switch.
  7. Enter a name for the file system.

    Use only lower-case letters, with no numbers or special characters. Initially, the field displays a default name based on the Cloud Manager instance name and domain. In the following illustration the name is cm-filesystem-infodev.

  8. Enter an export path, beginning with a slash (/).

    The field displays a default name based on the Cloud Manager instance name and domain. In the following illustration the Export is /cm-filesystem-export-infodev.

  9. Select Yes for the Use existing Mount Target switch.
  10. Select a mount target from the Use existing Mount Target drop-down list.

    Note:

    If you do not see an existing mount target, you may need to wait a few minutes and click Refresh OCI Metadata on the Infrastructure Settings page again.

    Cloud Manager displays the Mount Target OCID, Availability Domain, and Compartment OCID. In the following illustration the mount target is mount-target.

  11. Click Create.
    File Server page, set up a file system with an existing mount target
    Description of this illustration (fileserverpage_existing_mount_target.png)
  12. To monitor the status of the process, click More Info.

    The file system is ready when the Fss Status changes to FSS Configured, as shown in this example.

    File Server page with file system status Configured
    Description of this illustration (fileserverpage_existing_mount_target_complete.png)

Use an Existing File System

Use these instructions with a File Storage service file system created with another Cloud Manager instance. For example, you have a Cloud Manager instance set up and have downloaded various items in the Repository. You want to remove the first Cloud Manager, but you want to retain the downloaded items in the repository. In this case, after you remove the first Cloud Manager instance, you can create a new Cloud Manager instance and attach the File Storage service file system from the first Cloud Manager instance. This process makes all the items that you had downloaded previously visible in the new instance repository.

Note:

This procedure does not apply to file systems created independently of Cloud Manager.

You must ensure that the File Storage service mount target associated with this file system is in the same availability domain, VCN, and availability domain-specific subnet as the Cloud Manager instance.

If the existing File Storage service mount target is within a regional subnet, however, you can create the Cloud Manager instance in any of the availability domains spanned by the regional subnet.

  1. Obtain the information about the existing file system.

    You will need the IP address for the mount target. You will also need the full name and domain for the export.

  2. Sign in to Cloud Manager in a browser using the Cloud Administrator user ID and password.
  3. On the home page, select the Cloud Manager Settings tile, and then select File Server from the left-hand panel.
  4. Select Yes for the Use existing file system switch.
  5. In the Existing Mount path field, enter a mount target and export path, using the following format:

    <Mount Target IP address>:/<File System Export Path>

    The mount path in this example is 10.x.x.x:/cm-filesystem-export.regsubnet.pscmnetwork.oraclevcn.com.

    File Server page for existing file system
    Description of this illustration (fileserverpage_existing_filesystem.png)
  6. Click Create.
  7. To monitor the status of the process, click More Info.

    The file system is ready when the Fss Status on the File Server page changes to FSS Configured.

Next Steps

Manage Cloud Manager Users, Roles, and Permission Lists

Learn More