You must install Oracle Storage Cloud File Transfer Manager command-line interface (FTM CLI) first, and depending on your choice of authentication method, you might have to set up configuration files, or some environment variables.
System Requirements and Supported Platforms
Oracle Linux 6.3
Oracle Linux 6.5
Microsoft Windows 7
Ubuntu Desktop 14.04
JRE RequirementsEnsure that one of the following JREs is installed:
Obtaining Account Information
Identity Domain Name, User Name, and Password
After Oracle creates your account, you'll receive an email that contains your identity domain name, user name, and password for your Oracle Storage Cloud Service account.
If you can't find this email or didn't receive it, then contact your service administrator.
REST API Endpoint URL
Sign in to the Oracle Cloud My Services application. See Signing In to the My Services Application in Managing and Monitoring Oracle Cloud.
The My Services Dashboard is displayed. It lists the services that are assigned to your account.
Look for Oracle Storage Cloud Service.
From the Actions menu, select View Details. The Service Details page is displayed.
Look at the URL displayed in the REST Endpoint field under Additional Information.
REST Endpoint: https://acme.storage.oraclecloud.com/v1/Storage-acme
acmeis the identity domain name.
v1is the API version.
Storage-acmeis the account name.
Storageis the service name.
Note:The full REST API endpoint URL displayed in Oracle Cloud My Services will include the API version and the account name. But in the FTM CLI, use only the endpoint host name for the authentication URL as shown in bold in the prior example (
Getting Your Required Roles
To create, update, and delete the Oracle Compute Cloud Service containers, you must have the
To create, update, and delete the Oracle Compute Cloud Service objects, you must have the
To view or retrieve details of the objects or containers, you must have the
For more information, see About Oracle Storage Cloud Service Roles and Users in Using Oracle Storage Cloud Service.
If the required role isn't assigned to you or you're not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud My Services. See Modifying User Roles in Managing and Monitoring Oracle Cloud.
Obtaining the Oracle Storage Cloud File Transfer Manager CLI
To start using the CLI for the Oracle Storage Cloud Service, download the CLI client and store it at an appropriate location on the host.
- Download the FTM CLI client ftmcli.jar file from http://www.oracle.com/technetwork/topics/cloud/downloads/index.html.
- Save the file at an appropriate location on the local host, for example,
/home/jack/FTM_CLI/ftmcli.jar. Note that when you create the configuration file, you must store it at the same location. The CLI creates the
ftmcli.tracefiles at the same location. You can view the contents of these files to debug issues.
Executepermission to the
ftmcli.jarfile with the
Setting Up Configuration Files
To avoid entering the authentication information with every command, setting the environment variables at the start of every session, or updating the configuration file with new set of parameters, you can store combinations of parameters permanently in multiple configuration files. You can also set the default values of some of the parameters associated with the Oracle Storage Cloud File Transfer Manager command-line interface (FTM CLI) operation in the configuration file. By using the
--properties-file command option on the command-line, you can specify the service instance against which the command must run or the CLI parameters that the command must use by specifying the appropriate configuration file. To create a configuration file on the local host on which you downloaded the FTM CLI client:
- Store the following sample configuration file with a suitable name on your local host:
# url endpoint of the storage service auth-url=https://acme.storage.oraclecloud.com # service name service=Storage #identity domain name or tenent name identity-domain=acme # storage service user email@example.com # container for segments, if not specified <container>_segments is used segments-container=all_segments # segment size in MiBs segment-size=200 # number of retries retries=5 # maximum number of threads created to transfer file(s) max-threads=15 # storage Class (Archive or Standard) storage-class=Standard # Proxy Host #https-proxy-host = <proxy_host> # Proxy Port #https-proxy-port = <port_numbrt>
- Update the parameters in the configuration file as follows:
The REST API endpoint URL of your Oracle Storage Cloud Service instance.
Your user name.
You must have the appropriate role in Oracle Cloud My Services. See Getting Your Required Roles.
The cloud service name.
The default value is
The name of your identity domain.
The storage class.
By default, it’s set to
Standard, but you can also change it to
The maximum number of threads to be used in a request.
You can specify any value between 1 and 100. Depending on the speed and quality of the network, the FTM CLI may perform better with a different number of threads. By default, it’s set to 15.
The number of times that a request must be retried in case of failure.
By default, it’s set to 5.
The segment size in MB.
By default, it’s set to 200 MB.
The container in which the segments must be stored during the upload process.
By default, it’s set to
all_segments. If the segments container is not specified, then the segments are stored in the container
<container>is the name of the container specified to store the manifest object.
The proxy host and the proxy port.
The lines to set these parameters are excluded from execution by default. Include the lines by uncommenting them and set the values of the proxy host and the proxy port if necessary.
Caution:When you run a CLI command, if you specify the
--save-auth-keyoption, then the key to decrypt your saved password is stored in the configuration file, as the
auth-keyparameter. Don't remove or edit that parameter.
Note:To find out your account’s details like user name, password, identity domain, service name, and REST API endpoint URL, follow the instructions at Obtaining Account Information.
Setting Up the Required Environment Variables
To avoid entering the authentication URL, service name, and domain name with every command, you can store them in the environment variables once at the beginning of the session. The values of the environment variables are lost when the session ends.
The CLI gives higher priority to the environment variables than to the configuration file. The values set in the configuration file get picked up by the Oracle Storage Cloud File Transfer Manager command-line interface (FTM CLI) client if the environment variables haven't been set for the session.
To set the required environment variables on the host on which you downloaded the FTM CLI client:
- Store the REST API endpoint URL of your Oracle Storage Cloud Service instance in the environment variable
FTM_AUTH_URL.To find out the REST API endpoint URL of your site, follow the instructions at Obtaining Account Information.
- Store your user name in the environment variable
Note:You must have the appropriate role in Oracle Cloud My Services. See Getting Your Required Roles.
- Store the cloud service name in the environment variable
- Store the name of your identity domain in the environment variable
FTM_IDOMAIN.To find out your account’s identity domain name, follow the instructions at Obtaining Account Information.