Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SAP SQL Anywhere, on-demand edition 1.0 » SAP SQL Anywhere, on-demand edition » Installation


Installing and initializing a cloud (Linux)

Install, initialize, and configure your cloud.


The minimum supported configuration for a cloud includes two cloud partners and one cloud arbiter with high availability enabled. Cloud partners are cloud servers that are identical and oversee all activity between hosts and servers in the cloud. Each cloud partner and the cloud arbiter must be on separate computers to ensure that if one computer fails, your cloud continues to run. Both cloud partners must run constantly and on the same operating system. They must have Internet connectivity and access to your SMTP servers to send alert emails.

  • Timezone synchronization   Computers running cloud hosts must have UTC times synchronized to within 30 seconds of each other.

  • Host name restrictions   By default, the host name is the computer name. Host names can only contain the following characters: a-z, A-Z, 0-9, minus sign (-), period (.), and underscore (_).

  • Firewalls must allow TCP/IP connections   Configure firewalls for cloud hosts to allow TCP/IP connections to the TCP/IP, HTTP, and HTTPS ports used by each cloud server installed on the host. Configure firewalls on or between hosts that are used to connect to cloud servers to allow TCP/IP connections to the TCP/IP, HTTP, and HTTPS ports used by the cloud server.

    If your firewall blocks incoming application connections, then configure the firewall to allow connections to the dbsrv16 executable. If your firewall blocks outgoing application connections, then configure your firewall to allow outgoing connections from all cloud executables.

    If firewalls are not configured properly, then connections may fail.

  • Cloud Console requires Adobe Flash   Install Adobe Flash on any cloud host where cloud administration is performed.

Context and remarks


During the install process, several passwords are set, some of which cannot be changed for the life of the cloud. Record the specified passwords and store them in a safe place.

Run the cloud installer as the root user.

 Install and configure the first cloud partner
  1. Access the SAP SQL Anywhere, on-demand edition software from SAP and run the installer (setup), accepting all defaults. When prompted, specify the key that was provided to you when you registered.

    The default cloud installation directory is /opt/saondemand100/.

  2. After the installation is complete, the setup program prompts you to create a cloud. Accept the prompt.

    The installer launches the Cloud Initialization utility found in the cloud installation directory. For example: /opt/saondemand100/sa-linux64-x64-


    Do not run this utility after your cloud is running unless you intend to remove your existing cloud and create a new one. All existing cloud data (including tenant databases) are deleted; this process is irreversible. Before running this utility, delete all your hosts except your last cloud partner, and stop the cloud.

  3. For the Enter the cloud name prompt, give your cloud a name.

    The cloud name must conform to the rules for cloud object names.

  4. For the Enter the two-letter language code for the cloud language prompt, enter the language you want your cloud to use.

  5. Create the cloud administrator by providing a user ID, password, and full name for the cloud administrator.

  6. For the Select how this host will be addressed by the cloud prompt, specify dynamic or static host addressing. If you are unsure what to specify, then check with your system administrator to find out how addressing is configured for your network.

  7. For the Enter the user account name the cloud server should run as prompt, specify which Linux user account the cloud will run from.


    Do not run the cloud from the root user account in a production system.

  8. If you specified a non-root user in the previous step, then the default port settings are as follows:

    Communication protocol Default port
    HTTP 40800
    HTTPS 40400
    TCP/IP 2638

    For the root user, the default port settings are:

    Communication protocol Default port
    HTTP 80
    HTTPS 443
    TCP/IP 2638

    If an error is returned indicating that a port number is already in use, change the value to an available port.

  9. For the Enter the encryption key prompt, specify an encryption key. The encryption key is restricted to 7-bit ASCII characters and is used to encrypt the cloud. By default, the cloud uses RSA encryption. To use FIPS encryption, you can accept Do you want to use FIPS-approved encryption? You cannot alter the FIPS encryption option once the cloud is created.

    For the Enter the secure feature key prompt, specify a secure feature key to use for the cloud.

    The secure feature key is used to enforce tenant database isolation. It is restricted to 7-bit ASCII characters and must be between 6 and 128 characters. Secure feature keys cannot:

    • begin or end with a space or single quote
    • contain backslashes, double quotes, or semicolons
    • contain control characters (characters with an ordinal value of less than 32 or the character value 127)

    The secure feature key is used to enforce tenant database isolation.

  10. For the Choose a certificate to be used by the cloud prompt, specify the certificate to use for the cloud. If you do not have a certificate, the cloud creates one for you (RSA encryption with a 2048 bit key).


    The cloud uses certificates to secure communication between cloud servers and the Cloud Console. Unsigned certificates can cause certificate warnings in your browser when you attempt to access the Cloud Console. It is safe to ignore these warnings in a development environment. However, for increased security in your production environment, use a signed certificate.

You are about to create a host install that installs cloud software on the second cloud partner and the cloud arbiter.


The computer you designate for the cloud arbiter must have the same operating system and bitness as the cloud partners, so you can create a single host install that you run on the remaining two computers. If the bitness is not the same, create two host installs (use the Create host install web site twice), specifying the appropriate bitness. If the arbiter server will run on a different operating system, then download the cloud software for that operating system to the cloud.

Context and remarks

Use the Create Host Install web site (https://host-name:port-number/dbcloud/addhost) to create host installs. The Create Host Install web page creates a file called dbcloudaddhost, which you run on the two computers. The dbcloudaddhost file pulls the host install software that you created down from the cloud and runs it. Each host install is specific to an operating system and bitness.

 Install and configure the second cloud partner and the cloud arbiter
  1. On the computer where you installed the first cloud partner, in the Cloud Console, click Hosts.

  2. On the Hosts panel, click Create host install. If prompted, accept the certificate and continue.

    If you cannot access the Cloud Console, then navigate to https://host-name:port-number/dbcloud/addhost.

  3. For Host install type, select Multiple use because you are going to use the install more than once. Once on the computer that will be the cloud partner, and once on the computer that will be the cloud arbiter.

  4. For Valid for (days), specify the number of days that the install remains available before it is removed from where it is stored in the cloud, or accept the default (recommended).

  5. In the Install can be run on, select Restricted and enter the names and/or IP addresses for the computers that will host the second cloud partner and the cloud arbiter (recommended), or accept the default, Unrestricted - can be run on any machine.

  6. For Install version, select the platform/bitness of the host where you are going to run the host install.

  7. For Installation directories, specify the location to install the software and cloud data to, or accept the defaults (recommended).

  8. For Server ports, accept the default ports that the cloud servers will use (recommended), or specify different ports.

  9. Leave Create and start a cloud server on the host selected.

  10. Click Create and Download to create and download the dbcloudaddhost file. The file is downloaded to the default download location for your browser.

  11. Run the following command:

    chmod +x dbcloudaddhost
  12. Copy dbcloudaddhost to the computers that will host the second cloud partner and the cloud arbiter, and run it.

  13. Specify your cloud user name and password when prompted.

    dbcloudaddhost performs the following operations:

    • Downloads the correct cloud software from the cloud to the host you are installing

    • Installs the cloud host software

    • Adds the host to the cloud

    • Creates and starts a cloud server

    • Cleans up local install files

  14. After you have run dbcloudaddhost on both computers, log in to the Cloud Console to confirm that the cloud now has three cloud servers running.

  15. In the Cloud Console, navigate to the Overview panel.

  16. Under High Availability, and click the Configure high availability link.

  17. In the Cloud High Availability window, set the cloud partner and the cloud arbiter by selecting the cloud servers running on the hosts you installed, then click Finish.


High availability is now configured and enabled for your cloud, and cloud setup is complete. You can start adding tenant databases to your cloud.


You are now ready to add more hosts, servers, and tenant databases to the cloud.

 See also