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
Purpose
The 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.
Access
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.
mkdir /opt/viewer_jobs chmod -R a+w /opt/viewer_jobs
Not publicly accessible
Make sure web access is not allowed to this directory
Storage Needs
At least 0.5 Gigabyte of space is recommended for your working directory
Edit Configurations
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.
Shrine URL:
Purpose
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.
return array(
'shrine_url' => 'your_SHRINE_URL_here',
'working_directory' => '/opt/viewer_jobs',
'site_name' => 'Partners',
'debug_logging' => true,
'shrine_connector_logging' => false,
'patient_list_exporter_logging' => false
);
i2b2 Domain & PM cell URL:
Purpose
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).
{
urlProxy: "index.php",
urlFramework: "js-i2b2/",
//-------------------------------------------------------------------------------------------
// THESE ARE ALL THE DOMAINS A USER CAN LOGIN TO
lstDomains: [
{ domain: "your_i2b2_Domain_here",
name: "ACT - Local i2b2",
urlCellPM: "your_i2b2_PM_cell_URL_here",
allowAnalysis: true,
//installer: "/webclient/plugin_installer/",
debug: true
}
]
//-------------------------------------------------------------------------------------------
}
Deploy the ACT Web Client to web server
Validate ACT Web Client installation
