Creating Multiple Configurations

The cdfa -g command creates multiple configuration files for implementations with a large number of Sterling Connect:Direct® File Agent sites. This command uses a configuration template and a text-based build file to create the configuration files, which can then be sent through e-mail to client sites. This reduces the amount of configuration that the Sterling Connect:Direct File Agent site must perform.

In the following procedure, assume that you want to create three new configuration files for distribution named FA1, FA2, and FA3.

  1. Use the configuration interface to create a configuration named Template. (Name it whatever you want.)
  2. Modify the Template configuration settings as necessary for your site. However, type variables into the following fields:
    Tab Field Variable
    File Agent Password for API &passwd.
      API host DNS name &netmap.

    Variables are user-defined. See Configuration Template Variable Rules for more information about variables.

  3. Save the Template configuration file.
  4. Use a text editor to create a configuration build file named build.cfg. (Give the file any name you want.)
  5. Insert the following text into the build.cfg file. Bold text indicates the values to change for each client. 
    #FA1's unique configuration
copy Template
&passwd=PROCEED1
&netmap=CDFA1
save FA1
#FA2's unique configuration
copy Template
&passwd=FORWARD23
&netmap=CDFA2
save FA2
#FA3's unique configuration
copy Template
&passwd=MUSTER43
&netmap=CDFA3
save FA3

    See Configuration Build File Variable Rules for build file syntax.

  6. Save the build.cfg file in any directory. In this example, it is saved in the c:\ directory.
  7. Change your directory to the Sterling Connect:Direct for UNIX installation directory.
  8. Type cdfa -g c:\build.cfg at a command prompt. Be sure to specify the complete path to the build.cfg file. This command is case-sensitive.

    Using this example, Sterling Connect:Direct File Agent builds three new configuration files based on the values in the template and the build.cfg file. You should now have five configuration files in the File Agent directory:

    • Default_Config.ser
    • FA1.ser
    • FA2.ser
    • FA3.ser
    • Template.ser
  9. E-mail the FA1.ser, FA2.ser, and FA3.ser configuration files to the appropriate Sterling Connect:Direct File Agent client site, with the following instructions:
    • Copy the configuration file into the File Agent directory.
    • Rename the configuration file to Default_Config.ser.