Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Central ManagerCentral ServerStore ManagerCentral ClientPOSstoretestCentral databaseCentral Administratorstore databaseStore Administratorforce install tablesmulti-storeCentral modeStore IDCommand PromptNot For ResaleNFR

Set up Central Manager and multiple stores on a test machine

This topic describes how to set up Central Manager and multiple stores on one computer for testing purposes.

For testing purposes it can be helpful to install Central Manager and multiple Store Manager instances on a single test or demo machine.

The test machine must be running Microsoft SQL Server 2019 Express or higher. Ensure the test machine meets all other system requirements and has POS for .NET installed.

  1. Install all RMH apps.

  2. Open Central Administrator. Do the following:

    1. Restore and connect to the sample Central Manager database, RMHCentralSample.bck.

    2. Force install tables.

The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.

  1. Open Store Administrator. Do the following:

    1. Restore and connect to the sample Store Manager database, RMHCentralStore1.bck.

    2. Force install tables.

The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.

  1. Create a new instance of Store Manager for Store2:

    1. Open Store Administrator.

    2. Connect to the store database.

    3. Click Configuration and click Save As and Close.

    4. Enter a new configuration file name, e.g., Store2.config, and click OK.

    5. Create a copy of the original Store Manager desktop shortcut and rename it RMH Store Manager - Store2 to easily differentiate this store instance from other store instances.

    6. Open the shortcut properties and change the Target to "C:\Program Files (x86)\Retail Hero\RMH Store Manager\RMH Store Manager.exe" -c Store2.config

  2. Repeat the previous step for Store3.

  3. Create a new instance of Store Administrator for Store2:

    1. Create a copy of the original Store Administrator desktop shortcut and rename it RMH Store Administrator - Store2.

    2. Open the shortcut properties and change the Target to "C:\Program Files (x86)\Retail Hero\RMH Store Manager\RMH Store Administrator.exe" -c Store2.config

  4. Repeat the previous step for Store3.

  5. Open Store Administrator - Store2. Do the following:

    1. Restore and connect to the sample Store Manager database, RMHCentralStore2.bck.

    2. Force install tables.

The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.

  1. Repeat the previous step for Store3.

  2. Create a new instance of the Central Client for Store2. Refer to Creating a new instance of Central Client for Store2 below.

  3. Repeat the previous step for Store3.

  4. Open RMH Central Client - Store2. Do the following:

    1. Enter an NFR license key.

    2. Click Start Services.

  5. Repeat the previous step for Store3.

  6. Create a new instance of POS for Store2:

    1. Go to C:\Program Files (x86)\Retail Hero\RMH POS.

    2. Right-click RetailHero.POS.App.exe and select Create shortcut.

    3. Save the shortcut to the desktop and rename it RMH POS - Store2.

    4. Open the shortcut properties and change the Target to "C:\Program Files (x86)\Retail Hero\RMH POS\RetailHero.POS.App.exe" -c Store2.config

  7. Repeat the previous step for Store3.

  8. Open each instance of Store Manager. Do the following:

    1. Click File | Configuration.

    2. Go to the Multi-Store tab.

    3. Make sure the Store ID is correct.

    4. Select Enable Central Mode. Click OK to continute.

    5. Enter the Central Server URL, e.g., http://localhost:21000.

    6. Click OK. Store Manager will shut down.

    7. Restart Store Manager. It is now operating in Central Mode.

    8. Restart POS.

Creating a new instance of Central Client for Store2

  1. Go to C:\ProgramData\RetailHero.

  2. Create a new folder called RMH Central Flash Client 2.

  3. Run the Command Prompt as Administrator.

  4. Go to C:\Program Files (x86)\Retail Hero\RMH Central Flash Client.

  5. Enter the following command to open the RMH Central Client Wizard: RMH.Central.Communication.Store.Wizard.exe -c "RMH Central Flash Client 2"

If a configuration file already exists on the computer, it is not necessary to open the RMH Central Client Wizard to configure services. Instead, the services can be automatically configured using the configuration file. To do this, enter the command RMH.Central.Communication.Store.Wizard.exe -c "RMH Central Flash Client 2" -n

  1. Click Next.

  2. Enter the following to configure the server and database for Store2:

  • Store SQL Server Instance: Enter the name or IP address of the store SQL Server, including the instance name if you are using a named SQL Server instance.

  • Database Name: Enter the name of the store database, e.g., RMHC-Store2.

  • User ID: Enter the user ID to use for the SQL Server.

  • Password: Enter the password to use for the SQL Server.

  1. Click Test Connection.

  2. Click Next.

  3. Enter the port for the RMH Store 2 Hub, e.g., 30000.

You must use a different port from Store1.

  1. Click Next.

  2. Enter the ports for the Central Client services for Store2:

  • RMH Store 2 Input Gateway

  • RMH Store 2 Job Processor

  • RMH Store 2 Output Gateway

  • RMH Store 2 Custom

You must use different ports from Store1.

  1. In the Server Input Address section, enter the RMH Central Input Gateway address and port.

You must use the same port that you entered in the RMH Central Input Gateway field when you set up the Central Server services.

  1. Enter the RMH Central Client IP. This is the static IP or hostname of the computer where the client services are running.

  2. Click Create Services and Finish.

  3. Click OK. The RMH Central Client Wizard will close.

  4. Open Services and confirm that the Central Client services for Store2 were installed successfully:

  1. Create a copy of the Central Client desktop shortcut. Rename the new desktop shortcut RMH Central Client - Store2.

  2. Open the shortcut properties and change the Target to "C:\Program Files (x86)\Retail Hero\RMH Central Flash Client\RMH.Central.Communication.Store.Assistant.exe" -c "RMH Central Flash Client 2"

You must use the same folder name that you created under C:\ProgramData\RetailHero.

  1. Click OK.

Last updated