Encrypt a password

With the encrypt utility, you can encrypt a password before specifying it in an IXIA CCMS configuration file. This utility is available in both IXIA CCMS Output Generator and IXIA CCMS Scheduler.

Procedure

Ensure that the Java wrapper file, wrapper.conf, is configured to point to your Java JRE/JDK.
The encrypt utility requires a configured wrapper.conf file.
Run the command as follows:
- On Windows:
  1. Open a command prompt and go to the bin directory of CCMS Output Generator or CCMS Scheduler installation folder, depending on which tool you are configuring.
  2. Enter the following command:
```
encrypt <password>
```
    Where <password> is the password that you want to encrypt. For example, to encrypt the password HelloWorld2020, enter:
```
encrypt HelloWorld2020
```
- On Linux:
  1. Go to the bin directory of CCMS Output Generator or CCMS Scheduler installation folder, depending on which tool you are configuring.
  2. Enter the following command:
```
./encrypt.sh <password>
```
    Where <password> is the password that you want to encrypt. For example, to encrypt the password HelloWorld2020, enter:
```
./encrypt.sh HelloWorld2020
```
Note: If you get an error message indicating that Java could not be found, set the JAVA_HOME environment variable to point to the JRE installation and try again.

The tool returns the encrypted password, as follows:

C:\ixiasoft\OutputGenerators\OutputGen_Prod\bin>encrypt HelloWorld2020
IXIASOFT Technologies inc.
******************************************
Encrypting [HelloWorld2020]
Crypted using TripleDES [#!;dI0W5ubkD08UJImaUNnULlbwu2T/5mlvnARNUTgrEDI=]
Decrypted using TripleDES [HelloWorld2020]
******************************************

The encrypted password is provided on the "Crypted using TripleDES" line, inside the brackets [], as shown in bold above.

If you are using special characters in your password (for example, <, >, |, &, and &&), make sure that the password that appears on the "Decrypted using TripleDES" line is the one that you encrypted. If that is not the case, enclose your password in double quotes. For example:

encrypt "Hello\World"

If your password includes a double quote, specify it as follows:

On Windows: Insert the double quote twice; for example:
```
encrypt "Hello""World"
```
On Linux: Insert a backslash before the double quote; for example:
```
./encrypt.sh "Hello\"World"
```

In the configuration file, enter the encrypted string without specifying the brackets.

For example, in the outputgenerator.xml file, enter the password as follows:

<outputgenerator>
   <textml address="localhost" port="2500" forceupdate="false" version="4">
      <docbase>Update36_test</docbase>
      <user domain="ixiasoft" name="outgen" password="#!;dI0W5ubkD08UJImaUNnULlbwu2T/5mlvnARNUTgrEDI="/>
      <timeout>500000</timeout>
   </textml>
</outputgenerator>