Cloud Replicator Documentation
Index

Installation

This guide walks you through installing Cloud Replicator in your Business Central environment.

Installing from AppSource

Cloud Replicator is available through Microsoft AppSource, the official marketplace for Business Central extensions.

Step-by-Step Installation

  1. Open Extension Marketplace
    • In Business Central, use the search icon and search for "Extension Marketplace"
    • Alternatively, navigate to the Extension Management page and select "Marketplace"
  2. Search for Cloud Replicator
    • In the AppSource marketplace, search for "Cloud Replicator"
    • Look for the extension published by Hougaard
  3. Install the Extension
    • Click on Cloud Replicator to view details
    • Select "Free Trial" or "Get it now" depending on availability
    • Review and accept the terms and conditions
  4. Wait for Installation
    • Business Central will download and install the extension
    • This process typically takes a few minutes
    • You may need to sign out and back in after installation
  5. Verify Installation
    • Search for "Extension Management" in Business Central
    • Confirm Cloud Replicator appears in the list of installed extensions
    • Check that the version matches the expected version (1.0.0.123)

Post-Installation Steps

After installation, you need to complete the following steps before using Cloud Replicator:

1. Register Your License

For production environments, you must register your license:

  1. Search for "Cloud Replicator Setup" in Business Central
  2. Open the setup page
  3. Click "License/Register" in the action bar
  4. Enter your registration key
  5. Click OK to validate

See License Registration for detailed instructions.

2. Configure Azure Credentials

Before you can replicate data, configure at least one cloud destination:

  1. Open Cloud Replicator Setup
  2. Enter credentials for your chosen destination(s):
    • Azure Table Storage: Account Name and Access Key
    • Cosmos DB (NoSQL): Account Name, Access Key, and Database Name
    • Cosmos DB (Table): Account Name and Access Key
    • Azure AI Search: Service Name and API Key

See Initial Configuration for details.

3. Create Table Mappings

Define which tables to replicate:

  1. Search for "Cloud Replicator Table Mapping" in Business Central
  2. Add entries for each table you want to replicate
  3. Configure destination and options for each table

See Table Mapping Overview for guidance.

Updating Cloud Replicator

When updates are available:

  1. Navigate to Extension Management
  2. Find Cloud Replicator in the list
  3. If an update is available, you'll see an update option
  4. Click to install the update
  5. Review release notes for any configuration changes required

Uninstalling Cloud Replicator

To remove Cloud Replicator:

  1. Navigate to Extension Management
  2. Find Cloud Replicator in the list
  3. Select the extension and choose "Uninstall"
  4. Confirm the uninstallation

Important: Uninstalling the extension will:

  • Remove all Cloud Replicator configuration data
  • Stop any scheduled replication jobs
  • NOT delete data already replicated to your cloud destinations

Installation Troubleshooting

Extension Not Appearing After Installation

  • Sign out of Business Central and sign back in
  • Clear your browser cache
  • Wait a few minutes for the extension to fully deploy

Installation Fails

  • Check that you have administrator permissions in Business Central
  • Verify your Business Central version meets the minimum requirements (18.0+)
  • Contact support if the error persists

After installation, Cloud Replicator pages may take a few minutes to appear in search results. If they don't appear:

  1. Try searching for the exact page name: "Cloud Replicator Setup"
  2. Navigate manually through the Extension Management page
  3. Refresh your browser and try again

Sandbox vs. Production Installation

Sandbox Environments

  • Full functionality without license registration
  • Ideal for testing and evaluation
  • Same installation process as production

Production Environments

  • Requires valid license registration
  • Register immediately after installation to avoid disruption
  • Contact Hougaard for license purchases