Chip Gore · Apr 15, 2021

Renaming and installed Instance of IRIS

Is there any way (on a Window machine) to rename an installed instance?  I installed my instance as 20201 and now I've upgraded in place to 2020.4 and I would like to change the instance name to be 20204, but I'm not sure how/where/or-even-if-possible to rename the instance.


Am I out of luck, or is this possible?


Product version: IRIS 2020.1
$ZV: IRIS for Windows (x86-64) 2020.1 (Build 217_1U) Tue May 26 2020 20:41:06 EDT
0 615
Discussion (5)1
Log in or sign up to continue

Sorry Chip, I'm afraid you're out of luck. On Unix there's "iris rename" but this doesn't work on Windows because of registry stuff.

To rename an instance on Windows you'll have to migrate.

Hi @Chip Gore !
extrapolating Vic's very valid comment:
- if you have to take the sour apple of migration, let it be the last time.
- why not install WSL2 and migrate into a Linux environment. Or even into a docker scenario

You can easily do this by replacing two values in the registry.
Just checked on Caché & IRIS: SMP and Terminal (##class(%SYS.System).GetInstanceName()) displays the new instance name.
Upgrade/Deinstall work fine too.

If desired, you can also replace the service names (private Apache, etc.).

  1. stop IRIS
  2. close IRIS Launcher (aka Cube)
  3. open regedit (run as Administrator)
  4. rename instance name (let's say "ABC")
    1. [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Intersystems\IRIS\Configurations\ABC]
    2. [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Intersystems\IRIS\Configurations\ABC\Manager\PreferredServer] @="ABC"
  5. run IRIS Launcher (aka Cube) and rename server names. If you want, you can also do this through the registry:
    1. [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Intersystems\CACHE\Servers\ABC]
    2. [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Intersystems\CACHE\Servers] "DefaultServer"="ABC"
  6. start IRIS
  7. Profit! Now the instance name is ABC.