# Install Velocity Web Service

### Requirements

- **Velocity Operator User**: This is required for the IIS application pool.
- **Velocity REST API Software:** Ensure you have the necessary software for the REST API.
- **Velocity REST API User Creation Tool:** This tool is needed to create users for the REST API.
- **Velocity License:** A valid Velocity license is required.  
    
    - SDK2 or RestfulVelocitySDK (SEN 165034): Ensure you have either SDK2 or RestfulVelocitySDK with the specified version.

### Installation

- **Download the Velocity REST API Service Pack**: 
    - Obtain the software pack by contacting Identiv IGS or your SADEVIO account manager.
- **Unzip the Directory**: 
    - Extract the contents of the service pack to your desired location.

[![Screenshot 2024-06-27 at 11.36.00 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-36-00-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-36-00-am.png)

- **Open IIS Manager**: 
    - Launch the Internet Information Services (IIS) Manager.
- **Add a New Website**: 
    - In the left-hand Connections pane, right-click on "Sites" and select "Add Website..."

[![Screenshot 2024-06-27 at 11.38.24 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-38-24-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-38-24-am.png)

- **Site Name**: Enter a name for your site, e.g., `velocityrestapi`.
- **Physical Path**: Select the directory where you have unpacked the Velocity REST API software.
- **TCP Port**: Set your dedicated TCP port, e.g., `8088`.

[![Screenshot 2024-06-27 at 11.39.22 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-39-22-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-39-22-am.png)

**Configure the Application Pool**:

- - **Windows Account**: Ensure the service uses a Windows account that is a Velocity operator with administrative permissions to add/update persons in Velocity.
    - **Select the Application Pool**: 
        - In the left-hand Connections pane, click on "Application Pools."
        - Select your REST API application pool from the list.
    - **Open Advanced Settings**: 
        - - In the right-hand Actions pane, click on "Advanced Settings."

[![Screenshot 2024-06-27 at 11.43.31 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-43-31-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-43-31-am.png)

- In the "Advanced Settings" window, locate the "Identity" option.
- Enter the credentials for your Velocity user.

[![Screenshot 2024-06-27 at 11.44.40 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-44-40-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-44-40-am.png)

8. **Restart the Website**: 
    - After setting the user, restart the website context of the REST API.
9. **Verify the Installation**: 
    - Open a web browser and navigate to the check license endpoint to verify the installation: 
        - `http://localhost:8088/Api/CheckLicense`
    - Ensure everything is functioning correctly.

[![Screenshot 2024-06-27 at 11.47.46 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-47-46-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-47-46-am.png)

### IIS configuration

- **Access Advanced Settings**: 
    - Navigate to your application pool and select "Advanced Settings."
- **Enable 32-Bit Applications**: 
    - Set the "Enable 32-Bit Applications" option to `True`.

[![Screenshot 2024-06-27 at 11.49.51 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-49-51-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-49-51-am.png)

**Configure Idle Time-out**:

- Set the "Idle Time-out (minutes)" option to `0`.

[![Screenshot 2024-06-27 at 11.51.15 AM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/screenshot-2024-06-27-at-11-51-15-am.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/screenshot-2024-06-27-at-11-51-15-am.png)

### Generate Velocity REST API Password

- **Generate Password**:
    
    
    - Use the Velocity configuration tool to generate a password for the API.
    - Enter the desired password in both text fields.

[![Screenshot 2024-06-27 at 5.39.21 PM.png](http://help.sadevio.com/uploads/images/gallery/2024-06/scaled-1680-/O82screenshot-2024-06-27-at-5-39-21-pm.png)](http://help.sadevio.com/uploads/images/gallery/2024-06/O82screenshot-2024-06-27-at-5-39-21-pm.png)

- **Configure Password**:
    
    
    - **For Cloud Connector**: 
        - Configure the generated password in the `appsettings.json` file.
    - **For On-Premise System**: 
        - Configure the generated password in the access system configuration.