We’re upgrading your documentation experience!

A new doc website is live at docs.openit.cloud — a temporary preview during our transition. This website is now in maintenance-only mode (only critical issues will be addressed).

Explore the new website and send us your feedback!

# File Distribution via host-config.map

# Introduction

The host-config.map file is used to distribute files to selected hosts in the network.

Apply the configurations shown in the Open iT server.

# Configuring `host-config.map`

Before modifying this file, make sure to put the file(s) to distribute in C:\Program Files\OpeniT\Core\Configuration\dist-config.

Open host-config.map in the dist-config directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\dist-config.

Notice that it contains instructions on how to edit the file.
Specify the source, destination, and the hosts with the following syntax:
```
MAP: $source ($destination)
Hostname.domain
```
The host-config.map uses C:\Program Files\OpeniT\Core\Configuration\ as the working directory. It is also allowed to use relative path for the source and destination. Variables like $CONF_DIR/$CONFIG_DIR, $BIN_DIR, and $ROOT_DIR can be used to set the full path.

For Open iT version 9.6, use the $CONF_DIR variable. Both $CONF_DIR and $CONFIG_DIR work on later versions.

Empty lines are allowed — any line beginning with # as the first non-white character is considered a comment. Globbing is also supported.
Example
```
MAP: lmutils/lmutil-v1.exe ($BIN_DIR/lmutil.exe)
host*windows.domain
```
This will create a copy of the file and replace the target file in all Windows host in the domain.

To change this behavior, open apicontroller.xml in C:\Program Files\OpeniT\Core\Configuration\Components and under download_dist, change the value of action to move. This will not replace the target file.
Save the changes.

Before modifying this file, make sure to put the file(s) to distribute in /var/opt/openit/etc/dist-config.

Open host-config.map in the dist-config directory, which is by default in /var/opt/openit/etc/dist-config.

Notice that it contains instructions on how to edit the file.
Specify the source, destination, and the hosts with the following syntax:
```
MAP: $source ($destination)
Hostname.domain
```
The host-config.map uses /var/opt/openit/etc/ as the working directory. It is also allowed to use relative path for the source and destination. Variables like $CONF_DIR/$CONFIG_DIR, $BIN_DIR, and $ROOT_DIR can be used to set the full path.

For Open iT version 9.6, use the $CONF_DIR variable. Both $CONF_DIR and $CONFIG_DIR work on later versions.

Empty lines are allowed — any line beginning with # as the first non-white character is considered a comment. Globbing is also supported.
Example
```
MAP: lmutils/lmutil-v1.exe ($BIN_DIR/lmutil.exe)
host*windows.domain
```
This will create a copy of the file and replace the target file in all Windows host in the domain.

To change this behavior, open apicontroller.xml in /var/opt/openit/etc/Components and under download_dist, change the value of action to move. This will not replace the target file.
Save the changes.

We’re upgrading your documentation experience!

# File Distribution via host-config.map

# Introduction

# Configuring host-config.map

# Configuring `host-config.map`