Follow these steps to replace the existing distribution with the new version while preserving your profile configuration:
  1. Move to the installation directory and stop the running profile:
    Set-Location $env:OEMCP_HOME
    .\mcpgen.ps1 stop $Profile
  2. Remove existing mcpgen wheel files to avoid stale tooling conflicts:
    
    # Remove previous version wheel files
    Get-ChildItem -Path 'wheels\mcpgen-*.whl' | Remove-Item
  3. Extract the target OpenEdge MCP Server distribution into the installation directory:
    
    # Extract new distribution
    Expand-Archive -LiteralPath "$HOME\Downloads\OPENEDGE_MCP_SERVER_<VERSION>_WIN64.zip" -DestinationPath $env:OEMCP_HOME -Force
  4. Load the target Docker images and validate the environment:
    
    # Load new Docker images
    .\load_images.ps1
    
    # Verify installation
    .\mcpgen.ps1 doctor
  5. Start the profile after the upgrade completes:
    # Start the upgraded profile
    .\mcpgen.ps1 start $Profile

    The default compose configuration uses openedge-mcp-server:latest. The load_images.ps1 script loads the new image under this reference, so no compose-file changes are required.