Skip to main content
Feedback

Installing the initial runtime cloud cluster node on Windows

Use the runtime cloud cluster installer to install the initial runtime cloud cluster on your Windows operating system.

Before you begin

Runtime cloud clusters require either the Java 8 JRE or Java 11 JDK. Boomi recommends Java 11. Boomi internally tested Amazon Corretto OpenJDK Java 1.8.0_382 and Amazon Corretto Open JDK 11.0.20.8.1.

Before completing these steps, download the runtime cloud cluster installer and set up a Windows shared directory. Depending on the version of Windows you are running, you might require Administrator access to run the runtime cloud cluster installer.

The installer gives you an option to select local directories for storing working data and temporary data. Boomi strongly recommends that you select the Use Local Storage for Runtime Assets setting. If you select local directories, ensure that these directories exist before you run the installer. The installer does not create the directories for you. For new runtimes, you can enable local storage during installation.

If you do not have Java 11 installed on your machine, you can download the installer file that includes a private copy of Java 11 (11.0.20.8.1) from the Runtime Management page. You can alternatively manage your own distribution of the Java 11 JDK by downloading the JDK from Amazon prior to installing the runtime cloud cluster.

note

Ensure that you use the Java binary to run the installer comes from the <jdk>/jre/bin directory and not the <jdk>/bin directory.

Warning

If there are Unicode characters in the directory path to where you intend to install the runtime cloud cluster, the installation will fail.

Procedure

  1. After downloading the runtime cloud cluster installer, run the installation file.

  2. If you see a security verification window, click Yes.

    The Cloud Setup Wizard opens.

  3. On the Welcome page, click Next.

  4. On the User Information page:

    1. Select User Name and Password or Token, depending on how you want to authenticate the runtime cloud cluster.

    2. Enter one of the following, depending on the option you selected:

      • Type your user name and password

      • Type a valid installer token

      You can create tokens when you download the runtime cloud cluster installer from the Cloud Setup dialog. When generating tokens, they are valid only for the specific account and runtime clouds. Tokens expire after a set amount of time ranging from 30 minutes to 24 hours.

    3. Enter a name for the runtime cloud cluster.

      The runtime cloud cluster name that you see following the runtime cloud name when you go to Manage > Runtime Management. The name defaults to the local host name, but you can change it to something more familiar.

      note

      The following characters are reserved and cannot be used in the name: asterisk (*), backslash (\), caret (^), colon (:), dollar sign ($), greater than (>), less than (<), percent (%), pipe (|), question mark (?), quotation mark ("), slash mark (/), Yen sign (¥).

    4. If the local machine uses an HTTP proxy to connect to the internet, select Use Proxy Settings and enter the appropriate host, port, user name, and password for the proxy.

      If you do not fill out the proxy settings now, you can add them later.

    5. Click Next.

    You connect to the Boomi Enterprise Platform and it authenticates your credentials.

    If you specified a user name and password, the Accounts page appears followed by the Clouds page.

    If you specify an installer token, the Select Destination Directory page appears and you can skip to step 7.

  5. (Optional) On the Accounts page:

    1. If your user name has access to multiple accounts, a list of accounts appear. Select the account with which to associate this runtime cloud cluster. This step typically applies only to partners.

    2. Click Next.

  6. On the Clouds page, select the runtime cloud with which to associate this runtime cloud cluster and click Next.

    This step is the runtime cloud that you added to the Runtime Management panel before downloading the runtime cloud cluster installer.

  7. (Optional) On the Environment page:

    1. If you created environments for your account, a list of them appears. Select the environment with which to attach this runtime cloud cluster. If you do not select one, your new runtime cloud cluster appears in the list of Unattached Runtimes on the Runtime Management page in the user interface.

    2. Click Next.

  8. On the Select Destination Directory page, select the installation directory and click Next.

    You must install the runtime cloud cluster in the shared directory from the first machine using the FULL UNC path of the shared directory. For example, the directory name appears as: //<host_name>/Share/<cloud_installation_directory> where <host_name is the name of the machine. You also can choose a sub-directory of the UNC path.

  9. On the Select Local Cluster Node Directories page:

    1. Select a local directory for storing the runtime cluster node.

      The "Yes, store assets locally" is selected by default and strongly recommended. You must provide a local directory path with this option. If you select "No, use cluster shared storage instead (not recommended)" you will be directed to a new dialog box to a destination directory.

    2. Select a directory for storing the runtime cluster node’s temporary data. This value sets the -Djava.io.tmpdir property in the <runtime_install_directory>/bin/atom.vmoptions file.

    3. Click Next.

  10. On the Select Start Menu Folder page, modify any Start menu settings and shortcuts and click Next.

  11. On the Information panel, review the installation settings and click Next.

    The all of the necessary files install for your runtime cloud cluster.

  12. After completing the installation, click Finish to start the runtime cloud cluster.

Next steps

You need to set up the runtime cloud’s Windows service.

On this Page