Team for Capella license software installation

1. Server installation

  1. The license server is provided in the TeamForCapella-7.1.0-win32.win32.x86_64.zip archive. After the preparation steps (see Team for Capella Server installation procedure), it is located in the folder TeamForCapella\lic-server

  2. Unzip the OLS.zip archive in TeamForCapella\lic-server\OLS, the OLS folder should contain 4 .ols files.

  3. You can choose to:

    • either launch the license server from the scheduler’s job License Server - Run (disabled by default)

    • or directly launch the tool using the command lic-server -keys ./OLS -verbose

Additional parameters and documentation can be found in the DOCUMENTATION.txt file located in TeamForCapella\lic-server\.

The server configuration and more especially the .ols files should not be modified, moved or even accessed while the server is operating.Stop the license server before doing such operation.

1.1. Optional HTTPS monitoring endpoint

The license server monitoring endpoint is separate from the WSS/HTTPS connection used by the Team for Capella repository server. If organizational policy requires HTTPS monitoring, configure the License Server - Run job with a dedicated HTTPS port, for example:

lic-serverc.exe --launcher.ini lic-server.ini -verbose -consoleLog -keys ./OLS -port 9999 -httpPort 9443 -useHttps

Then reference a dedicated keystore in lic-server\lic-server.ini after -vmargs:

-Dorg.eclipse.jetty.ssl.keystore.path=../certs/<license-server-keystore.p12>
-Dorg.eclipse.jetty.ssl.password=<keystore-password>
-Dorg.eclipse.jetty.ssl.keystore.type=PKCS12

Protect the keystore and its passphrase according to the deployment security policy. This optional setting does not change the license checkout port encoded in the client connection key.

2. Client configuration

In order to connect Team for Capella instances with the license server, a connection key must be used to retrieve its address and port.

You should have received this key with the license server bundle and your .ols files. In order for Obeo to generate the key and send it to you, please provide the following information:

  • preferably the DNS otherwise the IP Address of the machine that will host the licence server, seen from the machine where the Team for Capella client is installed. It means that if you have a WAF(Web Application Server) between the two machines then the DNS or IP Adress of the WAF should be provided.

  • The associated port. By default it is 9999.

The capella\capella.ini file has to be modified with the following line to define the configuration of the server (after -vmargs):

-DOBEO_LICENSE_SERVER_CONFIGURATION=<connection key>

This must be done on all clients.

A license token is retrieved at the first connection attempt done by Team for Capella. It is then revoked when the last connected Capella project is closed or when Team for Capella closes. This license is verified from times to times with the server while you are using Team for Capella.

Clients are programmatically throttled and will not send requests to the server more frequently than once every minute. This throttling means some of the client actions might have a delay before being distributed to the server, for instance if one user stops using a given feature, 2 minutes of delay at most can be necessary for another user to be able to get the token.

The client/server communication is request based, no connection is kept alive for longer than just a request.