# Initial Setup

![Initial Setup Tab](/files/e4cb0e91fc348fd0ebce9b642fd282b1396bb1b5)

### Date Time

The Date & Time Configuration form is used to verify or edit the date, time, and time zone on the Verifone Commander.

![](/files/f19c42104107cb44d30545cb20951cdd8b10b5f6)

Select the date, month, and year from the drop-down list boxes.

The displayed time is the current time. To change the time, select the time from the drop-down list boxes.

#### Time Zone

Use to select the time zone in which your site is located.

#### NTP Server

Enable to get the time from the Network Time Protocol (NTP) server instead of the

system clock. This section can be used to configure the IP address of the NTP server.

### Registration

The Registration form presents information that must be supplied to the Verifone Technical Support Centre to obtain a Registration Key.

Call the Verifone Technical Support Center at (888) 777-3536. The Support Center will process the registration while you are on the phone.

{% hint style="info" %}
*Registration is only done once, at the time of installation.*
{% endhint %}

![](/files/6e964be7a47dc8913c2cafeb87b7da3fe478a0ac)

#### Registration Key

Enter the Registration Key supplied by the Verifone Technical Support Center.

### View Feature Info

The Feature Information form displays the options installed on the system. To view the entire list, select the last item and press the down arrow on your keyboard. Click Print to print the entire list.

![](/files/a0ca4f6b8af84cb42e637a1bae2cef23d7011314)

### Maintenance Configuration

Refer to Maintenance Chapter

### System Properties

Use to select, update, and save System Properties.

Detailed descriptions of the system properties can be found in the respective feature’s feature reference manuals.

![](/files/3b85dcb247ee46c8505548dafba38ffafd40fce5)

| **Field/Button**     | **Allowable Value/Function**           |
| -------------------- | -------------------------------------- |
| System Property Name | Displays the property name.            |
| Value                | Displays the property value.           |
| Save                 | Click to save the selected Properties. |

#### System Properties Description

The following is the list of system properties and their descriptions:

<table><thead><tr><th valign="top">Field</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">allow.concurrent.scanner</td><td valign="top">Allows two scanners to work</td></tr><tr><td valign="top">apply.upgrade.forcefully</td><td valign="top">Opt-in for forced auto-upgrade</td></tr><tr><td valign="top">auto.print.Pd.report</td><td valign="top">Auto print reports</td></tr><tr><td valign="top">Properties that control the daily message display</td><td valign="top"></td></tr><tr><td valign="top">DailyMsg.poll.interval</td><td valign="top">The interval in which the system checks for daily messages.</td></tr><tr><td valign="top">DailyMsg.scroll.interval</td><td valign="top">The interval the message pauses before adding another line when the window must be scrolled to display all messages.</td></tr><tr><td valign="top">DailyMsg.server.IP</td><td valign="top">IP address of server hosting daily message text.</td></tr><tr><td valign="top">DailyMsg.server.Port</td><td valign="top">IP port to use on the server hosting daily message text.</td></tr><tr><td valign="top">DailyMsg.server.URL</td><td valign="top">URL to reach the daily message text files</td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">data.trans.hst.days</td><td valign="top">Number of days to keep t-log</td></tr><tr><td valign="top">database.plu.isgempromaster</td><td valign="top">Sales configuration</td></tr><tr><td valign="top">disable.pinpad.cardreader</td><td valign="top">Disable PIN pad card reader between transactions.</td></tr><tr><td valign="top"><p>DVR UDP Multicast properties</p><p>AI-generated content may be incorrect.">Note: <em>Refer to the Digital Video Recorder Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</em></p></td><td valign="top"></td></tr><tr><td valign="top">dvr.localIPPort</td><td valign="top">DVR local port</td></tr><tr><td valign="top">dvr.multicastEnable</td><td valign="top">Enable multicast</td></tr><tr><td valign="top">dvr.multicastHost</td><td valign="top">DVR multicast host</td></tr><tr><td valign="top">dvr.multicastPort</td><td valign="top">DVR multicast port</td></tr><tr><td valign="top">dvr.ttl</td><td valign="top"></td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">eps.needs.immediate.declined.receipt</td><td valign="top">EPS Needs Immediate Declined Receipt (Options = yes,no)</td></tr><tr><td valign="top"><p>E-Safe Properties</p><p>&#x3C;img src="file:///C:/Users/Dolly_A1/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png" alt="A black background with a black square</p><p>AI-generated content may be incorrect.">Note: <em>Refer to the Tidel Sentinel E-Safe Interface Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</em></p></td><td valign="top"></td></tr><tr><td valign="top">esafe.coin_denomination</td><td valign="top">E-Safe - Coin Denominations</td></tr><tr><td valign="top">esafe.note_denomination</td><td valign="top">E-Safe - Note Denominations</td></tr><tr><td valign="top">esafe.retryAttempts</td><td valign="top">E-Safe connection retry attempts</td></tr><tr><td valign="top">esafe.retryInterval.milliseconds</td><td valign="top">E-Safe connection retry interval in milliseconds.</td></tr><tr><td valign="top">esafe.socketTimeout.seconds</td><td valign="top">E-Safe - Socket timeout in seconds</td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">event.monitor.history.limit</td><td valign="top">How much event monitor history data is shown</td></tr><tr><td valign="top">extPOS.config.depts</td><td valign="top">External POS properties</td></tr><tr><td valign="top">fcc.dcrs.test</td><td valign="top">Test Gilbarco DCRs comma delimited</td></tr><tr><td valign="top">force.InHouse.PayInOut</td><td valign="top">Force In_House for Pay IN and pay OUT</td></tr><tr><td valign="top">fuel.max.curr.limit</td><td valign="top">Set limit for the maximum currency at pump</td></tr><tr><td valign="top">fuelsys.tankmonitor.tankcapacity</td><td valign="top">Enable Fuel Tank Monitoring</td></tr><tr><td valign="top">include.cinit.activation.criteria</td><td valign="top">Show Auto Upgrade notification</td></tr><tr><td valign="top">journalPrinter.enabled</td><td valign="top">Enable journal printer</td></tr><tr><td valign="top">journalPrinter.port</td><td valign="top">Journal printer port</td></tr><tr><td valign="top"><p>Kitchen Printer Configuration</p><p>&#x3C;img src="file:///C:/Users/Dolly_A1/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png" alt="A black background with a black square</p><p>AI-generated content may be incorrect.">Note: <em>Refer to the Kitchen Printer Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</em></p></td><td valign="top"></td></tr><tr><td valign="top">kp.svc.list</td><td valign="top"><p>Kitchen printer service list</p><p>kp.svc.POS use the exact text</p></td></tr><tr><td valign="top">kp.svc.POS.CommID</td><td valign="top">Indicates which COM port of the POS terminal the kitchen printer is on.</td></tr><tr><td valign="top">kp.svc.POS.host</td><td valign="top">Indicates which POS terminal the printer is on.</td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">loyalty.ppg.stack</td><td valign="top">Enable Loyalty PPG stacking</td></tr><tr><td valign="top">mobile.feature.enabled</td><td valign="top"><p>Enable Mobile Feature</p><p>&#x3C;img src="file:///C:/Users/Dolly_A1/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png" alt="A black background with a black square</p><p>AI-generated content may be incorrect.">Note: <em>Refer to the Mobile Payment Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</em></p></td></tr><tr><td valign="top"><p>Money Order Prompt</p><p>&#x3C;img src="file:///C:/Users/Dolly_A1/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png" alt="A black background with a black square</p><p>AI-generated content may be incorrect.">Note: <em>Refer to the Money Order Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</em></p></td><td valign="top"></td></tr><tr><td valign="top">mopayee.prompt</td><td valign="top">Money order prompt</td></tr><tr><td valign="top">mopayee.swb</td><td valign="top"></td></tr><tr><td valign="top">moptr.maxVendorPayment</td><td valign="top">Maximum amount for Money Order Vendor Payment.</td></tr><tr><td valign="top">mws.response.time</td><td valign="top">Manager Workstation Response Time</td></tr><tr><td valign="top">naxml.config.pluHasCheckDigit</td><td valign="top"><p>NAXML input processing</p><p>&#x3C;img src="file:///C:/Users/Dolly_A1/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png" alt="A black background with a black square</p><p>AI-generated content may be incorrect.">Note: Refer to the VIP NAXML Mix &#x26; Match Feature Reference documentation for more information on this feature. The Feature Reference is available on Premier Portal.</p></td></tr><tr><td valign="top">pdclose.forcelogout.time.inMins</td><td valign="top">AEOD force logout warning time in minutes</td></tr><tr><td valign="top">promotions.enableNaxmlDeal</td><td valign="top">Enable Naxml promotions.</td></tr><tr><td valign="top">receipt.enterprise.footer.alignment</td><td valign="top">Receipt Footer Alignment (Options - LEFT, RIGHT, CENTER)</td></tr><tr><td valign="top">receipt.enterprise.header.alignment</td><td valign="top">Receipt Header Alignment (Options - LEFT, RIGHT, CENTER)</td></tr><tr><td valign="top">receipt.print.programName</td><td valign="top">Print the promotion program name on receipt</td></tr><tr><td valign="top">remote.server.hostname</td><td valign="top"></td></tr><tr><td valign="top">Remote Log Server properties</td><td valign="top"></td></tr><tr><td valign="top">remote.server.hostname</td><td valign="top">Host where the logs are stored</td></tr><tr><td valign="top">remote.server.logBuffer.size</td><td valign="top">Log server buffer size</td></tr><tr><td valign="top">remote.server.openRetry</td><td valign="top"></td></tr><tr><td valign="top">remote.server.port</td><td valign="top"></td></tr><tr><td valign="top">remote.server.prefix</td><td valign="top"></td></tr><tr><td valign="top">remote.server.socektTimeout.second</td><td valign="top"></td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">rsd.useTestHost</td><td valign="top">Use RSD test host</td></tr><tr><td valign="top">ruby.fuelsys.driveOffAlert</td><td valign="top"></td></tr><tr><td valign="top">ruby.fuelsys.driveOffRepeat</td><td valign="top"></td></tr><tr><td valign="top">safeDrop.calculator</td><td valign="top">Calculator appears on screen during safe drop</td></tr><tr><td valign="top">sales.foodorder.expire.minutes</td><td valign="top">Expiry minutes for food order</td></tr><tr><td valign="top">sales.print.zerovalueitem</td><td valign="top">Prints receipts for zero value items</td></tr><tr><td valign="top">standard.keybd.filename</td><td valign="top">POS Keyboard file name</td></tr><tr><td valign="top">Amber Alert</td><td valign="top"></td></tr><tr><td valign="top">sys.amber.alertCountUrl</td><td valign="top"></td></tr><tr><td valign="top">sys.amber.alertDataUrl</td><td valign="top"></td></tr><tr><td valign="top">sys.amber.compareUrl</td><td valign="top"></td></tr><tr><td valign="top">sys.amber.enable</td><td valign="top">Enable amber alert</td></tr><tr><td valign="top">sys.amber.pollFreqSecs</td><td valign="top"></td></tr><tr><td valign="top"></td><td valign="top"></td></tr><tr><td valign="top">ticket.reprint.includeDCRTrans</td><td valign="top">Include DCR transactions in ticket reprint</td></tr><tr><td valign="top">topaz.enablevirtualkeyboard.expresspanel</td><td valign="top">Enable or disable virtual keyboard button on express panel</td></tr><tr><td valign="top">topaz.safedrop.numbLines</td><td valign="top">Number of blank lines on safe drop receipt</td></tr><tr><td valign="top">topaz.sales.allowDismissalOfGroupedItemMenu</td><td valign="top">Grouped item menu configuration</td></tr><tr><td valign="top">topaz.sales.allowDismissalOfModifierMenu</td><td valign="top">Grouped item menu configuration</td></tr><tr><td valign="top">topaz.sales.print.printTaxLines</td><td valign="top">Print separate tax lines on receipt</td></tr><tr><td valign="top">topaz.sales.showPluModifiers</td><td valign="top">Enable or disable display of plu modifier list</td></tr><tr><td valign="top">upgrade.token.timeout</td><td valign="top">Auto Upgrade - timeout value for token in seconds</td></tr><tr><td valign="top">viper.custom.feecode</td><td valign="top">Viper custom fee product codes</td></tr></tbody></table>

### Local Area Network Configuration

Local Area Network Configuration provides UI for configuring the LAN. Use to configure Global Routes, Device Specific IP Configuration, Device specific Routes and DNS.

![](/files/2534612fccf05d77a9dc24a09d08067c08c19ae0)

{% hint style="info" %}
Refer to the Network Configuration Guide for each profile for more information.
{% endhint %}

From Verifone Software Release 55.02, after an auto upgrade for Sunoco, the default route will be Verifone Zone. The changes for Sunoco are as specified below:

| Current                                      | Changes                                                               |
| -------------------------------------------- | --------------------------------------------------------------------- |
| **Isolated Payment Nic** Default Route = Yes | **Verifone Zone Nic** Default Route = Yes                             |
| **Device Specific Routes** 12 Configured     | **Device specific Routes** In addition to the current, added two more |
| **DNS** Default configured                   | **DNS** Sunoco Specific DNS                                           |

### VHQ Configuration

The customers can choose from the following VHQ options:

1. Sign a SOW - Verifone performs services to customer PIN pads through VHQ.
2. VHQ Administered – Verifone does the estate management for a fee.
3. VHQ Own Instance – Customers want to own their own instance and move all their PIN pads to their own instance.

The objective of having all Petro PIN pads on VHQ is the ability to remediate and resolve issues found in the field faster.

{% hint style="info" %}
Refer to the VHQ User Reference documentation for more information on this feature. The User Reference is available on Premier Portal.
{% endhint %}

POS sends following VHQ data to EPS:

* Enable/Disable (VHQ)
* VHQ Address
* Customer ID
* Store ID
* Lane ID
* Service ID
* Customer Profile
* Pinpad ID

Enable/Disable VHQ, Customer ID and VHQ Address is configured through VHQ Configuration form.

EPS sends the same information to PIN pad as part of the diagnostic message when the POS logs in. VHQ extracts the information from PIN pad.

Inorder to view and update VHQ Configuration, new user role functions should be created to view and update “VHQ Configuration”.

* vvhqconfiguration – View VHQ Configuration
* uvhqconfiguration – Update VHQ configuration

A person having the role “manager” have these (view and update) functions enabled by default. All other roles have view function enabled by default.

Refer to Configure Roles for more information to configure roles.

![](/files/ce009a8640036fddcc8ea0a435e09f68125215f4)

After you enable VHQ, the form allows you to edit Customer ID and VHQ address.

![](/files/411f01fb0d2f2b1550b8b912bbfc2d46e3fb72a4)

On save, the form validates customer ID and VHQ address. VHQ address can be a URL or an IP address. Customer ID can be Alphanumerical characters up to 64 characters. If validation is not successful, an error message is displayed.

#### Service and Maintenance (SAM)

Beginning with ViperPAY version 4.06.xx, an additional Service and Maintenance (SAM) feature will be available for Mx9xx Series PIN pads. The objective of having all Petro PIN pads connected with the Service and Maintenance feature is the ability to remediate and resolve issues found in the field faster. The SAM feature is included as part of ASM entitlement for Verifone Commander locations and includes improved Verifone Helpdesk support functions, such as:

* Review general configuration of the device, including network and system configuration.
* Review PIN pad diagnostic logs.
* Correct some operating system and application issues.
* Perform diagnostics remotely on the PIN pad, such as screen calibrations.

The SAM feature can be enabled after each PIN pad has the ViperPAY application loaded/upgraded. Enablement is performed by selecting "Accept" on the Terms & Conditions prompt that appears after the PIN pad application is loaded/upgraded. The SAM feature is PIN pad specific, therefore the prompt will appear on all PIN pads once the application is loaded/upgraded.

Rejecting the Terms & Conditions will disable SAM functionality. Verifone strongly encourages our customers to enable the Service and Maintenance feature.

![](/files/d1f1107399905faba3383e0e9ba690e03f5e8dae)

Should a customer reject the agreement after updating the ViperPAY version and want the Service and Maintenance feature later, they can enter into System Mode on the PIN pad, navigate to “Enable VHQ default” and change the value to 1. They will then need to run the application from the PIN pad home screen and accept the Terms & Conditions prompt. This must be completed for each PIN pad.

{% hint style="info" %}
*The above process is same when user changes from SAM to No SAM on PIN pad.*
{% endhint %}

{% hint style="info" %}
*Some PIN pads have Accept and Reject soft keys. Use these keys for SAM enablement.*
{% endhint %}

{% hint style="info" %}
*SAM is only available for PIN pads that are not a part of a client managed instance of VHQ.*
{% endhint %}

### Verifone Commander Console

The Verifone Commander Console is a cloud-based enterprise application on which the Verifone Commander transactions and reports can be viewed. In order for Verifone

Commander transactions and reports to be viewed on Verifone Commander Console, the Verifone Commander Console needs to be configured in Configuration Client.

![](/files/72ed480624f090d69ccfe0fd862ae60ad66b0e0e)

| Field/Button                   | Allowable Value/Function                    |
| ------------------------------ | ------------------------------------------- |
| Enable Cloud Agent             | Select to enable Cloud Agent                |
| Verifone Commander Console URL | Enter the Verifone Commander Console URL.   |
| Site ID                        | The Site ID of the store                    |
| Service ID                     | Verifone Commander Service ID. 7 characters |
| Postal Code                    | Enter the postal code of the site.          |

### Cloud Configuration Manager

The Cloud Configuration Manager is a cloud-based enterprise application used to manage Verifone Commander configuration settings for a site or group of sites. All Verifone Commanders that are managed through Cloud Configuration Manager must have the Cloud Configuration Manager agent configured in Configuration Client.

{% hint style="info" %}
*Refer to the Cloud Configuration Manager documentation for information on this feature.*
{% endhint %}

#### General

<figure><img src="/files/0b5479b63983fdd2c8eb6591d41bcce4ffd0f7e4" alt=""><figcaption></figcaption></figure>

| Field/Button | Allowable Value/Function                                                      |
| ------------ | ----------------------------------------------------------------------------- |
| Host URL     | The URL of Cloud Configuration Manager.                                       |
| Company      | Company name that was set up when requesting for Cloud Configuration Manager. |
| Custom ID    | Leave it as blank                                                             |
| Site ID      | The Site ID of the store                                                      |
| Service ID   |                                                                               |

#### CM Diagnostics

Use CM Diagnostics to see if Verifone Commander is connected to the Cloud Configuration Manager.

### Cloud Connect

The Verifone Commader Central application allows to remotely configure data for the POS system through the web. A technician does not have to visit each location to make changes and updates. These updates can be done selectively or all at once for all the POS devices from the web application.

{% hint style="info" %}
*Refer to the Verifone Commader Central User Reference documentation for more information on this feature.*
{% endhint %}

#### Annual Software Maintenance

Annual Software Maintenance ensures the Verifone payment devices, site controllers, POS workstations and peripherals operate on software and tools that meet or exceed the requirements of current PA-DSS standards.

Verifone POS customers are required to enroll in the ASM Program available through major oil brands, Verifone distributors or Verifone. Without current ASM coverage, customer locations are NOT entitled to software installation, upgrades, reloads or remote assistance.

Go to <https://www.verifone.com/asm> on a web enabled device for more information.

{% hint style="info" %}
*Retailers should reach out to your distributor or Verifone sales representative to get the ASM license.*
{% endhint %}


---

# 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/commander-user-reference-guides/commander-user-references/commander-user-reference-56.00/configuration-client-forms/initial-setup.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.
