Installing on macOS

Introduction

This document describes how to run Composable Architecture Platform using the Tomorrow-Software-Server-2021-noJRE-10.0.0.zip distribution for a macOS environment. This example is using macOS Catalina 10.15 and JAVA JDK 14.

Requirements:

• macOS capable of running JAVA JDK 11+

• JAVA JDK 11+

• Tomorrow-Software-Server-2021-noJRE-10.0.0.zip (or other approved) distribution for Composable Architecture Platform

• Chrome browser

• Root user access permissions

Useful things to know

JAVA environment - Composable Architecture Platform requires Java v11+ JDK Runtime Environment to run so check if Java is installed and the Java running version.

The Composable Architecture Platform installation uses the open source Jetty application server.

Enable macOS root user - To run Composable Architecture Platform on macOS, the "root" user needs to be enabled. If the root user has previously been enabled, the root user password will be required. To enable the root user, please follow the instructions at the following Apple support page:

https://support.apple.com/en-us/HT204012

Check Java installation and version

Command: java –version

Will either return “command not found” when no Java installation has been installed or display the current Java installation details.

e.g. Java version details

# java –version

java version "14" 2020-03-17
Java(TM) SE Runtime Environment (build 14+36-1461)
Java HotSpot(TM) 64-Bit Server VM (build 14+36-1461, mixed mode, sharing)

Install or modify Java

If you don’t have Java or have an older Java version, then you’ll need to upgrade with the following steps:

1. Locate and download the Java SE Development Kit 14 (JDK) macOS Installer from https://www.oracle.com/java/technologies/javase-downloads.html

2. Once downloaded, located and double click the downloaded file (jdk-14.0.1_osx-x64_bin.dmg) and follow instructions to complete the installation

3. To confirm that you have successfully installed the JDK 14, rerun the Check Java installation and version steps above

Download, upload, unzip, run.

1. Download the Composable Architecture Platform distribution zip file

2. Unzip the downloaded Composable Architecture Platform zip file into the desired destination folder.

You may consider moving the zip to another folder (e.g., Applications) before unzipping.

Unzipping will produce a new folder called “Tomorrow-Software-Server-10.0.0”. You may then proceed to archive or trash the downloaded zip file.

Note: the location of the file named Product Reference.pdf is in the Documentation folder. This is the comprehensive document for the entire Composable Architecture Platform.

Important: Don’t refer to Product Reference.pdf until the latest updates have been applied via console updates after installation, as there may be an update available.

3. Open a new Finder window (Command + N) and navigate to the folder used to unzip the Composable Architecture Platform (e.g., Applications)

4. Double click “Tomorrow.command”

Tomorrow.command

If you encounter insufficient privileges to launch the script in Terminal, then modify using chmod 755 Tomorrow.command before launching.

5. Enter the macOS root user password in the Terminal window. After a successful start you should see the following:

$Password:
2020-04-20 16:23:16.326:INFO::main: Logging initialized @812ms to org.eclipse.jetty.util.log.StdErrLog
2020-04-20 16:23:16.611:INFO::main: Console stderr/stdout captured to /Applications/Tomorrow-Software-Server-2021-noJRE-10.0.0/server/logs/stderrout-2020_04_20.log

6. Navigate to http://localhost/console

Login

7. Use the default administrator credentials to access the console:

Username: admin
Password: admin

Useful things to know before launching

When launching the console application, there may be other demo applications and a built-in proxy server that will also launch at the same time. Default ports 80 and 443 are used to run the console application, and therefore must be available before launching. To modify default ports, refer Product Reference.pdf section: Port numbers and how to change them.

Port	Use
80	HTTP port for the console, demo applications and the built in proxy
443	HTTPS port for the console, demo applications and the built in proxy

Shutting down

To stop Composable Architecture Platform use Control-C in the active terminal screen. This will terminate the instance.