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!

# Configuring Access to the Open iT Shared Software Assets Directory (SSAD)

# Activating the Shared Software Assets Directory (SSAD) Feature

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

Once in the directory, run the command:

Command Syntax
activate_ssad.bat true

The following arguments are available when running the activate_ssad script.

Argument	Description
`true`	Use this to activate the SSAD jobs and configurations.
`false`	Use this to deactivate the SSAD jobs and configurations.

Available Arguments for activate_ssad

You may also use the following options for activate_ssad.

Option	Description
`--loglevel`	Use this to print out usable logs for debugging the program.
`--help` or `-?`	Use this to print out the notes and list of options to activate/deactivate the SSAD feature.

Available Options for activate_ssad

Open a command prompt with Administrator level privileges.
Go to the contrib\bin directory, which is by default in /opt/openit/contrib/bin, run the command:
Command Syntax
```
cd $ROOT_DIR/contrib/bin
```
Example
```
cd /opt/openit/contrib/bin
```

Once in the directory, run the command:

Command Syntax
./activate_ssad.pl true

The following arguments are available when running the activate_ssad script.

Argument	Description
`true`	Use this to activate the SSAD jobs and configurations.
`false`	Use this to deactivate the SSAD jobs and configurations.

Available Arguments for activate_ssad

You may also use the following options for activate_ssad.

Option	Description
`--loglevel`	Use this to print out usable logs for debugging the program.
`--help` or `-?`	Use this to print out the notes and list of options to activate/deactivate the SSAD feature.

Available Options for activate_ssad

Change the file ownership by running the command:
Command Syntax
```
chown -R [openit_user]:[openit_group] /var/opt/openit/etc
```
where:

Argument Description

[openit_user] Use this to indicate the user name.

[openit_group] Use this to indicate the group name.

Arguments to Change File Ownership
Example
```
chown -R openit:openit /var/opt/openit/etc
```
Verify that the file ownership of data_generation_config is changed. Run the command:
Command Syntax
```
ls -l /var/opt/openit/etc | grep data_generation_config
```
This displays detailed information about the data_generation_config file.
Example Output
```
-rw-r--r-- 1 openit openit 8954 Apr 29 11:25 data_generation_config
```
Verify that the file ownership of core_mapping_ssad.oconf is changed. Run the command:
Command Syntax
```
ls -l /var/opt/openit/etc/scheduler | grep ssad
```
This should display detailed information about the core_mapping_ssad.oconf file.
Example Output
```
-rw-r--r-- 1 openit openit 1425 Apr 29 11:25 core_mapping_ssad.oconf
```

Argument	Description
[openit_user]	Use this to indicate the user name.
[openit_group]	Use this to indicate the group name.

# Configuring the Shared Software Assets Directory (SSAD) Access Credentials

Coordinate with the Open iT Account Manager or Delivery/Support Team to get your SSAD access credentials.
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, run one of following the commands:

To encrypt and save the SSAD credentials, use this command:
Command Syntax
```
openit_ssad_connector --config --client_id <client_id> --client_secret <client_secret>
```
To encrypt, save the SSAD credentials, and perform normal processes such as sending data to the SSAD API and fetching maps, use this command:
Command Syntax
```
openit_ssad_connector --client_id <client_id> --client_secret <client_secret>
```
After completing the steps, verify that the SSAD credentials are configured successfully. Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration, and check the credentials.json file to ensure the credentials have been updated.

The client secret value is already encrypted.

Coordinate with the Open iT Account Manager or Delivery/Support Team to get your SSAD access credentials.
Go to the bin directory, which is by default in /opt/openit/bin, run the command:
Command Syntax
```
 cd $BIN_DIR
```
Example
```
 cd /opt/openit/bin
```
Once in the directory, run one of following the commands:

To encrypt and save the SSAD credentials, use this command:
Command Syntax
```
./openit_ssad_connector --config --client_id <client_id> --client_secret <client_secret>
```
To encrypt, save the SSAD credentials, and perform normal processes such as sending data to the SSAD API and fetching maps, use this command:
Command Syntax
```
./openit_ssad_connector --client_id <client_id> --client_secret <client_secret>
```
After completing the steps, verify that the SSAD credentials are configured successfully. Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration, and check the credentials.json file to ensure the credentials have been updated.

The client secret value is already encrypted.