Skip to main content
Version: 10.3

Syncing Configuration Files

The Open iT Core Server distributes configuration files upon periodic client requests. The distributed files include those listed in distreplace.xml and the files within the dist-config directory of the Core Server.

File Distribution​

The Core Server reads the list of configuration files in distreplace.xml in C:\Program Files\OpeniT\Core\Configuration\Components and copies the files from C:\Program Files\OpeniT\Core\Configuration\dist-config. The copied files, those listed in distreplace.xml and sourced from the dist-config folder, are then validated and compressed into a file named dist-config.<platform>.tar.gz and saved to the temp directory for distribution, which is by default in C:\Program Files\OpeniT\Core\Log\temp. This will prevent collection errors if a malformed XML file is sent to the client.

The distributable files have a default maximum age of 24 hours before creating a new one. However, if you make changes to the file(s) in the dist-config directory or distreplace.xml, the system will generate new distributable packages at the start of the next hour.

Suggested Reading: Configuring the Maximum Age of the dist-config Distributable

The connected clients request the compressed distributable file four times a day, at 12:00 AM, 6:00 AM, 12:00 PM, and 6:00 PM, and it saves it to C:\Program Files\OpeniT\Core\Log\temp.

Syncing Configuration Files

Syncing Configuration Files

Adding Files on the dist-config.<platform>.tar.gz Distributable​

Copy a file, following the directory structure on the server, to C:\Program Files\OpeniT\Core\Configuration\dist-config to add it to the distributable.

For example, save a file in C:\Program Files\OpeniT\Core\Configuration\dist-config\scheduler and it will be included in C:\Program Files\OpeniT\Core\Configuration\scheduler.

note

You need to add the files you want to distribute to Open iT version 6 clients to the distreplace.xml file.

Manually Creating and Downloading a Distributable Configuration Files Package​

Use this guide when you need to test new or modified configuration files on a specific client without waiting for the automatic distribution schedule.

Manually Creating a Distributable Configuration Files Package​

To ensure clients receive the latest distributable packages, run the update job in the Data Processing GUI before distributing the package.

This job also runs automatically every hour at the 55th minute. If the latest materialization is recent, you may not need to run it manually unless an immediate update is required.

Before you begin make sure you have:

  • Access to the Data Processing GUI
  • Verified that the latest files are already available

After confirming the prerequisites, proceed to run the update job in the Data Processing GUI to generate the latest version of the package.

Step 1. Open the Data Processing GUI.​

  1. Open the Data Processing GUI.

    This is usually accessible through: http(s)://<hostname>/dagster-webserver/

Step 2. Open the Catalog​

  1. From the sidebar, click Catalog.

  2. Select the core_create_dist job to update the distributable package.

    Alternatively, use the search bar at the top of the page, enter core_create_dist, then select the job from the results.

Step 3. Materialize the Job​

  1. In the upper-right corner of the page, click Materialize.

  2. Monitor the run and wait until the Latest Materialization timestamp is updated.

Manually Downloading the Distributable Configuration Files Package​

You can download the created distributable configuration files packages immediately by following these steps:

warning

Apply the configurations shown in the Open iT Core Client.

Step 1. Open Command Prompt​

  1. Open a command prompt with Administrator level privileges.

Step 2: Navigate to the bin Directory​

  1. Go to the bin directory.

    By default, this is located at: C:\Program Files\OpeniT\Core\bin.

  2. Run the command:

    Command Syntax
    cd <bin_dir>
    Example
    cd C:\Program Files\OpeniT\Core\bin

Step 3. Execute the Command​

  1. Run the command:

    Command Syntax
    openit_apicontroller.exe -t download_dist
note

This will only apply to the current client machine and will not affect other clients.

Files can also be distributed to specific client(s):

File Distribution via host-config.map