# Commander VRSD Implementation Guide

## Revision History 

<table data-header-hidden><thead><tr><th width="219" valign="top">Date</th><th>Description</th></tr></thead><tbody><tr><td valign="top">July 22, 2014</td><td>Initial Documentation Release.</td></tr><tr><td valign="top">September 8, 2014</td><td>Added Connectivity Check section.</td></tr><tr><td valign="top">May 14, 2015</td><td>Added Requesting/Canceling Upgrade, Network Diagram Example, and Configuring the Verifone Enhanced POS Zone Router.</td></tr><tr><td valign="top">July 28, 2015</td><td>Made correction to Service ID digits to seven.</td></tr><tr><td valign="top">September 23, 2015</td><td>Added a note to the Service ID in Site Requirements and URL note to the overview where clients can find more information on VRSD.</td></tr><tr><td valign="top">November 12, 2015</td><td>Notes format update. Update to Installing VRSD.</td></tr><tr><td valign="top">November 2, 2017</td><td>Added a network requirements section.</td></tr><tr><td valign="top">May 13, 2021</td><td>Updated the entire document.</td></tr></tbody></table>

## Overview

The Verifone Remote Software Delivery (VRSD) feature allows a site to initiate a complete software upgrade without requiring the presence of a technician (VASC) or intervention from the Verifone Helpdesk. This feature requires an Annual Support Maintenance (ASM) contract. One of the benefits of having the ASM is the automatic delivery of auto-upgrade packages via VRSD using the public Internet.
\
This feature meets PCI requirements and can be used with every PCI compliant version of any application. This guide describes how to set up a site to receive Verifone Remote Software Delivery.

{% hint style="info" %}
For more information on VRSD, go to support.verifone.com > Technical Support > Support Articles > Petro and Convenience > Products and Services > Software Updates (VRSD).
{% endhint %}

### Supported Hardware Configurations and Requirements

### Supported Hardware Configurations

VRSD is supported on the following Commander Site Controller or RubyCi configurations:

* Verifone Commander + Verifone C18

### Site Requirements

Each site must have the following before VRSD can be used:

* Verifone Commander
* Approved MNSP solution
* Valid 7-digit Service ID assigned by Verifone

{% hint style="info" %}
A valid 7-digit Service ID must be entered. The correct Service ID is critical for VRSD to connect to the VeriCentre Server. The service ID must be unique to the installation. One Service ID per installation and cannot be shared across multiple installations.
{% endhint %}

* Active Annual Software Maintenance (ASM) contract

### Network Requirements

These are the minimum suggested network requirements for Verifone Commander with a router. Meeting these requirements ensures the best experience with Verifone support and remote upgrade services.

These are the minimum suggested network requirements with Verifone Commander and a router. This ensures the best experience in support and remote upgrade service from Verifone. The WAN/Internet connection should adhere to the following minimum network requirements.

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Download</td><td valign="top">Upload</td><td valign="top">Latency</td><td valign="top">Packet Loss</td></tr><tr><td valign="top">> = 1.5Mb</td><td valign="top">>= 768Kb</td><td valign="top">&#x3C;= 500ms</td><td valign="top">0%</td></tr></tbody></table>

In addition to the above, for VSAT connectivity include:

* Enable TCP Acceleration on the communication over Port 443 from the Commander Site Controller. See article [TCP acceleration](https://en.wikipedia.org/wiki/TCP_acceleration).
* Perform large file transfers during non-data rated (Access control) hours.
* Perform software upgrades during times when there are no downloads to other site systems.
* Optional when available, upgrade data line including extending window of access control and using newer acceleration technologies that come with VSAT solutions.

<figure><img src="/files/LGX5cPY2jI5E1doMSZ71" alt=""><figcaption></figcaption></figure>

## Service ID and ASM Contract

### Determine the Service ID

Use the Verifone Premier Portal to find the Service ID and confirm an active ASM contract.

{% stepper %}
{% step %}
**Verifone Premier Portal**

Open a browser and navigate to the Premier Portal. Log in with your credentials.

<figure><img src="/files/BCBEwsTN6cmR8uTC7anc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### View

Click on **View**.

<figure><img src="/files/OQJNyeZkliAJerICs80L" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Lookup Site Services**

Click **Lookup Site Services** from the left menu.

<figure><img src="/files/s1LMqcxFONFHR8QRM7Oo" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Site Information**

Enter the site details and click **Search**.

<figure><img src="/files/MgW4H4ozayCtQDYi0GjO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Record the Service ID**

The **Lookup Site Based Services** screen displays the Service ID and confirms whether an active ASM contract exists. Record the Service ID for use during installation.
{% endstep %}
{% endstepper %}

## Installing Verifone Remote Software Delivery (VRSD)

VRSD is included in the Verifone Commander Release software — there is no separate installer. It runs as a background service and is configured during the standard Verifone Commander installation.

{% stepper %}
{% step %}
**Install an approved MNSP solution**

Ensure an approved Managed Network Service Provider (MNSP) solution is installed and operational at the site.
{% endstep %}

{% step %}
**Installation**

Perform a normal installation of the Verifone Commander using the distribution software.
{% endstep %}

{% step %}
**User Input/Confirmation Required**

At the installer “User Input/Confirmation Required” screen:

1. For the Hard Disk Drive (HDD) configuration, choose either “KCC” (if the HDD is already enabled and formatted) or “FCC” (if the HDD is not formatted) so that the hard disk will be used.
2. Enter the site’s Service ID assigned to the site.

{% hint style="info" %}
A valid Service ID must be entered. The correct Service ID is critical for VRSD to connect to the VeriCentre Server.
{% endhint %}

<figure><img src="/files/C6ehFYx4vIO0e24DcOeS" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
This step obtains and registers the Service ID — it is not a purchase.
{% endhint %}

## Verify VRSD Connectivity

After installation, verify that the site can communicate with the VeriCentre server.

{% stepper %}
{% step %}
**Premier Portal**

Open a browser and navigate to the Verifone Premier Portal.

<figure><img src="/files/Edo8inxBSuD2BgjwdeVO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Manage**

Click on **Manage**.

<figure><img src="/files/Hx2TdoWm1kg5OUr9drbS" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Test VRSD Connectivity**

Click on **Test VRSD Connectivity**.

<figure><img src="/files/FvFUHeF3PYt6ss3fYlCt" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Search for the site**

Search for the merchant site by Service ID, address, or phone number, then click **Search Merchant Site**.
{% endstep %}

{% step %}
**Select the site**

Click on the site from the results list.

<figure><img src="/files/nGRdkKFDajgkgSSxt9M8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Run the connectivity check**

Click **Check VRSD Connectivity**. The portal performs the check and displays the result.
{% endstep %}
{% endstepper %}

### Connectivity Check Results

| Result                                              | Meaning                                                                     | Action                                                            |
| --------------------------------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| VRSD Connectivity Check passed                      | The connectivity check was successful.                                      | No action needed.                                                 |
| Site has not communicated to VRSD in over 24 hours  | Network or agent software configuration issue.                              | Recheck network and agent software configuration, then try again. |
| Connectivity check located an old VeriCentre record | Stale record in VeriCentre.                                                 | Contact Verifone Support to update the record.                    |
| Site not connected                                  | Network or agent software configuration issue.                              | Recheck network and agent software configuration.                 |
| VRSD terminal did not perform a connectivity check  | The terminal did not check in, or the connection was down during the check. | Verify the terminal configuration and try again.                  |

## Request a VRSD Upgrade

### Prerequisites

Before submitting an upgrade request, confirm that:

* The site is enabled for VRSD.
* The site has a current, active ASM contract.

### Required Information

* Site Service ID - If the Site's Service ID is unavailable,
  1. Open a browser and navigate to [Verifone Estore](https://Estore.Verifone.com/).
  2. Click Buy Now.
  3. Click Utilities.
  4. Click Lost Registration Lookup.
  5. Enter the Site information. The Service ID is displayed.

{% hint style="info" %}
This is not a purchase. This only obtains the Service ID.<br>
{% endhint %}

* Current Application Version - Use the following steps to display the current VRSD software list.
  1. Open a browser and navigate to [Verifone Support](http://support.verifone.com/).
  2. Click on Support Articles.
  3. Click on Petro & Convenience.
  4. Click on Products and Services.
  5. Click on Software Updates (VRSD).
  6. Click on VRSD FAQs.
  7. Click on Current VRSD Software List.
* Requested Application Name
  * Review Release Update documents located at the Software Updates (VRSD) page at [Verifone Support](http://support.verifone.com/). See previous bullet for steps.

### Submit the Upgrade Request

{% stepper %}
{% step %}
**Open the upgrade request form**

Open a browser and navigate to [Verifone Support](http://support.verifone.com/s/) and click on Support by Email in the Technical Support column.

<figure><img src="/files/bFnyVZAFICd6asWhUORe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select the Department and Category**

<figure><img src="/files/yAsrBu1eNQ2IqEs33hk6" alt=""><figcaption></figcaption></figure>

Select:

* **Department/Category:** Petro and Convenience
* **Reason for Contacting Us:** VRSD upgrade request
* Enter **First** and **Last Name**, **Phone Number**, and **Email Address**
* Enter **Service ID**
* If any, enter the **Existing Case ID**.
* Key in a **Detailed Description**, for example:
  * Current Application Version: Buypass 2.06.00
  * Requested Application Version: Buypass 2.06.01
* When requesting Upgrades for more than one location, use the spreadsheet below as an example and then attach it before submitting. The Service ID for the first location on the list should be entered for the Input Value field above.

<figure><img src="/files/SUnpceVB2CgVjtsuWqb4" alt=""><figcaption></figcaption></figure>

* Click **Submit**. The following email is sent to the address entered above.

  *Hello,*

  *This is a system generated email to confirm your request for VRSD Software Upgrade has been received.*

  *You will receive another email within 48-72 hours providing a status of your request.*

  *Thank you for choosing Verifone.*

  [*Verifone Support Team https://support.verifone.com*](https://support.verifone.com/)

  Within 48-72 Hours of the Upgrade request, another email will be sent notifying the status of the Request and Instructions for applying the upgrade.
  {% endstep %}
  {% endstepper %}

### Cancel an Upgrade Request

{% stepper %}
{% step %}
**Open the upgrade request form**

Open a browser and navigate to [Verifone Support](http://support.verifone.com/s/) and click on Support by Email in the Technical Support column.

<figure><img src="/files/bFnyVZAFICd6asWhUORe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select the Department and Category**

<figure><img src="/files/yAsrBu1eNQ2IqEs33hk6" alt=""><figcaption></figcaption></figure>

Select:

* **Department/Category:** Petro and Convenience
* **Reason for Contacting Us:** VRSD upgrade request
* Enter **First** and **Last Name**, **Phone Number**, and **Email Address**
* Enter **Service ID**
* If any, enter the **Existing Case ID**.
* Key in a **Detailed Description**, for example:
  * Key “**CANCEL**” and the requested application name and version in the detailed description box.

{% hint style="info" %}
*If the VRSD upgrade request has already been processed, there is a risk that the download has already been scheduled and will be sent. If the site has Checked in, then the download cannot be canceled.*
{% endhint %}

* If a spreadsheet was submitted in the original request, attach before submitting.
* Click **Submit**.
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
If the VRSD upgrade request has already been processed, the download may already be scheduled and cannot be stopped. If the site has already checked in, the download cannot be canceled.
{% endhint %}

## Perform the Auto Upgrade

The Auto Upgrade instructions are available to customers on [Verifone Support](https://support.verifone.com/)  > Technical Support > Support Articles > Petro & Convenience > Products and Services > Software Updates (VRSD).

Provide the site with the location of this document for assistance in performing their software upgrades.

A Verifone Authorized Service Contractor (VASC) can find Auto Upgrade Feature Reference document on the Premier Portal at Petro Downloads > Feature References.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/petroleum-docs/partner-and-vrsd-updates/software-updates-vrsd/commander-vrsd-implementation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.