Installing yuuvis® RAD service-manager

Valid for: yuuvis® RAD version 6.x

The microservices are integrated in the yuuvis® RAD service-manager service and are installed using yuuvis® RAD service-manager. All components for yuuvis® RAD client and yuuvis® RAD management-studio are also a part of this.

Ensure that the System Requirements are fulfilled before installation.

To install yuuvis® RAD service-manager, follow these steps:

  1. Copy the yuuvis_rad_service-manager installation directory to the file system of the computer on which you want to install yuuvis® RAD service-manager with the microservices.

  2. Launch yuuvis_rad_service-manager_setup-<Version>.exe from the installation directory.
  3. The installation wizard will start. Follow the steps described by the installation wizard.

  4. Enter the following microservice parameters.

    The central microservice parameters will be entered in the configuration files of the microservices. Subsequent changes can be made via the Service Application Manager SAM.

  5. Technical service name/

    service display name

    Technical service name and service display name for service control
    HTTP port Port of yuuvis® RAD service-manager. Default: 7281
    Data directory Data directory for yuuvis® RAD service-manager.
    Server

    IP address of the computer on which yuuvis® RAD core-service is installed.

    API key

    Specify API key The API key required here to access yuuvis® RAD core-service is shown when yuuvis® RAD core-service is installed.

    Database type
    • MSSQL
    • PostgreSQL

    Continued support for Oracle databases will only be available for existing installations.

    Database server IP address of the computer on which the database is installed.
    Database server port Port of the database computer
    Database instance Database instance name
    Database name Database name
    Schema name Schema name of the database
    Database user Name of the technical user for database access.
    Database password Password of the technical user for database access.
    JDBC string

    The JDBC string for the database connection is created automatically from the database information. Only edit the entry if changes need to be made for specific environments.

    Rendition server

    IP address of the rendition service

    The rendition service can be installed after yuuvis® RAD service-manager.

    Rendition server port Rendition service port. Default: 8090
  6. Adjust the service parameters before you start the service:

    • Launch yuuvis_rad_service_managerw.exe from the \service-manager\bin\ directory.
    • Service parameters:

      Log On > Account

      Account for login to the service

      yuuvis® RAD service-manager requires an administrative account.

      Logging > Level Optional: Logging level for service logging
      Logging > Path Optional: Path for service logs
      Logging > Stdout Optional: Redirect the standard output to a file
      Logging > Stderror Optional: Redirect the standard error output to a file
      Startup > Arguments The port of yuuvis® RAD service-manager can be modified. Default: 7281
      Java > Java options

      Optional: Modify Tomcat data directories.

  7. Modify the application-prod.yml configuration file located in the \config directory of yuuvis® RAD service-manager.
    • Add the following entry to the end of the file: feign.hystrix.enabled: false

    • Change the values for connection-timeout and socket-timeout as follows:

      service:
       connection-timeout-ms: 60000
       socket-timeout-ms: 300000

  8. Modify the application-es.yml configuration file located in the \config directory of yuuvis® RAD service-manager:

    spring.data.elasticsearch.cluster-nodes: '127.0.0.1:9300'
    spring.elasticsearch.rest.uris: '127.0.0.1:9200'

    Specify the address of Elasticsearch.

    If Elasticsearch is installed on the same server as yuuvis® RAD service-manager, then no change is necessary.

  9. Modify the application-mq.yml configuration file located in the \config directory of yuuvis® RAD service-manager:

    spring.activemq.broker-url: 'tcp://127.0.0.1:61616'
    spring.activemq.broker-url-stomp: 'stomp://127.0.0.1:61777'

    Specify the address of the server running the 'messagingservice' microservice.

    If yuuvis® RAD core-service is installed on the same server as yuuvis® RAD service-manager, then no change is necessary.

  10. If the 'structureservice' and 'discoveryservice' microservices are running on different computers and/or the Discoveryservice is running on a port other than the default port (7261), then add the appropriate values, host/port of the Discoveryservice, to the configuration file <service-manager>\config\servicewatcher-sw.yml in the Structureservice section as follows:

    - name: structureservice
      type: executable
      profiles: prod,red,es,mq
      instances: 1
      port: 7461-7469
      path: ${appBase}/structureservice/structure-service.exe
      env:
        EUREKA_HOST: discovery-host
        EUREKA_PORT: discovery-port
  11. Other optional changes:

    • Setting for authentication via the 'Gateway' microservice:
    • Default: 'FORM' (login dialog) / 'BASIC' (login data as parameter).

      'NTLM' can be activated via the gateway-prod.yml configuration file in the \service-manager\config\ directory. 'NTLM' automatically deactivates 'FORM' and 'BASIC'.

    • HTTPS
    • HTTPS can be activated.

    • IP filter
    • IP filters for access to yuuvis® RAD service-manager and the microservices can be set up.

    • Instances and memory assignments
    • Microservice instances can be added and microservices can be deactivated (instances: 0) via the servicewatcher-sw.yml configuration file in the \service-manager\config\ directory.

      The memory assignment for the individual microservices can be modified.

      If more than 1.5 GB of storage space is assigned to a microservice, the arch: x64 parameter must be added.

  12. Start the yuuvis® RAD service-manager service.

    It may take several minutes to start yuuvis® RAD service-manager and the microservices.

Uninstalling yuuvis® RAD service-manager

When you install yuuvis® RAD service-manager, an uninstallation program is created in the installation directory, which uninstalls yuuvis® RAD service-manager and all microservices.