# Set up Central Manager and multiple stores on a test machine

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

{% hint style="info" %}
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.
{% endhint %}

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.

{% hint style="info" %}
The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.
{% endhint %}

<div align="left"><img src="/files/1u8aPay5U4zeeK7JqR8R" alt=""></div>

3. Open **Store Administrator**. Do the following:
   1. Restore and connect to the sample Store Manager database, **RMHCentralStore1.bck**.
   2. Force install tables.

{% hint style="info" %}
The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.
{% endhint %}

4. 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`
5. Repeat the previous step for **Store3**.
6. 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`
7. Repeat the previous step for **Store3**.
8. Open **Store Administrator - Store2**. Do the following:
   1. Restore and connect to the sample Store Manager database, **RMHCentralStore2.bck**.
   2. Force install tables.

{% hint style="info" %}
The sample database is typically available under C:\Program Files (x86)\Retail Hero\RMH Central Manager\DBFiles.
{% endhint %}

4. Repeat the previous step for **Store3**.
5. Create a new instance of the **Central Client** for **Store2**. Refer to [#creating-a-new-instance-of-central-client-for-store2](#creating-a-new-instance-of-central-client-for-store2 "mention") below.
6. Repeat the previous step for **Store3**.
7. Open **RMH Central Client - Store2**. Do the following:
   1. Enter an **NFR license key**.
   2. Click **Start Services**.
8. Repeat the previous step for **Store3**.
9. 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`
10. Repeat the previous step for **Store3**.
11. 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"`

{% hint style="info" %}
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`
{% endhint %}

6. Click **Next**.
7. 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.

<div align="left"><img src="/files/JoM3T0KGBsJOwLNeVVMw" alt=""></div>

8. Click **Test Connection**.
9. Click **Next**.
10. Enter the port for the **RMH Store 2 Hub**, e.g., 30000.

{% hint style="info" %}
You must use a different port from Store1.
{% endhint %}

<div align="left"><img src="/files/GuCkMaq5BbCZ1yRXGbZL" alt=""></div>

11. Click **Next**.
12. 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

{% hint style="info" %}
You must use different ports from Store1.
{% endhint %}

<div align="left"><img src="/files/Z0WUl23t2OAukGkn3uvS" alt=""></div>

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

{% hint style="info" %}
You must use the same port that you entered in the RMH Central Input Gateway field when you set up the Central Server services.
{% endhint %}

14. Enter the **RMH Central Client IP**. This is the static IP or hostname of the computer where the client services are running.
15. Click **Create Services and Finish**.
16. Click **OK**. The RMH Central Client Wizard will close.
17. Open **Services** and confirm that the **Central Client** services for **Store2** were installed successfully:

<div align="left"><img src="/files/RJL0kSoy2BL8QpngeEiD" alt=""></div>

18. Create a copy of the Central Client **desktop shortcut**. Rename the new desktop shortcut **RMH Central Client - Store2**.
19. 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"`

{% hint style="info" %}
You must use the same folder name that you created under C:\ProgramData\RetailHero.
{% endhint %}

<div align="left"><img src="/files/LpArtirLLFy2iU6b8alX" alt=""></div>

20. Click **OK**.


---

# 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.rmhpos.com/installation/other-procedures/installation-cm-stores-test-machine-flash.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.
