Connect:Direct transfer sites

To use the Connect:Direct protocol, you must install the Connect:Direct Java Application Interface (CDJAI.jar) in the <FILEDRIVEHOME>/lib/jars directory or any subdirectory on the server running SecureTransport. You cannot create or modify a Connect:Direct transfer site without installing the Connect:Direct Java Application Interface. The CDJAI.jar file is available as part of the Connect:Direct software.

Note Support for the NDM protocol through a Connect:Direct transfer site does not replace or append your Connect:Direct license.

You also need to manually configure some options in SecureTransport.

  1. Stop SecureTransport by running <FILEDRIVEHOME>/bin/stop_all.
  2. Copy the CDJAI.jar file to the <FILEDRIVEHOME>/lib/jars directory.
  3. If you are using the embedded database, run <FILEDRIVEHOME>/bin/start_db.
  4. Start the Administration Tool server by running <FILEDRIVEHOME>/bin/start_admin.
  5. Log in to the Administration Tool and select Operations > Server Configuration.
  6. The Server Configuration page is displayed.
  7. Search for the ConnectDirectTransferAgent parameters.
  8. Set ConnectDirectTransferAgent.transfersFolder to full path of the directory for the SecureTransport Server to use for the Connect:Direct transfers.
  9. Note The directory path is not relative to <FILEDRIVEHOME>. Specify a full absolute path from / (root) in UNIX or C:\ or another volume on Windows.
  10. Set ConnectDirectTransferAgent.commandTimeout to the interval in seconds that SecureTransport waits before the transfer times out.
  11. Create the directory for the SecureTransport Server to use for the Connect:Direct transfers on the server. Verify that SecureTransport has full permissions for the directory.
  12. Start SecureTransport by running <FILEDRIVEHOME>/bin/start_all.
  13. Enable the ConnectDirectTransfer rules package in the Rules Packages page of the Administration Tool.

The following table describes the Connect:Direct protocol options for a transfer site:

Field Description
Site Settings
Local server name Specifies the domain name or IP address of the local server. You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.
Local server port Specifies the port assigned to the local server. You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.
Site Login Credentials
Local server user name Username used to log in to the local server.
Local server password If the local server uses a password, select Use Password and enter the password in the field provided.
Send Options
Send Script

Specifies the Connect:Direct process to execute when uploading a file to a remote site. You must provide a script in for either the Send Options or the Receive Options. This field must contain a valid Connect:Direct process language script. You can use expression language variables such as ${stenv.target} in the script. For example, you can use the script field to execute a copy command. The remote server you are calling must be identified by its alias in the script.

To correctly identify the file name in a script you must use the variable ${cd_transfer_file}. The variable is required because the file names might not be known at the time you write the script.

When creating an upload script you must use ${cd_transfer_file} instead of the file name of the file being uploaded.

You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.

Receive Options
Receive Script

Specifies the Connect:Direct process to execute when downloading a file from a remote site. You must provide a script for either the Send Options or the Receive Options. This field must contain a valid Connect:Direct process language script. You can use expression language variables such as ${stenv.target} in the script. For example, you can use the script field to execute a copy command. The remote server you are calling must be identified by its alias in the script.

To correctly identify the file name in a script you must use the variable ${cd_transfer_file}. The variable is required because the file names might not be known at the time you write the script.

When creating a download script you must use ${cd_transfer_file} to specify the directory where downloaded files are saved. When downloading a single file, use ${cd_transfer_file}<path_separator><file_name>. For example, ${cd_transfer_file}/xls_sheet.xls.

You cannot enter spaces-only values in this field. For more information, see Spaces in required fields.

Note The Send Script and Receive Script accept regular expressions. For more information on writing Connect:Direct scripts, refer to the Connect:Direct documentation.

You can use a site template to define a Connect:Direct transfer site. For more information, see Site templates.

Related topics:

Related Links