Upgrading Repository to Deployment Server

New
  • Published on Oct 3, 2025
  • 2 minute(s) read
Next

Overview

This document walks you through converting a Repository Server to a Deployment Server in Decisions, including configuration of the associated Dev Server. It includes upgrade instructions, migration steps, and all necessary configurations.

Prerequisites

Before starting the conversion process, ensure the following requirements are met:

  1. Supported Version: Only servers on Decisions version 9 are supported for this process.
  2. Commit All Changes: All uncommitted changes from connected Dev Servers must be committed to the Repository Server before beginning the upgrade.
  3. Database Connection Details: Note down the Database Connection String of the Repository Server.

Upgrade the Servers

Upgrade both the Repository Server and the Dev Server connected to it to the latest MVP build of Decisions v9.

Post-Upgrade Configuration

  1. Repository Server Configuration
    1. Update Settings.xml
      • Navigate to: C:\Program Files\Decisions\Decisions Server\Settings.xml
      • Change the ServerType to Deployment:                                                                       
    2. Restart Decisions Service
      • Restart the Decisions Windows Service to apply changes.
    3. Verify UI Update
      • After restart, verify that the "All Organizations" folder appears in the folder tree. This confirms Deployment Server mode is active.                                                                                        
    4. Create a New Organization
    5. Right-click inside the "All Organizations" tree to create a new Organization.
    6. Obtain Organization ID
      • Right-click the newly created Organization and select Copy Org ID.
      • Alternatively, retrieve the folder ID of the Organization from the folder structure if the context menu doesn't work.
    7. Prepare Migration Tool
      • Navigate to: C:\Program Files\Decisions\Decisions Server\Tools
      • Extract the RepositoryMigrationTool.zip archive.
    8. Configure Migration Settings
      • Open the extracted migration-config.json in a text editor (e.g., Notepad).
      • Provide the following:
        • DB Connection String
        • Organization ID
        • Database Type
      • Save the file.
    9. Run Migration Tool
      • Launch RepositoryMigrationTool.exe.
      • The tool will begin migrating all Repository Projects to the selected Organization.
    10. Wait for Migration Summary
      • Once the migration completes, a summary will be displayed.
      • Review the output to confirm successful project transfers.
    11. Restart Decisions Service (Again)
      • After migration completes, restart the Decisions Service to finalize setup.
  2. Dev Server Configuration
    1. Install Deployment Client Module
      • Use the Module Installer to add the Deployment Client module after the MVP upgrade is complete.
    2. Restart the Decisions Service
      • After module installation, restart the service to activate the module.
      • This step is required for proper initialization.
    3. Disable Designer Repository Service
      • Navigate to: System > Designers > Designer Repository Service
      • Disable the service.
    4. Configure Deployment Server Connection
      • Go to: System > Administration > Deployment Server Connection Parameter
      • Fill in the following settings:
        • Environment Name (e.g., Dev)
        • Deployment Server URL
        • Environment Type: Dev
      • Save the configuration.         
    5. Completion
      • The Development Server is now ready for Check-in and Check-out operations with the Deployment Server.

Important Notes

  • A restart of the Decisions Service is required:
    • After modifying the server type.
    • After installing the Deployment Server or Deployment Client modules.
    • After completing the migration process.

Support

For any technical issues or troubleshooting, contact the system administrator or the official Decisions support team.