Actions

Windows Install - VersaVision Service

From VersaVision Support


VV-Service-Main.png

OVERVIEW


WSL by default requires a user to log into the Windows Computer/Server/VM in order for WSL to run/start.
The disadvantage of this is when a Computer/Server/VM is updated or restarted. WSL will stop running and VersaVision will stop running until the user manually logs in on the Computer/Server/VM.
To prevent this issue, we have a Service that runs inside Windows that keeps WSL running without a user having to log in.
This guide will explain how to install and setup this Windows Service.


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 uploaded/extracted the VersaVision Windows Service zip file to the C:\VersaVision\WindowsService folder.
Pre-Requisites II: User must have installed WSL, Docker and the Core/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.
New-Service -Name VersaVision -BinaryPathName "C:\VersaVision\WindowsService\VersaVisionWindowsService.exe" -Description "Manages VersaVision on Windows" -DisplayName "VersaVision" -StartupType Automatic


Paste the Code/Text into Power Shell - press the Enter key on your keyboard after the Code/Text is pasted in.
Serv1.png


Leave the Power Shell Window open.
The Guide will come back to Power Shell later.


Open Windows Services on the Computer/Server/VM – type Services in the search field next to the Windows button.
Serv2.png


Select the Services App from the menu.
Serv3.png


In the Services Window, scroll down the list until you find the VersaVision service.
Serv4.png


Right Click on the VersaVision service.
Serv5.png


Select Properties from the pop-up menu.
Serv6.png


On the Properties Window, select the Log On tab.
Serv7.png


Select the This Account option.
Serv8.png


Select the Browse button.
Serv9.png


Type in the name of the Window User account you logged in with.
Serv10.png


Click on the Check Names button.
Serv11.png


The name typed in will be replaced with the qualified user name – click on the OK button.
Serv12.png


Type in the password for this user in the Password field.
Serv13.png


Type in the password a second time in the Confirm Password field.
Serv14.png


Select the OK button.
Serv15.png


When you are returned to the Services window, right click on the VersaVision service.
Serv5.png


Select Start from the pop-up menu.
Serv11a.png


If Start is greyed out – select the Restart option from the pop-up menu.
Serv11b.png


Go back to the Power Shell Window that was left open in the beginning of the guide.
Serv11c.png


Copy the Code/Text from the cell below.
wsl --list --verbose


Paste the Code/Text into the WSL Terminal.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Serv16.png


The Ubuntu service should be shown as Running.
If it is not Running, restart the VersaVision service from the previous steps.
Serv17.png


Bring up your IP Address screen shot or notes that you made in the Server 2022/Windows 10, 11 Install – Docker Installation guide.
This IP Address, labeled as inet, will need to be used in the commands below.
Dock10.png


IMPORTANT NOTE FOR THE FOLLOW STEPS.
The next 3 Copy/Paste Code/Text steps will have an <ipaddress> field in them.
DELETE the <ipaddress> text and replace it with your IP Address found in the step above.
If this is not replaced, the Command will fail in Power Shell.


Copy the Code/Text from the cell below.
Replace the <ipaddress> text with your IP Address.
netsh interface portproxy set v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<ipaddress>


Paste the Code/Text into Power Shell.
Our example IP is in Red.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Serv18.png


Copy the Code/Text from the cell below.
Replace the <ipaddress> text with your IP Address.
netsh interface portproxy set v4tov4 listenport=9000 listenaddress=0.0.0.0 connectport=9000 connectaddress=<ipaddress>


Paste the Code/Text into Power Shell.
Our example IP is in Red.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Serv19.png


Copy the Code/Text from the cell below.
Replace the <ipaddress> text with your IP Address.
netsh interface portproxy set v4tov4 listenport=9090 listenaddress=0.0.0.0 connectport=9090 connectaddress=<ipaddress>


Paste the Code/Text into Power Shell.
Our example IP is in Red.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Serv20.png


Copy the Code/Text from the cell below.
netsh interface portproxy show v4tov4


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


Power Shell will display information about each of the Ports that were added in the steps above.
Each Port will show that it is now mapped to the IP Address that was entered.
Serv22.png


Copy the Code/Text from the cell below.
New-NetFirewallRule -DisplayName "HTTP" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 80


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


You will get a print out on the screen the looks like the image below.
Serv24.png


Copy the Code/Text from the cell below.
New-NetFirewallRule -DisplayName "Portainer" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 9000


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


You will get a print out on the screen the looks like the image below.
Serv26.png


Copy the Code/Text from the cell below.
New-NetFirewallRule -DisplayName "Web Sockets" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 9090


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


You will get a print out on the screen the looks like the image below.
Serv28.png


Leave the Power Shell Window open.
The Guide will come back to Power Shell later.


Before executing the next command, you will need to get the IP Address of the Windows Server/Computer/VM.
If you do not know the IP Address, type Ethernet settings into the search field next to the Windows button.
Serv29.png


Select the Ethernet settings application.
Serv30.png


Click on the Ethernet connection that shows as Connected.
Serv31.png


Scroll down to the Properties section, the IP Address needed is the one marked as IPv4 address.
Make a note of this IP Address.
Serv32.png


Return to the Power Shell Window that you left open.
Copy the Code/Text from the cell below.
New-NetFirewallRule -DisplayName "VersaVision Host Management" -Direction Inbound -Action Allow -Protocol TCP -RemoteAddress <serveraddress>


Paste the Code/Text into Power Shell.
REPLACE the <serveraddress> field with the IP Address you noted in the step above in Ethernet Settings.
Press the Enter key on your keyboard after the Code/Text is pasted in.
Our example IP is in Red.
Serv33.png


Close the Power Shell Window.
Serv34.png


Open a Web Browser on another computer, not the Computer/Server/VM where VersaVision has been installed, connected to your network.
Edge is shown in the example, Chrome will work as well.
Initialize1.png


Type in the Server IP Address, that you obtained in the previous steps, into the web browser.
For our example this is 10.10.10.10.
Press the Enter key on your keyboard.
Serv35.png


The VersaVision log in screen should load.
If this screen does not load, contact VersaCall for assistance.
Initialize19.png


Return to the Computer/Server/VM that has the VersaVision installation.
Type File Explorer into the search field next to the Windows button.
Serv36.png


Select the File Explorer application from the list.
Serv37.png


Double click on the C: Drive.
Serv38.png


Double click on the Users folder.
Serv39.png


Double click on the (Users Name) Folder.
Our example is showing Administrator.
Serv40.png


Inside File Explorer, select the View option from the tool bar.
Serv41.png


Select the File name extensions option.
Serv42.png


There should be a check mark next to the File name extensions.
Serv43.png


Right click on an empty space on the right side of the root menu.
Serv44.png


Select New from the pop-up menu.
Serv45.png


Select Text Document from the New Menu
Serv46.png


A new text file will show on the screen named New Text Document.
The name will be highlighted, click on the file name.
Serv47.png


Replace the New Text Document name with wslconfig.
All lowercase letters with NO spaces.
Serv48.png


Press the Enter key on your keyboard after entering the new file name.
Serv49.png


Double click on the wslconfig.txt file you just created.
Serv50.png


A new Notepad Window will load on the screen.
The document will be blank, click on the document to get a cursor.
Serv51.png


Once the cursor appears, type in [wsl12].
All lowercase letters NO spaces.
Serv52.png


Press the Enter key on your keyboard after typing in the text.
Serv53.png


Type in Memory=16GB exactly as it is here.
Serv54.png


After typing in the second line of code, select File option from the Window Tool bar.
Serv55.png


Select Save from the File menu.
Serv56.png


Close the Notepad Window by clicking on the X in the top right corner.
Serv57.png


Close all open windows and reboot the server.
NOTE: The Computer/Server/VM MUST be restarted for all changes to take effect.


Next Step - Package Upload and Install Guide



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