Installing Private Cloud

Before installing AnyLogic Private Cloud, make sure that the external 80 or 443 (for HTTPS only) ports are open and available.

It is also assumed that your internal network configuration allows for connecting to external interfaces from the host itself, specifically from the following ports: 22, 80, 5000, 5432, 5672, 80, 9000, 9042, 9050, 9080, 9101, 9102, 9103, 9200, 9201, and 9202.

Note: You should execute all commands described below in your Linux terminal.

Downloading the Private Cloud installation package

  1. Create a directory to which you will download Private Cloud, or choose an existing one:
  2. Download Private Cloud:

Installing Private Cloud Lite

  1. Unzip the installation file:
    tar -xf anylogic-private-cloud-lite.tar.gz
  2. Navigate to the resulting folder:
    cd anylogic_private_cloud_lite
  3. Run the installer script:
    sudo ./install.sh

    During the installation, you will need to specify the Private Cloud external address.
    Enter Cloud external address :
    Type in a valid hostname or IP address, and press Enter.

    Note: The hostname or IP address you use should be the same address the end-users will use to connect.
    You should not use loopback addresses like localhost or 127.0.0.1.

    Next, you will be asked whether you would like to specify the License Server address during installation. You need a properly configured License Server to continue using AnyLogic Cloud after the evaluation period.
    Enter Y to configure license server address [y/n]:

    Note: You may configure this address later using the administrator panel.

    If you have chosen to specify the License Server address, type in the valid License Server address and press Enter.
    Enter License Server address :

    Next, you will need to specify whether you plan to enable HTTPS support in Cloud.
    Enter Y to enable HTTPS support [y/n]:

    To proceed with HTTPS configuration, you need a valid SSL key and certificate pair.
    Specify the full path to your SSL key.
    Enter HTTPS key file path :
    Specify the full path to your SSL certificate.
    Enter HTTPS certificate file path :

    You can simplify the installation process by manually providing the installer script with appropriate flags. To view the full list of supported flags, execute the following command:
    sudo ./install.sh --help
  4. Upon completing the installation, navigate to the address you have specified for your Private Cloud Lite instance using a browser of your choice. Click Guest in the top right corner of the screen, then select Log in. The Sign-in page, demonstrated on the screenshot below, will open up. The default credentials of the administrator account are as follows:

    Private Cloud: Administrator sign-in

    Note: Make sure to change the default password of the administrator account. To do that, log in as the administrator, click admin in the top right corner of the screen, then select Profile. After that, modify the password using the Change Password form.

    It is also recommended to change the default user name of the administrator account to a valid email on the administrator panel.

  5. Users of Private Cloud Lite will also need to create their accounts to begin uploading models. Alternatively, the Cloud administrator can create user accounts in the administrator panel.

To learn how to configure AnyLogic desktop installations to connect to your freshly installed Private Cloud instance, see Exporting a model to AnyLogic Cloud.

Installing Private Cloud Full

  1. After downloading the installation package, run the installation script install.sh on a machine that will serve as your primary node, that is, will host most of the Private Cloud service components. Proceed with the regular installation, similar to the Private Cloud Lite installation process.
  2. Upon completing the installation, you will need to prepare your secondary nodes — additional machines that your Private Cloud instance will use to run models. The following steps must be performed on each secondary node.
  3. After that, you need to distribute the necessary certificates from your primary node (the one that has Private Cloud installed):
  4. Next, you have to properly install the freshly acquired certificates on each secondary node:
  5. Now, inform the primary node about the nodes. To do that, edit nodes.json in the /home/alcadm/alc/controller directory.
    This file contains information about all nodes of a Private Cloud cluster.
    The following is the example JSON object that represents a secondary node:

    {
      "host" : "10.0.0.1",
      "sshAccess" : {
        "method" : "PRIVATE_KEY",
        "user" : "alcadm",
        "key" : "id_rsa"
      },
      "volumeRoot" : "/home/alcadm/alc/cache",
      "labels" : [ "executor" ],
      "stoppable" : false,
      "manageable" : true
    }

    For more information about Private Cloud configuration files, see the corresponding article.
  6. Restart the controller service component to apply changes by running the following command on the primary node:
    sudo docker restart controller
    After these changes, the additional nodes running executor services should be visible in the controller state report. To access this report, open the browser of your choice and go to http://%Private Cloud address%:9000/main.html (for older versions of Cloud) or http://%cloud adress%/admin/controller?tab=NODES (for Cloud 2.2.0 and later).

Related topics

AnyLogic Private Cloud

AnyLogic Cloud

AnyLogic Cloud options