RPSW User's Guide
RPSW User's Guide
RPSW User's Guide
B005-0000-1634
Issue H
The product described in this document is a licensed product of NCR Corporation.
NCR is a registered trademark of NCR Corporation. NCR SelfServ is a trademark of NCR Corporation in the United States and/or
other countries. Other product names mentioned in this publication may be trademarks or registered trademarks of their
respective companies and are hereby acknowledged.
Where creation of derivative works, modifications or copies of this NCR copyrighted documentation is permitted under the terms
and conditions of an agreement you have with NCR, NCR's copyright notice must be included.
It is the policy of NCR Corporation (NCR) to improve products as new technology, components, software, and firmware become
available. NCR, therefore, reserves the right to change specifications without prior notice.
All features, functions, and operations described herein may not be marketed by NCR in all parts of the world. In some instances,
photographs are of equipment prototypes. Therefore, before using this document, consult with your NCR representative or NCR
office for information that is applicable and current.
To maintain the quality of our publications, we need your comments on the accuracy, clarity, organization, and value of this book.
Please use the link below to send your comments.
EMail: [email protected]
Copyright © 2009, 2011–2016
By NCR Corporation
Duluth, GA U.S.A.
All Rights Reserved
i
Preface
Audience
This book is written for software and hardware installer or service personnel, system
integrators, and field engineers.
Notice: This document is NCR proprietary information and is not to be disclosed or
reproduced without consent.
References
• NCR Retail Systems Manager Software User’s Guide (B005–0000–1518)
• NCR Retail Controls 3.x UPOS User’s Guide for Windows (B005–0000–1619)
• NCR Partition Image User’s Guide (B005–0000–1641)
• NCR PXE Image Loader User's Guide (B005-0000-2326)
• NCR Command Center Management Tool – Retail Site Setup Guide (B005-0000-2331)
ii
iii
Table of Contents
RSM LE Functionalities 54
RSM LE EUI Functionality 55
RSM LE with RSM License 57
Logging on to RSM LE 59
Installing the RSM LE License 61
Setting the Customer Number 61
Adding the License file 61
Adding an RSM LE license file through the UI 61
Adding an RSM LE license file through manual copying 62
Revision Record
Issue Date Remarks
A Feb 2005 First Issue
B Apr 2005 Various updates.
C Dec 2006 Updates for RSM Release 2.1.2.
D Jun 2007 Added SNMP Configuration.
Various updates for RSM Release 2.2.
E Jan 2009 Updated for release 3.0.
F Sept 2009 Separated into chapters.
G Nov 2012 Used the new IP book template.
Various updates for RPSW Release 4.0.1 and 4.0.2.
Added brightness settings information.
Added Appendix A about troubleshooting SNMP.
Updated the list of operating systems that RPSW supports.
Updated the list of service object devices.
H Apr 2016 Various updates for RPSW 4.x and 5.x releases.
Added information on the new Image Scanner service object.
Added Windows 10 in the list of supported operating systems.
Chapter 1: Retail Platform Software for Windows
Overview
Retail Platform Software for Windows (RPSW) provides a single Windows installation
program to install the various NCR retail terminal software components. The RPSW
installer is released on a single LPIN, eliminating the need of separate media for NCR
retail terminal software components.
The following table displays the LPIN for the latest RPSW releases.
For information on the LPIN of the previous RPSW release versions, refer to Previous
LPIN on page 3.
1-2 Retail Platform Software for Windows
Previous LPIN
The LPIN of the previous RPSW release versions are listed as follows:
For information on the LPIN of the latest RPSW releases, refer to Retail Platform Software
for Windows on page 1.
1-4 Retail Platform Software for Windows
Blocked Content
In the Internet Explorer advanced settings, permit blocked content to display through
the following steps:
1. Open the Internet Explorer browser, and then select ToolsàInternet
OptionsàAdvancedàSecurity.
2. Enable the Allow active content to run in files on My Computer option.
3. Select ApplyàOK.
Note: If this option is not set, the user must allow the blocked content manually each
time the RSM user interface is initiated.
ActiveX Controls
In the Internet Explorer security settings, enable the ActiveX controls through the
following steps:
1. Open the Internet Explorer browser, and then select ToolsàInternet Optionsà
SecurityàInternetàCustom LevelàActiveX controls and plug–ins.
2. Enable the Automatic prompting for ActiveX controls option.
3. Select OK. The system displays this window.
4. Select Yes.
Retail Platform Software for Windows 1-5
Firewall Settings
If a firewall is installed in the system, you must modify the firewall settings to open
certain RSM ports and provide RSM the functionality to communicate properly with the
RSM Site Server (SE).
For systems using the Windows Firewall, the RPSW installation package opens the
following required ports for the system, unless you choose not to modify the firewall
settings:
• TCP 8502—RSM File Agent (required only for file distribution or retrieval features
with RSM servers)
• UDP 68—DHCP/PXE client
• TCP 8504—RSMDesktopAgent.exe
• TCP 5800—VNC Server for Win32 (if you selected to install VNC)
• TCP 5900—VNC Server for Win32 (if you selected to install VNC)
• TCP 16992—RSM AMT Agent (Terminals 7459, 7350, 7403, and 7409 only)
• TCP 16993—RSM AMT Agent (Terminals 7459, 7350, 7403, and 7409 only)
If you do not permit the RPSW installation to open the ports, you must manually
configure the settings.
For systems using the Windows Firewall, select StartàSettingsàControl
PanelàWindows FirewallàExceptions to open the required RSM ports, depending on
the location and intended use.
If a different firewall is used, open the RSM ports using the appropriate procedure for
the firewall being used.
For more information about the ports used for RSM communication, refer to the NCR
Retail Systems Manager Software User’s Guide (B005–0000–1518).
1-6 Retail Platform Software for Windows
Chapter 2: RPSW Installation
Overview
This chapter describes the prerequisites, installation steps, and post–installation
activities of the Retail Platform Software for Windows (RPSW). This chapter also
discusses the steps on how to create a client image.
2-8 RPSW Installation
Pre–installation Information
Install the Retail Platform Software for Windows (RPSW) (D370–0924–0100) through any
of the following ways:
• Through the installation CD
• Through installers that you can download from the NCR website
http://www.ncr.com/support.
After obtaining the installers, either use the installation packages on the terminals or
upload the installers to the RSM SE Server or FitClient Server so that it can be
downloaded and installed on the terminals. For additional information on how to
upload applications, refer to the “RSM File Distribution” section in the NCR Retail
Systems Manager Software User’s Guide (B005–0000–1518).
Installation Versions
The RPSW comes in two versions:
• Retail Platform Software for Windows.msi
Remote Installation
Remote installs can be performed on .msi files, which mean that the application can be
pushed from the server to the client without any action at the client terminal. The Install
Parameters (for non–GUI installation) for the RPSW are listed in the Command line
parameters for Retail Platform Software for Windows.doc file on the CD.
You cannot perform push installs using RSM until the RPSW LPIN (with RSM client
software) is installed on the system terminal. Upgrades of RPSW can be installed
remotely using RSM. For additional information on using RSM to remotely upgrade the
RPSW, refer to the section on using Packages in the NCR Retail Systems Manager
Software User’s Guide (B005–0000–1518).
OPOS Installation
If you install the RPSW and install OPOS 2.2, then you are installing an older release
version of OPOS over it; the install lets you install because the “product name” has
changed from OPOS to Retail Platform Software for Windows, and the old installation
cannot detect the newer release. The real problem comes if you then try to upgrade that
older version you just installed back to the newer version. The install thinks the newer
version is already there and does not upgrade. If you get into this situation, uninstall
both the older and the newer releases of OPOS, and then reinstall.
RPSW Installation 2-9
Windows Installer
When installing RPSW, the installer checks whether the Windows Installer version
installed on the system is at least version 3.0. If there is no Windows Installer installed on
the system or if the version installed is prior to version 3.0, the installer displays a
prompt requesting the user to install the latest version of the Windows Installer before
installing RPSW.
Note: If you are running on Windows 7 operating system, you must install the
RPSW install package through the Run as Administrator option. If you do not run
the installation program as Administrator, the install does not recognize the terminal
type and some necessary components of the RPSW software are not installed
properly.
To install RPSW as Administrator, perform any of the following:
• Right–click the .exe version of the install package (Retail Platform Software
for Windows.exe) and select Run as administrator.
• Launch a DOS command prompt with administrative privileges and run the
MSIEXEC executable on the .msi version of the install package.
After launching the installer, the system displays this window.
RPSW Installation 2-11
2. The RPSW detects the current configuration. Ensure that the following
configurations are correct:
• Class
• Model—defines the type of system where you are installing the RPSW.
• Service Type—can be any of the following:
• Assisted—includes terminals 7403, 7443, 7446, 7449, 7452, 7453, 7454, 7456,
7457, 7458, 7459, 7460, 7600, 7601, 7610, 7611, 7643, 7649, 7606, and 7616.
• Self—includes terminals 7350, 7401, 7402, 7404, and 7409.
The only difference between these two terminal service types is the set of Printer
Finite State Machine definition files (used by State of Health) that are installed by
default. These files minimize the State of Health changes on an assisted terminal
because an operator is present to fix the problem. For example, a paper low
status is generated on a Self–Service system indicating the printer on the
unattended system needs attention. This type of alert is not necessary, or even
undesirable, for systems where a cashier is present to handle the condition.
3. Select Confirm. The system displays the Welcome window.
4. Select Next.
2-12 RPSW Installation
5. If you have a previous version of OPOS or Logs and Tallies that are currently
installed, the system displays a window with options for dealing with the existing
installation. Select Next.
6. The system displays the License Agreement window. Select I accept the terms in
the license agreement, and then select Next.
RPSW Installation 2-13
7. The system displays the Setup Type window. Select the type of installation, whether
Standard or Custom, and then select Next.
8. If you selected the Standard setup type, the Control Object Warning window is
displayed.
• Local Only—refers to the option where no RSM SE server is present. If you plan
to use SNMP or Command Center in this configuration, select the option Enable
event monitoring for RSM SNMP support.
If the check box for event monitoring is selected, the NCRFSM module is enabled
for processing the event log to generate alerts for State of Health and Critical
Events. On unmanaged systems, this functionality is required only if RSM SNMP
or Command Center is used. Selecting this check box sets registry setting
[HKEY_LOCAL_MACHINE\SOFTWARE\NCR\NCR Store Minder
Client\CurrentVersion\StartFSM] to T to enable NCRFSM, which is the same as it
would be set on a managed system. The setting is only available in RPSW 4.0.1.0
and up. If a system is installed as unmanaged and later changed to managed, this
setting may need to be configured manually to enable NCRFSM.
13. Select Next.
2-18 RPSW Installation
In a Custom installation, if you selected to install RealVNC, the system displays the
RealVNC Server Options window.
Note: Selecting to install RealVNC in the RPSW installation is not supported for
systems running on the Windows 7 operating system.
14. Enter the Password for accessing this system from a remote location using the
RealVNC program.
15. Select Next.
RPSW Installation 2-19
The system displays the Event Log Wrapping window. RPSW software logs events,
and RSM uses these events to report device status. If the event log gets full and does
not wrap, events discarded by Windows cannot be used for device statuses.
16. Select which Event Logs you want to wrap when the event log is full.
17. Select Next.
2-20 RPSW Installation
If Windows Firewall is enabled, the system displays the Firewall Setting Options
window to set up the ports that can get through the firewall to support RSM.
22. Select Back if you need to make any changes, or Install if you are ready to install the
Retail Platform Software for Windows.
RPSW Installation 2-23
The system displays a message stating you should reboot the client terminal.
Custom Setup
The Custom setup type provides the functionality to select the available options that you
want to install. If you select the custom setup type in the installation process, the system
displays the Custom Setup window.
Note: The Predictive Services installation options are no longer available in the RPSW
4.0.1.x and later releases. For these releases, installing the Predictive Services software is
possible through a separate LPIN (D370–0955–0100).
RPSW Installation 2-25
UnifiedPOS
The UnifiedPOS feature provides support for OLE for POS (OPOS) and for Java for POS
(JavaPOS).
RPSW Installation 2-27
NCR OPOS
NCR OPOS is an industry standards interface for accessing and configuring the retail
peripherals. NCR OPOS provides interactive and non–interactive diagnostics for
analyzing problems with the peripherals.
2-28 RPSW Installation
• Service Objects
2-30 RPSW Installation
• NCR OPOS 2.8—OPOS 1.4 Compliant Services. It supports all terminals. Updates
to this feature have been capped. This feature is not being updated as new
features are added to the various terminals. For information on the NCR OPOS
2.8 service objects, refer to OPOS 2.8 Controls on page 34.
RPSW Installation 2-31
• Utilities
• Miscellaneous
The following table displays the support for OPOS 2.8 Controls:
NCR JavaPOS
JavaPOS is a wrapper application for OPOS that is used to write Java applications using
the OPOS Retail Controls.
3. If you want to install the JavaPOS 2.2 controls or both the JavaPOS 2.2 and 3.x
controls, select and expand Device Services.
The RSM LE feature in the RPSW installation provides the option to install RealVNC
3.3.7. This remote control software provides the ability to remotely control a terminal.
This feature used to be installed by default, but now you must select it as part of a
custom installation.
Note: Selecting to install RealVNC in the RPSW installation is not supported for
systems running on the Windows 7 operating system. The sample image above shows
RPSW installed on a Windows 7 Professional 64–bit system.
2-44 RPSW Installation
Predictive Services
Note: The Predictive Services installation options are no longer available in the RPSW
4.0.1.x and later releases. For these releases, installing the Predictive Services software is
possible through a separate LPIN (D370–0955–0100).
Before installing the Predictive Services feature, make sure to install the following
software packages on the terminal:
• .Net Framework 3.5 or later
• .Net 2.0 Framework Service Pack 2
• 3rdParty.msi
The UALog Collector component is installed as part of the RPSW installation package.
RPSW Installation 2-45
The packages of the other three components, Unified Agent Service, PDC, and Retail
Collectors for Unified Agent, are extracted and ready for installation after the RPSW
install process. These packages are found in the NCR APTRA directory of the install
folder.
Example: C:\Program Files\NCR APTRA
After installing RPSW, install the following three components manually in the following
order:
• PDC
• Unified Agent Service
• Retail Collectors for Unified Agent
• ua_css_extranet_prod_v2_192.127.224.16.crt
To install these certificates, open the command prompt and type the following
command lines:
• Certmgr /add /all NCR_IT_Services_CA.crt /s /r LocalMachine root
Note: To install the Unified Agent Service package on a Windows 7 operating system
configuration, you must launch the install with administrative privileges.
Note: You can use the value “SSCO” instead of “POS” for the CONFIGURE_DEVICE_
TYPE parameter during the silent install.
RPSW Installation 2-47
FitClient
FitClient is used only on legacy terminals. It is not supported in RPSW 4.0 and later
versions. The setup displays the following window during the custom installation for
RPSW versions that are below 4.0.
FitClient Agent
The FitClient Agent feature provides communication and synchronization with the
FitClient Manager Server. FitClient Agent is only available through a custom install
because FitClient Manager has been replaced by RSM.
FitClient Manager LE
FitClient Manager LE provides local configuration and diagnostic capabilities. FitClient is
not being updated with new features that are being incorporated into RSM LE. RSM LE
is the replacement product for FitClient LE. FitClient LE is only available if you select a
Custom Install.
2-48 RPSW Installation
Post–installation Information
If you run the installation program, and the RPSW is already installed on the system,
the system displays this window with the following options:
Problem
The NCR Retail Platform Software for Windows (RPSW) reads and stores terminal–
based DMI information to the hard disk, either in the registry or in a file. The DMI space
(firmware on the processor board) contains information, such as Terminal Serial
number, class or model, and so forth. This information is critical because it may be the
only way of identifying the terminal and its version.
This process works fine when each terminal’s hard drive is built up from scratch at that
terminal. Now, with the use of drive duplication software, this process has become an
issue because the duplicated terminals can get the DMI information of the source
terminal where the image was created. Usually, a master disk image is created on a test
terminal and then the software on that terminal is imaged on to all the other terminals.
The problem occurs the first time the test terminal is rebooted after the RPSW is
installed. During this reboot, the DMI information is read and written to disk (this data
is not modified on subsequent reboots). When the image is sent to the other terminals,
the DMI values on the disk do not match what is actually in DMI on that terminal.
Impact
When this problem occurs, NCR platform software, such as the Retail Systems Manager
(RSM) or Command Center, displays incorrect DMI information for any terminals that
have been loaded using the image. In addition, the affected terminals will have an
unhealthy state when it detects that the board and disk drive DMI information do not
match.
Note: If you do not have RSM State–of–Health, check the event log for NCRHAL
events, which indicate that the information does not match.
Action
To create a client image, follow these steps:
1. Install RPSW.
2. Install RPSW patches.
3. Configure any RSM Local Edition (LE) settings that are common across terminals,
such as the system Custom Tags, peripheral settings, and so forth.
RPSW Installation 2-51
4. Run the NCRSysPrep utility, which is included with RPSW 2.1.1 or later versions.
The NCRSysPrep utility can be run for the NCR 7402, 7456, 7457, 7458, and newer
terminal images. This utility clears out the data on the terminal’s hard drive so that
the next time the terminal is loaded or rebooted, the data is read from the processor
board on the new terminal. The customer can run the NCRSysPrep on each terminal
to clear this error, but the best solution is to run NCRSysPrep on the terminal being
imaged. If you reboot the terminal after NCRSysPrep is run and the Base Platform
software in RPSW runs again, the data on the hard drive is filled in again and you
must run NCRSysPrep again.
5. Run Microsoft SysPrep/fbreseal. Do not reboot after this step is done.
Note: It is important that you run NCRSysPrep before you run the Microsoft
sysprep/fbreseal.
6. Create the image. To capture or restore an image, refer to the NCR Partition Image
User’s Guide (B005–0000–1641).
2-52 RPSW Installation
Chapter 3: Introduction to RSM LE
Overview
RSM Local Edition (LE) provides peripheral configuration and local out–of–service
diagnostics. If RSM LE is licensed, additional functionalities become available. The
following are the characteristics of the RSM LE:
• RSM LE has Every Unit Item (EUI) functionality if there is no RSM license or the
RSM license has expired.
• EUI functionality permits you to configure peripherals and run diagnostics only.
• If you are in EUI mode, no logon prompt is displayed when RSM LE starts up.
• Additional functionality is available when you have an RSM license (monitoring and
information).
• RSM LE provides SNMP functionality if you are licensed for it.
3-54 Introduction to RSM LE
RSM LE Functionalities
When you start RSM LE in EUI (every unit item) mode, the system displays the
following window:
The options available in RSM LE are based on the licensed features. RSM LE normally
gets its license from the RSM SE server that it connects to, though it is possible to add
an RSM license file to an unmanaged RSM LE system. For more information, refer to
Installing the RSM LE License on page 61.
RSM LE has EUI functionality when either it has no RSM license or the license has
expired. The EUI functionality is typically seen on unmanaged RSM LE systems. The
“RSM LE EUI Functionality” and “RSM LE with RSM License” sections describe
features that are typically included, but your license file may provide different features.
Introduction to RSM LE 3-55
• Administration
• RSM Services
• Customer Number
• RSM Managed—Enabled or Disabled. Set to Disabled for an unmanaged
system.
• Licensing
• Current User
• License File
• License Expiration
• Data Capture
• Configuration—Simple or Advanced
• Simple
• Default Setting—No Logging, Error Logging, or Full Logging
• Advanced
• Trace Mask Settings
• Level Mask Settings
• The list of modules that support data capture. The type of logging can be
changed for each one of the devices.
Introduction to RSM LE 3-57
Logging on to RSM LE
To log on to RSM LE, follow these steps:
1. Start RSM LE by performing any of the following:
• Select the desktop icon for RSM LE.
• Open a browser on the system and type the path to the RSM website.
Example: C:\Prgram Files\NCR\RSM\Website\ConsoleLE.htm
If RSM is operating in Every Unit Item (EUI) mode, you are not prompted for a
logon window, but you are automatically logged on with privileges to configure
peripherals and run diagnostics only.
If RSM LE is managed and licensed, the Login window is displayed.
The RSM LE user interface displays the different available features. These features are
discussed in the next sections.
Note: The functionality present is based on the license file, and the unlicensed features
are not available.
Introduction to RSM LE 3-61
Overview
This chapter provides information on how to use RSM LE and its different components:
• Monitor
• Administration
• Peripherals
• Platform
Note: The functionality present is based on the license file. The unlicensed features are
not available.
4-64 Using the RSM LE
State of Health
The State of Health screen is the first screen that displays after you log on.
RSM has the ability to determine the state of health of managed components. State of
health determination is derived using events logged by managed components. These
events are then driven through a finite state machine to determine the current state of
health. NCR terminals and peripherals have been instrumented to log the events needed
to drive this state machine and permit RSM to determine their current state of health.
State of Health is a key component of RSM and therefore is easily visible from the RSM
user interface. At RSM LE, State of Health monitors the peripherals attached to the
system, and reports problems that are encountered from the platform devices.
The State of Health screen displays information about the current status of a system
such as the following alerts:
• State Of Health Alerts—refers to the alerts that are defined by the information
provided by the Retail Controls, Platform devices, or RSM software. State Of Health
does not require that the Alert configuration parameters be defined. The State of
Health alerts include the following alerts:
• Healthy Alerts
• Attention Soon Alerts
• Attention Now Alerts
• Event Alerts—refers to the alerts that are set up for events that are specific to an
application or device. Event alerts are set up at the System level and include the
following alerts:
4-66 Using the RSM LE
Connectivity
The Connectivity screen displays the current connection status to RSM SE or PXE Image
Loader.
4-68 Using the RSM LE
Event Logs
The Event Logs section displays significant events that occurred in the system that the
RSM application needs to notify the users about. RSM provides you the functionality to
view all the events of all the event log types available in the system.
Using the RSM LE 4-69
Viewing Events
To view the events of a system, follow these steps:
1. On the RSM Console, select MonitoràEvent Logs. The Event Logs section displays
the available event log types.
2. Select the event log type you want to view. The RSM Event Viewer displays the
events of the selected event log type. In this example, Application Log is selected.
4-70 Using the RSM LE
Note: The RSM Event Viewer user interface is designed to look and function
similar to the Windows Event Viewer user interface.
The RSM Event Viewer displays all the event logs of the selected event log type in a
table with the following event data:
• Type
• Date/Time
• Source
• Event ID
• Category
• User
• Computer
3. Select More to view more events in the RSM Event Viewer.
4. Select Close to close the RSM Event Viewer.
Using the RSM LE 4-71
2. The system displays the Open Log File window. Double–click Event Log Path.
4-72 Using the RSM LE
3. The system displays the Event Log Path window. Browse for and select the event log
file you want to view, and then select OK.
4. On the Open Log File window, double–click Event Log Type. The system displays
the Event Log Type window.
5. Select the Event Log Type from the drop–down list, and then select OK.
6. Select OK in the Open Log File window. The RSM Event Viewer displays the events
of the exported log file.
Note: You cannot view .evtx files exported from newer operating systems, such as
Windows 7, on operating systems that do not support .evtx files.
Using the RSM LE 4-73
2. The system displays the RSM Event Viewer. Perform any of the following:
• Select the event from the RSM Event Viewer, and then select Details.
• Double–click the event from the RSM Event Viewer.
4-74 Using the RSM LE
The system displays the Event Details window. In this example, RSMPowerStates is
selected.
Information Refers to
Type The type of event. The event types are the following:
• Error
• Warning
• Information
• Success Audit
• Failure Audit
Date/Time The date and time when the event occurred.
Source The software that logged the event.
Category The classification of the event.
Event ID The number that identifies the particular event for this source.
User The name of the user when the event occurred.
Computer The name of the computer where the event occurred.
Description The description of the event.
Resolution The details about the meaning and actions to take regarding
the event. The system displays the resolution information only
if you have the license to view resolution information.
Using the RSM LE 4-75
Information Refers to
Binary Information The binary information of the selected event. Binary
information displays only when it is available for the selected
event. The following binary information displays when
available:
• Data Size
• Byte Data
• Word Data
Option Used To
Copy Copy event details to clipboard. For more information, refer to
Copying Event Details to Clipboard on the next page.
Previous Display the event details of the event that comes before the
currently displayed event as listed in the RSM Event Viewer.
Next Display the event details of the event that comes next to the
currently displayed event as listed in the RSM Event Viewer.
Close Close the Event Details window.
4-76 Using the RSM LE
Filtering Events
You can filter the events in the RSM Event Viewer to display a subset of events. To filter
events in the RSM Event Viewer, follow these steps:
1. On the Event Logs section of the RSM Console, double–click the event log type you
want to view. In this example, Application Log is selected.
2. The system displays the RSM Event Viewer. Select Filter.
3. Filter the events displayed in the RSM Event Viewer according to the following
event information:
• Event Type
• Event Source
• Category
• Event ID
• User
• Computer
• From
• To
4. Select OK. The RSM Event Viewer then displays the events according to the filter
criteria you selected.
Using the RSM LE 4-79
2. The system displays the From window. Select whether you want to filter from the
First Event or from the Events On a specific date and time.
3. Select OK. If you selected Events On, the Filter Events window additionally displays
the Date and Time options.
4. Select the Date and the Time from when the events will be filtered.
Using the RSM LE 4-81
6. Select whether you want to filter up to the Last Event or up to the Events On a
specific date and time.
7. Select OK. If you selected Events On, the Filter Events window additionally displays
the Date and Time options.
8. Select the Date and the Time of up to when the events will be filtered.
9. Select OK. The RSM Event Viewer then displays the events according to the filter
criteria you selected.
4-82 Using the RSM LE
2. The system displays a confirmation window. Select Yes to clear the events.
Using the RSM LE 4-85
Tallies
Tallies are available when RPSW is installed and licensed with RSM. Tallies are not
available with RSM LE EUI functionality. Tallies are maintained for each peripheral.
These tallies are counts of both good and bad information that are incremented until
reset by a user. The good tallies are used to compare bad to good counts and assist in
proactive maintenance of devices. For a listing of the tallies for the various devices, refer
to the OPOS Help file or the NCR Retail Controls 3.x UPOS User's Guide for Windows
(B005–0000–1619).
In addition to the RPSW peripherals, tallies may also be maintained by any software
using the NCR Store Minder tally interface to create and increment tallies. For more
information, refer to the RSM SDK LPIN (G370–2800–0100).
4-86 Using the RSM LE
2. Select the tally you want to view. The system displays information about the tally.
• Hardware—includes the tallies that are maintained on the physical device and
retrieved periodically by the peripheral software.
• Tally Value—refers to the current count for the tally.
• Tally Threshold Alert—refers to the status of the alert, whether Enabled or
Disabled.
• Tally Threshold—refers to the number of times a certain operation is performed
before an alert is sent. For more information, refer to Tally Thresholds on page 121.
• Reset Tally—refers to the option of resetting the current tally.
3. Select OK to close the window.
4-88 Using the RSM LE
Refreshing Tallies
Tallies are initially stored in memory, and the current tally counts are saved to disk
periodically. The RSM user interface displays the tally values that are saved on the disk.
The interval for how frequently the tallies are saved to disk can be configured in the
RSM user interface by selecting the System or Server, and then selecting
Administration→Alerting→Tally Save Interval. The default Tally Save Interval is 60
minutes.
Tallies may increment while using a device, but the updated tally counts may not
display in the RSM user interface until the next Tally Save Interval.
To refresh the tallies, follow these steps:
1. On the RSM Console, select MonitoràTallies. The Tallies section displays the
available tallies.
2. Select Refresh Tallies. The system saves the current tallies in memory to the disk
and then displays them on screen.
Note: Prior to RSM and RPSW release 4.0, the Tally Save Interval option was called Tally
Flush Interval, and the Refresh Tallies button was called Flush Tallies.
Using the RSM LE 4-89
Hardware Tallies
For RSM release 3.0 and later, hardware tallies are added to RSM for some 3.x Retail
Control peripherals. Hardware tallies must be pulled from the device instead of
updating them as they occur like the software tallies. A timer is used to periodically
retrieve the hardware tallies when the device is in use. However, the hardware may
report hardware tallies at different times depending on the device.
Currently, the following devices are supported:
• Printers
• MICR
• Scale
• Scanner
Note: The minimum firmware version for support of hardware tallies in the 7875
SA, 7876, 7883 SA (All SuperASIC) scanners is 497–0449064, dated 4/17/06.
The Printer and MICR hardware tallies are only reported up to every 8 hours. If you
print a few lines and wait five minutes, the hardware tally values do not change. To
force the hardware tally values to update, print a diagnostic form by opening and
closing the cover, while holding the paper feed button. Afterwards, new hardware tally
values are reported to RSM at the next update interval.
The Scanner and Scale hardware tallies are written to volatile memory every five
minutes and then to non–volatile memory every hour. RSM reads the tallies from
volatile memory. If you are using the scanner or scale, the hardware tallies are accurate
up to a 5–minute window. But if you unplug the scanner or scale before the hour–
interval is up (before hardware tallies are written to non–volatile memory), the count
reverts back to the last non–volatile count so the count in RSM could decrease after a
device is power–cycled.
Note: A reset of hardware tallies is not supported.
4-90 Using the RSM LE
Processes
The system displays the Processes window by selecting MonitoràProcesses. The
Processes window displays the processes that are running and their CPU utilization
percentage.
If you select a process from the list, the system displays additional information about the
process.
The End Process button is used to stop a process.
Warning: Make sure you understand what a process is doing before stopping it.
Unexpected behavior could result.
Using the RSM LE 4-91
Services
The system displays the Services window by selecting MonitoràServices. The Services
window displays the services that are installed and their Stopped or Started state.
If you select a service from the list, the system displays additional information about the
service.
You can change the Startup Type of a service by selecting Start or Stop from the
Services window.
Warning: Ensure that you understand what a service is doing before stopping it.
Unexpected behavior could result. If you stop the NCRLoader service from the RSM
user interface, the RSM user interface stops working. You must restart the service
from the Windows Control Panel.
4-92 Using the RSM LE
RSM Services
The Services menu for RSM LE is primarily used with a system that is being managed by
an RSM server. If you are running the RSM LE in an unmanaged, local environment,
most of the features are not applicable, such as the RSM LE shown in the sample image
below.
The system displays the RSM Services section when you select AdministrationàRSM
Services. The RSM Services section displays the following information:
Settings Description
Customer Number Identifies the customer using RSM. The Customer Number
displays on the contract with NCR. The Customer Number is
required for activating an RSM license. If RSM LE is managed,
the Customer Number is configured at an RSM server and is
not changeable at RSM LE.
If RSM LE is not managed by an RSM SE server but an RSM
license file is used, such as when adding SNMP support, the
customer number must be configured at RSM LE to activate
the RSM license. For more information, refer to Installing the
RSM LE License on page 61.
Using the RSM LE 4-95
Settings Description
RSM Managed Indicates whether this system is managed by an RSM SE Server.
(Enabled or Disabled) If this option is set to enabled, it is assumed that an RSM SE
Server manages this RSM LE system.
If using PXE Image Loader instead of RSM SE:
• If using Command Center in a Dual Server configuration,
configure RSM LE to be managed by the two PXE Image
Loader servers to simplify role changes for Command
Center. Otherwise, configure RSM LE as unmanaged.
RSM Server Discovery Determines if a managed client gets the address of the
(Dynamic or Fixed) managing server dynamically or whether you assign a fixed
address for the SE or PXE Server.
Connected RSM Server Displays the last RSM SE or PXE Server that the client
communicated with, if managed.
RSM Server (Primary) Refers to the field for setting the name or IP address of the
server if RSM Server Discovery is Fixed.
RSM Server Refers to the field for setting the name or IP address of the
(Secondary) secondary server in a dual server environment.
Logical System Name Refers to the identifying name for this system that can be used
to identify this system by a name other than its computer name
at RSM Servers. For example, it may be desirable to use names
like Lane 1 or Bakery to identify the location or usage of the
system.
Custom Tag Provides the functionality to group systems managed by RSM
SE or RSM EE into various roles such as the functional area in
the store, a region in the country, or any other grouping you
wish.
OS Monitor (Enabled Indicates whether the monitoring of the operating system is
or Disabled) Enabled or Disabled. This setting is a licensed feature, but it
can be used without an RSM SE server. It is automatically
licensed if Command Center is used.
File Agent (Enabled or Indicates whether File Agent is Enabled or Disabled to support
Disabled) file distribution packages scheduled from RSM SE or RSM EE.
Note: If RSM SE is not used, File Agent may be disabled.
4-96 Using the RSM LE
Settings Description
Software Agent Indicates whether Software Agent is Enabled or Disabled to
(Enabled or Disabled) support software execution in packages scheduled from RSM
SE and RSM EE servers.
Note: If RSM SE is not used, Software Agent may be disabled.
Default Destination Refers to the default destination directory used for packages
Directory that contain distributed files but no destination directory is
defined in the package.
Using the RSM LE 4-97
Licensing
The system displays the Licensing section when you select AdministrationàLicensing.
The licensing section displays the current licensing information. If RSM LE is managed
by an RSM SE server, these are information fields and cannot be changed on this screen.
If the RSM LE is unmanaged, you can add a license file through this section.
Note: For more information on installing the RSM LE license, refer to Installing the
RSM LE License on page 61.
Alerting
The system displays the Alerting section when you select AdministrationàAlerting.
The Alerting section provides you the functionality to change the settings for the logs
and tallies and configure the SNMP Agent.
Using the RSM LE 4-99
After the SNMP agent is enabled, the system displays the various types of traps and
other settings.
For additional information on the SNMP Agent, refer to the "RSM SNMP Agent" section
in the NCR Retail Systems Manager Software User’s Guide (B005–0000–1518).
4-104 Using the RSM LE
Overall Alerts
Overall traps may be sent for changes in the overall status of the terminal or kiosk.
These traps are a roll–up of the statuses of the terminal based on the status of all devices.
The Overall traps may be filtered by severity.
Selecting AdministrationàAlertingàSNMP AgentàSuppress Overall Alerts with
displays the Suppress Overall Alerts with window.
In this window, you can configure which Overall traps should be sent or suppressed. To
suppress an alert, select the corresponding alert, and then select OK.
Category Alerts
Category traps may be sent for changes in the State of Health categories on the terminal
or kiosk. Category is a sub–classification of the terminal, peripheral or peripheral device
state. These categories include Configuration, Hardware, Maintenance, OPOS, and
UPOS.
The Category traps may be filtered by severity.
Using the RSM LE 4-105
In this window, you can configure which Category traps should be sent or suppressed.
To suppress an alert, select the corresponding alert, and then select OK.
System Alerts
System traps may be sent for changes in the system State of Health of a terminal or
kiosk. This state is the state of the base system, not the state of peripherals or other
devices in the system.
The System traps may be filtered by severity.
Selecting AdministrationàAlertingàSNMP AgentàSuppress System Alerts with
displays the Suppress System Alerts with window.
In this window, you can configure which System traps should be sent or suppressed. To
suppress an alert, select the corresponding alert, and then select OK.
4-106 Using the RSM LE
Device Alerts
Device traps may be sent for changes in the State of Health for a peripheral or device on
a terminal or kiosk. The State of Health for each device on the system is monitored
separately.
The Device traps may be filtered by severity.
Selecting AdministrationàAlertingàSNMP AgentàSuppress Device Alerts with
displays the Suppress Device Alerts with window.
In this window, you can configure which Device traps should be sent or suppressed. To
suppress an alert, select the corresponding alert, and then select OK.
Using the RSM LE 4-107
In this window, you can configure which Critical Event traps should be sent or
suppressed. To suppress an alert, select the corresponding alert, and then select OK.
4-108 Using the RSM LE
Tally Alerts
Traps may be sent when a tally reaches a tally threshold configured through RSM.
Note: Tally Threshold Traps are new in the RSM SNMP Agent and were not supported
in the NCR Retail SNMP Agent.
The Tally Threshold traps may be filtered.
Selecting AdministrationàAlertingàSNMP AgentàSuppress Tally Alerts displays
the Suppress Tally Alerts window.
In this window, you can configure whether Tally Threshold traps should be sent or
suppressed. To suppress an alert, select the corresponding alert, and then select OK.
Using the RSM LE 4-109
Maximum Alerts in Queue defines the length of the internal queue for TRAP events. If
the queue becomes full, TRAP events are dropped (based on this value). Possible values
are 10 through 1000. Default value is 256.
This option determines the strategy for managing the internal TRAP queue when the
queue becomes full and a new TRAP event is created. The possible values are:
• Discard Old Alerts—overwrites older TRAP events. This value is the default value.
• Discard New Alerts—ignores new TRAP events.
4-110 Using the RSM LE
Heartbeat Configuration
This section describes the heartbeat configuration.
Heartbeat Interval
The interval (in seconds) between which the RSM SNMP Agent sends a periodic
heartbeat trap. A zero (0) value indicates that no heartbeat trap should be sent. Possible
values are 0 through 86400 seconds (24 hours).
Selecting AdministrationàAlertingàSNMP AgentàHeartbeat Interval displays the
Heartbeat Interval window.
Critical Events
The system displays the Critical Events section when you select
AdministrationàCritical Events. In the Critical Events section, you can perform the
following:
• Change and view the threshold information for the various critical errors that were
automatically set up during the RPSW installation.
• Add new events.
• View, export, and print event messages.
Using the RSM LE 4-113
2. Select a specific error and then select OK. In this example, DrWatson is selected.
4-114 Using the RSM LE
The critical event window displays the critical events of the selected set.
• FSMID—if the event message contains the Finite State Machine ID (FSMID) field
to specify the instance of the monitored item (profile name for peripherals,
process name for process monitoring, file name for file monitoring), this field can
be used to configure a critical event for a specific FSMID.
• Threshold—refers to the number of times the event should occur before an alert
is sent.
• Count—refers to the current count of how many times the event has occurred.
• Reset Count—refers to whether to reset the count value when the threshold
occurs or to never reset the count.
• Command Line (optional)—refers to the command line to run when the
threshold is reached.
• Requires user interaction—refers to whether the Command Line specified for the
event requires user interaction.
4. Modify the critical event set's information if necessary, and then select OK.
4-116 Using the RSM LE
2. Select the Event Message that you want to view. The system displays this window.
The system creates a CSV file and uses the Message File Source as the file name. It
then displays an Alert window showing the path to where the file is saved.
4-120 Using the RSM LE
Tally Thresholds
Tallies are counts of the number of times a certain operation is performed. For example,
the number of track 1 reads on the Magnetic Stripe Reader. A tally threshold is the
number of tallies recorded for a device when you wish to be notified.
There are multiple ways to set tally thresholds, and these include the following:
• Default tally thresholds are installed with RPSW. The default tally thresholds are
based on the default profiles. If the default profiles are not used, the default tally
thresholds should be replaced with tally thresholds for the peripheral profiles used.
• An alternate set of tally thresholds can be installed with RPSW using a command
line parameter to specify a .reg file containing tally thresholds.
• Add a tally threshold for a system or a group using the Tally Threshold menu in the
RSM user interface where all the tally thresholds are listed.
• You can enable a tally threshold from the tallies page by selecting MonitoràTallies
in the RSM user interface. You can add a tally threshold for a system only (not
groups) by using the tally page for a device and selecting the tally.
To display the Tally Thresholds menu, select AdministrationàTally Thresholds.
4-122 Using the RSM LE
In the Tally Thresholds menu, you can go through the device tallies by selecting Next
Set or Previous Set.
4-124 Using the RSM LE
OS Monitoring
If licensed, Operating System (OS) Monitoring provides a display of various features
that can be measured by the operating system. The OS Monitoring feature tracks and
reports information about system performances, disks, SMART disks, files, processes,
and services. OS Monitoring is performed periodically. If an error condition is found, an
event is logged, and a State of Health (SOH) transition occurs. On subsequent checks, if
the same error condition is still present, no error is logged because the previous error
condition is remembered. If the error condition is no longer present on subsequent
checks, a healthy or informational event is logged and SOH transitions to healthy.
Healthy or informational events are logged only after an error condition is resolved;
they are not logged when the initial state is healthy.
If Command Center is used, OS Monitoring is licensed even if an RSM license is not
present. OS Monitoring can be configured locally through RSM LE or remotely through
Command Center.
To access the OS Monitoring parameters, select AdministrationàOS Monitoring.
Using the RSM LE 4-125
For each type of OS Monitoring (overall system performance, disk, SMART disk, file,
process, and services), two configuration settings determine when the monitoring is
performed: Start Up Delay and Monitoring Interval.
Configuration
Description
Settings
Start UP Delay The Start Up Delay setting determines how long RSM waits after start
up before it begins monitoring. The default values are selected to
provide the system time to fully start up before monitoring begins and
to not start all monitoring at the same time. If the Start Up Delay is
changed, the change takes effect on the next start up.
Monitoring The Monitoring Interval setting determines how often periodic checks
Interval occur after monitoring begins. If the Monitoring Interval is changed,
the change takes effect immediately and the interval starts over. If
the Monitoring Interval is set to zero, that particular OS Monitoring
occurs once on start up (after the Start Up Delay period) and then
ends. Any error that occurs when the checks occur on start up results
in SOH transitions to an error state. These SOH errors cannot be
cleared until the next time the monitoring is done and the condition
that caused the error has cleared up, either on the next start up or if
the monitor interval is changed to some periodic value. If you intend
to use Monitor Interval of zero, you may want to consider changing
the configuration of your system to use Critical Events instead of SOH
for the related error conditions.
System–wide Monitor
The System–wide Monitor displays the following monitoring settings for CPU and
memory usage:
Information Definition
System–wide Refers to the option to enable or disable the monitoring of CPU and
Monitoring memory usage.
System–wide Refers to the time (in seconds) that determines how often the RSM
Monitor Interval application checks the CPU and memory usage. If you set the
monitor interval to zero, the monitoring of CPU and memory usage
occurs only at the start up of the NCRLoader.
System–wide Start Refers refers to the time (in minutes) before monitoring of CPU
Up Delay and memory usage starts at the start up of the NCRLoader. You can
set this setting to provide time for the system start up to complete
before monitoring begins because high activity during start up may
be normal. Changes to this setting take effect on the next start up.
Using the RSM LE 4-127
CPU Usage
CPU Usage displays monitoring settings for the following information:
Information Definition
Maximum CPU Usage Refers to the maximum allocation that is permitted for CPU
usage.
High Usage Tolerance Refers to the time (in seconds) that is permitted for high CPU
usage.
Memory Usage
Memory Usage displays the monitoring settings for the Maximum Memory Usage,
which is the maximum allocation permitted for memory usage. If set to zero, monitoring
of memory usage is disabled.
4-128 Using the RSM LE
Disk Space
RSM can monitor the amount of disk space used. Alerts and State–of–Health status
indicate when disk usage is higher than the configured thresholds. The Disk Space
section displays the following options for monitoring the disk space:
Refer to the following table for more information on the Disk Space options.
Information Definition
Disk Space Refers to the option to enable or disable the monitoring of
Monitoring standard disk space.
Disk Monitor Refers to the time (in minutes) that determines how often the RSM
Interval application checks the standard disk drives. If you set the monitor
interval to zero, the monitoring of standard disk drives occurs only
at the start up of the NCRLoader.
Disk Start Up Delay Refers to the time (in minutes) before monitoring of standard disk
drives starts at the start up of the NCRLoader. You can set this
setting to provide time for system start up to complete before
monitoring begins because high activity during start up may be
normal. Changes to this setting take effect on the next start up.
Monitored Disks Refers to the standard disk drives that the RSM application
monitors.
4-130 Using the RSM LE
Information Definition
Attention Soon Refers to the percentage of used disk space that triggers a warning
Warning that implies the disk is almost full.
Attention Now Refers to the percentage of used disk space that triggers a more
Warning severe warning that implies the disk is almost full.
Using the RSM LE 4-131
SMART Drive
The RSM application monitors SMART drives at the monitor interval that you provided,
and if problems exist, the application generates an alert. The SMART Drive section
displays the following options for monitoring SMART drives:
Refer to the following table for more information on the SMART drive options.
Information Definition
SMART Drive Refers to the option to enable or disable the SMART drives
Monitoring monitoring.
SMART Drive Refers to the time (in minutes) that determines how often the RSM
Monitor Interval application checks the SMART drives. If you set the monitor interval
to zero, the SMART drives monitoring occurs only at the start up of
the NCRLoader.
SMART Start Up Refers to the time (in minutes) before SMART drives monitoring
Delay starts at the start up of the NCRLoader. You can set this setting to
provide time for system start up to complete before monitoring
begins because high activity during start up may be normal.
Changes to this setting take effect on the next start up.
Monitored Drives Refers to the SMART drives that the RSM application monitors.
4-132 Using the RSM LE
File
The RSM application monitors files in the system, and alerts you if a monitored file is
either present or not. It can also monitor file sizes and versions. The File section displays
the following options for monitoring files:
Refer to the following table for more information about the File options.
Information Definition
File Refers to the option to enable or disable the monitoring of files.
Monitoring
Monitor Refers to the time (in minutes) that determines how often the files are
Interval checked. If you set the monitor interval to zero, the file monitoring occurs
only at the start–up of the NCRLoader.
File Start Refers to the time (in minutes) before files monitoring starts at the start–
Up Delay up of the NCRLoader. You can set this setting to provide time for system
start–up to complete before monitoring begins because high activity during
start–up may be normal. The default values are selected so that all OS
monitoring does not start at the same time. Changes to this setting take
effect on the next start–up.
Using the RSM LE 4-133
Files Monitored
RSM permits monitoring for file presence, size, and version. File monitoring generates
State–of–Health status and alerts. The Files Monitored section is displayed only if files
are being monitored.
4-134 Using the RSM LE
Monitoring Files
To monitor a file, follow these steps:
1. On the OS Monitoring section, select Add. The Add window is displayed.
2. Select File, and then select OK. The system displays the Add File window.
Using the RSM LE 4-135
Parameter Definition
File Name Refers to the name of the file that you want to monitor.
Path Refers to the directory path of the file that you want to
monitor.
Presence Refers to the type of monitoring that you want, which can be
any of the following:
• Not Monitored—indicates that the presence of the file is
not monitored.
• Present—indicates that you want to make sure the file is
present.
• Not Present—indicates that you want to make sure the file
is not present.
Maximum File Size Refers to the maximum file size for the file before an event is
triggered. Zero disables maximum file size monitoring.
Version Monitors the version of the file to verify that the correct
version is present. Leaving it blank disables version
monitoring.
4. Select Add. The Files Monitored section indicates that the file is added for
monitoring.
4-136 Using the RSM LE
To stop the monitoring for a file, select the line containing the name of the file, and then
select Remove. Confirm the removal by selecting OK.
Using the RSM LE 4-137
Processes
RSM permits monitoring processes that are running and their running usage. Process
monitoring generates State–of–Health status and alerts. The Processes section displays
the following options for monitoring processes:
Information Definition
Process Refers to the option to enable or disable the monitoring of processes.
Monitoring
Process Refers to the time (in minutes) that determines how often the RSM
Monitor application checks the processes. If you set the monitor interval to zero,
Interval the process monitoring occurs only at the start–up of the NCRLoader.
Process Refers to the time (in minutes) before process monitoring starts at the
Start Up start–up of the NCRLoader. You can set this setting to provide time for
Delay system start–up to complete before monitoring begins because high
activity during start–up may be normal. Changes to this setting take effect
on the next start–up.
Monitoring Processes
To monitor a process, follow these steps:
1. On the OS Monitoring section, select AddàProcess, and then select OK.
Using the RSM LE 4-139
2. Select a process from the drop–down menu, and then select OK. The system
displays the Add Process window.
4-140 Using the RSM LE
Parameter Definition
Process Refers to the process you want to monitor.
When configuring the process to be monitored, a drop–down
box permits selection of one of the processes currently
running. If you select Unlisted Process, you can enter another
process name. If a list of currently running processes is not
available, the system does not display the drop–down box. You
must then enter the process name.
Path Refers to the directory path of the process. The path is
optional. If you do not specify a path, the RSM application
monitors any process matching the process name. If you
specify a path, ensure that both the process name and path
match a running process.
Minimum Instances Refers to the minimum number of copies of the process that
can run at the same time. A zero input means that the
minimum number of instances of the process is not
monitored.
Maximum Instances Refers to the maximum number of copies of the process that
can run at the same time. A zero input means that the
maximum number of instances of the process is not
monitored.
Maximum CPU Refers to the maximum percentage of CPU usage that the
Usage process can use without generating an alert. Alerts are
generated only if the CPU usage exceeds the threshold for
High Usage Tolerance rather than generating alerts for brief
spikes in CPU usage. A zero input means that the maximum
percentage of CPU usage of the process is not monitored.
High Usage Refers to the time (in seconds) that determines how long the
Tolerance Maximum CPU Usage can last until an alert is generated. A
zero input means that the high usage tolerance of the process
is not monitored.
Maximum Memory Refers to the maximum memory usage (in MB) that the
Usage process can use without generating an alert. A zero input
means that the maximum memory usage of the process is not
monitored.
Using the RSM LE 4-141
Parameter Definition
Maximum Handle Refers to the maximum number of handles the process can
Count use without generating an alert. A zero input means that the
maximum number of the handles of the process is not
monitored.
Maximum Thread Refers to the maximum number of threads the process can
Count use without generating an alert. A zero input means that the
maximum number of the threads of the process is not
monitored.
4. Select Add. The system displays the process in the Processes Monitored section.
To stop monitoring a Process, select the line containing the name of the Process, and
then select Remove. Confirm the removal by selecting OK.
4-142 Using the RSM LE
Services
RSM permits monitoring of services with Started or Stopped states and their start–up
type. Service monitoring generates State–of–Health status and alerts. The Services
section displays the options for monitoring services:
Information Definition
Service Refers to the option to enable or disable the monitoring of services.
Monitoring
Service Monitor Refers to the time (in minutes) that determines how often the RSM
Interval application checks the services. If you set the monitor interval to
zero, the service monitoring occurs only at the start–up of the
NCRLoader.
Service Start Up Refers to the time (in minutes) before service monitoring starts at
Delay the start–up of the NCRLoader. You can set this setting to provide
time for system start–up to complete before monitoring begins
because it takes a little time for services to start up and get to their
normal state after start–up. Changes to this setting take effect on
the next start–up.
Monitoring a Service
To monitor a service, follow these steps:
1. On the OS Monitoring section, select AddàService, and then select OK.
Using the RSM LE 4-143
2. Select a service from the drop–down menu, and then select OK. The system displays
the Add Service window.
4-144 Using the RSM LE
Parameter Definition
Service Refers to the service that you want to monitor.
When configuring a service to be monitored, a drop–down box
permits selection of one of the services currently registered.
If you select Unlisted Service, you can enter another service
name. If a list of currently registered services is not available,
the system does not display the drop–down box. You must
then enter the service name.
Expected Startup Specifies whether to monitor the Startup Type of the service,
Type and if monitored, what Startup Type is expected. If the actual
Startup Type is not the same as this setting, the RSM
application logs an event and generates an alert. The
following options are available:
• Automatic (Delayed Start)
• Automatic
• Manual
• Disable
• Not Monitored
Note: The Automatic (Delayed Start) option displays only on
systems running on Windows 7 operating system.
Expected Status Specifies whether to monitor the Status of the service, and if
monitored, what Status is expected. If the actual Status is not
the same as this setting, the RSM application logs an event
and generates an alert. The following options are available:
• Started
• Stopped
• Not Monitored
Using the RSM LE 4-145
4. Select Add. The system displays the service in the Services Monitored section.
To stop monitoring a Service, select the line containing the name of the Service, and
then select Remove. Confirm the removal by selecting OK.
4-146 Using the RSM LE
Data Capture
Data Capture is for use by NCR developers when a problem arises with NCR software.
The NCR developer provides the information for the Trace Mask and the Level Mask,
based on the problem to be solved.
3. If you selected the Simple configuration, select Default Setting. The system displays
the Default Setting window.
The Default Setting is the data capture mask used for all modules listed under
Module Settings. These modules are configured for Default Logging.
a. Select the default setting, and then select OK.
b. If you want to configure a module and set it to a logging that is different from
the default setting, select the module and then select any of the following
options:
4-150 Using the RSM LE
a. Select Default Trace Mask, and then select the trace mask settings from the
default Trace Mask window.
c. Select Default Level Mask, and then select the level mask setting, whether All
or None.
d. Select OK.
e. If you want to configure a module and set it to a setting that is different from the
default setting, select the module and then select the desired setting.
5. Select Save in the DataCapture section to save the changes.
4-152 Using the RSM LE
4. Select from the options, and then select OK. The system launches a utility to create
the GDF file on the system where the information is to be gathered.
4-154 Using the RSM LE
The file name is of the following form so that creating a file does not overwrite the
files previously created:
<product>_<date>_<time>.zip
Example: RSM_20060810_133314.zip
For RPSW 2.x and 3.x releases, the GDF file created is stored in C:\Program
Files\NCR\RSM\Diags on the system where the information is gathered.
For RPSW 4.0 and up, the path for the diagnostic files is at
%ALLUSERSPROFILE%\Application Data\NCR\RSM\Diags. The
%ALLUSERSPROFILE% variable is an environment variable that points to different
locations depending on the operating system.
Note: Prior to RSM Release 3.0.3, there was no file retrieval, so to get the file from a
remote system using an older version of RSM, you must manually retrieve it. With RSM
3.0.3 and up, you can use the RSM file retrieval feature to move files from RSM LE to
RSM SE or RSM EE. For more information, refer to the NCR Retail Systems Manager
Software User’s Guide (B005–0000–1518).
If you cannot use the user interface to create the GDF file, you can create the .zip file
from a command prompt. The command file for creating the file from a command
prompt is RSMlogs.cmd.
Note: It is best to run RSMLogs.cmd as an Administrator. If the current logged in user
cannot access the registry or Windows event logs, RSMLogs.cmd will not be able to
collect some items in the diagnostic file.
Using the RSM LE 4-155
When RPSW is installed, the default profiles for the retail peripherals you chose are
installed. These profiles provide some default configurations for the most common uses
of the peripherals. You can change a profile’s configuration or create new configurations
based on your needs.
4-156 Using the RSM LE
Changing a Profile
To change a profile, follow these steps:
1. Select Profile Name. The system displays the Profile Name window.
2. Select one of the available profiles from the drop–down list, and then select OK. The
system displays the configuration of the selected profile.
You can change any parameter that is not grayed out by selecting that parameter
and making the changes. Fields in bold font are changes that have not been saved.
3. After making the changes, select Save.
4-158 Using the RSM LE
Deleting a Profile
To delete a profile, follow these steps:
1. Select the Delete, and then select the profile name of the profile you want to delete.
Performing Diagnostics
You can perform two different types of diagnostics on the peripherals:
• Interactive Diagnostics—require interaction from the user, such as swiping a card
and scanning an item.
• Non–interactive Diagnostics—test the internal software or hardware and do not
require user interaction.
To perform diagnostics, follow these steps:
Note: In this example, the desired profile is POS Printer.
1. Select PeripheralsàPOS PrinteràDiagnosticsàLocal Attended Diagnostics. The
system displays this window.
The printer test permits you to select a specific print station and other parameters
associated with that printer.
2. Select Print. The selected printer prints some information.
4-160 Using the RSM LE
Platform Devices
The following are the devices that are not controlled by OPOS or JavaPOS:
• Audio
• Audio volume
• Diagnostics button tests Stereo, Left, or Right Speaker
• BIOS
• BIOS Information
• BIOS Version
• BIOS Release Date
• BIOS Vendor
• BIOS ROM Size
• BIOS OEM String
• System Information
• NCR Class & Model
Using the RSM LE 4-161
• Power States (For more information, refer to Configuring Power States on page 165.)
• Serial Ports—identifies the COM Ports attached to the system.
• Diagnostics button is used to select a COM port, and then a turnaround test is
performed if a turnaround plug is installed on that port.
• Software (if licensed)—lists the software installed on the system.
• Touchscreen
• Controller
• Diagnostics button is used to test a touch screen.
• UPS (only if installed with custom install)
• Versioning—version numbers for the modules in the following categories:
• RSM Version
• Common
• Common Kernel Drivers
• Common Libraries
• Common IO Libraries
• Common OSAL Libraries
• Common Utilities
• Platform
• Platform Agents
• Platform HAL
• Platform Kernel Drivers
• Platform Libraries
• Retail Controls
• JavaPOS Retail Controls
• Retail Control Models
• OPOS Retail Controls
• RSM
4-164 Using the RSM LE
3. Select the brightness percentage on the slider control. The color blue represents the
brightness percentage that is currently set. You can also set the brightness
percentage by clicking the plus (+) and minus (-) buttons.
4. Select OK, and then select Save on the Display section. The display screen of the
terminal automatically changes according to the brightness settings you have
selected.
If you modify the brightness settings of a client or terminal through the server, the
change reflects automatically even without refreshing the terminal. If you modify the
brightness settings on the terminal itself, the change reflects only after selecting Save.
Using the RSM LE 4-165
The Power Switch setting (enable or disabled) is supported only on the following
systems:
• 7452
• 7453
• 7456
• 7457–1xxx and 2xxx
• 7458–1xxx and 2xxx
The Reboot Type and Boot Order settings, which affect the corresponding BIOS
settings, are supported on the following systems:
• 7402
• 7403
• 7457–4xxx
• 7458–4xxx
• 7459
Using the RSM LE 4-167
Overview
There are three settings that need to be set in the Microsoft SNMP Service to load the
RSM SNMP agent. Normally, these settings are set by the RPSW installation or by the
RSM user interface. However, these settings may need to be checked manually if RSM
SNMP is not running as expected or if other software has changed the Microsoft SNMP
configuration. These are the following settings:
• Allow Service to interact with Desktop
• NCRLoader service
• RSM SNMP Agent
A-170 Microsoft™ SNMP Service Settings
NCRLoader Service
The SNMP service is dependent on the NCRLoader service running. In the Microsoft
SNMP properties under the Dependencies tab, the NCRLoader service should be listed,
which is normally set by the RPSW installation as long as the Microsoft SNMP service
was installed prior to installing RPSW.
If you install RPSW before you install the Microsoft SNMP Service, you must manually
edit the registry to set this dependency. The install sets the following REG_MULTI_SZ
Registry Entry:
HKEY_LOCAL_
MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\DependOnService
Note: This setting may vary from this example if other dependencies are already
configured on your system.
Microsoft™ SNMP Service Settings A-171
RSM SNMP Agent
The Microsoft SNMP Service must be configured to load the RSM SNMP Agent. This
setting is set in the RSM LE or RSM SE user interface by selecting
AdministrationàAlertingàSNMP agent (Enable).
A-172 Microsoft™ SNMP Service Settings