Store Management

The Stores page lets you manage your store connections, download agent software, and monitor store connectivity.

Stores Overview

Click "Stores" in the sidebar to access store management. You'll see:

Summary Cards

• Total Stores - Number of stores configured in the system
• Online - Stores currently connected and ready
• Offline - Stores not currently connected
• Store License - How many store licenses you're using vs. available

Store List

The table shows all your stores with:

• Store Code - Unique identifier (e.g., STORE001)
• Store Name - Descriptive name
• Status - Online or Offline
• Agent Version - Version of the agent software running
• Last Heartbeat - When the store last checked in

Adding a New Store

1. Click "Add Store"
   Click the blue "Add Store" button in the top right.
2. Enter store details
   
   • Store Code - A unique ID like "STORE001" (cannot be changed later)
   • Store Name - A friendly name like "Main Street Location"
   • Timezone - The store's timezone for scheduling
3. Click "Create Store"
   The store will be created and you'll be prompted to download the agent bundle.

Downloading the Agent Bundle

After creating a store, you need to install the agent software on the store's ACE system:

1. Download the bundle
   Click "Download Agent Bundle" when prompted after creating the store, or click the download icon next to an existing store.
2. Copy to the store
   Transfer the ZIP file to the store's 4690 OS system.
3. Extract the files
   Unzip the bundle to a directory on the store system.
4. Follow the README
   The bundle includes a README file with installation instructions.

Importing Multiple Stores

If you need to add many stores at once, use the CSV import feature:

1. Click "Import CSV" button
2. Prepare a CSV file with columns: store_code, name, timezone
3. Upload the file
4. Review the import results
5. Download the agent secrets CSV (one-time only!)

CSV Format Example

Editing a Store

To modify a store's settings:

1. Click the edit icon (pencil) next to the store
2. Update the store name or timezone
3. Click "Save Changes"

Collecting Agent Logs

If you're troubleshooting an issue with a store, you can collect logs from the agent:

1. Find the store in the list (must be Online)
2. Click the folder/archive icon
3. Wait for the agent to collect and upload its logs
4. Click "Download Logs" when complete

This downloads a ZIP file containing the agent's log files, which can help diagnose issues.

Deleting a Store

To remove a store from the system:

1. Click the delete icon (trash can) next to the store
2. Confirm the deletion

Store Connectivity

How Stores Connect

Each store runs a small agent program that:

• Connects to the ACE Report Center server over HTTPS
• Sends a "heartbeat" every 30 seconds to confirm it's online
• Polls for pending report requests
• Runs reports using ACETVREL and uploads results

Offline Stores

A store shows as offline when:

• The agent program is not running
• The store has no internet connection
• Firewall is blocking outbound HTTPS traffic
• The agent has crashed or encountered an error

If a store stays offline unexpectedly:

1. Check that the agent service is running on the store
2. Verify internet connectivity at the store
3. Check firewall settings
4. Review the agent logs on the store system