Managing Libraries

Using modules such as a Database Connectors may require installing additional programs such as database drivers on your INUBIT Process Engine.

The drivers will be copied into the cache database and will then be stored in the <SUITE-INSTALL-DIR>/inubit/server/lib/system directory.

Drivers — especially for the cache database — may only be stored in exact one version in exact one directory on the application server. Make sure that there are no other versions on your INUBIT installation before you install or update a driver.

Upload libraries

Prerequisites

You are logged in as a system administrator.

Proceed as follows

  1. In the INUBIT Workbench, select Configuration > Library Manager. A dialog opens.

  2. Click the Upload new library icon installation guide 69 2 to upload a new library. The Upload library dialog opens.

  3. To the right of the File field click the Browse file icon installation guide 69 3. A file selection dialog opens.

  4. Navigate to the driver, select it, and click Open. The file name is displayed in the File field.

  5. In the Library Type section, select Driver library.

    How to upload plug-ins, refer to Installing Plug-ins.

  6. Click OK to upload the library.

    → The file is uploading.

    If the upload was successful, a confirmation is displayed. Otherwise, an error message is displayed.

  7. Click OK to close the dialog.

    → A dialog informs you about a necessary restart of the INUBIT Process Engines and the INUBIT Workbenches. Confirm the dialog.

  8. Restart the INUBIT Process Engines and the INUBIT Workbenches.

    After the restart, the driver is available, and will be used during module execution automatically.

In the Available libraries section, you can choose which library type(s) (All, Drivers, Plugins) are to be displayed using the drop-down list.

To remove a library, click the Remove library icon installation guide 69 4 and follow the instruction. The library will be marked as to be removed (struck through). On restart of the Process Engine and all Workbenches, the library will be removed effectively from file system, and then it also disappears from Library Manager. If you accidentally marked a wrong library as to be removed, you can remove the marker entry from libraries.properties file in the <SUITE-INSTALL-DIR>/inubit/server/ibis_root/conf directory. This will prevent the deletion on restart.

To download a previously uploaded library, select the library and click the Download installation guide 69 5 icon.

To search for a library, click the Search icon installation guide 69 6 and enter the search string. To navigate within the search results use the right arrow and the left arrow next to the search field.

Updating Libraries

Existing library are updated by uploading a new library version.

You must not upload a new library version of an older library version before having removed the older one from the INUBIT Process Engine.

Prerequisites

You are logged in as a system administrator.

Proceed as follows

  1. In the INUBIT Workbench, select Configuration > Library Manager. The Library Manager dialog opens.

  2. Choose Drivers from the Library type selection list.

  3. Click the driver you want to update.

  4. Click the Remove library icon installation guide 69 4 to remove the existing library.

  5. Confirm deleting the driver in the Question dialog.

  6. Restart all INUBIT Process Engines and INUBIT Workbenches.

  7. Log in as a system administrator to the INUBIT Workbench.

  8. In the INUBIT Workbench, select Configuration > Library Manager. The Library Manager dialog opens.

  9. Click the Upload new library icon installation guide 69 2 to upload a new library. The Upload library dialog opens.

  10. To the right of the File field click the Browse file icon installation guide 69 3. A file selection dialog opens.

  11. Navigate to the driver, select it, and click Open. The file name is displayed in the File field.

  12. From the Type pull-down list in the Library type section, select Driver library.

  13. Click OK.

    → A dialog informs you about a necessary restart of the INUBIT Process Engine and the INUBIT Workbench. Confirm the dialog.

    → The file is uploading. If the upload was successful, a confirmation is displayed. Otherwise, an error message is displayed.

  14. Restart the INUBIT Process Engine and the INUBIT Workbench.

    → After the restart, the new driver is available and you can use it in your workflows.

Integrating Native Libraries

Proceed as follows

  1. Download the corresponding libraries and decompress them.

  2. Upload the JAR files to the INUBIT Workbench.

  3. Copy the native library files into one of the following directories:

    • Windows

    • Linux 64

    • Native library files: *.dll

    • When starting the INUBIT Process Engine via the Windows start menu: <SUITE-INSTALL-DIR>/_jvm\bin

    • When starting the INUBIT Process Engine as a Windows service: <SUITE-INSTALL-DIR>/inubit/server/process_engine\bin

    • Native library files: *.so

    • In the directory: <SUITE-INSTALL-DIR>/_jvm/lib

    You must possibly add the directory to the environment variable PATH.

  4. Restart the INUBIT Process Engine.

Press Esc to exit full screen
Modal image placeholder
Press Esc to exit full screen