To All King James Pure Bible Search Users:
There is now an easy way to compile and use the KJPBS Command-Line tools on your computer without actually having to know how to compile and write software, as I have created a Docker container provisioning script that will automate the building and configuration of the KJPBS Command-Line tools.
What is Docker? Docker is a software program that allows you to easily build and use virtual computer nodes right on your computer. These nodes are kept and run in "containers". The "container" is essentially its own complete operating system containing whatever applications it needs to function for its intended purpose. It's isolated from the rest of your computer and doesn't even have to be the same operating system that your computer is running.
The Docker container scripts I have developed for KJPBS creates a Linux-based image and compiles and runs the KJPBS tools in an environment similar to what I use for developing them. This allows them to work and run on your computer without your computer having to be set up in a particular fashion or with specific tools or compilers to use KJPBS directly outside of the container, meaning that it will work the same for everyone without requiring different installation and configurations for every different operating system, which makes it possible for everyone to use.
To set up your computer to use the KJPBS Command-Line tools in a Docker container, you simply need to do the following:
1) Install Docker Community Edition by visiting https://www.docker.com/community-edition and following their instructions for installing Docker-CE on your computer.
2) Install Packer by visiting https://www.packer.io/downloads.html and downloading the correct version for your computer. Packer is distributed as a zip-file containing a single, self-contained binary executable that you can simply extract and place on your computer so that it's in your system execution path (or in your working folder while creating the container).
3) Copy the KJPBS Docker script files, found on GitHub at https://github.com/dewhisna/KingJamesPureBibleSearch/tree/master/docker to a folder on your computer.
4) Open a command-prompt on your computer in the folder where you placed those Docker script files and run the following command:
packer build packer_docker_KJPBS.json
This will create the Docker image for KJPBS. Take a coffee-break while it's processing, as this step takes a while to run.
The four steps above only need to be completed once to get your computer set up with the KJPBS Docker image. After it's completed, your computer will have all of the KJPBS command-line tools ready to use.
Then, anytime you wish to use the KJPBS command-line tools, simply bring up a command-prompt on your computer and enter:
docker run --rm -it localhost:5000/dewtronics/kjpbs-cmd:latest
That will launch the KJPBS Docker Container and give you a new command-prompt to run KJPBS commands. Then you can simply run programs like KJVLookup, KJVSearch, and the new KJVPhraseSearch. Here's some examples:
# KJVLookup 1 "John 3:16"
# KJVSearch -h -t 1 "Word of God"
# KJVPhraseSearch -sc 1 13
Run these tools without any options to see usage information.
When you are finished using the command-line tools, simply enter "exit" to shut down the Docker container.
The KJPBS command-line tools do require basic command-line proficiency on your computer. If you are unfamiliar with using the command-line for simple tasks, you'll probably just want to stick with using the normal graphical user interface KJPBS application and not try using the command-line tools.
Also, note that the KJPBS Docker Image generated is around 11.5GB in size (not counting the space requirements for Docker and Packer) and will probably require 2-1/2 to 3 times that amount of hard drive free-space to generate. So make sure you have ample free hard drive space before you begin -- I recommend having at least 50-60GB free to try it.
God Bless,
Donna
(You are receiving this email because you are subscribed to the SourceForge purebiblesearch-release mailing list)
|
