#Sending Miscellaneous Files to Server

The API Controller offers the added benefit of enabling clients to transmit non-Open iT related files to the server. This feature is particularly advantageous in scenarios where clients are required to send mapping files from their local machines. Currently, clients are only allowed to send files only from a single directory to the server. While this limitation is in effect, users may need to consolidate relevant files into a specific directory for seamless transmission.

To configure sending of files to the server:

Windows

Unix

macOS

On the client machine, open apicontroller.xml in the Components directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\Components.

Locate object node upload_misc and set the value of its subobject node dir to the path of the directory containing the miscellaneous files.

apicontroller.xml
<Name>upload_misc</Name>
<Description>Upload miscellaneous files</Description>
<SubObjects>
      ...
   <Object>
       <Name>dir</Name>
       <Description>Directory where to find upload files</Description>
       <Value type="DirName">/custom/path/to/misc/files</Value>
   </Object>
 

Example: apicontroller.xml
<Name>upload_misc</Name>
<Description>Upload miscellaneous files</Description>
<SubObjects>
      ...
   <Object>
       <Name>dir</Name>
       <Description>Directory where to find upload files</Description>
       <Value type="DirName">C:\Users\OpeniT\Documents\LocalMappings</Value>
   </Object>
 

Save the file.
Open a command prompt with Administrator level privileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```
Update the configuration file, run the command:
Command Syntax
```
 openit_confbuilder.exe --client
```

The files from the client will be uploaded to the server in $ROOT_DATA_DIR\misc, which is by default in C:\ProgramData\OpeniT\Data\misc.

#Retaining Client Source Files

The API Controller deletes the source files upon sending them to the server by default. However, in the case of sending miscellaneous files to the server, it is not advisable to delete the source file upon sending. Instead, it is recommended to retain the source files to ensure data integrity and avoid unintended loss.

The retention of client source files is enabled by default. If disabled, follow these instructions to enable:

Windows

Unix

macOS

On the client machine, open apicontroller.xml in the Components directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\Components.

Locate object node upload_misc and make sure the value of its subobject node keep_data is true.

apicontroller.xml
<Name>upload_misc</Name>
<Description>Upload miscellaneous files</Description>
<SubObjects>
      ...
   <Object>
       <Name>keep_data</Name>
       <Description>Override deleting of source file</Description>
       <Value type="DirName">true</Value>
   </Object>
 

Save the changes.
Open a command prompt with Administrator level privileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```
Update the configuration file, run the command:
Command Syntax
```
 openit_confbuilder.exe --client
```

#Enabling Scheduler to Send Files to Server

By default, this scheduler job is not enabled. If enabled, the API Controller will send the client files to the server once a day.

Follow these instructions to enable:

Windows

Unix

macOS

Open a command prompt with Administrator level privileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```

Once in the directory, activate the sending of miscellaneous files, run the command:

Command Syntax


openit_oconfinit -u "transfer_misc_files.root.scheduler.jobs.transfer_misc_files.general.active=true"

#Force Send Client Files to Server

After configuring the APIController, you can force the client to send files to the server:

Windows

Unix

macOS

Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```
Run the following command:
Command Syntax
```
openit_apicontroller.exe -t upload_misc
```
Check that the files from the client are uploaded to the server in $ROOT_DATA_DIR\misc, which is by default in C:\ProgramData\OpeniT\Data\misc.