PKC Data Package

PKC Data Package is a compressed file in the tar.gz format. It contains all configuration information of a PKC.

For the smallest initial data set, once DockerizedPKC is cloned from Github.com, one can follow the following procedure to create a fully functional PKC Data Package from scratch.

Clone DockerizedPKC from Github

Clone DockerizedPKC from [1]

git clone http://github.com/benkoo/DockerizedPKC
cd DockerizedPKC

Temporarily hide LocalSettings.php file from MediaWiki

Temporarily comment out the volume entry of - ./mountPoint/LocalSettings.php in the file: docker-compose.yml under the DockerizedPKC project home directory.

# - ./mountPoint/LocalSettings.php

Configure your version of MediaWiki

1. Kickoff the Docker-compose process to start both database and mediawiki services:

docker-compose up -d

1. Use a browser and enter the URL: http://localhost:9352
2. Go through the configuration process
   1. A typical setting for PKC is shown here: PKC MediaWiki configuration data
3. Download the newly generated LocalSettings.php file and put that file under the ./mountPoint directory under DockerizedPKC project
4. Stop the Docker-compose process

docker-compose down

1. Uncomment the entry in docker-compose.yml file (take out the # in front of the - ./mountPoint/LocalSettings.php entry.
2. Kickoff the Docker-compose process again to start both database and mediawiki services:

docker-compose up -d

1. Use a browser and enter the URL: http://localhost:9352, and you should see MediaWiki running.
2. After verifying the data is correct and the service are running, shutdown the service,

docker-compose down

1. You must wait for the docker processes to be turn down, before your can use tar -czvf command to package up all the data. For Windows 10 environment, use the following command:

tar -czvf <archive.tar.gz> ".\mountPoint"

For Mac, Linux and other Unix variants, use the following command:

tar -czvf <archive.tar.gz> ./mountPoint

Tested Data Packages

Due to the fact that Windows 10 tends to be the most unreliable runtime environment for Docker containers, we suggest that all data packages to be eventually tested on Windows before publishing the Data Package. This place will list a Github repository that stores some of these tested files: When the Data Package file ends with a platform name, particularly, windows as the last part of its file name before the .tar.gz, we assume that this file is tested on Windows platform.

A PKC Data Package Repository on GitHub.com