Adding a connector project to the Transaction Server

Modify your environment to deploy a custom connector project to your Transaction server Docker container. Setting up this process will allow for continuous security and performance updates from HCL without the need for significant manual overhead when modifying the provided containers.

Procedure

  1. Remove the connector project archive from the generated wcbd package.
  2. Place your archived custom connector project into your customization working directory. The archived connector project will be referred to through this document as CustomSOAPConnector.rar
  3. Create the addConnectorModule.py python script in your customization working directory. This script places the contents of the custom connector project .rar archive file into the correct location, updates the server configuration, and then saves the changes made to the container.
    #This script places the contents of the custom connector project rar archive file into the correct file location, updates the server configuration, and then saves the changes made to the container.
    AdminApp.update('ts','modulefile','[-operation addupdate -contents /SETUP/CustomSOAPConnector.rar -contenturi "CustomSOAPConnector.rar" -usedefaultbindings -nodeployejb -defaultbinding.cf.jndi jdbc/WCDataSource -defaultbinding.datasource.jndi jdbc/WCDataSource -defaultbinding.cf.resauth Per_Connection_Factory -MapModulesToServers [[CustomSOAPConnector CustomSOAPConnector.rar,META-INF/ra.xml WebSphere:cell=localhost,node=localhost,server=server1]]]')
    AdminConfig.save()
    Where:
    • CustomSOAPConnector.rar is the name of your archived custom connector project.
    • CustomSOAPConnector is the name of the module that will be mapped to the server.
  4. Update the docker file (Dockerfile) in your working directory.
    This docker file instructs docker on correctly copying over and setting permissions for your archived custom connector project and python script into your Transaction server Docker container. It then executes the script to modify and save the changes made to the Docker container.
    FROM <ts-docker image>
    COPY addConnectorModule.py /SETUP/scripts/addConnectorModule.py
    RUN chmod 755 /SETUP/scripts/addConnectorModule.py
    COPY CustomSOAPConnector.rar /SETUP/CustomSOAPConnector.rar
    RUN run was-jpython-command addConnectorModule.py
    Where:
    • CustomSOAPConnector.rar is the name of your archived custom connector project.
    • addConnectorModule.py is the name of the script created in the previous step.
  5. In the customization working directory, run the docker build command.

Results

The connector is installed into the Transaction server Docker container.