PKC/Readme.md

Context

Given the impacts of Moore's Law, by year 2020, most Internet-connected data can be universally abstracted as a set of services, files, and page data assets, individuals can manage a scalable collection of data assets on privately owned computing resources and connect their resources to the public Internet at will. At the same time, software tools created under the Free Software movement, such as MediaWiki, Semantic MediaWiki,, Solid, Docker, Kubernetes, and Ansible have matured to a point that allows for individual persons to own personally controlled data centers. This created a new asset class that can have significant technological and societal implications.

Goal

To offer personal data asset management at scale PKC aims at minimizing the operational complexity of data backup, verification, and restore process as a sound data validation workflow, while using public-key infrastructure and networked timestamps to ensure the trust-worthiness of PKC contained data.

Success Criteria

1. Allow Individuals to install an instance of MediaWiki service by reading this PKC/Readme.md file.
2. Make all textual content, executable software images, installation scripts in the public domain, so that everyone can share and use them at will.
3. Provide instructions to learn about how to use PKC in the initial MediaWiki's database, so that people can start learning to use PKC through their own instance of MediaWiki.

Required Resources (Inputs)

1. A computer that you have access to its "root" or "administrator" previledge.
2. A host machine that runs an Operatng System that supports Docker:
   1. Windows 10
   2. Mac OS X
   3. Linux
3. Access to the Internet during intallation time. Try to perform the installation on a network with 10Mbps+ to the Internet.
   1. After installation, this system can operated without access to the Internet.
   2. References to MediaWiki's software installation practices.

Installation Procedure/Implementation Process

Go to Main Text

1. Install Git
2. Install Docker Runtime
3. Install PKC
4. (optional) Install Reverse Proxy
5. (Optional) Example of Source Code

Expected Outcome(Outputs)

1. A localized instance of Personal Knowledge Container, which can be accessed on localhost.
2. Given a configurable regular interval, all the changes you made to your local instance of MediaWiki will be automatically backed up to the directory's "backup/" sub-directory.
3. The textual content stored in MediaWiki's database can will be stored in an XML file: XLPLATEST.xml
4. All the uploaded files, assuming the file names are accepted by the host operating system, will be dumped to the "backup/MediaFile/" sub-directory.
5. New applications and data processing patterns can be defined by Data Flow
6. Please carefully read Explaining LocalSettings.php to see how the MediaWiki is being set up.

Boundary Conditions

1. PKC have only been tested on a small number of machines and configurations, your mileage may vary.
   1. Compared to Unix-derivatives such as Mac OSX and Linux operating systems, installing PKC on Windows operating system can be a challenge, therefore, please refer to PKC on Windows Platform.
2. We can not warrant any reliability, completeness, and accuracy of this installation procedure. Any action you take upon this information and execute this script is at your own risk, the software developers for PKC have no way to be liable for any losses and damages in connection to the use of the actions and software prescribed here.
3. Do not remove any of the files in the directory with backup/, such as docker-compose.yml and the LocalSettings.php. These files are the configuration files for Docker and MediaWiki respectively. Missing them, this system will cease to work.