Adding a Second Subdomain to yuuvis RAD client

With version 7.0 of yuuvis® RAD, the default URL changed from /enaio/client to /app/client because the /enaio subdomain did no longer match the product name. This might be inconvenient because the old URL might be saved in (many) bookmarks, external tools and documentation. We recommend updating the URL where ever possible, but if you really want to keep /enaio/client/ in parallel to /app/client or if you want to add another subdomain /<yoursubdomain>/client in addition to the default /app/client, you can follow this guide to achieve this (replace "enaio" with your desired subdomain if you want have a different subdomain).

  1. Stop the service-manager service.

  2. In the <service-manager>\config\ folder, create a new file client-enaio.yml with the following content:

    client-enaio.yml
    spring:
      application:
        name: clientenaio
    resourcesDirectoryPath: '${enaio.data.path}/webresource/resources-enaio/'
  3. In the <service-manager>\config\ folder, edit the servicewatcher-sw.yml file and copy the "clientservice" section. Then change the "name" parameter to "clientservice-enaio" and add "enaio" to the right end of the profiles parameter. It should look like this now:

    servicewatcher-sw.yml snippet
    - name: clientservice
      type: microservice
      profiles: prod,cloud
      instances: 1
      memory: 64M
      port: 7391-7395
      path: ${appBase}/clientservice/clientservice-app.jar
    
    - name: clientservice-enaio
      type: microservice
      profiles: prod,cloud,enaio
      instances: 1
      memory: 64M
      port: 7391-7395
      path: ${appBase}/clientservice/clientservice-app.jar
  4. In the <service-manager>\config\ folder, edit the gateway-prod.yml file and add a new endpoint:

    gateway-prod.yml endpoint
      - name: 'enaio'
        url: 'http://clientenaio'
  5. In the <service-manager>\data\webresource folder (replace <service-manager>\data with the data folder of the service-manager if you chose a different location for it), copy the "resources" folder and call it "resources-enaio".

  6. Copy the <service-manager>\data\public\client\index.html file to <service-manager>\data\webresrouce\resources-enaio\client\.

  7. Edit the copied index.html and change the line "<base href="/app/client/">" to "<base href="/enaio/client/">.

  8. Start the service-manager. You can now use /enaio/client the same way as /app/client.

Attention

You have to repeat steps 6 and 7 after every update of the service-manager!