Getting Started with Arc Server on Linux

Getting Started with Arc Server on Linux

Getting Started with Arc Server on Linux

This guide covers installing and running Arc Server on Linux.


Prerequisites

  • TM1 11+ (Planning Analytics 2+) is recommended. Some features work with TM1 10.2.2 but important APIs are only present in TM1 11+.

  • The TM1 REST API must be enabled: set HTTPPortNumber=8111 in tm1s.cfg.

  • Arc should be installed on the same server as TM1 for full functionality (ODBC, text file preview in TI processes).


Step 1: Download Arc for Linux

  1. Go to code.cubewise.com/arc-download

  2. Copy the download link for the Linux 64-bit version.

  3. Use wget to download Arc on the server:

wget <download-link>

Step 2: Unzip and Configure Permissions

Unzip the downloaded archive:

unzip arc_linux.zip

Assign executable permissions to the Arc binary:

chmod +x arc

Step 3: Start Arc

Run Arc in the foreground:

./arc

To run Arc in the background:

./arc &

Arc will be accessible at: https://servername:7070


Step 4: Activate a Trial or License

On first run you will need to validate a license. See Trialling and Buying Arc.


Step 5: Connect to TM1

Arc uses the TM1 REST API to connect to instances. Configure the adminhost in settings.yml:

adminhosts: - https://localhost:5898

If Arc cannot connect to your TM1 instances:

  • Verify the TM1 REST API is accessible in your browser.

  • Double-check credentials (CAM Namespace is case-sensitive).


Optional: Add Arc to System PATH

To run Arc from any directory without specifying the full path, see Adding Arc Path to the Linux User's Environment.

Optional: Run Arc as a Linux System Service

To keep Arc always running across server restarts, see Setting Up Arc as a Linux System Service.