How do I start up a headless Virtualize server?
Hey everyone! Often in organizations, users will want to be able to spread the work that they have done with others, allowing progress to be shared. Virtualize is no exception to this rule, as there will be many times across a team where users will want to be able to access the same virtual endpoint as opposed to the real endpoint for testing and verification purposes. This guide will step you through the process of starting up a headless Virtualize server that can be shared across your team.
Before we embark on our journey, there are a few things that we need before we can go on.
- A Virtualize server license
- A localsettings file --Note: This file is a description of all of the different preferences that users can set within their Virtualize desktop client. A post describing the process of creating and editing the localsettings file can be found here.
- An FTP client or some other means of moving the localsettings file to the Virtualize machine
- Access to the machine the Virtualize server will be running from
- An installation of Virtualize on that machine
Now that we have our prerequisites taken care of, it's time to put them to use. First, use your FTP client to drop the localsettings file from your local machine to the headless machine. For ease of access, it is recommended to drop this file into the Virtualize installation directory.
Now, open up your terminal/command prompt. Once it is open, navigate to your Virtualize installation directory, and use the following command to start up your Virtualize server:
-(Windows) virtualizecli.exe -startServer -localsettings "localsettings.properties"
-(Linux) ./virtualizecli -startServer -localsettings "localsettings.properties"
Note: if you are using a workspace different than your default workspace, you can specify to start up in that workspace by using the following flag in the startup command:
Connecting to the headless server
Once your server is up and running, the next step is to connect your desktop client to it.
To do so, open up your Virtualize client and look at your Virtualize server tab. Here, there will be a button with the Virtualize logo on it with a small '+' symbol on it. Click this button to bring up the "Add Server" window.
Here, enter in the hostname of the server you installed Virtualize onto, the Display name on your machine for that server, and the protocol for the server (default http). If you are connected to CTP/Environment Manager, you may also need to enter in your CTP/EM login to this window.
Once that is done, click OK, and if you have everything configured correctly, then congrats, you have stood up and connected to a remote Virtualize server.