Working with basic functions

This module helps you update and validate configuration.

Updating the configuration

To update the configuration file, do the following steps:
  1. Open the Dataflowsconfig.xml file in your preferred text editor.

    By default, the file is found at C:\Program Files\HCL\IntegrationServices\src\Dataflowsconfig.xml.

  2. Edit the file and save the changes.
  3. In the CLI, run the --ValidateConfiguration command.
  4. Resolve issues found, if any.
  5. Restart the service to import the new configuration.

Updating the credentials

If you need to change the credentials for a data source, access the Integration Service CLI with the ProvideCredentials command. You can supply an additional command line parameter to key in a specific data source to modify; otherwise, you are prompted to enter a user name and password.

To update the credentials, do the following steps:
  1. Open the Integration Services CLI. By the default, the executable is found at C:\Program Files\IntegrationServices\DataFlows.exe.
  2. Run the following command: --ProvideCredentials.
  3. Enter the credentials for the data source:
    • Username
    • Password
  4. Enter the BigFix REST API credentials:
    • Username
    • Password

Upon successful update, the following message appears at the command prompt: "The entered credentials are encrypted successfully".

Note: The password field appears blank even after you enter the password.

Initializing Schema

Purpose: This step initializes the analysis in BigFix.
  1. Navigate to the installation directory and run \Dataflow.exe --InitializeSchemas command.

    When successful, the message 'Schema Initialized Successfully!' appears in the command prompt.

Validating the configuration

Validating the configuration involves validating the credentials, data flows, duplicate column names and properties of the configuration. In the CLI, run the --ValidateConfiguration command. Upon successful completion, the following message appears: "Configuration verified successfully".

Configuring the solution

The default configuration file provides for bi-directional configuration, which synchronizes common properties across both the systems. The default mapping of properties could be customized to meet the unique needs of each environment.
  • Configure the connection string of each data source in the default configuration file.
  • Use the CLI to provide credentials and validate the document. For details, click link.
  • Use the CLI to start the service. For details, click link.
Note: The base configuration is set to Preview Mode by default.