Installing Velocity Web Service Client and IIS Client_v3.8.4

Owned by Anand Rajaraman
Last updated: Feb 26, 2023
5 min read

To install a Velocity Web Services Client, perform the steps in this procedure:

  1. Make sure you are logged onto Windows as an administrator.

  2. Run the Velocity_Installer_3.8.4(build-3.8.4.xxx).exe file for the Velocity 3.8.4 installation:

    • If you have a Velocity 3.8.4 installation DVD, insert it into your DVD drive, and the auto-start feature should automatically start the Velocity Installer.

    • If you downloaded the files to install Velocity 3.8.4, use Windows Explorer to navigate to the folder containing those files, and double-click on Velocity_Installer_3.8.4(build-3.8.4.xxx).exe.

  3. After the Velocity Installer’s Welcome (or splash) screen appears, click Next.

     

  4. On the resulting End-User License Agreement page, select the “I agree to the terms in the License Agreement” option, and click Next.

  5. In the Install Options screen, select the Server option and either accept the currently displayed SQL server or select a different one, then click Next.

    Note: If the SQL Server Browser service is not running, a dialog is displayed which enables you to remedy the problem.

  6. At the resulting Web Services Options screen, select the Install Velocity Web Services option, then click Next.

  7. When the EULA Screen appears, read the License Agreement and scroll down to the bottom and click Next.

     

  8. In the succeeding screens to follow, click next to proceed till you reach a screen like the one shown below.

  9. In the Application Install Option of the Velocity Web Services Client Installer wizard select the appropriate set of options, then click Next.

    • Choose whether to install both the Velocity Web Service and the IIS Client Website or only the Velocity Web Service

      • Choosing the option to Install Velocity Web Service only enables the last option on this page to Create a Website bundle for the separate machine. This enables you to install the Web site on a different computer than your Velocity Server.

    • Choose whether to enable Secure Socket Layer (SSL) communication for the Velocity Web Service and Website

    • If you chose the option to install only the Velocity Web Service on this computer, then you can choose whether to create a Website bundle for installing the Web site on a different computer than your Velocity Server
      After you click the Next button, the following screen appears:

  10. On this Service and Website Settings screen:

    1. In the Service Account field, verify or change the user account (by default in the Velocity Services group) that the underlying service for the Velocity Web Services Client will use to log on to Velocity. The default information is automatically obtained for you.

    2. In the Password field, enter the password that the specified Service Account will use to log on to Velocity. (Enter the same password that was used on the Application Network and Security page of the Velocity Installer wizard.)

    3. In the Port number field, enter the network port number that will be used for communication between Velocity and the Velocity Web Services Client.

    4. Click Next
      An Application Installation screen displays progress information while the Velocity Web Services Client is being installed. For example

    5. After successful Velocity Web Services Client installation, the VWSC Installation complete screen appears as below:

  11. If you are updating an existing installation of the Velocity Web Services Client (instead of performing a new installation), then when the following dialog appears, choose whether or not you need the Velocity Web Service to use the secured HTTPS protocol when communicating with some other software components.


    After the installation of the Velocity Web Services Client has finished, its installer wizard closes, and the primary Velocity installation begins, with progress information displayed on its Application Installation page.

  12. When the Installation Complete screen is displayed, select the desired Closing Options, and click the Close button.

  13. After Velocity and the Velocity Web Services Client have finished installing, ensure that:

    • the Velocity Web Service is running

    • if you want to use a network port other than the default of 80, you must configure the network port used by the default IIS Web site to communicate with the Velocity Web Services Client

    • the network port used by the default IIS Web site is allowed through your firewalls

Ensuring that the Velocity Web Service is Running

To check the status of the Velocity Web Service, you must have the following  Role Permission: Application Permissions ▶ Service Control Manager ▶ Service Control Manager - Use.

After you install the Velocity Web Services Client, you should use Velocity's Service Control Manager to verify that the Velocity Web Service is running.

  1. Right-click on the Velocity Service Control Manager icon in the Windows task-bar, and look at the commands on the pop-up menu:

    • If you see a command to Start Velocity Web Service, click on it

    • If you see a command to Stop Velocity Web Service, the service is already running, and you should click outside the pop-up menu to close it