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