13. How Do I Setup VVEngine as a Windows Service?
*** Requires VVEngine 1.1 or any later version ***
- After installing VVEngine (see http://www.tgrmn.com/web/kb/item47.htm) go to the installation folder (usually c:\program files\vvengine\)
- Open the subfolder "Serv".
- Double-click on the file "Service - INSTALL VVEngine as Service.bat" This script will install VVEngine as a service. You will need administrator privileges to be able to do it. Note: this script will stop any VVEngine profiles that are running before installing VVEngine as a service.
- Open the Windows Service Console. You should now see VVEngine in the list of installed services.
- Right-click on the "VVEngine service" and select "Properties" from the menu. Click on the "Log On" tab and select which account will run the VVEngine service. If you plan to schedule synchronizations or replications over the network, an account with network access needs to run the VVEngine service, e.g. Administrator
- After having selected the right account, click on the button "OK" and start the service by right-clicking on the service name and selecting "Start" from the menu.
- As a service, VVEngine will keep running even if no one is logged onto the computer.
- You can connect to VVEngine from any computer in the network by typing http://<ip>:8001 into the web browser address bar. <ip> is the IP address of the computer on which VVEngine is running (for example http://192.168.1.100:8001). See http://www.tgrmn.com/web/kb/item54.htm for more information.
VVEngine saves its settings and the profile list in a file called VVEngine.xml This file is kept in the folder c:\Documents and Settings\<account>\Application Data\VVEngine (where <account> is the account name running VVEngine).
If you install VVEngine as a service under a different account and you want to maintain the profile list, you will need to copy this file from the old account location to the new account location.
- Services do not have access to mapped network drives: use UNC paths in the ViceVersa profile settings if you plan to run VVEngine as a Windows Service and need to access the network.
- The local system account does not have access to the network at all. Use the NetworkService account or a user account with network access if you need to access the network.
- If a password to access the network is needed, enter it in profile settings -> folders -> network in the ViceVersa profile.
- If the password to access the network expires or changes, it needs to be re-entered.
- If the account password for the account running the VVEngine service is changed or expires the VVEngine service will stop working. An event is logged in the Windows Event Log. You'll need to re-enter the password in the service properties. Best practice is to use a dedicated account to run the VVEngine service with a password that does not expire.
- To use Volume Shadow Copies, backup / restore privileges are required (use an account member of the Backup Operators group or Administrators to run the VVEngine service).
| | A printable version of the entire ViceVersa FAQ and Knowledge Base is also available.
For further queries, please contact us by E-Mail at firstname.lastname@example.org.