SimpleVAT Deployment Documentation
Purpose
This installation and deployment documentation focuses on describing technically the procedure to install and use the SimpleVAT software successfully.
Definitions
Containers - Containers are software that allows applications to work reliably when moved from one computing environment to another.
Docker – Docker is the most popular container engine, open-sourced for developers and administrators to manage, shift, and run applications.
Docker image - Docker image is a template that consists of instructions to conveniently package up applications.
Docker hub - Docker hub is a repository for storing and sharing private or public container images.
MySQL – Open source data base used for web-based applications.
Prerequisites
The following system prerequisites are necessary in prior to the installation of the Docker software:
Windows 10 64-bit: Pro
Enterprise
Education (Build 16299 or later).
The following hardware prerequisites are required to successfully run Docker on Windows 10:
64-bit processor with Second Level Address Translation (SLAT)
4GB system RAM
Docker installation
Docker is to be installed in your system prior to installation of SimpleVAT software.
Windows Docker installation
Download the installation file from docker hub. I will be available in your https://hub.docker.com/editions/community/docker-ce-desktop-windows/
When prompted, ensure the Enable Hyper-V Windows Features option is selected on the Configuration page.
Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
When the installation is successful, click Close to complete the installation process.
After this you need to install Mysql, Navigate to Creating Database Section.
Linux Docker installation
Installing on Ubuntu
Set up the repository
Update the apt package index and install packages to allow apt to use a repository over HTTPS:
Add Docker’s official GPG key:
Verify that you now have the key with the fingerprint 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88, by searching for the last 8 characters of the fingerprint.
Use the following command to set up the stable repository.
Install Docker Engine
Update the apt package index, and install the latest version of Docker Engine and containerd, or go to the next step to install a specific version:
To install a specific version of Docker Engine, list the available versions in the repo, then select and install:
a. List the versions available in your repo:
b. Install a specific version using the version string from the second column, for example, 5:18.09.1~3-0~ubuntu-xenial
Verify that Docker Engine is installed correctly by running the hello-world image.
Install On CentOS
Set up the repository
Install the yum-utils package (which provides the yum-config-manager utility) and set up the stable repository.
Install Docker Engine
Install the latest version of Docker Engine and containerd, or go to the next step to install a specific version:
If prompted to accept the GPG key, verify that the fingerprint matches 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35, and if so, accept it.
Docker is installed but not started. The docker group is created, but no users are added to the group.
2. To install a specific version of Docker Engine, list the available versions in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts results by version number, highest to lowest, and is truncated:
The list returned depends on which repositories are enabled, and is specific to your version of CentOS (indicated by the .el7 suffix in this example).
b. Install a specific version by its fully qualified package name, which is the package name (docker-ce) plus the version string (2nd column) starting at the first colon (:), up to the first hyphen, separated by a hyphen (-). For example, docker-ce-18.09.1
Docker is installed but not started. The docker group is created, but no users are added to the group.
Start Docker.
Verify that Docker Engine is installed correctly by running the hello-world image.
This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits.
Install On Debian
Set up the repository
Update the apt package index and install packages to allow apt to use a repository over HTTPS:
Add Docker’s official GPG key:
Verify that you now have the key with the fingerprint 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88, by searching for the last 8 characters of the fingerprint.
Use the following command to set up the stable repository.
Install Docker Engine
Update the apt package index, and install the latest version of Docker Engine and containerd, or go to the next step to install a specific version:
2. To install a specific version of Docker Engine, list the available versions in the repo, then select and install:
a. List the versions available in your repo:
b. Install a specific version using the version string from the second column, for example, 5:18.09.1~3-0~debian-stretch
Verify that Docker Engine is installed correctly by running the hello-world image.
This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits.
Creating database
Installing MySQL Shell with the MySQL APT Repository
Make sure you do not skip the step for updating package information for the MySQL APT repository:
sudo apt-get update
Install MySQL Shell with this command:
If you already have the MySQL APT repository as a software repository on your system, do the following:
Update package information for the MySQL APT repository:
Update the MySQL APT repository configuration package with the following command:
Install MySQL Shell with this command:
Installing MySQL Shell with the MySQL Yum Repository
If you already have the MySQL Yum repository as a software repository on your system but have configured the repository with the old release package mysql-community-release, it is easiest to install MySQL Shell by first reconfiguring the MySQL Yum repository with the new mysql57-community-release package.
To do so, you need to remove your old release package first, with the following command :
For dnf-enabled systems, do this instead:
Then, follow the steps given in Adding the MySQL Yum Repository to install the new release package, mysql57-community-release.
Enable the MySQL Tools Preview subrepository. You can do that by editing manually the /etc/yum.repos.d/mysql-community.repo file. This is an example of the subrepository's default entry in the file (the baseurl entry in your file might look different, depending on your Linux distribution)
Change the entry enabled=0 to enabled=1 to enable the subrepository.
Install MySQL Shell with this command:
For dnf-enabled systems, do this instead:
Connecting to Mysql Server
Now that Mysql is installed, you need to connect to the server and create your database
If that works, you should see some introductory information followed by a mysql> prompt:
Now you need to create a Database
Now that docker is installed and Mysql is configured we will now pull simplevat form Docker hub and run it in your machine.
Please keep a note of the database name, database username and password and it will be required in the next step.
Run Docker
Once the database is created, input the Docker commands which are needed to run the SimpleVAT application.
Open a command prompt and perform the following commands:
(to check the docker version)
Now we will pull the simplevat docker image from https://hub.docker.com/r/datainn/simplevat
Use the below command to perform this operation
Now that you have successfully pulled the docker image, we will now run the docker image
Use the below command to perform this operation
Last updated