MedDream for ClearCanvas Quick Install (IIS and Apache) GENERAL NOTES: WARNING: ClearCanvas support was last tested with MedDream 4.03. Starting from 4.04, there are no pre-release tests with $pacs = "ClearCanvas". Please contact info@softneta.com if you would like to use this integration mode. WARNING: only the older ClearCanvas v2 is supported. We didn't test MedDream with ClearCanvas 3+. Under Windows, a thread-safe (TS) 32-bit PHP build is required. The DLLs included won't work with a 64-bit PHP, like in 64-bit builds of WampServer. Under Linux, a non-TS PHP build is required. This is related to a more common build of Apache, the "prefork". The "worker" build is incompatible. The traditional php_mssql.dll is officially deprecated and might not work with newer versions of PHP and SQL Server. Its replacement, the "Microsoft SQL Server Driver for PHP" ($dbms = 'SQLSRV' in config.php), can be downloaded from Microsoft free of charge. It contains many flavors of the driver; the ones supported by MedDream are non-PDO and TS. The v2.0 driver also requires the "Microsoft SQL Server 2008 R2 Native Client". Drivers older than v1.1 might be incompatible. Java must be installed for the Forward and Export/Burn commands. Under Windows, do not forget to update either PATH or JAVA_HOME environment variable accordingly. During an upgrade it's recommended to use the included config.sample-clearcanvas.php as a template and then update the resulting config.php according to the old one. This will prevent misunderstandings like variable names which were suddenly changed. The user interface now offers "CD" (740 MB) and "DVD" (4.7 GB) disc sizes. The actual splitting into volumes, however, is implemented only for PacsOne. Other PACSes still have *unlimited* volume size. MedDream is able to automatically include a DICOMDIR viewer in each disc of exported studies. To use that, simply place the viewer files in a subdirectory named "DICOMDIR". You must also ensure that a file named "autorun.inf" exists in that directory, otherwise contents won't be included; an empty autorun.inf is suitable if the viewer somehow doesn't contain it. While still in demo mode, you *must* remove the existing meddream.lic after changing computer's host name (any OS), reinstalling the OS (Windows) or changing the MAC of any network card (Linux). A correct file will be created automatically. Otherwise a commercial license generated from your meddream.lic will not work. This also means that Windows must be activated in advance! WINDOWS (IIS/PHP) INSTALL: Note: it is assumed that PHP is already installed and working. Installation of PHP under IIS is outside the scope of this short memo. Note: PHP should be installed as ISAPI module. CGI/FastCGI has problems for which we don't have a solution so far. Consequently, you must use PHP 5.2 with IIS, as ISAPI support was removed in PHP 5.3. 1. Copy meddream folder to IIS_WWW_ROOT (so that the result is IIS_WWW_ROOT/meddream; for example, in our machines it usually is C:\Inetpub\wwwroot\meddream.) Adjust permissions: the directories "meddream", "meddream\temp", "meddream\log" must be writeable by IIS (accounts IUSR_, IWAM_ or just IUSR in IIS7) if you need MPEG2 support, then cmd.exe must be readable by IIS (there is an explicit "Deny" permission by default) If you are updating an older version of MedDream: a) Please back up the old version (so you can go back any time). b) Please do not replace files you changed in last version. You must carefully synchronize the new version 2. From IIS_WWW_ROOT\meddream copy php5.2_meddream.dll to PHP_INSTALL_DIR\ext 3. Add to php.ini file "extension=php5.2_meddream.dll" 4. Specify date.timezone in php.ini: [Date] ; Defines the default timezone used by the date functions date.timezone = "America/Chicago" (the list of possible values is at http://www.php.net/manual/en/timezones.php) 5. Edit IIS_WWW_ROOT/meddream/config.php file. Use config.sample-clearcanvas.php as a template. The file contains basic instructions. You will likely need to specify a port for database connection, like "localhost,1433". 6. Restart the World Wide Web Publishing service 7. Navigate to http://127.0.0.1/meddream/home.php and use database accounts to log in. If the 'MSSQL' driver fails to log in, try installing the "Microsoft SQL Server 2008 R2 Native Client". If even that didn't help, change $dbms to 'SQLSRV' and manually install the "Microsoft SQL Server Driver for PHP". The file that must be added to PHP extensions and php.ini, depends solely on your PHP version as other choices are strictly non-PDO and TS. 8. The Export function might need a MIME map ".iso=application/octet_stream" (in IIS configuration). If you download results via the Burn Now button, then also add ".burn=application/octet_stream". WINDOWS (APACHE/PHP) INSTALL: Note: it is assumed that both IIS and Apache are installed and using different TCP/IP ports. 1. Copy meddream folder to APACHE_HTDOCS_DIR (so that the result is APACHE_HTDOCS_DIR/meddream; for example, in our machines it usually is C:\xampplite\htdocs\meddream.) If you are updating an older version of MedDream: a) Please back up the old version (so you can go back any time). b) Please do not replace files you changed in last version. You must carefully synchronize the new version 2. From APACHE_HTDOCS_DIR\meddream copy php5.2_meddream.dll to PHP_INSTALL_DIR\ext (if you are using PHP 5.2.x) copy php5.3_meddream-VC6.dll to PHP_INSTALL_DIR\ext (if you are using PHP 5.3.x, VC6 build) copy php5.3_meddream-VC9.dll to PHP_INSTALL_DIR\ext (if you are using PHP 5.3.x, VC9 build) copy php5.4_meddream.dll to PHP_INSTALL_DIR\ext (if you are using PHP 5.4.x) copy php5.5_meddream.dll to PHP_INSTALL_DIR\ext (if you are using PHP 5.5.x) 3. Add to php.ini file "extension=php5.2_meddream.dll" (if you are using PHP 5.2.x) "extension=php5.3_meddream-VC6.dll" (if you are using PHP 5.3.x, VC6 build) "extension=php5.3_meddream-VC9.dll" (if you are using PHP 5.3.x, VC9 build) "extension=php5.4_meddream.dll" (if you are using PHP 5.4.x) "extension=php5.5_meddream.dll" (if you are using PHP 5.5.x) 4. Specify date.timezone in php.ini: [Date] ; Defines the default timezone used by the date functions date.timezone = "America/Chicago" (the list of possible values is at http://www.php.net/manual/en/timezones.php) 5. Edit APACHE_HTDOCS_DIR/meddream/config.php file. Use config.sample-clearcanvas.php as a template. The file contains basic instructions. You will likely need to specify a port for database connection, like "localhost,1433". 6. Restart Apache 7. Navigate to http://127.0.0.1:APACHE_PORT/meddream/home.php (do not forget the actual port that Apache runs on, and use database accounts to log in) If the 'MSSQL' driver fails to log in, try installing the "Microsoft SQL Server 2008 R2 Native Client". If even that didn't help, change $dbms to 'SQLSRV' and manually install the "Microsoft SQL Server Driver for PHP". The file that must be added to PHP extensions and php.ini, depends solely on your PHP version as other choices are strictly non-PDO and TS.