18.7 Deploying Containers on a Single Server

In this example, all the Identity Manager containers are deployed on a single Docker host using the host network mode.

18.7.1 Prerequisites

  • Ensure that the hostname is in FQDN format as shown below:

    <IP of the host> <FQDN> <short_name>

    For example:

    172.120.0.1     identitymanager.example.com      identitymanager

  • You must generate the silent properties file before you deploy the containers. For more information on generating the silent properties file, see the Creating the Silent Properties File.

The containers must be deployed in the following order:

18.7.2 Deploying Identity Manager Engine Container

  1. Generate the silent properties file. For more information, see Creating the Silent Properties File.

  2. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  3. Run the following command to load the image:

    docker load --input IDM_490_identityengine.tar.gz

  4. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=engine-container -v /data:/config -e SILENT_INSTALL_FILE=/config/silent.properties --stop-timeout 100 identityengine:idm-4.9.0-580

  5. To verify whether the container was successfully deployed, check the log files by running the following command:

    tail -f /data/idm/log/idmconfigure.log

  6. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it engine-container bash

NOTE:To run the Identity Vault utilities such as ndstrace or ndsrepair, log in to the container as a non-root user called as nds. These utilities cannot be run if you are logged in as a root user. To log in to the container as a nds user, run the docker exec -it engine-container sudo nds command.

18.7.3 Deploying Remote Loader Container

  1. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  2. Run the following command to load the image:

    docker load --input IDM_490_remoteloader.tar.gz

  3. Deploy the container using the following command:

    docker run -d --network=host --name=rl-container -v /data:/config remoteloader:idm-4.9.0-580

    This deploys the 64-bit and 32-bit version of the Remote Loader. The driver files can be found at the /opt/novell/eDirectory/lib/dirxml/classes/ directory of the container.

  4. (Conditional) If you do not want to use configuration files while deploying the container, deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=rl-container -v /data:/config --stop-timeout 100 remoteloader:idm-4.9.0-580

  5. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it rl-container bash

  6. Configure Remote Loader. For more information, see Configuring the Remote Loader and Drivers in the NetIQ Identity Manager Driver Administration Guide.

  7. Ensure that the configuration files are available in the shared volume.

18.7.4 Deploying Fanout Agent Container

  1. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  2. Run the following command to load the image:

    docker load --input IDM_490_fanoutagent.tar.gz

  3. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=foa-container -v /data:/config --stop-timeout 100 fanoutagent:idm-4.9.0-580

  4. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it foa-container bash

  5. Configure the Fanout Agent. For more information, see Configuring the Fanout Agent in the NetIQ Identity Manager Driver for JDBC Fanout Implementation Guide.

18.7.5 Generating Certificate With Identity Vault Certificate Authority

(Conditional) This section applies only if you are using Identity Vault as the Certificate Authority.

The following components require you to generate certificate before they are deployed. Before you generate the certificates for the following components, ensure that you deploy the Identity Manager Engine and Identity Console containers.

  • OSP

  • Identity Applications

  • Identity Reporting

Perform the following steps to generate the certificate:

  1. Ensure that the Java version installed is Azul Zulu 1.8.0_392 or later.

  2. Ensure that you set the Java path. For example, run the following command:

    export PATH=<java installed location>/bin:$PATH

    For example,

    export PATH=/opt/netiq/common/jre/bin/:$PATH

  3. Generate the PKCS keystore:

    keytool -genkey -alias idm -keyalg RSA -storetype pkcs12 -keystore /data/tomcat.ks -validity 3650 -keysize 2048 -dname "CN=identitymanager.example.com" -keypass <password> -storepass <password>

  4. Generate a certificate signing request:

    keytool -certreq -v -alias idm -file /data/idm.csr -keypass 
<password> -keystore /data/tomcat.ks -storepass <password>

  5. Generate a self-signed certificate:

    1. Launch Identity console and login.

    2. Navigate to Certificate Management > Issue Certificate.

    3. Browse to the .csr file created in step 4. For example, idm.csr.

    4. Click Open.

    5. Under Key Usage Specifications drop-down, Specify the key type.

    6. Under Extended Key Usage Specifications drop-down, Specify the Extended key type.

    7. For the certificate type, select Unspecified under Basic Constrains drop down.

    8. Specify the validity of the certificate under Certificate Parameters drop down.

    9. Select the File in binary DER format under Certificate format drop down.

    10. Click Next.

    11. Click OK.

    12. Download the certificate and copy the downloaded certificate to the /data directory.

  6. Export the root certificate in .der format:

    1. Launch Identity console and login.

    2. Navigate to Certificate Management > Server Certificate Management.

    3. Select the SSL CertificateDNS check box and click Export.

    4. In the Certificates drop-down list, select the Organizational CA.

    5. In the Export Format drop-down list, select DER.

    6. Click OK.

    7. Download the certificate and copy the downloaded certificate to the /data directory.

  7. Import the certificates into the PKCS keystore you created in step 2:

    keytool -import -trustcacerts -alias root -keystore /data/tomcat.ks -file /data/cert.der -storepass <password> -noprompt
    keytool -import -alias idm -keystore /data/tomcat.ks -file /data/idm.der -storepass <password> -noprompt

NOTE:Ensure that the keystore is available in the path that was specified as an input for deployment.

18.7.6 Deploying OSP Container

  1. Generate the silent properties file. For more information, see Creating the Silent Properties File.

  2. Ensure that the SSO_SERVER_SSL_PORT property is set to a unique port.

  3. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  4. Run the following command to load the image:

    docker load --input IDM_490_osp.tar.gz

  5. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=osp-container -v /data:/config -e SILENT_INSTALL_FILE=/config/silent.properties --stop-timeout 100 osp:idm-4.9.0-580

  6. To verify whether the container was successfully deployed, check the log files by running the following command:

    tail -f /data/osp/log/idmconfigure.log

  7. Stop the container using the following command:

    docker stop osp-container

  8. Run the following command to modify the Tomcat shutdown port in the server.xml file. In the following example, the port 8005 will be changed to 18005:

    sed -i "s~8005~18005~g" /data/osp/tomcat/conf/server.xml

  9. Start the container using the following command:

    docker start osp-container

  10. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it osp-container bash

18.7.7 Deploying PostgreSQL Container

  1. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  2. Run the following command to load the image:

    docker load --input IDM_490_postgres.tar.gz

  3. Create a sub-directory under the shared volume /data, for example, postgres.

    mkdir postgres

  4. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=postgresql-container -e POSTGRES_PASSWORD=<password> -v /data/postgres:/var/lib/postgresql/data --stop-timeout 100 postgres:12.18

    For example,

    docker run --restart unless-stopped -d --network=host --name=postgresql-container -e POSTGRES_PASSWORD=novell -v /data/postgres:/var/lib/postgresql/data --stop-timeout 100 postgres:12.18

  5. Create the idmdamin user for Identity Applications.

    docker exec -it postgresql-container psql -U postgres -c "CREATE USER idmadmin WITH ENCRYPTED PASSWORD '<password>'"

  6. Create the Identity Applications, Workflow, and Identity Reporting databases.

    docker exec -it postgresql-container psql -U postgres -c "CREATE DATABASE idmuserappdb"
    docker exec -it postgresql-container psql -U postgres -c "CREATE DATABASE igaworkflowdb"
    docker exec -it postgresql-container psql -U postgres -c "CREATE DATABASE idmrptdb"

    NOTE:These databases are used while you configure the Identity Applications and Identity Reporting containers.

  7. Grant all the privileges on the databases for the idmadmin user:

    docker exec -it postgresql-container psql -U postgres -c "GRANT ALL PRIVILEGES ON DATABASE idmuserappdb TO idmadmin"
    docker exec -it postgresql-container psql -U postgres -c "GRANT ALL PRIVILEGES ON DATABASE igaworkflowdb TO idmadmin"

  8. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it postgresql-container bash

18.7.8 Deploying Identity Applications Container

NOTE:Before you deploy the Identity Applications container, ensure that you generate the required certificates. For more information, see Generating Certificates for Identity Applications.

  1. Use the silent properties file generated in the Creating the Silent Properties File section for deploying the container.

    NOTE:Specify the exposed port, 18543, as the value for the application server port.

  2. Navigate to the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file.

  3. Navigate to the docker-images directory.

  4. Run the following command to load the image:

    docker load --input IDM_490_identityapplication.tar.gz

  5. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=idapps-container -v /data:/config -e SILENT_INSTALL_FILE=/config/silent.properties --stop-timeout 100 identityapplication:idm-4.9.0-580

  6. To verify whether the container was successfully deployed, check the log files by running the following command:

    tail -f /data/userapp/log/idmconfigure.log

  7. Run the following command to log in to the container:

    docker exec -it <container> <command>

    For example,

    docker exec -it idapps-container bash

  8. Run the following command:

    NOTE:Before performing this step, ensure that the container is deployed successfully.

    /opt/netiq/common/jre/bin/keytool -importkeystore -srckeystore /config/tomcat.ks -srcstorepass <password> -destkeystore /opt/netiq/idm/apps/tomcat/conf/idm.jks -deststorepass <password>

  9. Type yes to overwrite the entry for the root alias.

  10. Run the following command to exit the container.

    exit

  11. Restart the Identity Applications container.

    docker restart idapps-container

NOTE:To modify any settings in the configuration update utility, launch configupdate.sh from the /opt/netiq/idm/apps/configupdate/ directory of the Identity Applications container. The configuration update utility can be launched in console mode only.

18.7.9 Deploying Form Renderer Container

  1. Generate the silent properties file. Select Identity Applications while generating the silent properties file. For more information, see Creating the Silent Properties File.

  2. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  3. Run the following command to load the image:

    docker load --input IDM_490_formrenderer.tar.gz

  4. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=fr-container -v /data:/config -e SILENT_INSTALL_FILE=/config/silent.properties --stop-timeout 100 formrenderer:idm-4.9.0-580

  5. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it fr-container bash

18.7.10 Deploying ActiveMQ Container

  1. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  2. Run the following command to load the image:

    docker load --input IDM_490_activemq.tar.gz

  3. Deploy the container using the following command:

    docker run --restart unless-stopped -d --network=host --name=amq-container -v /data:/config --env-file /data/silent.properties --stop-timeout 100 activemq:idm-4.9.0-580

  4. To log in to the container, run the following command:

    docker exec -it <container> <command>

    For example,

    docker exec -it amq-container bash

  5. Configure ActiveMQ. For more information, see Setting Up ActiveMQ Startup Service in the NetIQ Identity Manager Driver for JDBC Fanout Implementation Guide.

18.7.11 Deploying Identity Reporting Container

NOTE:Before you deploy the Identity Reporting container, ensure that you generate the required certificates. For more information, see Generating Certificates for Identity Reporting.

  1. Use the silent properties file generated in the Creating the Silent Properties File section for deploying the container.

    NOTE:Specify the exposed port, 28543, as the value for the application server port.

  2. Navigate to the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file.

  3. Navigate to the docker-images directory.

  4. Run the following command to load the image:

    docker load --input IDM_490_identityreporting.tar.gz

  5. Deploy the container using the following command:

    docker run --restart unless-stopped -d --ip=192.168.0.10 --network=host --hostname=identityreporting.example.com -p 28543:28543 --name=rpt-container -v /etc/hosts:/etc/hosts -v /data:/config -e SILENT_INSTALL_FILE=/config/silent.properties --stop-timeout 100 identityreporting:idm-4.9.0-580

  6. To verify whether the container was successfully deployed, check the log files by running the following command:

    tail -f /data/reporting/log/idmconfigure.log

  7. Run the following command to log in to the container:

    docker exec -it <container> <command>

    For example,

    docker exec -it rpt-container bash

  8. Run the following command:

    NOTE:Before performing this step, ensure that the container is deployed successfully.

    /opt/netiq/common/jre/bin/keytool -importkeystore -srckeystore /config/tomcat.ks -srcstorepass <password> -destkeystore /opt/netiq/idm/apps/tomcat/conf/idm.jks -deststorepass <password>

  9. Type yes to overwrite the entry for the root alias.

  10. Run the following command to exit the container.

    exit

  11. Restart the Identity Reporting container.

    docker restart rpt-container

18.7.12 Deploying SSPR Container

Perform the following tasks to deploy the SSPR container:

  1. Generate the silent properties file for SSPR. For more information, see Creating the Silent Properties File.

  2. Create a sub-directory under the shared volume /data, for example, sspr.

    mkdir sspr

  3. From the location where you have extracted the Identity_Manager_4.9.0_Containers.tar.gz file, navigate to the Identity_Manager_4.9.0_Containers/docker-images directory.

  4. Run the following command to load the image:

    docker load --input IDM_490_sspr.tar.gz

  5. Deploy the container using the following sample command:

    docker run --restart unless-stopped -d --network=host --name=sspr-container -v /data/sspr:/config --stop-timeout 100 sspr/sspr-webapp:4.7.0.1-580

  6. Run the following command from the Docker host to copy the silent.properties file from the Docker host to SSPR container:

    docker cp /data/silent.properties sspr-container:/tmp

  7. Load the silent properties file to the SSPR container.

    docker exec -it sspr-container /app/command.sh ImportPropertyConfig /tmp/silent.properties

    NOTE:Check if the SSPRConfiguration.xml is created under the /config directory of SSPR container and verify the content of the file.

  8. Import the OAuth certificate to SSPR:

    1. From the Docker host, edit the SSPRConfiguration.xml file located at /data/sspr/ directory and set the value of the configIsEditable flag to true and save the changes.

    2. Launch a browser and enter the https://identitymanager.example.com:8443/sspr URL.

    3. Log in using administrator credentials, for example, uaadmin.

    4. Click on the user, for example, uaadmin, on the top-right corner and then click Configuration Editor.

    5. Specify the configuration password and click Sign In.

    6. Click Settings > Single Sign On (SSO) Client > OAuth and ensure that all URLs use the HTTPS protocol and correct ports.

    7. Under OAuth Server Certificate, click Import from Server to import a new certificate and then click OK.

    8. Click at the top-right corner to save the certificate.

    9. Review the changes and click OK.

    10. After the SSPR application is restarted, edit the SSPRConfiguration.xml file and set the value of the configIsEditable flag to false and save the changes.

18.7.13 Deploying Identity Console Container

For more information on deploying Identity Console Container, see Installing OpenText Identity Console as Docker Container.