Backing Up and Recovering Messaging Keys

During startup, Unwired Server uses a messaging key that is created only at messaging service startup, then saved in the Windows registry. The registry entry is Base64 encoded, and the contents must be used as the value for the serververificationkey= key in messaging applications or Hybrid Apps.

Registry entries for the messaging keys are recorded in Computer\HKEY_LOCAL_MACHINE\Software\Node\Sybase\SybaseMessagingServer\Server\identinfo. If you are using an alternate method for creating complete backups of a host system, continue to use that method to backup and recover these keys.

  1. To backup required messaging service registry entries, from a command prompt, run:
    regedit /s /e msgserver.reg "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Sybase\Sybase Messaging
          Server\Server\identinfo 
    A file is exported to C:\Windows\System32\msgserver.reg. This file is human readable, and contains the RSA private key that is fundamental to secure messaging.
  2. Save the exported registry to a secure location.
    Note: If this key becomes compromised, the security of messaging communications can no longer be guaranteed.
  3. Delete the C:\Windows\System32\msgserver.reg file.
  4. To recover a system that has failed:
    1. Reinstall Unwired Platform.
    2. Stop Unwired Server.
    3. Copy the msgserver.reg file from its secure location to a temporary location on the server that is being restored (for example C:\temp).
    4. From a command prompt, run:
      regedit /s <filePath>\msgserver.reg 
      For example, if you saved the file to C:\temp then the command is:
      regedit /s C:\temp\msgserver.reg 
    5. Delete the msgserver.reg file from it's temporary location.
    6. Restart Unwired Server.