Skip to main content

Installation Manual

Configuration of ADONIS/ADOIT with the rich client Administration toolkit​

note

In order to use ADONIS Process Manager/ADOIT Enterprise Architect for Confluence with your ADONIS/ADOIT Enterprise Edition, the Standard RESTful services module must be licensed and enabled!

  1. Open the Administration Toolkit.

  2. Go to the Library Management component and then to the Component Settings tab.

  3. Go to Standard RESTful services -> General.

    • Enable MFB REST globally.
    • In the Tokens tab configure the Settings of the local REST security context by adding a Key and generating a Secret (this can be done automatically by the Generate Secret button).
    • In the Technical user setting, select a technical user for the REST context. Available technical users are displayed in the table. If no user is available, go to User Management and create a technical user (this user must have Trusted Login ). You can assign one or more repository to the chosen technical user and therefore selecting what content should be available within REST.
      NOTE: All content that the technical user has access to, will also be available via the ADONIS Process Manager/ADOIT Enterprise Architect macros in Confluence for all Confluence users.
      For further information, please see chapter Enterprise Edition: Restricting access to ADONIS/ADOIT content.
    • The following REST Scenarios must be enabled for ADONIS Process Manager/ADOIT Enterprise Architect for Confluence to work:
      • Repository read APIs
      • Repository search APIs
      • Metamodel read APIs
    • [Optional] In the Cache Path setting, setup an absolute path on the webserver machine, accessible by ADONIS/ADOIT, where REST cache can be saved. The path should be dedicated to this purpose and not shared with other services. ADONIS/ADOIT will take care of managing it. Doing so will improve the response time for REST.
      Please note: if it is a SaaS ADONIS/ADOIT environment hosted by BOC Group then the Cache Path setting change must be requested from the Key Account Manager.
    • For the Enable Validator setting, the recommendation for ADONIS Process Manager/ADOIT Enterprise Architect for Confluence is to keep it disabled as enabling this parameter may slow down the execution of requests and cause high memory consumption and CPU usage on the web server.
    • Enable HATEOAS links setting has to be enabled for ADONIS Process Manager/ADOIT Enterprise Architect for Confluence, since it is used for links rendering.

Standard RESTful services settings

REST scenarios to enable

  1. Go to Web Client -> System page.
  • Configure the Base URL to match the web client URL.
  • In Technical Users , select the same technical user from the previous step.

Web Client System settings