Windows Install - VersaVision Service
From VersaVision Support
Revision as of 14:59, 27 March 2024 by VVSupportAdmin (talk | contribs) (Created page with "<BR> <span style="box-shadow:2px 2px 15px #90A4AE; border-radius:5px; padding:20px">250px|link=Windows Install - VersaVision Windows Service</span> <div style="text-align: center;"><span style="color:#0054a6; font-size:150%;"><u>'''OVERVIEW'''</u></span></div> <BR> <div style="box-shadow:2px 2px 15px #90A4AE; border-radius:5px; padding:10px"> :WSL by default requires a user to log into the Windows Computer/Server/VM in order for WSL to run/st...")
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.
- 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.
INSTRUCTIONS
- 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
- Leave the Power Shell Window open.
- The Guide will come back to Power Shell later.
- Copy the Code/Text from the cell below.
- wsl --list --verbose</span>
- 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>
- 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>
- 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>
- Copy the Code/Text from the cell below.
- netsh interface portproxy show v4tov4
- Copy the Code/Text from the cell below.
- New-NetFirewallRule -DisplayName "HTTP" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 80
- Copy the Code/Text from the cell below.
- New-NetFirewallRule -DisplayName "Portainer" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 9000
- Copy the Code/Text from the cell below.
- New-NetFirewallRule -DisplayName "Web Sockets" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 9090
- Leave the Power Shell Window open.
- The Guide will come back to Power Shell later.
- 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>
- Close all open windows and reboot the server.
- NOTE: The Computer/Server/VM MUST be restarted for all changes to take effect.
- Return to the Software Install Main page and continue with the next Guide/Step.