SystemLink Server Ultra Careful Upgrade Steps

Issue Details

How can I be as careful as possible when upgrading SystemLink Server, so that I make sure I don't lose any data or configuration information?

Solution

To upgrade SystemLink Server with maximum safety, follow these steps:

• Check server’s general health (SystemLink Server Resource Requirements)
  • Verify ample disk space
  • Verify SystemLink Server licenses are not near expiration
  • Verify SSL web certificates are not near expiration
• Stop the NI Web Server
  • Open the NI Web Server Configuration UI
  • Switch to the Control tab
  • Click the Stop button
• Turn off the SystemLink Service Manager and NI System Message Bus
  • Open the Windows Services dialog box
  • Find the NI SystemLink Service Manager service
  • Right click and select Stop
  • Find the NI SystemLink Message Bus service
  • Right click and select Stop
  • Verify in the NI SystemLink Server Configuration dialog that all services have stopped
• Turn off other (TDM or client) Windows Services in Windows “Services” dialog
  • “NI CORBA Naming Service”
  • “NI PCP Service Locator”
  • “NI Salt-Minion” (if present)
  • “NI SystemLink Forwarding Service” (if present)
  • “NI SystemLink TDM Account Service”
  • “NI SystemLink TDM Database Service”
• Back up the following key SystemLink config directories:
  • C:\ProgramData\National Instruments\Skyline\Certificates
  • C:\ProgramData\National Instruments\Skyline\Config
  • C:\ProgramData\National Instruments\Skyline\HttpConfigurations
  • C:\ProgramData\National Instruments\Skyline\Install
  • C:\ProgramData\National Instruments\Skyline\RabbitMQ
  • C:\ProgramData\National Instruments\Skyline\SkylineConfigurations
• Back up the following key Web Server config directories
  • C:\Program Files\National Instruments\Shared\Web Server\certs
  • C:\Program Files\National Instruments\Shared\Web Server\conf
  • C:\ProgramData\National Instruments\Web Server\config
• Take a system snapshot (if possible, say if the server is a VM or in the cloud)
• Back up the Postgres data directory—the default location is:
  • C:\ProgramData\National Instruments\Skyline\PostgreSQLDatabase
• Back up the Mongo data directory—the default location is:
  • C:\ProgramData\National Instruments\Skyline\NoSqlDatabase
• Run SystemLink Server software upgrade using NI Package Manager. This will take ~30 minutes.
• Restart the SystemLink Server computer
• Verify all services come up Live in the NI SystemLink Server Configuration dialog
• Troubleshooting
  • Contact NI Support with Logs and configuration backups
  • Do not run NI Package Manager repair unless directed to by NI support 

Additional Information

None of these steps is strictly speaking required.  In general an in-place SystemLink Server upgrade is quick safe and almost always succeeds without issue.  For users how are wanting to be extra careful, though, these are steps you can take to safeguard the current status of your SystemLink Server.  The more of these steps you choose to do, the less risk that data or configuration info will be lost during the upgrade.