Windows Install - Core and Packages API Installation

OVERVIEW

VersaVision is an On-Premise Web Based Application. Each part of the application is a Package that runs independently.

To Load and Run Packages, Docker must be configured correctly and the Core application must be installed.

REQUIREMENTS

Log In: Installer/User must have a Windows Log In with Administrator permissions. This Account must remain active after the installation.

Access: When using a VM, Installer/User must have Remote PC Access to the Windows instance.

Internet Access: Server must have full internet access. Access can be removed after the installation is complete.

Pre-Requisites I: User must have downloaded the Core & Packages API files and copied them to the C:\VersaVision\Packages folder.

Pre-Requisites II: Docker must be installed before attempting to install the Core Application and Packages API.

NOTE: The instructions below will work for Windows Server 2022, Windows Pro 10 & Windows Pro 11.

TOOL TIP

There is specific Code that needs to be entered in on the steps below. The Paste function in Power Shell and WSL works differently from Windows.

To Copy - select the Code/Text in the cell so that it is highlighted. Press the Control Key & C Key on your keyboard at the same time. Alternatively, you can right click on the highlighted text and select Copy from the pop-up menu.

To Paste - Right Click on the Cursor next to the User Prompt. The copied text will fill in automatically.

INSTRUCTIONS

Open Power Shell on the Computer/Server/VM – type Power Shell in the search field next to the Windows button.

Select the Run As Administrator option for this application.

A Power Shell Window will load on the screen with a User Prompt.

Copy the Code/Text from the cell below.

wsl --list --verbose

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

System will return a Stopped result for Ubuntu

Copy the Code/Text from the cell below.

wsl

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

This will relaunch Ubuntu and provide you with a new user prompt.

Copy the Code/Text from the cell below.

sudo docker run --rm hello-world

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Power Shell will request the Password - enter the Password completely and press the Enter key on your keyboard.

Enter the Password you created when installing WSL/Ubuntu. For our example, the Password is 6676776.

The Password typed in will not be displayed on the screen.

A Hello World message will display in Power Shell.

This is done to confirm Docker is running correctly.

Copy the Code/Text from the cell below.

sudo docker swarm init

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

cd /mnt/c/VersaVision/Packages

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

sudo docker image load -i 'packages-api!1.1.2.tar'

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

A Loading progress will display - allow the load to complete.

Copy the Code/Text from the cell below.

sudo docker run -d --name initial-packages-api -p 9998:80 --mount type=bind,source=/var/run/docker.sock,destination=/var/run/docker.sock --mount type=volume,source=packages-api,destination=/var/lib/packages-api -e INITIAL_DEPLOYMENT_MODE=true packages-api:1.1.2

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

curl -F 'file=@core-package!1.1.2.1.package' http://localhost:9998/api/packages/upload

Paste the Code/Text into the Power Shell Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

The Core Package can take up to 5 minutes to load. In most cases, the load time will be 60 to 90 seconds.

Allow the load to complete. When the load is completed, there will be a message to the right of the user prompt (similar to the screen shot below).

Once the Core package has been loaded, Click on the X in the top right corner of the Power Shell window to close the interface.

Return to the Software Install Main page and continue with the next Guide/Step.

---