Install third-party libraries and license file

The following section describes where to place the libraries (included in the pre-built module directory in the ImageMaster assembly file).

Copy library files

Copy the t-systems sub-directory with all contained libraries and directories

from the ImageMaster assembly release .../libs/jboss-module/com/tsystems

to your server ${JBOSS_HOME}/modules/system/layers/base/com

The final directory structure in the WildFly/JBoss home directory should be:

${JBOSS_HOME}/modules/system/layers/base/com/tsystems/ima/main/
- If the assembly contains empty sub-directories within its “main” directory, these must also be copied!
- The module.xml file is already adjusted and references all JAR files which are included in the assembly release.
- Additional jar files may be required for which you need to insert further entries in module.xml.
Also copy any required third-party jar files into this “main/” subdirectory (e.g. libraries required for special add-on modules as described in other manuals).
Insert further entries in module.xml in section “<resources>” for any third-party external library added in the previous step.

(This file “module.xml” was also copied into subdirectory “main/” in the first step.)
```
<module xmlns="urn:jboss:module:1.1" name="com.tsystems.ima">
...					
 <resources>
...
    <resource-root path="AnExternalLibrary.jar" />
...
 <resources>
...
```
Copy third-party libraries (like the ones required for SAP integration according to Additional libraries) into the following sub-directory (corresponding to your operating system architecture):
“…com/tsystems/ima/main/lib/<your-OS-and-architecture>/”

See the vendor documentation [JBossNativeLibs] for details according to which a path for Linux could be: “…com/tsystems/ima/main/lib/linux-x86_64/”.

Copy the ImageMaster license file

Copy the ImageMaster license file into the sub-directory:

${JBOSS_HOME}/standalone/configuration/ima-license/

Instead of copying the license file you can also configure an accessible path via the system property: ima.license.directory in the ImageMaster configuration file (configureAppServer.config).

The exchange of an ImageMaster license file is supported without a system restart (since ImageMaster 9.9.1).

Marginalia

If the server was already running when you made any kind of changes like above, reboot the server to make the external libraries available for all deployed applications. If you followed the instructions in this manual in sequential order, this should not be the case.

In the META-INF directory of the delivery EAR file of the ImageMaster assembly release, the file “jboss-deployment-structure.xml” is located, where all required dependencies are referenced that are necessary for the deployment and permissions processing.