Post installation

After installing Transfer CFT, but before starting Transfer CFT and the Copilot server, you may need to perform the following tasks:

Otherwise you can go to:

For information on user rights, refer to the topic Defining user rights UNIX.

Installed directories

When you install Transfer CFT, the home directory is created and populated under the Transfer_CFT installation directory. This home directory contains installation libraries, binaries, and templates. Do not store any personal files in the home directory, as they are erased during updates.

Standalone installations

If you are not using Transfer CFT with Central Governance, you must provide a certificate in order to be able to use the Transfer CFT UI. See Using the web-based browser UI page for details.

Perform an update

If you need to apply service packs or patches, refer to Update Transfer CFT.

If you have already started Transfer CFT or Copilot, stop these servers prior to performing an update.

Create a basic configuration

This section describes how to create a basic Transfer CFT configuration if you did not do so during the installation process. If you started Transfer CFT or Copilot, stop these servers before modifying the configuration.

Update the profile

To add environment variables to your Transfer CFT profile edit the following script:

  • Windows:  <CFTDIRRUNTIME>\profile.bat
  • UNIX: ./<CFTDIRRUNTIME>/profile


To determine the Transfer CFT variable values list the values using the command:

CFTUTIL listuconf

To change or update a value, start the Transfer CFT profile and make modifications using either the Transfer CFT Copilot UI or command line UCONF tools. Refer to Transfer CFT online documentation for details.

For example, to change the user interface port:

CFTUTIL uconfset id=copilot.general.serverport,value=1766


Before you can start Transfer CFT for the first time, Transfer CFT must have a basic configuration. Typically this is created during installation or migration.

License key

If you did not enter the license key during installation, you can enter it post installation in the cft.key file located in: <CFTDIRRUNTIME>/conf/

You can enter a single key or a list of keys in this file. In the configuration default file, the variable <$CFTKEY> represents the cft.key file.

Transfer CFT internal datafile and configuration

Check the values, especially the key value, hostname, and port for TCP, in the following file:

  • Windows and UNIX: <CFTRUNTIME>/conf/cft-tcp.conf

Start the Transfer CFT profile and, to create the Transfer CFT internal datafile and update the basic configuration, execute:

cftinit cft-tcp.conf

To update the configuration at a later date, execute:

cftupdate cft-tcp.conf

User interface configuration

To view the Copilot user interface configuration, execute:


To change this configuration, you update the hostname and listening port for Transfer CFT UI using CFTUTIL uconfset.


CFTUTIL uconfset id=copilot.general.serverhost, value=""

CFTUTIL uconfset id=copilot.general.serverport, value="7000"

Configuration for Service Mode

This option is only available on Windows systems and must be selected during the installation process configuration.

Start the Transfer CFT Copilot server

If you have implemented Central Governance, starting Copilot launches the registration process. For more information, see the topic Registration overview.


  1. Change directory to the runtime.
  2. Execute profile.bat.
  3. To start the Copilot server, enter: copstart
  4. To check the Copilot status, enter: copstatus -v



. . /profile



Start Transfer CFT

If you have implemented Central Governance, you can start and stop Transfer CFT via the Central Unified Flow Management user interface. Otherwise perform the following command from the Transfer CFT runtime directory.


cft start

Service mode set up when using Central Governance

Since you can start or restart a registered Transfer CFT from Central Governance, when using service mode you must set the CFT UI service account so that it can start the CFT service. Therefore, perform one of the following two tasks:

  • Add the account to the CFT server's Local Administrator Group, or
  • Provide the rights to start the Transfer CFT Service as a non Local Admin user:
    • Use a Sysinternals utility such as Process Explorer to change Windows service permissions. Run Process Explorer as administrator and locate the CFT service (CFTSRVLD.exe) process.
    • Open the process properties and click the Services tab. Click the Permissions button and add the user or group in the opened window. Then select the permissions that you want to assign (Full Control) and click OK to save.

Register with Central Governance

If you intend to implement Central Governance, please refer to the Transfer CFT User's Guide > Register with Central Governance page for registration details.

Related Links