Skip to main content

Environment Setup

Before building with PARA or running the runtime, source the para-env-setup.sh script at the SDK root into your current shell to configure the environment.

Usage

The script must be sourced (not executed). If you run it without sourcing, the script aborts on its own.

cd /path/to/para-sdk
. ./para-env-setup.sh

It is written to work in sh/bash/zsh. If you invoke it the wrong way (such as running it directly like ./para-env-setup.sh), it aborts with the message Error: This script must be sourced. Please run it as '. ...'.

On success, the following notice is printed.

PARA environment setup completed. You may proceed with the following:
- Build the PARA Adaptive Application project
- Ensure $PARA_CONF, $PARA_DATA, and $PARA_APPL are set correctly
- Run PARA with 'EM'

Environment Variables That Are Set

The script determines PARA_SDK based on its own location, then sets the variables needed to run the runtime.

VariableValuePurpose
PARA_SDKSDK rootSDK location
PARA_CORESDK rootRuntime core root
PARA_CONF$PARA_CORE/etcConfiguration / manifest directory
PARA_DATA$PARA_CORE/varRuntime mutable data
PARA_APPL$PARA_CORE/optDeployed applications
PATH$PARA_CORE/bin appendedDaemon and tool execution path
PKG_CONFIG_PATH$PARA_SDK/external/lib/pkgconfig appendedThird-party pkg-config

Note that in a freshly extracted SDK, etc/ and opt/ do not yet contain machine/app manifests, so launching EM directly does nothing meaningful. First build and install the example Machine, then launch the runtime with the generated para-exec.sh wrapper — see Build with CMake.

Verifying the Environment

You can verify that the configuration was applied with the following.

echo "$PARA_SDK" # SDK root path is printed if correct
command -v EM # check that EM in bin/ is visible on PATH