INTERPOLAR

Bitte laden Sie Redcap (Install, zip) herunter: https://redcap.vanderbilt.edu/community/custom/download.php
Entpacken Sie die Zip-Datei, z.B. redcap14.6.2.zip in den Ordner ‘html’.
cd REDCap-app/html/
unzip redcap14.6.2.zip
Legen Sie das folgende Verzeichnis an: REDCap-app/html/redcapdocs
mkdir redcapdocs
Passen Sie die Zugriffrechte für die folgenden Verzeichnisse an:
- REDCap-app/html/redcap/temp
- REDCap-app/html/redcap/modules
- REDCap-app/html/redcapdocs
  chmod ugo+rwx redcap/temp redcap/modules redcapdocs
Bitte passen Sie die Verbindungsparameter zur Datenbank (mariadb in diesem Docker Compose Setup) in der Datei redcap/database.php an. Verwenden Sie dafür den von Ihnen gewählten Redcap Datenbank-Namen, den Benutzernamen und das Passwort entspr. der Einträge in den .env-Dateien unter REDCap-db/.env_redcap_db*. Ändern Sie außerdem die SALT Variable.
Beispiel für die Einträge in REDCap-app/html/redcap/database.php:
```
$hostname   = 'redcap_db';   //your_mysql_host_name
$db         = 'redcap';      //your_mysql_db_name
$username   = 'redcap';      //your_mysql_db_username
$password   = 'password_for_redcap_user';    //your_mysql_db_password
```
```
$salt = '32534739';
```
wechseln Sie in das Hauptverzeichnis und führen Sie ‘docker compose up’ aus:
```
cd ../..
docker compose up
```
Rufen Sie im Browser die REDCap Install-Seite auf: http://127.0.0.1:8082/redcap/install.php (REDCap-URL)
- Hinweis: Sie können die REDCap-URL ggf. über einen Reverse-Proxy oder einen SSH-Tunnel auf dem Client-PC verfügbar machen.
- Sie sollten Install-Seite mit mehreren Schritten sehen:
  - STEP 1) Kann übersprungen werden. Diese SQL-Anweisungen wurde bereits beim Initialisieren ausgeführt
  - STEP 2) Diese Anpassungen haben Sie schon vorgenommen und es sollte in gründer Schrift folgendes zu lesen sein: “Connection to the MySQL database ‘redcap’ was successful!”
  - STEP 3) Nehmen Sie ggf. optional Änderungen vor. Klicken Sie anschließend auf “Generate SQL Install Script”
  - STEP 4) Kopieren Sie den Inhalt des SQL-Scripts und fügen Sie ihn in die Datei [REDCap-db/init/10redcap_install-tables.sql](REDCap-db/init/10_redcap_install-tables.sql) ein. Gehen Sie anschließend zurück zur Console. Ersetzen Sie in der nachfolgenden Befehlszeile “<insert redcap db root pw here>_” durch das REDCap Datenbank root Passwort und starten sie den Befehl. Das REDCap Datenbank root Passwort finden Sie unter REDCap-db/.env_redcap_db_root.password.
    docker compose exec -T redcap_db mariadb -u root -p"<insert redcap db root pw here>" redcap < REDCap-db/init/10_redcap_install-tables.sql
  - STEP 5) Klicken Sie auf “REDCap Configuration Check”. Es werden einige Rot gefärbte Meldungen erscheinen, die für eine produktive Umgebung noch behoben werden sollten. Dies kann zu einem späteren Zeitpunkt erfolgen. Ist im unteren Bereich “CONGRATULATIONS!” zu lesen, können Sie die REDCap mit Klick auf http://127.0.0.1:8082/redcap/ starten.
- Hinweis: Diese Schritte müssen nur wiederholt werden, wenn eine neue REDCap Version zum Einsazt kommen soll. Das Update kann auch über die REDCap Weboberfläche im “Control Center” eingespielt werden.
Das INTERPOLAR-Projekt in REDCap importieren:
- Die INTERPOLAR REDCap Projekt Datei ist in INTERPOLAR erarbeitet worden und steht im MII SharePoint Ordner Release v0.2.x verfügbar. Bitte laden Sie sich die Datei “INTERPOLARDev_*.REDCap.xml” herunter.
- Wechseln Sie im Browser zur REDCap Weboberfläche und klicken Sie auf “New Project” (Menu-Leiste oben).
- Geben Sie dem Projekt einen Titel, z.B. INTERPOLAR-1a
- Wählen Sie bei “Project’s purpose” aus: “Quality Improvement”
- wählen Sie bei “Project creation option” → “Upload a REDCap project XML file” und importieren Sie die zuvor vom MII SharePoint heruntergeladene REDCap Projektdatei “INTERPOLARDev_*.REDCap.xml”.
- Klicken Sie auf “Create Project”
- Unter “My Projects” einscheint nun das angelegte Projekt.
Führen Sie die Konfiguration von DB2Frontend durch (REDCap API-Token).
Fahren Sie mit Schritt 3) REDCap-app/Readme.md fort.