File Server FAQ
Find answers to common questions about File Server and its capabilities in Oracle Integration.
Availability and Limits FAQs
Is File Server Available to Me?
File Server is available for new and existing Oracle Integration 3 instances in all regions.
File Server is available with the Standard, Enterprise, and Healthcare Editions of Oracle Integration.
Additionally, File Server is available in both Oracle Integration and Oracle Integration for SaaS.
Is File Server Enabled by Default?
No, but your organization enable it at any time.
If you're an administrator, when you click Settings in the navigation pane, the File Server menu option is visible. If your organization hasn't enabled File Server yet and you click the menu option, you see directions for enabling it in the Oracle Cloud Infrastructure Console. See Enable File Server.
How Is File Server Metered?
There is no extra cost associated with File Server.
When using the FTP Adapter or File server action to write files in File Server, the standard pricing applies. Any file read or write over 50KB is considered a message. For example, 110KB is considered 3 messages (50KB each).
For information on File Server usage, see Monitoring Billable Messages in Provisioning and Administering Oracle Integration 3.
How Much Storage Is Allowed, and What Is the Size Limit for Files?
Each File Server service instance provides 500GB of storage. If you reach this limit, any calls to write files to File Server fail.
When accessing File Server from an integration in Oracle Integration, you can use the use the FTP Adapter or the File server action. For both options, the file limit is 1 GB.
When you upload and download files using an SFTP client, files can be of any size, as long as they do not exceed your allocated storage limits.
How Many Concurrent Connections Can I Have?
You can have a maximum of 50 connections per service instance.
When you use the FTP Adapter to connect to File Server, you don't need to worry about connections remaining live throughout the instance flow. That's because connections are closed in the FTP Adapter immediately after the interaction completes, regardless of whether the interaction was done using parallel processing or sequential processing. However, keep in mind that if an integration has a for-loop with parallel processing, and the for-loop contains a trigger or invoke action in which the FTP Adapter connects to File Server, every iteration of the for-loop is counted as an individual connection while the connection is open.
-
Example 1: 50 simultaneous connections from an SFTP client
-
Example 2: 30 simultaneous connections from an SFTP client, and 20 connections from the Integration FTP Adapter (1 for each FTP connection)
Can I Update the Same File Using Multiple Integrations?
Yes, but you might experience issues under some circumstances.
For example, if one or more integrations attempt to update the same file by appending data to it, and the updates occur in parallel, leading to changing the file simultaneously, all data is sometimes removed from the file. The empty file can then cause one or more integrations to fail because the integrations expect the file to contain data.
Security and Access FAQs
Can I Create an Allowlist for File Server?
Yes. You must create an allowlist (formerly a whitelist) that identifies the entities that are explicitly allowed access to File Server. Only users from the entities that you specify can connect to File Server. Tenant administrators are responsible for creating the allowlist.
How to manage the allowlist: If you're responsible for managing the allowlist for HTTP connections, you already know how to manage the allowlist for File Server. Follow the same steps to manage both lists. For instructions, see Configure an Allowlist for Your Instance in Provisioning and Administering Oracle Integration 3.
How Are Files Protected?
Oracle applies fine-grained user access to control access to files in File Server. Files are encrypted on the disk.
What Encryption Options Are Available When Reading and Writing Files?
You have the following options for accessing files from File Server:
-
File server action
Encryption and decryption are currently not supported for the File server action. However, you can use the File server action with the stage file action to achieve these goals. See Interact with Files in File Server in Using Integrations in Oracle Integration 3.
-
FTP Adapter
Leverage the encryption and decryption features supported by the FTP Adapter. The FTP Adapter supports Pretty Good Privacy (PGP) encryption, which enables you to:
- Encrypt a file that is being uploaded to remote FTP/SFTP servers using Pretty Good Privacy (PGP) cryptography.
- Decrypt a file that is being read or downloaded from a remote FTP/SFTP server using Pretty Good Privacy (PGP) cryptography.
Learn more about the FTP Adapter encryption in FTP Adapter Encryption Decryption in Using the FTP Adapter with Oracle Integration 3.
What File Signing and Verification Options Are Available?
You can perform signing using the private key to allow the receiver to verify that the file contents were not altered during transit. You can also perform signature verification using the public key on the incoming file to verify that the contents were not altered during transit.
You have the following options:
-
File server action
File signing and verification are currently not supported for the File server action. However, you can use the File server action with the stage file action to achieve these goals. See Interact with Files in File Server in Using Integrations in Oracle Integration 3.
-
FTP Adapter
Leverage the file signing and verification features supported by the FTP Adapter. Learn more about the FTP Adapter encryption in FTP Adapter Encryption Decryption in Using the FTP Adapter with Oracle Integration 3.
How Do I Access File Server Administration?
To access File Server administration in Oracle Integration, you must be an Oracle Integration administrator assigned the ServiceAdministrator role. In the navigation pane, click Settings, then File Server.
Can Administrators See the Files in File Server Folders?
Yes. When you open a folder on the Files page, a list of its files and folders is displayed. You can sort and filter the list.
Where Are Users and Groups Stored, and How Are They Managed?
Users and groups are stored in Oracle Cloud Infrastructure Identity and Access Management (IAM). After an administrator configures the users and groups, a File Server administrator can configure their access to File Server.
What Roles Do Administrators Need?
Oracle Integration users must be assigned the ServiceAdministrator role to grant access to File Server.
Where Do I View Audit and Log Information?
Audit and log information is available for several types of interactions:
-
Actions that a person completes in the user interface
All actions that you perform in the File Server user interface, such as disabling a user or creating a folder, are logged in the Design Time Audit. See Check the Audit History for an Integration or Other Component in Using Integrations in Oracle Integration 3.
-
Actions that an integration performs
For all File Server interactions done through an integration, view log information under Integrations observability options.
-
Actions performed from an SFTP client
View the logs in the SFTP client.
Other File Server interactions aren't logged.
How Do Integrations and People Connect to File Server?
Integrations connect to File Server using either of the following options:
-
File server action
See Interact with Files in File Server in Using Integrations in Oracle Integration 3.
-
FTP Adapter
People connect to File Server in different ways, depending upon their roles:
-
Administrators can use the interface in Oracle Cloud Infrastructure Console or the File Server REST APIs.
-
Anyone who wants to transfer files manually can use a supported SFTP client or an SFTP command line interface.
Which SFTP Clients Are Supported?
The File Server capabilities are compatible with commonly used SFTP clients.
Can I Connect to File Server Using the File Adapter?
No. To connect to File Server, use the File server action or the FTP Adapter.
If I Use File Server, Can I Enable Multi-Factor Authentication (MFA) in Oracle Cloud Infrastructure Identity and Access Management (IAM)?
No. MFA is not supported for File Server.
Usage FAQs
How Do I Clean Up Files?
Need to remove or organize the files in File Server? You have a couple options.
The simpler option is to use any standalone (UI-based or command line) SFTP client. Use the connection settings on the Settings page (In the navigation pane, click Settings, then File Server, then Settings.). To delete files at regular intervals, work in the command line and write a script that invokes SFTP commands to delete folders. When using a UI-based SFTP client, use the options made available by that specific client to delete folders and files.
- Use the File Server REST API to clean up folders and
files.
You can't use the REST API to delete a single file.
- Create an integration that obtains the list of files on the server and then deletes them. Schedule the integration, if needed.
Which Activities in File Server Raise System Events?
Several activities in File Server raise system events. You can design an event integration that subscribes to a system event, and then the integration then runs whenever the activity occurs in File Server.
For example, subscribe to the File created system event to run an integration when a file is added to File Server.
The following activities in File Server raise a system event.
System event name | Activity that raises the event |
---|---|
File created |
Creating a file Note: A system event currently isn't raised when you create a file using the File server action. All other methods of creating a file do raise an event. |
File deleted |
Deleting a file Note: A system event currently isn't raised when you delete a file using the File server action. All other methods of deleting a file do raise an event. |
File downloaded |
Downloading a file Note: A system event currently isn't raised when you download a file using the File server action. All other methods of downloading a file do raise an event. |
Folder created |
Creating a folder |
Folder deleted |
Deleting a folder |
For a sample use case, see Subscribe to a File Server System Event.