(Self-signed only) Add the certificate to the list of trusted certificates

To connect to the IXIASOFT TEXTML Server, the clients (IXIASOFT CCMS Desktop, IXIASOFT CCMS Output Generator, IXIASOFT CCMS Scheduler, IXIASOFT CCMS Web etc.), must have the IXIASOFT TEXTML Server signed certificate in the list of trusted certificates.

This is done by running the keytool command in the JRE/JDK that is running the client.

Note: If you are using a trusted certificate authority, you can skip this procedure. However, if you get an error message indicating that the certificate could not be trusted, you will need to add the root certificate for the trusted authority. Contact your commercial root CA for more information.
  1. On the machine where the CCMS component is installed, copy the root CA and the Intermediate Certificate (if present) to a temp folder c:\temp or /tmp.

    To execute the next step you will need to be in the JRE/bin or JDK/bin folder used by each CCMS component. Each CCMS components has a configuration entry that specific which/where the JRE/JDK is located.

    Client Sample JRE/JDK Path for Each Component
    IXIASOFT CCMS Desktop Windows: C:\ixiasoft-ccms\cms-<instance name>\jre\bin
    Note: Do this for each <instance name>.
    • IXIASOFT CCMS Output Generator
    • IXIASOFT CCMS Scheduler
    Windows: %install_dir%\jdk\bin

    Linux: %install_dir%/jdk/bin

    Note: Wherever it is defined in the wrapper.conf file.
    CCMS Web Windows: c:\Ixiasoft\ccms\jdk-11\bin

    Linux: /opt/ixiasoft/ccms/jdk-11/bin

    Java Console Windows: C:\Program Files\IxiaSoft\TextmlServer44\TextmlAdminJava\jre\bin

    Linux: /opt/ixiasoft/bin/5167/textmladminjava/jre/bin

  2. Open a command prompt and go to the \jre\bin directory for the client.
  3. Run the following command:
    For the: Enter:
    • CCMS Desktop
    • IXIASOFT CCMS Output Generator
    • CCMS Web
    • IXIASOFT CCMS Scheduler
    • TEXTML Java Console
    Windows:
    
    keytool -importcert -keystore ..\lib\security\cacerts -storepass changeit -file c:\temp\textml_root_cert.pem -alias company_root_ca
    
    keytool -importcert -keystore ..\lib\security\cacerts -storepass changeit -file c:\temp\textml_intermediate_cert.pem -alias company_intermediate_ca
    								
    Linux:
    
    keytool -importcert -keystore ..\lib\security\cacerts -storepass changeit -file /tmp/textml_root_cert.pem -alias company_root_ca
    
    keytool -importcert -keystore ..\lib\security\cacerts -storepass changeit -file /tmp/textml_intermediate_cert.pem -alias company_intermediate_ca
    								
    Information about the certificate is provided and the following message is displayed:
    Trust this certificate? [no]:
  4. Enter yes.
    The certificate is added to the keystore.
  5. Repeat this procedure for every client that connects to the IXIASOFT TEXTML Server.