Server Installation

A prerequisite for working with the Composable Agentic Platform Programmable Data Agent is an instance of a Composable Agentic Platform console server.

To perform the installation, un-zip the Composable Agentic Platform Server distribution somewhere within the local file system and start it using the Tomorrow.bat file (or the Tomorrow.sh file if using Linux, Solaris, or the Tomorrow.command file if using macOS).

The installation uses the open source Jetty application server. If you need to change ports or use of SSL, you can configure the application server using the http.ini configuration file found in the subfolder server/start.d/.

Please note that the server installation does not lay down a proper database. We strongly recommend that you use a production level database such as DB2, Oracle or MySQL.

Now open a browser and point it to http://localhost/console.

Login interface

You will see the main page and the console is ready to use. However, we suggest that you first review and complete additional configuration by following the steps in the relevant sections below, and also refer to the earlier section “Getting Started”.

Installing as a Windows Service

Composable Agentic Platform Console service wrapper

The CAP Console can be installed as a Microsoft Windows service. This provides a convenient way to manage the Console as part of standard Windows administration (auto-start on boot, automatic restart on failure, management via services.msc).

The wrapper used is WinSW (Windows Service Wrapper, MIT licensed). It is shipped in the WinService subdirectory of the distribution and requires no additional download or installation.

Prerequisites

  • Windows 10 / Windows Server 2016 or later (.NET Framework 4.6.1+ is pre-installed on these versions).

  • A Command Prompt running as Administrator — installing or removing a Windows service requires admin rights.

Install the Console service

This registers the service CAPConsole, configures it to start automatically on boot, and starts it immediately. Behind the scenes the service runs the existing Tomorrow.bat launcher in the distribution root, so all JVM arguments and Jetty configuration stay in one place.

The service will appear in services.msc as CAP Console.

Stop, start, restart

Use standard Windows commands from any administrator command prompt:

Uninstall the Console service

Further WinSW documentation is available at https://github.com/winsw/winsw.

CAP Multi-Protocol Agent (PDA) service wrapper

Multi-Protocol agents (and other Programmable Data Agents) live in subdirectories of the distribution root, each containing its own tomorrow.bat launcher. The default agent subdirectory is Multi-Protocol; load testing uses Stress.

To install a PDA as a Windows service, take note of the agent subdirectory name (e.g. Multi-Protocol) and run:

For example:

The service appears in services.msc as CAP Agent - Multi-Protocol. Repeat for additional agents (e.g. install-agent.bat Stress).

Uninstall the PDA service with:

For full details on the WinService folder layout, log file locations, antivirus considerations, and troubleshooting, see WinService\README.md in your CAP Console distribution.

Installing as a Linux Service

Please refer to the full Linux setup instructions found in the section Creating a stand-alone built in forwarding proxy or Installing on Red Hat Enterprise Linux.

Last updated