# 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.

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.