-
+
+
- Open the file `.env` in the `rdc` directory (note that in Windows you can _not_ simply double click the `.env` file to open it)
-
+
- Paste this block at the end of the file and save it. Make changes to reflect your timezone and REDCap version number. You can find a list of valid time zones at [List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
The port numbers should reflect your REDCap version number in some way so you can keep your different REDCap installations from colliding and tell them apart. Each of these port numbers needs to be unique. The standard used here compresses the REDCap version number into 4 digits and prefixes it with 1 through 4. For example, 10.3.3 becomes 1033. With prefixes, that becomes 11033, 21033, 31033, and 41033. Any method that makes unique port numbers and works for you is fine, though be aware that the max allowed port number is 65535.
@@ -55,20 +55,20 @@ MAILHOG_PORT=41033
```
You'll need a terminal that's in the `redcap-docker-compose` directory to start the Docker containers
-- If you used VSCode or another IDE with an integrated terminal for the previous steps, you already have a terminal attached and in the desired directory 
+- If you used VSCode or another IDE with an integrated terminal for the previous steps, you already have a terminal attached and in the desired directory 
- If you did not use VSCode, open a terminal or git-bash session and cd to the `redcap-docker-compose` directory
- GitHub Desktop can open a terminal cd'd to the `redcap-docker-compose` folder with the shortcut \
+
Your Docker containers are now downloading required software and initializing. This step will take some time, especially on the first run.
- Once the containers are built, wait one more minute for the webpage to finish setting up.
- Access web-based redcap installer at [http://localhost:1935](http://localhost:1935) You should see this:
-
+
- Select 'Use a local copy of the full zip installer...'. Click Browse, locate your redcap zip file (e.g. redcap10.3.3.zip), and upload it.
- Select 'Prepopulate with table-based users and activate table authentication' and provide _your_ email address.
@@ -76,7 +76,7 @@ Your Docker containers are now downloading required software and initializing. T
- Wait a couple of minutes.
- When you see the green dialog boxes, the installation is complete.
-
+
- **Ignore the website instructions** to access the REDCap installer and access your fully functional local REDCap at [http://localhost:1935](http://localhost:1935)
- Login as admin. Your password is 'password'. Every user's account is 'password'.
diff --git a/docs/emd102.md b/docs/emd102.md
index 71bea49..5e4820d 100644
--- a/docs/emd102.md
+++ b/docs/emd102.md
@@ -12,15 +12,15 @@ This document assumes some familiarity with REDCap and access to a REDCap system
## Access the Control Center > Browse Users. Look at the accounts that the installer made for you:
-
+
You can also use this to find any specific REDCap user:
-
+
Click on the name /user to access their account, see which projects they have access to, and to suspend or delete their account:
-
+
@@ -35,13 +35,13 @@ Click on the name /user to access their account, see which projects they have ac ## Access the Control Center > General Configuration: -
+
The Other System Settings section is important for REDCap Admins:
-
+
-
+
@@ -56,11 +56,11 @@ The Other System Settings section is important for REDCap Admins: ## Access the Control Center > Configuration Check: -
+
If your installation is set up correctly, everything should be highlighted in green here. If there is an issue, the problem will be highlighted in red.
-
+
@@ -76,13 +76,13 @@ If your installation is set up correctly, everything should be highlighted in gr
## Access the Control Center > User Settings:
-
+
These user setting are important and apply to all users, except REDCap Admins. For example: can users create their own projects, or do they need to request a new project that the REDCap Admins have to approve? Can users move their own projects into production, or do the REDCap Admins have to approve their request? Should unused/inactive REDCap accounts be suspended after x number of days of inactivity? Should post-production change requests be automatically approved or should a REDCap Admin approve them first to ensure no data is lost or orphaned?
-
+
-
+
@@ -97,11 +97,11 @@ These user setting are important and apply to all users, except REDCap Admins. F ## Access the Control Center > File Upload Settings: -
+
This is where you enable the different File Upload settings/locations, such as maximum file size, including the Send-It module:
-
+
@@ -116,20 +116,20 @@ This is where you enable the different File Upload settings/locations, such as m ## Access the Control Center > External Modules: -
+
On this page, you can see modules that are already downloaded, which modules have updates available, which version of the module you are using, module configurations, and which projects are using these modules. You can also disable any modules here and set custom text for users on the External Modules page in their REDCap projects.
To view modules available already downloaded in your instance: look at the section "Modules Currently Available on this System"
-
+
Download a few modules by clicking on the blue "View modules available in the REDCap Repo" button.
Try _Admin Dashboard, MySQL Simple Admin, Image Map_, and _Date Calculated Fields_. They are popular and easy to implement. Click on the blue "Download" button next to the module's name to download it to your REDCap server:
-
+
Once downloaded, you return to this page to configure the module's global settings by clicking on "Configure" next to the module's name. Global settings include: _Enable module on all projects by default_, _Make module discoverable by users_, and _Module configuration permissions in projects_.
@@ -148,11 +148,11 @@ Once downloaded, you return to this page to configure the module's global settin
These "Modules" are not External Modules. They are big features in REDCap that are turned off by default.
-
+
Here is where you enable the use of the survey features in REDCap (i.e., can projects use surveys), URL shortening feature (found on the Survey Distributions Tools page), the Randomization module, the REDCap Shared Library, REDCap API, the Mobile App, the biomedical ontology feature, and many others.
-
+
Note: enabling surveys, the Randomization module, the REDCap API and Mobile App does not mean projects/users have to use these features. They only make them available to the users.
@@ -169,13 +169,13 @@ Note: enabling surveys, the Randomization module, the REDCap API and Mobile App
## Access the Control Center > Field Validation Types:
-
+
To make these field validations available, click on Enable next to the validation(s) you want to be available.
Note: not all validations will be relevant to your institution/area.
-
+
Do you know these are just rows in the MySQL table `redcap_validation_types`? Did you know you can add your own?
@@ -193,11 +193,11 @@ Do you know these are just rows in the MySQL table `redcap_validation_types`? Di
## Access the Control Center > Project Templates:
-
+
Project templates are form(s) that other users at your institution can download upon project creation. Some templates are provided by Vanderbilt by default, but you can add your own by clicking on _Add new template_ and choosing which project you want to become a template. Unlike the REDCap Shared Library, these templates are only available upon project creation.
-
+
@@ -212,11 +212,11 @@ Project templates are form(s) that other users at your institution can download ## Access the Control Center > Email Users: -
+
You can use this page to email all users or users who meet a certain criteria, such as they have logged in during the past month.
-
+
@@ -231,11 +231,11 @@ You can use this page to email all users or users who meet a certain criteria, s ## Access the Control Center > To Do List: -
+
Here is where all pending Move to production requests, API requests and Post-production change requests can be found, that need admin approval. There are several options under _Actions_ to deal with these requests. REDCap will still send an email to the REDCap Admins, unless you uncheck the _Enable email notifications_ for administrators button.
-
+
@@ -250,11 +250,11 @@ Here is where all pending Move to production requests, API requests and Post-pro ## Access the Control Center > Administrators & Account Managers: -
+
Here you can see which users are REDCap Admins (have all rights and access to all projects and their settings) and who is an account manager, who cannot access all projects and only perform duties related to REDCap accounts (suspend users, delete users, create accounts, etc.)
- 
+
@@ -269,13 +269,13 @@ Here you can see which users are REDCap Admins (have all rights and access to al ## Access the Control Center > Edit a Project's Settings: -
+
This is where you can change the settings for just one project, such as enabling the Double Data Entry module or taking the project off line.
-
+
-
+