SwapServerID

Securely swaps Domino server identity files during migration with automatic backup and restart.

SwapServerID

Install

Domino console command to install this app on your server:

tell Genesis install SwapServerID

Install in MyAccount (for Prominic customers only)

Source code

Open in Moonshine

If the project doesn't open in Moonshine-IDE, then run Project > Import Genesis Directory Application and paste the below URL.

SwapServerID - A Genesis-compatible Java add-in that retrieves stored server IDs from a secure database and applies them to a target HCL Domino server during migration, effectively changing the server's identity. Features comprehensive backup of existing IDs, automatic server restart, and seamless integration with StoreServerID for complete server migration workflows. Fully command-line driven with built-in safety features.

Key Features:

  • Comprehensive Backup: Creates timestamped backups of all local ID files before replacement
  • Complete Identity Swap: Replaces server.id, admin.id, cert.id, and other identity files
  • Safety-First Design: Maintains directory structure and provides recovery options
  • Automatic Restart: Issues server restart command after successful ID swap
  • Migration Ready: Works seamlessly with StoreServerID for end-to-end server transitions

Console Commands:

  • tell SwapServerID run - Execute complete ID swap and restart server
  • tell SwapServerID status - Check database availability and backup count
  • tell SwapServerID restart - Manual server restart without ID swap
  • tell SwapServerID help - Display available commands

Essential for organizations executing Domino server migrations who need a secure, automated way to transfer server identities from source to target servers with comprehensive backup and recovery capabilities.

Version: 0.0.3

{
    "title": "SwapServerID v${version}",
    "versionjson": "${versionjson}",

    "config":
    {
        "version": "${version}",
        "active": "1",
        "runjava": "SwapServerID"
    },

    "steps": [
    {
        "title": "Step 1. Download needed files",
        "files": [
            {"from": "${baseurl}/0/${docid}/$FILE/SwapServerID-${version}.jar", "to": "JavaAddin/SwapServerID/SwapServerID-${version}.jar"}
        ]
    },
    {
        "title": "Step 2. Register SwapServerID Addin",
        "notesINI": [
            {
                "name": "JavaUserClassesExt",
                "value": "GJA_SwapServerID",
                "multivalue": true,
                "sep": ","
            },
            {
                "name": "GJA_SwapServerID",
                "value": "JavaAddin/SwapServerID/SwapServerID-${version}.jar"
            }
        ]
    },
    {
        "title": "Step 3. Restart All JavaAddins",
        "commands": ["restart"]
    },
    {
        "title": "Step 4. Final",
        "messages": ["SUCCESS: SwapServerID has been installed", "All addins will be restarted automatically"]
    }

    ]
}