Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
maxLevel5

Using FlexNet license server

Note
To install the FlexNet License Server, please see FlexNet license server
installation and licensing.

Upon successful installation, only the administrator account is available and required for you to apply a Magic Collaboration Studio license for the first time. The license selection page will also open if your license expires.

The license selection page prompts you to specify the address of the FlexNet license server installation where you store your license(s). If you do not specify any port, 1101 will be the default port. If you enter the wrong address, an error message will open for you to report the problem.

Note
  • You need to import a floating license key of Magic Collaboration Studio to the FlexNet License Server before you can activate it from Teamwork Cloud Admin.
  • An administrator account is required only when applying a

After installing the product, you need to log in to the Administrator account and apply the Magic Collaboration Studio license.

Note

Prerequisites:

  • You need to have the FlexNet license server with the Magic Collaboration Studio license.
  • The Administrator account is required when applying the
  • license for the first time.
  • Subsequent
  • In subsequent license updates
  • can be performed by
  • , any user who has the Server Administrator role
  • .
Important information:
  • can apply a Magic Collaboration Studio license.
  • Magic Collaboration Studio will automatically apply the selected license whenever it starts. If the license does not exist in the license server anymore, the server will go into a limited mode, allowing only a user with the Server Administrator role to log in.
  • After applying
  • the
  • a license, Magic Collaboration Studio permanently consumes one user connection.


To apply the Magic apply Magic Collaboration Studio license using the FlexNet license server


    In
  1. Open Web Application Platform in a web browser
  2. , go to http(s)
  3. using this address format: https://
  4. <domain_name>
  5. <machine ip>:<port>/webapp
  6. to open the authentication page
  7. .
  8. Sign in to Magic Collaboration Studio using the
  9. Administrator
  10. administrator account credentials (the default credentials are Administrator/Administrator)
  11. Open
  12. Click the Settings application to open it.
  13. In
  14. From the left-side menu select the Server license page. There you will find the License information table.
  15. In
  16. the License server field of the License Information card enter the license server address and click the Show Licenses button.
  17. the FlexNet tab, enter the IP address of the FlexNet server (if it is on the same instance, use 127.0.0.1), and click SHOW LICENSES.
    Note

    If you want to use the Three-Server Redundancy (Triad License Server), follow this format:

    server-address1:port,server-address2:port,serveraddress3:port


  18. If a valid license is found, it is applied automatically. If there are multiple licenses available, select the license to use on this server and click Confirm
  19. Select the license you want to apply and click the Confirm button
  20. .
  21. After applying the license, in the License information
card displays
  1. table, you will see the license that is used.


Note

If your license server only has a single license edition for Magic Collaboration Studio, it will be automatically applied.

Warning

If your Magic Collaboration Studio is using a multi-node Cassandra cluster, you must have a Business Pro or Enterprise license. Magic Collaboration Studio will deactivate if it detects a multi-node cluster with either a Standard or Business license.

Whenever a Magic Collaboration Studio node connects to the FLEXnet License Server and retrieves (leases) a license, the number of available licenses will decrease. If all available licenses from the server are leased, the node will not be able to launch and you will need to reactivate once a license becomes available.

If your FLEXnet License Server is down, the server capacity shall be set to zero. All currently active users can continue working but they cannot sign in again once they log out as no user can sign into the server at that time. A user with Configure Server permission (Server Administrator role) can sign into the Teamwork Cloud Admin to select a new license server.

You can see information about your current license on the Server license page of Teamwork Cloud Admin. The information includes the license edition and expiration date, the license version. See section Changing Magic Collaboration Studio license to change or update your license.  you want to update the license, see Changing Magic Collaboration Studio license.

Using DSLS

Note

You need to have DSLS (Dassault Systèmes License Server).

You can configure the Magic Collaboration Studio license using the user interface of Teamwork Cloud Admin.


To apply the Magic Collaboration Studio license through Teamwork Cloud Admin


  1. Open Magic Collaboration Studio in a web browser using this address format: https://<machine ip>:<port>/webapp. 4085 is the default port.
  2. Sign in to Magic Collaboration Studio using the administrator account credentials (the default credentials are Administrator/Administrator). 
  3. Click the Settings application to open it.
  4. From the left-side menu select the Server license page. There you will find the License information table.
  5. Choose the DSLS tab.
  6. In the DSLS tab, select one of the following:
    1. Organization defined and then click SHOW LICENSES.
      Info

      You do not need to set the address as it is already defined in the DSLicSrv.txt file by the organization. The API will know to checkout licenses from servers defined in that file:

      • On Windows: C:\ProgramData\DassaultSystemes\Licenses
      • On Linux and Mac: /var/DassaultSystemes/Licenses

    2. Custom. Enter the IP address of the License server (if it is on the same instance, use 127.0.0.1), and click SHOW LICENSES. The address provided in address line is used to connect to the licensing server.
  7. If a valid license is found, it is applied automatically. If there are multiple licenses available, select the license to use on this server and click Confirm.
  8. After applying the license, in the License information table, you will see the license that is used.


Note

Edition: with DSLS, product licenses are checked out using trigrams instead of the full product name. See Product trigrams for the specific trigrams denoting each product.

Related pages

  • Changing Magic Collaboration Studio license
  • Accessing Magic Collaboration Studio web applications