Creating Environment Variables

#1

Reactor Environment Variables
- Viewing the Reactor Log File
Using the Windows System Control Panel
Using a Linux BASH Profile
Using MacOS Launch Agent PLIST Files

Reactor Environment Variables

To see more diagnostic logging detail from the Reactor GUI you can add the REACTOR_DEBUG environment variable to your system:

Reactor Debug

The REACTOR_DEBUG environment variable can be set to true if you want to see more verbose logging output when you run the Reactor GUI:
Code: Select all
```
REACTOR_DEBUG=true
```
Viewing the ReactorLog.txt File

When the REACTOR_DEBUG environment variable is active it will tell Reactor that you want to have a log file written to Temp:/Reactor/ReactorLog.txt. You can quickly open this document by selecting the Reactor > Tools > Open ReactorLog menu item:

Opening the Reactor Log

reactor-menu-open-reactor-log.png (44.52 KiB) Viewed 1054 times

When you open the ReactorLog.txt file in your programmer's text editor it will look something like this:

An Example Reactor Log File

The first few lines of the log file indicate the state of the Reactor environment variables. Then each of the commands that are used by Reactor to sync files is listed. If the REACTOR_DEBUG_FILES environment variable was active you will also see the raw file downloads concatenated inline in the log file too.

Reactor Debug Files

The REACTOR_DEBUG_FILES environment variable can be set to true if you want to see Console logging output that shows each of the cURL based file download operations. When the environment variable is set to true Reactor will print the contents of the files as they are downloaded and written to disk. This debugging information is useful for spotting formatting issues and "Error 404" states when a file has trouble successfully downloading from GitLab:
Code: Select all
```
REACTOR_DEBUG_FILES=true
```
Reactor Debug Collections

The REACTOR_DEBUG_COLLECTIONS environment variable can be set to true while you are developing and testing atoms that use the Reactor Collections category.
Code: Select all
```
REACTOR_DEBUG_COLLECTIONS=true
```
Reactor Branch

The REACTOR_BRANCH environment variable allows you to change the default GitLab branch that is used in the Reactor Installer script, and in the Reactor Package Manager GUI when new content is downloaded and the Reactor utility scripts are updated. When the REACTOR_BRANCH environment variable is not specified the "master" branch will be used.

This example would tell Reactor to download content from the "dev" branch:
Code: Select all
```
REACTOR_BRANCH=dev
```
Reactor Install PathMap

The REACTOR_INSTALL_PATHMAP environment variable can be used to change the Reactor installation location to something other than the default PathMap value of "AllData:".
Code: Select all
```
REACTOR_INSTALL_PATHMAP=AllData:
```
or
Code: Select all
```
REACTOR_INSTALL_PATHMAP=UserData:
```
or
Code: Select all
```
REACTOR_INSTALL_PATHMAP=Profile:
```
or your own custom Reactor installation location on a local or network path like:
Code: Select all
```
REACTOR_INSTALL_PATHMAP=E:\Pipeline\Reactor
REACTOR_INSTALL_PATHMAP=/Volumes/Pipeline/Reactor
REACTOR_INSTALL_PATHMAP=/opt/Reactor
```
On Windows you would open the System Control Panel > Advanced System Settings > Environment Variables... window and add a new REACTOR_INSTALL_PATHMAP entry like this:

Adding an Environment Variable in Windows

Reactor Local System

The REACTOR_LOCAL_SYSTEM environment variable allows you to do local development of the files in the Reactor:/System/ folder without needing to git sync each of those revisions with the Reactor GitLab repository.

Whatever folderpath you define in the REACTOR_LOCAL_SYSTEM environment variable will be used as a local source of the Reactor:/System/ folder contents. When you run the Reactor > Open Reactor... menu item the REACTOR_LOCAL_SYSTEM defined files will be copied automatically to the Reactor:/System/ folder.

To use this environment variable you need to have a copy of the full Reactor System folder with the Protocols, Scripts, and UI folders present along with a copy of the Reactor.lua script.

Using the Windows System Control Panel

On Windows the Reactor Branch environment variables can be specified in the System Control Panel > Advanced System Settings > Environment Variables... window.

Environment Variables in Windows

On Windows you can type set into the Command Prompt window to see all of the active environment variables on the system.

Using a Linux BASH Profile
If you are on a Linux system you can add your own custom Reactor environment variables by editing your $HOME/.bash_profile or $HOME/.profile.

You would then add new environment variable entries that look like this:
Code: Select all
```
export REACTOR_DEBUG_FILES=true
export REACTOR_DEBUG=true
export REACTOR_INSTALL_PATHMAP=AllData:
export REACTOR_LOCAL_SYSTEM=/opt/Reactor/System
```
On Linux you can type env into the Terminal window to see all of the active environment variables on the system.

Using MacOS Launch Agent PLIST Files
On a MacOS system the easiest and most reliable way to setup new environment variables is with the help of LaunchAgent .plist files. If you want to make it easy to visually edit a LaunchAgent plist document you can look at using a 3rd party utility like "LaunchControl" by Soma-Zone.

The Reactor GitLab repository has a copy of some initial Reactor LaunchAgent example .plist files in the folder:
Code: Select all
```
Bonus/Mac/setenv.reactor.REACTOR_LOCAL_SYSTEM.plist
Bonus/Mac/setenv.reactor.REACTOR_DEBUG_FILES.plist
Bonus/Mac/setenv.reactor.REACTOR_BRANCH.plist
Bonus/Mac/setenv.reactor.REACTOR_DEBUG.plist
Bonus/Mac/setenv.reactor.REACTOR_INSTALL_PATHMAP.plist
```
You would need to edit these files in a programmer's text editor to customize them before you install them on your system.

These plist documents are designed to be installed on your MacOS system using root permissions to the folder:

/Library/LaunchAgents/

When you go to install the plist files you will need to change the documents to be owned by "root", have the group name of "wheel", and have a Unix "octal" file permission setting of 644.
Code: Select all
```
sudo chown root /Library/LaunchAgents/setenv.reactor.*.plist
sudo chgrp wheel /Library/LaunchAgents/setenv.reactor.*.plist
sudo chmod 644 /Library/LaunchAgents/setenv.reactor.*.plist
```
You can take a look at the file permissions of the Launch Agent files on your system using the following terminal command:
Code: Select all
```
ls -la /Library/LaunchAgents/
```
You will then see a directory listing that looks something like this:
Code: Select all
```
drwxr-xr-x  24 root  wheel   816 Nov 17 12:28 .
drwxr-xr-x+ 62 root  wheel  2108 Nov 17 11:59 ..
-rw-r--r--   1 root  wheel   715 Oct 26  2016 org.macosforge.xquartz.startx.plist
-rw-r--r--@  1 root  wheel   474 Nov 17 05:42 setenv.reactor.REACTOR_BRANCH.plist
-rw-r--r--@  1 root  wheel   463 Oct 25 07:25 setenv.reactor.REACTOR_DEBUG.plist
-rw-r--r--@  1 root  wheel   475 Oct 25 07:27 setenv.reactor.REACTOR_DEBUG_FILES.plist
-rw-r--r--@  1 root  wheel   473 Dec  7 22:23 setenv.reactor.REACTOR_INSTALL_PATHMAP.plist
```
On MacOS you can type env into the Terminal window to see all of the active environment variables on the system.

Creating Environment Variables

Creating Environment Variables

Reactor Environment Variables

Using the Windows System Control Panel

Using a Linux BASH Profile

Using MacOS Launch Agent PLIST Files