Since Islandora CLAW has moved development to Drupal 8, our Docker images no longer function properly. We recommend using the vagrant build instead. Please follow the Islandora listserv and weekly CLAW Tech Calls for updates about the status of Docker and Ansible with Islandora CLAW.
Please note that even with vagrant, there is not yet a stable release of Islandora CLAW. We welcome your volunteer contributions to help get the project to production.
❗ ❗ ❗
This is a single image that will install the dependencies required to run Islandora CLAW.
It's provided for the purposes of easing testing and development, but is not intended for production use.
Please see the install documentation in our main Docker repository.
With Kitematic you can download this Image from Docker Hub.
Please read the Kitematic documentation for more details.
If using Kitematic solely you must provide the required Environment Variables documented below.
If using Docker Compose, you first must generate the environment variables files, by running the command ./commands/generate-env-files
documented below.
Once the files have been generated simply run:
docker-compose up
To run in the foreground.
Please refer to our Docker User Guide for more information on using Docker Compose.
- PHP 5.6.17
- Java 8
- Drupal 7.43
- Tomcat 7.0.68
- Fedora 4.4.0
- Solr 4.10.3
- Blazegraph 1.5.1
- Karaf 4.0.4
Variable | Required | Default |
---|---|---|
TOMCAT_VERSION | no | 7.0.68 |
MAVEN_VERSION | no | 3.3.9 |
TOMCAT_VERSION | no | 7.0.68 |
FEDORA_VERSION | no | 4.4.0 |
BLAZEGRAPH_VERSION | no | 1.5.1 |
SOLR_VERSION | no | 4.10.3 |
SOLR_DEPENDENCIES | no | log4j-1.2.17.jar slf4j-api-1.7.6.jar slf4j-log4j12-1.7.6.jar |
KARAF_VERSION | no | 4.0.4 |
DRUSH_VERSION | no | 8.0.2 |
DRUPAL_VERSION | no | 7.43 |
SOLR_DEPENDENCIES are the jar files to copy from example/lib/ext
into $CATALINA_HOME/lib
.
Example:
docker build --build-arg "TOMCAT_VERSION=7.0.68" -t islandora/claw-all-in-one .
Variable | Required | Default |
---|---|---|
TOMCAT_ADMIN_USER | no | admin |
TOMCAT_ADMIN_PASSWORD | yes | |
JAVA_OPTS | no | |
CATALINA_OPTS | no | -server -XX:+CMSClassUnloadingEnabled -Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom" -Dfcrepo.home=/mnt/fedora-data -Dcom.bigdata.rdf.sail.webapp.ConfigParams.propertyFile=/opt/tomcat/webapps/bigdata/WEB-INF/RWStore.properties" |
KARAF_OPTS | no | -Xms128M -Xmx512M -XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass |
MYSQL_ROOT_USER | no | root |
MYSQL_ROOT_PASSWORD | yes | |
DRUPAL_SITE_NAME | no | Islandora CLAW |
DRUPAL_SITE_EMAIL | no | webmaster@localhost.com |
DRUPAL_SITE_LOCALE | no | en-us |
DRUPAL_SITE_ACCOUNT_NAME | no | admin |
DRUPAL_SITE_ACCOUNT_PASSWORD | yes | |
DRUPAL_SITE_ACCOUNT_EMAIL | no | webmaster@localhost.com |
DRUPAL_SITE_DB_NAME | no | drupal_default |
DRUPAL_SITE_DB_USER | no | drupal |
DRUPAL_SITE_DB_PASSWORD | yes | |
DRUPAL_SITE_DB_REPLACE_EXISTING | no | no |
DRUPAL_SITE_DB_REPLACE: If set to 'yes', the Drupal database will be replaced on start-up.
Example (foreground, random host port mapping, auto-remove, interactive shell):
docker run --rm -ti -P \
-e "TOMCAT_ADMIN_PASSWORD=your_super_secure_password" \
-e "MYSQL_ROOT_PASSWORD=your_super_secure_password" \
-e "DRUPAL_SITE_ACCOUNT_PASSWORD=your_super_secure_password" \
-e "DRUPAL_SITE_DB_PASSWORD=your_super_secure_password" \
islandora/claw-all-in-one ash
For convenience a number of commands are provided in the commands folder.
Command | Arguments | Defaults | Notes |
---|---|---|---|
build | none | Build this image with the default settings. | |
drush | drush documentation | Execute a drush command within the container | |
karaf | none | Connect to the Karaf client. | |
shell | none | Connect to the container and open an interactive shell. | |
exec | any valid command | Executes the given command in the container. | |
generate-env-files | none | Generates the .env files required to run docker-compose. |
N.B. The command above assumes you used docker-compose
to start the container or you have given the container the name islandora-claw.
- UPEI
- discoverygarden inc.
- LYRASIS
- McMaster University
- University of Limerick
- York University
- University of Manitoba
- Simon Fraser University
- PALS
- American Philosophical Society
- common media inc.
Current maintainers:
If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!
If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor Licencse Agreement. Please see the Contributors pages on Islandora.ca for more information.