Actions

Windows Install - Core and Packages API Installation

From VersaVision Support


Core-Pack-Main.png

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.



Return to Software Installation Main Page Pre-Install File Upload Guide Windows Server 2022 Windows 10 & 11 Pro WSL Installation Guide
Docker on WSL Installation Guide VersaVision Core & Packages API Installation Guide Initialize VersaVision Guide VersaVision Windows Service Installation Guide Package Upload and Install Guide

INSTRUCTIONS


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


Select the Run As Administrator option for this application.
WSL2a.png


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


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.
Core-Pack1.png


System will return a Stopped result for Ubuntu
Core-Pack2.png


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.
Core-Pack3.png


This will relaunch Ubuntu and provide you with a new user prompt.
Core-Pack4.png


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.
Core-Pack5.png


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.
Core-Pack6.png


A Hello World message will display in Power Shell.
This is done to confirm Docker is running correctly.
Core-Pack7.png


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.
Core-Pack8.png


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.
Core-Pack9.png


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.
Core-Pack10.png


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


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.
Core-Pack12.png


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.
Core-Pack13.png


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 left of the user prompt (similar to the screen shot below).
Core-Pack14.png


Once the Core Package has been loaded, copy the Code/Text from the cell below.
sudo docker container rm -f initial-packages-api


Paste the Code/Text into the Power Shell Terminal.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Core-Pack16.png


Click on the X in the top right corner of the Power Shell window to close the interface.
Core-Pack15.png


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



Return to Software Installation Main Page Pre-Install File Upload Guide Windows Server 2022 Windows 10 & 11 Pro WSL Installation Guide
Docker on WSL Installation Guide VersaVision Core & Packages API Installation Guide Initialize VersaVision Guide VersaVision Windows Service Installation Guide Package Upload and Install Guide

VC Footer.png
Follow Us On LinkedIn View our Blog