Unzip Folders and Files
Version 1.1 is released to ACT sites as a zipped folder containing the ACT web-client named act-webclient. To deploy the web-client at a local site user must first unzip the act-webclient folder into a local drive. After unzip, the directory structure of the folder will look like this:
Set Up Working Directory
Create the following directories on your system:
/opt/viewer_jobs (You can provide your own choice of directories and names as described below)
The Patient Set Viewer and other ACT software requires a working directory. Here the software creates and updates files for background jobs, caching, and other tasks. The software needs create and write access to this working directory.
In the ACT_config.php file, we have provided a default location for your working directory. It is: /opt/viewer_jobs. You have to provide the correct access by running the chmod command as shown.
Optional: Create your own working directory
Only if you want to create and use your own path/directory for the working directory follow these two steps. Otherwise the Working Directory step is now complete.
First, in the root of your ACT Web Client directory edit the ACT_config.php file. Change the working_directory to the path and directory name you plan on using
Second, create the directory with correct access settings:
NO HTTP(S) access
Make sure web (HTTP) access is not allowed to this directory
At least 0.5 Gigabyte of space is recommended for your working directory
Edit Config files locally
It is a good idea to edit config files locally and then copy all files to the web server.
To ensure that the ACT software works correctly, the ACT_config.php file has to be edited to accommodate your environment. This file can be found in the act-webclient root directory.
Details for each configuration task are shown below.
The SHRINE Connector software has a configuration item for your local SHRINE Adapter URL. This URL accepts service call requests from the SHRINE Connector.
SHRINE URL template
In most cases, your SHRINE URL will be https://your_hostname:6443/shrine/rest/i2b2/admin/request The your_hostname part of the URL is the host name or domain name of the web server where ACT is installed.
In the root folder of the ACT Web Client there is the ACT_config.php file. In here you can edit the shrine_url entry. This entry is where you place your SHRINE URL.
i2b2 Domain & PM cell URL:
The i2b2_config_data.js configuration file contains config items for your i2b2 domain name, the URL of your i2b2 PM cell, and other config items.
Edit this config file adding your i2b2 domain name (domain), and PM cell URL (urlCellPM).
Deploy the ACT Web Client to web server
Once Step 1 through 3 are done, user must copy/upload the edited ACT-webclient folder to their web server (eg. /var/www/html/).
Validate ACT Web Client installation
After the ACT webclient is successfully deployed to the web server, the user can validate the installation using a tool provided with the webclient.
This tool can be accessed at http(s)/url_to_your_webclient/ACT_requirements.php .
This ACT utility has checked your install for various requirements. If these requirements are not met, your ACT install may not run, or have issues. The requirements checked are such things as, the correct version of PHP, correct PHP extensions, a working directory that has the correct permissions set, and more. As new requirements are created, their tests will be added to this page.
The URL to the ACT Validator will be: http://your_hostname/ACT_requirements.php
This utility has three sections. Prerequisites checks, Configuration Checks, and a quick view of your ACT_config.php file.
By default the Validator shows only the test results for system requirements. Each time you make a correction to your system to fix any issues, you can click the refresh button to see if the test will pass.
By unchecking the Prerequisites checkbox, the Validator will show all test results including configuration settings.
Quick View of ACT_Config.php
You can get a quick view of your ACT_config file by clicking on the Show button.