This article describes how to log into your OVF Package staging folder using FTPS. The OVF Package staging folder is used for uploading and downloading Client Image import and export OVF, MF, and VMDK files.
- You will need FTPS-compatible client software
- FileZilla (cross-platform) is used in the example screenshots in this article, but any FTP client supporting FTPS with "Explicit" mode authentication should be usable.
- We have also included an example using the Linux lftp command line tool
- Some clients will require you to accept the certificate offered by the Server on your initial connection.
Note: When uploading an OVF Package to the FTPS servers, CloudControl will use the 'last modified' date of the OVF file as a base to determine expiration. This means that if an Image has a 'last modified' date that is past the allowable timeframe, it will be blocked from import and be subject to removal from the servers. Most FTP Client applications, such as WinSCP, Filezilla, CuteFTP or Cyberduck, default to preserving file modification times when uploading or downloading files. If you disable this setting, the file's modification time will be set to the date and time that you upload the file. Below is an example from WinSCP:
- You will need your Cloud user credentials to log into your OVF Package staging folder using FTPS. Note that usernames are case-sensitive (e.g. joeuser is not the same as Joeuser.)
How To Identify The OVF Package Staging Folder Location
There is a separate FTPS folder in each Geographic Region. From the Home page, click on the Compute button and select Support and Additional URLs from the drop-down menu:
The Support and Additional URLs page will be displayed. Click on the FTPS Details tab. The FTPS Details will be displayed, which lists the FTPS URL for each Region:
Copy the FTPS URL for the desired Geographic Region to your clipboard:
Additional Notes About Your OVF Package Staging Folders
- Your OVF Package folder is the location from which the output files for each completed Client Image Export are downloaded to your local system. See How to Export a Client Image to an OVF Package
- Your OVF Package folder is the destination folder for uploads of OVF Package files for each Client Image you want to import. Uploaded OVF Packages will appear in the Image Import dialog as available images for import. See How to Import an OVF Package as a Client Image
- All files in your OVF Package are subject to a two-week time limit after which the system will remove them as part of its internal housekeeping cycle. It is important to import uploaded OVF files and/or download complete exports promptly for this reason.
How To Connect To The OVF Package Staging Folder Location Using FileZilla
Open your FTPS client and create a new bookmark/shortcut. Use the URL you copied into the clipboard in the previous step as the host to connect to:
The connection type is TLS/SSL in "Explicit" mode. In most clients, the port field can be left blank to use the default value, however, if it is required enter "21" as the connection port.
Set the Logon Type to Normal.
Use your CloudControl credentials for the User and Password (ie the credentials you use to log in to your Cloud Account)
When connected, your OVF Package staging folder is displayed.
Note: If you have already performed an export of a Client Image and it is complete, or if another Administrator for your organization has already logged in and uploaded files in preparation for performing a Client Image import, files may already be present in your folder.
How To Connect To The OVF Package Staging Folder Location Using lft
The lftp program is a command line ftp client that supports encrypted channels (both command and data channels.) It can be found in the base repositories for Redhat (and, by extension, CentOS) If your Linux distribution does not have it readily available, the source code and some binaries can be found at http://lftp.yar.ru (if you compile the source code, be sure to use the --with-openssl configure option.)
lftp has many features to support reliable transfers, mirroring and scripting of actions. This article will not go into any detail on these features but only provide a quick guide to demonstrate a scripted upload of files.
To script the uploading of files, create a plain text document and put the commands in that you would normally type into the client. If you include your password, be sure to safeguard the script from unauthorized access. If the password is not present, you will get prompted for it. For this example, the files to upload are in a subdirectory named 'import1':
The open command identifies the site to connect to.
The user command specifies the username and, optionally, the password to connect with.
The lcd command changes the local directory. It does not change the directory on the ftp server.
The put commands initiate the transfer of the named files.
The bye command terminates the connection to the site.
To use the script, simply use the -f parameter to lftp:
The lftp program will display the progress of any transfers while it's running. Once all transfers are complete, it terminates. No additional output is printed.