Message-ID: <714126926.8690.1711722199666.JavaMail.confluence@ip-172-30-4-17.ec2.internal> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_8689_1663352391.1711722199664" ------=_Part_8689_1663352391.1711722199664 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Unzip Folders and Files
Version 1.2 is released to ACT pilot = sites as a zipped folder containing the i2b2 1.7.12 web client with prepack= aged ACT plugins named act-webclient. To deploy the web cl= ient at your local site user, unzip the file into your web server directory= (e.g. /var/www/html/)
Set Up Working Directory
Create the following 'working' directory on your system:
/opt/viewer_jobs (you c=
an rename viewer_jobs if desired)
Purpose
=20The ACT software requires a working directory. Here the software creates= and updates files for background jobs, caching, and other tasks. The softw= are needs create and write access to this working directory.
Access
=20In 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=20
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
=20It is a good idea to edit config files locally and then copy all files t= o the web server.
To ensure that the ACT software works correctly, the A= CT_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.
Purpose
=20The SHRINE Connector software has a configuration item for your local SH= RINE Adapter URL. This URL accepts service call requests from the SHRINE Co= nnector.
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 fil= e. In here you can edit the shrine_url entry. This entry i= s where you place your SHRINE URL.
return array= ( =09 'shrine_url' =3D> 'your_SHRINE_URL_here', =09=09 'working_directory' =3D> '/opt/viewer_jobs', =09=09 'site_name' =3D> 'Partners', =09 'debug_logging' =3D> true, 'shrine_connector_logging' =3D> false, 'patient_list_exporter_logging' =3D> false =09 );=20
Purpose
=20The i2b2_config_data.js configuration file contains config items for you= r i2b2 domain name, the URL of your i2b2 PM cell, and other config items.= p>
Edit this config file adding your i2b2 domain name (domain), and PM cell= URL (urlCellPM).
{ =09urlProxy: "index.php", =09urlFramework: "js-i2b2/", =09//----------------------------------------------------------------------= --------------------- =09// THESE ARE ALL THE DOMAINS A USER CAN LOGIN TO =09lstDomains: [ =09=09{ domain: "your_i2b2_Domain_here", =09=09 name: "ACT - Local i2b2", =09=09 urlCellPM: "your_i2b2_PM_cell_URL_here", =09=09 allowAnalysis: true, =09=09 //installer: "/webclient/plugin_installer/", =09=09 debug: true =09=09} =09] =09//----------------------------------------------------------------------= --------------------- }=20
Validate ACT Web Client installation
After the ACT webclient is successful= ly deployed to the web server, you can validate the installation using a to= ol provided with the webclient.
This tool can be accessed at http://u= rl_to_your_webclient/ACT_requirements.php. When your validation is = completed, you should remove ACT_requirements.php and ACT_inspector.php
Purpose
=20This ACT utility has checked your install for various requirements. If t= hese 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 permi= ssions 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_requireme= nts.php
This utility has three sections. Prerequisites checks, Configuration Che= cks, and a quick view of your ACT_config.php file.
Prerequisites
=20By default the Validator shows only the test results for system requirem= ents. 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.
Configuration Results
=20By unchecking the Prerequisites checkbox, the Validator will show all te= st results including configuration settings.
Quick View of ACT_Config.php
=20You can get a quick view of your ACT_config file by clicking on the Show= button.
= p>