Starting the INUBIT Workbench and Logging In

Prerequisites

Either your locally available Process Engine is already started or a remotely running Process Engine is available via the network.

Proceed as follows

  1. Start the Workbench:

    • Windows: Start > [All] Programs > INUBIT > Workbench

    • Linux/Windows

    • <inubit-installdir>/inubit/client/bin/start_local.sh or .bat

      or ^* <inubit-installdir>/inubit/bin/start_workbench.sh `or `.bat

  2. If an incompatible Java runtime version is detected:

    A dialog is displayed showing the Java runtime version detected as well as pointing out that this version is not supported (refer to Software Requirements).

    In this case, using the workbench may produce unexpected behavior.

    Click one of the buttons:

    • Quit (recommended)

      You cancel the start of the Workbench.

    • Continue

      You continue the start of the Workbench at your own risk.

      If a compatible Java runtime version is detected or if you have continued the start of the Workbench in case of an incompatible version, the following dialog is displayed:

      installation guide 67 2

      At the login, you can choose a direct user group or an additional user group in the User group field, refer to Assigning Users to Additional User Groups and Editing the Assignment. Both the username and the user group can be entered case-insensitive.

  3. To connect the Workbench with a Process Engine, specify the URL as follows:

    https://<server>:<port>/ibis/servlet/IBISSoapServlet

    • LoadBalancer

      Host name or IP address of the system on which the load balancer runs.

    • Port

      Port through which the load balancer can be reached.

  4. To login as system administrator, enter root as login name and lookup the random root password for the initial login provided in ibis.xml:

    <Property name="initialRootUserPassword"><!-- Random 20 character string --></Property>

    After first login, you can remove the property for the initial root password in ibis.xml.

    If the property entry for the initial root password is missing in ibis.xml during the first login, the server start is being aborted.

    To use different credentials, you can create multiple login profiles. Therefore, refer to Creating and Deleting Login Profiles or call the appropriate help in the login window with installation guide 68 2.

  5. Click Login.

    If the maintenance mode was activated for the Process Engine, a message is displayed. With the checkbox in this dialog, you can decide whether this warning should be displayed again. The same is true for the warning message that is displayed when the Workbench version is lower than the Process Engine version.

    → The INUBIT Workbench opens.

For security reasons, change the root password now. For this purpose, open burger menu root > Change password from the menu bar in the INUBIT Workbench.

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 <inubit-installdir>/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.

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 you can use it in your workflows.

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 <inubit-installdir>/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

Usage

To upload 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. Depending on your operating system, copy the `*.dll/so `files into one of the following directories:

    • Windows

      • When starting the INUBIT Process Engine via the Start menu: <inubit-installdir>/_jvm\bin

      • When using the INUBIT Process Engine as a service under Tomcat: <inubit-installdir>\server\process_engine\bin

    • Linux 64-Bit

      <inubit-installdir>/_jvm/lib

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

  4. Restart the INUBIT Process Engine.

Updating the License via INUBIT Workbench

A new license may be loaded to the INUBIT Process Engine by means of the INUBIT Workbench.

When your license expires, the INUBIT Process Engine automatically goes into maintenance mode. Even in maintenance mode, you can update your license via Updating the INUBIT Workbench.

To display license information, click in the menu bar on Help > About a dialog opens. You find the license details in the License Information tab.

Proceed as follows

  1. Log in to the INUBIT Workbench as the System Administrator.

  2. From the menu bar select Configuration > Update license file…​. A file explorer opens.

  3. Navigate to the directory where your license file is stored.

  4. Select the license file and click Open.

The new license is saved in the directory <inubit-installdir>/inubit/server/ibis_root/conf with the name license.xml.imported.

No licence file backup is created.