AnyLogic
Expand
Font size

Private Cloud: Administrator panel

Applies to AnyLogic Cloud 2.5.0. Last modified on November 20, 2024.

Use the administrator panel of Private Cloud to get a quick overview of your license information, check how various Cloud services perform in different situations, manage user profiles and their permissions, and customize the appearance of your Private Cloud instance.

This feature is available to administrators of AnyLogic Private Cloud instances.

To access the administrator panel

  1. Go to AnyLogic Cloud: Profile the user menu > AnyLogic Cloud: Admin panel Admin panel.

    AnyLogic Cloud: Admin panel menu item

  2. On the next screen, switch between tabs to get to the functionality you need.
    • Status — Provides a breakdown of the current state of Cloud services.
    • Users — Contains a list of users registered in your Private Cloud instance, as well as all the tools necessary to manage the user records.
    • Customization — Provides a selection of means to modify how your Private Cloud instance looks, allowing for a better reflection of your company’s chosen brand design.
    • Nodes, Services & Tasks — Contains multiple sections that let you review the current state of various Cloud service components.

Status tab

To open the Status tab

  1. While on the administrator panel, select Status in the left navigation bar.

AnyLogic Cloud: Status tab on the administrator panel

Status tab panels

The Status tab contains the following panels:

  • Cloud info — Information regarding your Private Cloud license.
    Cloud version The version of your Private Cloud instance.
    To learn more about the features of different Private Cloud versions, check the release notes.
    Environment Specifies the installed edition of Private Cloud: either Lite, Pro, or Enterprise.
    For more information about different editions of Private Cloud, see Private Cloud.
    Release date The date and time your shipment of Private Cloud was released. This information might be requested from you by our support team.
    Release hash The hash of your shipment of Private Cloud. This information might be requested from you by our support team.

    Support expiration date

    The date when your Private Cloud support license expires.
    To learn how to renew your license, contact our support team.
    Evaluation expiration date The date when your evaluation period ends.
    To learn how to purchase a license, contact our support team.
    Build date The date when your Private Cloud shipment was built. This information might be requested from you by our support team.
    Team License Server address The address and port of your Team License Server.
  • Cloud state — Information regarding the current state of Private Cloud service components and tasks currently running.
    Registered services The number of service components associated with your Private Cloud instance.
    To learn more about the state of individual components, go to the Services section of the Nodes, Services & Tasks tab.
    Running tasks The number of tasks currently in progress.
    To learn more about individual tasks, go to the Running tasks section of the Nodes, Services & Tasks tab.
  • Cloud health report — Contains a short excerpt describing the current state of your Private Cloud instance.

To specify the address of a different instance of Team License Server

  1. Click Edit on the Cloud info panel, next to the Team License Server address field.
  2. The Edit Team License Server address dialog appears.

    AnyLogic Cloud: The Edit IP address dialog

    In the Team License Server address field, specify the IP address and port of the new instance of Team License Server, in the following format:
    0.0.0.0:0
    You must specify the appropriate port after the address.
  3. Click Save.
    The successful modification of the Team License Server address will be confirmed in the notification dialog that appears in the top right corner of the screen.
  4. To ensure the changes are applied, you need to restart two service components.
    Go to the Services section of the Nodes, Services & Tasks tab.
  5. Select the checkboxes next to the controller component.
  6. Click Restart service.
  7. Upon successful restart of the controller, select the checkbox next to the rest service.
  8. Click Restart service.
    During the restart of the rest service, your Private Cloud instance will be unavailable, and you will need to authenticate once again after restart.

Upon completing the rest service restart, your Private Cloud instance will connect to the new instance of Team License Server.

Make sure to specify the correct address of Team License Server. In case you specify the address incorrectly, your license will be revoked, and the evaluation period will begin again. If you don’t connect your Private Cloud instance to Team License Server by the end of the evaluation period, this instance will become inaccessible.
Contact our support team in case you have any questions regarding licensing issues.

Users tab

To open the Users tab

  1. While on the administrator panel, select Users in the left navigation bar.

AnyLogic Cloud: The Users tab

The Users tab contains the full list of users registered in your Private Cloud instance and commands that you can use to manage the user profiles.

In the list of users, users that have administrator permissions are marked with Private Cloud: Administrator icon next to their user avatar.

In the right column of the table, each user record has the more_vert button. Click it to access the menu containing actions you can perform with the individual user account.

To navigate the list of users, use the pagination buttons in the bottom right corner of the screen.

To create a new user profile

  1. Click Create user.
  2. The Create user dialog appears.

    AnyLogic Cloud: The Create user dialog

    Specify the new user’s credentials in available fields:
    User type Required field. The type of permissions that will be assigned to the newly created user. Users of the User type will have regular permissions, while users of the Administrator type will be able to access the administrator functionality of your Private Cloud instance, including the administrator panel.
    Login Required field. The login (for example, the email) of the new user. They will use it to log in to the Private Cloud instance.
    First name Required field. The first name of the new user.
    Last name The last name of the new user.
    New password Required field. The password of the new user. They will use it to log in to the Private Cloud instance.
    Passwords support Latin characters, integers, and special characters only.
    To switch the password’s visibility during input on or off, click Show or Hide on the edit box’s right.
    Confirm password Required field. In this field, repeat the password for the new user.
    Passwords support Latin characters, integers, and special characters only.
    To switch the password’s visibility during input on or off, click Show or Hide on the edit box’s right.
    Company The company the new user belongs to.
    LinkedIn profile The link that refers to the LinkedIn profile of the new user.
    Personal page The link that refers to the new user’s personal page at any other domain name.
    About The optional description of the new user.
  3. Upon completing the form, click Save.

The successful creation of the new user profile will be confirmed in the notification dialog that will appear in the top right corner of the screen.

With the anylogic provider disabled in the registration.json configuration file, administrators still can create new instance-specific users, but they won’t be able to log in.

To search for a specific user profile

  1. Start typing the user’s email address (or a part of the email address) in the search box in the top right corner of the screen. The user list will be filtered immediately.

To edit an existing user profile

  1. In the left column of the user list, select the checkbox next to the user profile you want to edit, or
    Click more_vert next to the needed user’s record.
  2. Click Edit.
  3. Modify the user’s information as you see fit.

    AnyLogic Cloud: The Edit user dialog

    Check the table above for reference.
  4. Upon completing, click Save.

The successful modification of the user profile will be confirmed in the notification dialog that will appear in the top right corner of the screen.

With LDAP/AD or OAuth 2.0 authentication enabled, users originating from these providers might have uneditable fields, depending on the mapping settings.

To edit multiple existing user profiles

  1. In the left column of the user list, select the checkboxes next to the user profiles you want to edit.
  2. Click Edit.
  3. The Edit users form appears.

    AnyLogic Cloud: The Edit users dialog

    Modify the users’ information as you see fit.
    The value specified in the User type field applies to all users you have selected, that is, they will all be assigned the specified user group. Given that, we recommend making sure the users whose profiles you are trying to edit belong to the same user group.
  4. Upon completing, click Save.

The successful modification of multiple profiles will be confirmed in the notification dialog that will appear in the top right corner of the screen.

With LDAP/AD or OAuth 2.0 authentication enabled, users originating from these providers might have uneditable fields, depending on the mapping settings.

To copy a user’s login

  1. Click more_vert next to the needed user’s record.
  2. Click Copy login.

or

  1. Move the mouse pointer over the cell in the Login column that corresponds to the needed user s record.
  2. Click the content_copy Copy icon that appears on the cell’s right.

To send an email to a user

For this functionality to work, your Private Cloud instance needs an established connection between itself and an SMTP server. Specify the SMTP server in the email.json file, located in the /home/alcadm/alc/controller/conf directory by default.
  1. In the left column of the user list, select the checkbox next to the user profile belonging to the user you want to message, or
    Click more_vert next to the needed user’s record.
    By selecting multiple users with corresponding checkboxes, you can message multiple users.
  2. Click Send an email.
  3. In the resulting form, enter the text of your message.

    AnyLogic Cloud: The Send message dialog

  4. Click Send.

Your message will be emailed to the user. In the From field of the resulting letter, the service email will be specified, so your personal information will not be revealed. You can specify the service email in the Private Cloud configuration files.

To delete a user profile

  1. In the left column of the user list, select the checkbox next to the user profile you want to delete, or
    Click more_vert next to the needed user’s record.
    By selecting multiple users with corresponding checkboxes, you can delete multiple users.
  2. Click Delete.
  3. Confirm the action in the resulting dialog by clicking OK there.
It is entirely possible to delete your own user profile and those of other Private Cloud administrators. Upon deleting your profile, you will be logged out from Private Cloud immediately.
This is an irreversible action. Use this functionality with caution.

The successful deletion of the user profile will be confirmed in the notification dialog that will appear in the top right corner of the screen.

Customization tab

On the Customization tab, adjust the look and feel of your Private Cloud instance to reflect your company’s chosen brand design:

Private Cloud: The customized UI

To open the Customization tab

  1. While on the administrator panel, select Customization in the left navigation bar.

AnyLogic Cloud: Cloud customization settings screen

To upload custom images

  1. Click one of the following buttons to replace an image:
    • Change logomark — Replace the logomark: the small size image that appears in the upper left corner of the browser window in the Private Cloud workspace.
    • Change logotype — Replace the logotype: the big-size image that appears, for example, on the Private Cloud login page.
    • Change favicon — Replace the favicon: the small-size image displayed in the browser next to the page’s title on the Private Cloud tab.
  2. In the subsequent dialog, select an image file. To do that, you can either drag and drop the desired file directly into the dialog space, or click Upload an image, locate the desired file, then double-click the file or select it and click Open.
    The following image formats are supported: GIF, PNG, and JPG.

    Private Cloud customization: Image upload dialog

  3. On the next page of the dialog, specify which region of the image you want to use. To move the selection area, click and move the area while holding the left mouse button. To resize the selection area, use the rectangular handles in the area’s corners.

    Private Cloud customization: Image size

  4. Click OK to complete the uploading process. The image you have added will replace the default image of the chosen type in the preview area. Use tabs above the preview area to switch between different display modes: App bar, Login, or Loading.
  5. Click Apply changes to save the changes you have made.

You can discard your changes at any time before applying them by clicking Cancel editing.

To select a custom base color

In Theme base color, select a primary UI color for your Private Cloud environment.

You can either select one of the suggested default colors or pick a custom color.

To pick a custom color:

  1. Click Custom.
  2. In the subsequent color picker dialog, use the available controls to specify the desired color. The layout and functionality of the color picker dialog may vary in different browsers and operating systems.
  3. Confirm your choice by clicking OK. The color you have chosen will replace the primary UI color in the preview area, as well as on the Cloud customization settings screen toolbar. The default color of the font used in the UI may be adjusted slightly to improve readability. Use tabs above the preview area to switch between different display modes: App bar, Login, or Loading.
  4. Click Apply changes to save the changes you have made.

You can discard your changes at any time before applying them by clicking Cancel editing.

To select a custom background color for the loading screen

In Loading background, select a background color for the environment’s loading screen.

To pick a custom color:

  1. Click Custom.
  2. In the subsequent color picker dialog, use the available controls to specify the desired color. The layout and functionality of the color picker dialog may vary in different browsers and operating systems.
  3. Confirm your choice by clicking OK. The color you have chosen will replace the background color of the environment's loading screen. You can check the result on the Loading tab.
  4. Click Apply changes to save the changes you have made.

To discard your changes at any time before applying them, click Cancel editing.

To restore default images and colors

  1. On the Cloud customization settings screen, click Reset to default.
  2. Click OK in the confirmation dialog.

To change the page title of the instance in a web browser

Manually edit the frontend.json configuration file.

  1. Open the frontend.json configuration file, located in /home/alcadm/alc/controller/conf on the machine hosting the Cloud instance.
  2. Enter your custom text in the documentTitle field:
    "documentTitle": "new tab text"
    Make sure that the resulting file is valid JSON.
  3. Save the file and restart the controller and frontend components by executing the following command:
    sudo docker restart controller && sudo docker stop frontend

Nodes, Services & Tasks tab

To open the Nodes, Services & Tasks tab

  1. While on the administrator panel, select Nodes, Services & Tasks in the left navigation bar.

The Nodes, Services & Tasks tab consists of three sections:

  • Services — Contains the list of currently running service components of your Private Cloud instance.
  • Running tasks — Contains the list of tasks currently executed within the instance.
  • Nodes — Contains the list of nodes — the server machines that run your Private Cloud instance, with each machine having a list of service components associated with them.

Services section

In the Services section, you can check the list of service components of your Private Cloud instance, as well as manage them.

AnyLogic Cloud: The Services section

Each service has its separate tile, containing the following information:

  • The name of the service
  • The node the service is located on
  • The service log (hidden by default)

The state of the services is updated every 15 seconds. You can disable the auto-refresh functionality by switching Auto refresh off in the top right corner of the screen or manually update the state of services by clicking Refresh list.

To view the service log

  1. Click the Show log button located on the tile’s right.

While the log is in the expanded state, you can specify how many lines of the log you want to view, in the Show log’s last lines edit box.

To restart the service

  1. Select the checkbox on the left side of the tile of the service you want to restart. You can select multiple services.
  2. Click Restart service.
  3. Confirm the action in the subsequent dialog by clicking OK.

The services you have restarted will become unavailable for some time. The functionality they control will become unavailable, as well.

Some services are vital to the whole functionality of the Private Cloud instance. For example, the REST service maintains all interactions with the Private Cloud internal API. Upon restarting this service, the whole instance will become unavailable until the service finishes its restart.

To reload the service from an image

An image is a snapshot of the properly working state of the service. You may want to reload a service from an image upon encountering an issue that causes the Private Cloud instance to behave incorrectly. Reloading the service from the image may resolve the issue, though this must be used with caution.

  1. Select the checkbox on the left side of the tile of the service you want to restart. You can select multiple services.
  2. Click Reload image.
  3. Confirm the action in the subsequent dialog by clicking OK.

The services which you have reloaded will become unavailable for some time. The functionality they control will become unavailable, as well.

Running tasks section

In the Running tasks section, you can check how executors handle the model runs they’ve been assigned to process.

AnyLogic Cloud: The Running tasks section

  • executor-multi-run processes experiments that require multiple runs and splits them into single runs
  • executor processes the single-run experiments and SVG animations

For each experiment being run, its information is shown in a table row. Each row consists of the following columns:

Type The type of experiment being run.
Task ID The unique ID of the task associated with the experiment run.
Model Version ID The unique ID of the model version that is used in the experiment run.
Model ID The unique ID of the model whose version is used in the experiment run. Click to open the model screen.
User ID The unique ID of the user who requested the experiment run. Click to open the user profile.
Action

This column contains the Cancel button which you can use to stop the task’s execution.
The button is initially hidden. Hover the mouse cursor over the task’s row for it to appear.

Nodes section

In the Nodes section, you can check which server machines are used to run your Private Cloud instance, and which components are associated with each of them.

AnyLogic Cloud: The Nodes section

Each machine has its own tile in the interface, containing the following information:

Address The IP address of the server machine.
Volume root The location of the Private Cloud components within the server machine’s file structure.
Services The service components that are installed on the machine.
SSH access The IDs of the SSH keys which you can use to access the server machine.
How can we improve this article?