Installation (2nd Generation Deployment 2.1)

Normal manual installation for mySQL

(For advanced php users, you can click here)
(For automatic installation, you can click here)
(For manual installation for PostgreSQL, click here)

NOTE: The following installation procedure is valid ONLY for the 2nd Generation Deployment 2.1.

If your system has a built-in Apache-PHP-mySQL configuration you can skip the first 2 steps.

1. Download and install Apache, PHP, mySQL in your system.

2. Configure mySQL's access permissions properly. Please refer to the documention of mySQL.

3. It might be necessary to configure the Apache web server to run PHP scripts as CGI. Please refer to the documentation of Apache in doing this configuration.

4. Make sure that the following extensions and external php modules are loaded in your php installation.

GD = the graphic module
IMAP = if you use the internet webmailer
Calendar
TTF = if available

5. Uncompress the CARE2X 2nd Generation Deployment 2.1 scripts into the active directory of Apache web server.

6. Make sure that the server can write in the following directories and files. NOTE: In most servers, file access permission is highly restrictive. Make sure that the following directories and files are system writeable. The easiest way to do this is to CHMOD 777 the following:

/cache/barcodes/
/counter/hits/
/counter/hitcount.txt
/fotos/encounter/
/fotos/news/
/fotos/registration/
/logs/ (and all its subdirectories)
/med_depot/img/
/pharma/img/
/radiology/dicom_img/
/gui/img/logos_dept/
/gui/smarty_template/templates_c/
A safer way to change the file permissions is to use the CHOWN command. Note: this functions only in *nix/Linux servers.
For windows users, right click on the file, select "properties" and remove any write protection.

7. Use an editor and open the file "inc_init_main.php" inside the directory "/include" .

  • Enter the proper host, username, and password information for your mySQL database. If your mySQL resides on the same machine and uses the same IP address as the Apache web server you can use the default settings.

    The defaults are:

    $dbhost = 'localhost'
    $dbusername = 'httpd'
    $dbpassword = '' (empty string)

    Alternative defaults are:

    $dbhost = 'localhost'
    $dbusername = 'root'
    $dbpassword = '' (empty string)

  • Enter the database name. You must remember this name since you need it in creating the database in later steps.

    For example: $dbname = "caredb";

  • Change the following three secret keys with unique keys of your choice.

    $key : The secret key for the first level script lock.
    $key_2level : The secret key for the second level script lock.
    $ley_login : The secret key for the third level script lock.

  • Enter the domain or ip addresses and hosts information.
    For the main domain, enter the domain or host name without the http:// or https:// part and without a trailing slash as value of the $main_domain variable:

    For example: $main_domain = www.st-john-hospital.org ;

    Note: If the web server is within a network, enter specifically the IP adresses for the hosts. Never use "localhost".

    If you are running Care2x in an SSL server, make sure that the $httprotocol variable in this script is set to "https".

    For example: $httprotocol='https';

  • Set the database type variable to 'mysql':

    Like this: $dbtype='mysql';

  • 8. Open the file "inc_remoteservers_conf.php" inside the directory "/global_conf".

    If necessary, you can set the webcam source urls here.

    9. Start the Apache, mySQL, and your web browser. Recommended browsers are: Mozilla 1+, MS Internet Explorer version 5+, Opera 6+.

    10. Type the following address in your browser:

    http://your_host/modules/phpmyadmin/

    (where your_host is the actual host address of your Apache web server).
    You will be asked for the username and password for accessing the database. Enter the username and password that you used at step #7. The program module phpmyAdmin should be displayed after a successful authentication.

    ::::::::::::::::::::: NOTE::::::::::::::::::::::::

    If you do not like to use the integrated phpMyAdmin and wants to use your own db administration program, just skip step #10 and start your db admin program.

    11. Using the program phpmyAdmin (or any appropriate mySQL administration program), create a new database naming it with the name that you entered earlier in step #7.

    12. Within the newly created database create the care2x database structure. To do this use phpmyAdmin to load the following sql dump: install/mysql/manual/care_db_structure_d21_manual_my.sql
  • Click on the "SQL" tab menu.
  • Uncheck the "Show this query here again"
  • Click the "Browse" button and the file manager will pop-up.
  • Find and select the install/mysql/manual/care_db_structure_d21_manual_my.sql.
  • Click "Go".
  • 13. Following the same procedure described at step #12, Load additional data dump according to your needs. Note: In loading the data you must follow the order of loading the sql dumps as stated here.

  • ICD10 coding system in german language: Load the dump found at the /install/sql/icd10_de directory.

    a2g-insert.sql
    h2n-insert.sql
    o2s-insert.sql
    t2z-insert.sql

    Note: If you prefer to load the CSV formatted data, download the CSV file from here: care_icd10_de.csv

  • ICD10 coding system in english language: Load the additional data dump found at the /install/sql/icd10_en directory.

    insert-data-a2l.sql
    insert-data-m2y.sql

    Note: If you prefer to load the CSV formatted data, download the CSV file from here: care_icd10_en.csv

  • ICD10 coding system in brazilian-portuguese language: Load the additional data dump found at the /install/sql/icd10_br directory.

    insert-data-a2l.sql
    insert-data-m2z.sql

    Note: If you prefer to load the CSV formatted data, download the CSV file from here: care_icd10_pt_br.csv

  • ICD10 coding system in spanish language: Load the additional data dump found at the /install/sql/icd10_es directory.

    insert-data-a2o.sql
    insert-data-p2z.sql

  • OPS301 coding system in german language: Load the additional data dump found at the /install/sql/ops301_de directory.

    insert-data-1-5-499.sql
    insert-data-55-57.sql
    insert-data-58-94.sql

    Note: If you prefer to load the CSV formatted data, download the CSV file from here: care_ops301_de.csv

  • OPS301 coding system in spanish language: Load the additional data dump found at the /install/sql/ops301_es directory.

    insert-data-1.sql
  • 14. Create a new system admin permission.

    You need to use the supplied create_admin.php script. Type http://your_host/create_admin.php in your browser. Enter the necessary information and hit the button. Important: After creating the new system admin, remove this script from your active server directory. Leaving it in the active server directory will cause Care2x to block and refuse to run.

    15. REMOVE THE FOLLOWING FILES FROM THE CARE2X DIRECTORY!

  • /create_admin.php
  • /install/install.php
  • /install/encode_pw_md5.php

    Tip: you can move them to other places outside the web server directory.

  • 16. The installation is finished. Enter the following address in the browser:

    http://your_host/

    (where your_host is the actual host address of your Apache web server). The first page of CARE 2X should appear. Congratulations!

    Now you can start creating user access permissions.

    To do this:

    Select the EDP link on the left menu and then select "Access rights". Enter your admin username and your admin password. When the interface appears, you can start creating user access rights and permissions.

    Note: You cannot create additional Admin permission using this interface. You have to follow the step #14 to create additional admin permissions.

    17. Configure Care2x => go here


    2002, 2003, 2004 Elpidio Latorilla, CARE2X, CARE 2002, www.intellin.org, www.care2x.org, www.care2x.com , www.care2x.net