LogoLogo
  • Documentation
  • PRODUCT REFERENCE
    • Introduction
    • Concepts and Terminology
      • Console
      • Servers (X Agents)
      • Projects
      • Configurations
      • Rules Editor
      • Rules, rule catalogue, protocol rules and rule sets
      • Test Data
      • Trace Data
      • Flight Recorders
      • Case Managers
      • Data Files
      • Content Files
      • Performance Data
      • Extensions
      • Protocols
      • Credential Vault
      • Custom Functions
      • Databases
      • Input Adaptors
      • Users
      • User Roles
      • Access Rules
      • Repositories
      • Audit Log
      • Proxies
    • Architectural Scenarios
      • Command and Control
      • Simplest Form
      • Servlet Filter
      • API Transformation
      • Active Web Proxy
      • Web Application Server
      • Active Proxy With Content
      • Mobile Application Server
      • Asynchronous Multi-Protocol
      • Data Loss Prevention Architecture
    • Getting Started
      • Login
      • Essential Things to do First
      • Keeping the Product Current
      • Common Console Management Tasks
      • Viewing Active Servers
    • Quick Product Introduction
      • Preparing the Browser Proxy
      • Setting up the Proxy in the Browser
      • Verifying the Browser Configuration
      • Understanding the Configuration
      • Understanding input and variables
      • Preparing a new repository
      • Locating the Page to Modify
      • Determining the Actions Required
      • Building the First Rule Set
      • Setting Rule Properties
      • Connecting up the First Rule
      • Getting a Server Result
      • Manipulating the Server Result
      • Returning the Result to the User
      • Creating a Configuration for the Rule Set
      • Selecting the Input Source
      • Deploying the New Configuration
      • Testing the Rules
    • X Agent details
      • Configuration Settings
      • Rule Sets
      • Tips and Techniques for Working with the Rules Editor
      • Web Application Rule Set Patterns
      • Building Rule Sets for Inclusion
      • Notes on Working with SOAP
      • Zero Installation Rules Testing
    • Data Files
    • Content Files
      • Previewing Content Files
      • Editing Content Files
      • Deploying Content Files
    • Test Data
      • Uploading and Downloading Test Data
    • Performance Data
      • Setting the Performance Collection Level
      • Retrieving the Performance Data
      • Viewing Transaction Counts
      • Viewing Transaction Counts and Inline Time
      • Viewing the Complete Performance Report
      • Understanding the URI Performance Information
      • Performance Benchmarks
    • Trace Data
      • Understanding the Trace
    • Tracing the Result of a System Failure
    • Conjoined Performance and Trace data
    • Live Performance Data and Probes
      • Setting Probes
      • Live Performance Impact Considerations
    • Accessing Server Logs
      • Viewing a log
    • Working with Flight Recorders
      • Searching Flight Recorder Information
      • Retrieving Flight Recorder Data
      • Graphing Flight Recorder Data
    • Working with Case Managers
      • Case Manager Definitions
      • Navigating the Case Managers
      • Creating a Case From Rules
      • Creating a Case From the Console
      • Viewing the Queues
      • Picking a Task
      • Case View
      • Completing a Task
      • Task History
      • Searching Tasks
      • Searching Cases
    • Managing Repositories
      • Moving Files Between Repositories
      • Copying Configurations and Rule Sets Together
      • Copying Dependent Rule Sets
      • Backing up
      • Moving Entire Repositories Between Consoles
      • Setting Repository Imports
      • Specifying Repository Rule Group Restrictions
    • Version Control and Restoring Files
    • Using the Portal UI
      • Using the Start Menu
      • Positioning Windows
      • Resizing Windows
      • Maximize, Restore and Minimize
      • Storing and Switching Desktops
    • Enterprise Level Projects
      • Creating a Project
      • Working with Tasks
      • Closing a Task
      • Closing a Project
      • Project Assistants and Work Output
    • Administration Functions
      • Extensions
      • Custom Function Setup
      • Setting up a Database
      • Input Adaptors
      • Credential Vault
      • Log Adaptors
      • Server Definitions
      • Managing Large Clusters
      • Setting up the Flight Recorder in the Console
      • Creating a Case Manager Definition
      • Work Output
      • Project Definition
      • Managing Users
      • Managing User Roles
      • Managing Access Rules
      • Authenticating via LDAP
      • Authenticating via SAML
      • Audit Log
    • Installation and Configuration
      • Installing on macOS
      • Installing on Red Hat Enterprise Linux
      • Installing on Windows - Quick Start
      • System Requirements
      • Server Installation
      • Understanding the Console Deployment Structure
      • Console Server Type Configuration
      • Console Server Configuration
      • Removing Other Unnecessary Components
      • Installing Inline with an Existing Application
      • Installing a Stand-alone Multi-Protocol Feed Server
      • Installing a Stand-alone Built in Forwarding Proxy
      • Creating a Cluster Slave Console Instance
      • Understanding the magic.properties Configuration Settings
      • Port Numbers and how to Change Them
      • Dealing with Internal Failures
      • Linking Multiple Applications Together into a Single Server
      • Monitoring by External Systems
      • Installation Considerations for Portals
      • Docker Configuration Guide
      • AWS User Deployment Guide
      • Google Cloud User Deployment Guide
    • Creating a Stand-alone Built in Forwarding Proxy
      • Installing with Ubuntu and mySQL
    • Setting up a DNS override for Data Loss Prevention
      • Deciding what to Override
      • Installing a DNS Server for the Overrides
      • Setting the Override
      • SSL Considerations
    • Backup and Restore
      • The Server Component
      • The Console Component
    • Third Party Software
      • Open Source Components
      • Closed Source Licensed Components
      • Licenses
  • PROGRAMMER'S GUIDE
    • Composable Agentic Platform Concepts
    • Setting up a Development Environment
    • Creating a Rule
    • The Kapow Extension - Example
    • Java Documentation
  • CONSOLE WIZARDS
    • Create REST with JSON service
    • Create JDBC database definitions
    • Create data set maintenance custom function
  • BEST PRACTICES
    • Naming Conventions
    • Comments & Descriptions
    • Application Configuration
    • Rules & Rule Sets
    • Repositories
    • Data Manipulation
    • Internationalization
    • Debugging
    • Performance Testing
    • Tag Replacement Techniques
    • Best Practices Repository
  • GUIDES
    • Hello, World!
    • TCL Script Writer Reference
    • Windows Automation Reference
    • Browser Certificate Installation Guide
    • Web Development Guide
    • Using the Push Notification Framework
    • Raspberry Pi with PiFace Reference
    • TomorrowX Portal User Guide
    • Examples
      • CSRF attack prevention
      • Two Factor Authentication
      • Frame Busting
      • Google Analytics
      • DNS Multi Protocol
      • Customer Satisfaction Survey
  • CHANGE HISTORY
    • New in Version 8
    • New in Version 7
    • New in Version 6
    • New in Version 5
    • New In Version 3.1
    • New In Version 3.0
  • 🌏TIME ZONES
  • ❓TROUBLESHOOTING
    • DB2 SQL error: SQLCODE: -443
    • Error 404 when trying to access the console
    • java.io.IOException: Too many open files
    • Accidental deploy to console server
  • ⚙️BROWSE COMPONENTS
  • EULSA
Powered by GitBook
On this page
  • Introduction
  • Requirements:
  • Useful things to know
  • Check Java installation and version
  • Install or modify Java
  • Download, upload, unzip, run.
  • Useful things to know before launching
  • Shutting down
Export as PDF
  1. PRODUCT REFERENCE
  2. Installation and Configuration

Installing on macOS

PreviousInstallation and ConfigurationNextInstalling on Red Hat Enterprise Linux

Last updated 4 months ago

Introduction

This document describes how to run Composable Agentic 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 Agentic Platform

  • Chrome browser

  • Root user access permissions

Useful things to know

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

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

Enable macOS root user - To run Composable Agentic 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:

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. Once downloaded, located and double click the downloaded file (jdk-14.0.1_osx-x64_bin.dmg) and follow instructions to complete the installation

  2. 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 Agentic Platform distribution zip file

  2. Unzip the downloaded Composable Agentic 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 Agentic 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.

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

  2. Double click “Tomorrow.command”

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

  1. 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
  1. 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 Agentic Platform use Control-C in the active terminal screen. This will terminate the instance.

Locate and download the Java SE Development Kit 14 (JDK) macOS Installer from

Navigate to

https://support.apple.com/en-us/HT204012
https://www.oracle.com/java/technologies/javase-downloads.html
http://localhost/console
Tomorrow.command
Login