Upgrading the Enterprise Solution Servers

Advanced Store offers an upgrade path for some, but not all, of the Enterprise Solution Servers. Upgrades are applicable to full released versions of Advanced Store. For hotfix upgrade instructions, consult the Release Notes.

The following enterprise servers can be upgraded:

• Messaging (RabbitMQ) Server—NCR DSR Enterprise Server Utilities
• Web Server
• Application Server

The Enterprise Solution Servers can be upgraded using one of the following methods:

• Using the installer user interface
• Using the command line

Download the following NCR installation package.

Prerequisites

• Before upgrading to a later version of Advanced Store, verify that a previous version of the NCR DSR Enterprise Server solution exists on the servers to be upgraded. Under Windows Programs and Features, make sure that the software release version installed on your system matches the software release version you are upgrading from.
• Ensure that the software prerequisite versions match the versions compatible with the Advanced Store release version. For more information, refer to Installation software prerequisites.
• Back up all databases on the Database Server. For a list of databases, refer to Installing the Advanced Store Database Server.

Upgrading the NCR DSR Enterprise Server Utilities

NCR recommends installing the NCR DSR Enterprise Server Utilities on the Messaging Server. If the Utilities have been previously installed on a different server, such as the Database Server, upgrade the NCR DSR Enterprise Server Utilities on that server.

To upgrade the NCR DSR Enterprise Server Utilities, follow these steps:

1. On the Messaging Server, run the NCR DSR Enterprise Server.msi installer.
2. Follow the on-screen installation instructions using the default settings. For more information, refer to Installing the NCR DSR Enterprise Server Utilities on the Messaging Server.
3. Run Ncr.Retail.NcrDataSetup.exe. For more information, refer to NCR Data Setup utility.
4. Verify that the enterprise EOM parameter version has been upgraded. Follow the steps in the following section: Verifying the Enterprise Parameter Version Upgrade.
5. If applicable, run Ncr.Retail.Platform.RabbitMQ.SetupApplication.exe. For more information, refer to Running the NCR RabbitMQ Setup Utility.
   Note

   This step is optional. To determine if this step is required for the current release version, refer to the NCR Advanced Store 6.8 Release Notes.

Updating stores with the new EOM parameter version

Upgrading the Messaging Server installs a new EOM parameter version at the enterprise level during the NCR Data Setup step, but it does not update the new parameter version at the store level. Retailers are not required to upgrade POS terminals nor update the EOM parameter version used in the stores at the same time that they upgrade the enterprise servers. They may upgrade their store systems at a later time. When a retailer has upgraded their POS software and is ready to update their store’s EOM parameter version, they may follow the directions described in Updating the POS Parameter Version.

Upgrading the Web Server

To upgrade the Web Server, follow these steps:

1. On the Web Server, run the NCR DSR Enterprise Server.msi installer.
2. Follow the on-screen instructions using the default settings. For more information, refer to Installing the NCR DSR Enterprise Web Server (API Server).
3. Verify the Web Server API installation. For more information, refer to Verifying the Web Server API installation.

Upgrading the Application Server

To upgrade the Application Server, follow these steps:

1. On the Application Server, run the NCR DSR Enterprise Server.msi installer.
2. Follow the on-screen installation instructions using the default settings. For more information, refer to Installing the NCR DSR Enterprise Application Server.
3. If the services are not already running, start the NCR Retail Services. For more information, refer to Starting the NCR Retail Services.

Distributed application servers

If a retailer uses a distributed application model, meaning that they have multiple Advanced Store application servers, the Batch Apply, EOM Synchronization, PMP Director, and EOM Parameter Staging services should not be installed on more than one general application server. By default, the upgrade installation excludes these services when they are not detected on the system being upgraded.

If the EOM Parameter Staging service was accidentally installed on more than one application server, refer to Uninstalling the EOM Parameter Staging service for instructions about how to remove it.

Installing the EOM and ETS Servers

The EOM and ETS Servers do not support upgrading. A full installation and configuration of these servers is required. After upgrading the applicable enterprise servers, perform a full installation on the EOM and ETS Servers. The EOM and ETS Servers must be installed with the software release version compatible with the Enterprise Solutions Servers.

To proceed with the enterprise upgrade process, follow these steps:

1. Uninstall the EOM and ETS Servers. For more information, refer to the following sections:
   • Enterprise Options Management (EOM) server
   • Enterprise Transaction Search (ETS) server
   Note

   When uninstalling the previous software release version, the server prerequisites do not need to be uninstalled unless there are prerequisite updates. For more information, refer to Installation software prerequisites.

2. Install the EOM and ETS Servers with the new software release version. The following sections start the full installation instructions for the EOM and ETS Servers, respectively:
   • Installing the Enterprise Options Management (EOM) Server
   • Installing the Enterprise Transaction Search (ETS) Server

Configuring an upgraded system

During an enterprise upgrade, it’s normally not necessary to reconfigure the system. If a new release adds configuration values to the default application configuration files as part of a new feature or improvement, it might be necessary to reconfigure the system to pick up the new configuration defaults after installing the DSR Enterprise applications. To determine whether or not a system configuration is required for a specific release version, refer to the NCR Advanced Store 6.8 Release Notes.

If a new release requires reconfiguring the system, follow the steps in Configuring the Enterprise Server Environment to configure the following enterprise servers:

• Messaging (RabbitMQ) Server
• Web Server
• Application Server
• EOM Server
• ETS Server

Enterprise Solution Servers command-line upgrade

The Enterprise Solution Servers can also be upgraded using the command line.

The following enterprise servers can be upgraded in the following order:

• Messaging (RabbitMQ) Server—NCR DSR Enterprise Server Utilities
• Web Server
• Application Server

To upgrade the enterprise solution applications or utilities, run the following command on each server:

msiexec /i "NCR DSR Enterprise Server.msi" /qb

When upgrading to a Service Pack release, run the following command on each server:

msiexec /i "NCR DSR Enterprise Server.msi" REINSTALL=ALL REINSTALLMODE=vomus