How do I migrate my Shiny Server Pro license from one machine to another?

Avatar
Amanda Gadrow
Follow

To move your license from one Shiny Server Pro installation to another, take the following steps:

Online license

  1. Install Shiny Server Pro on the new machine, and verify that it is functioning properly.
    • /etc/shiny-server/shiny-server.conf
    • /etc/init/shiny-server.conf (if you made any changes to this file)
    • Any PAM session file you may have created on the old server
    1. If this machine has never had Shiny Server Pro on it before, you will have the standard 45-day trial period before a license is required.
    2. If you would like the new machine to have the same configuration as the old machine, you can copy the configuration files in the /etc/rstudio directory from the old server to the new.
    3. If you are using an authentication method with Shiny Server Pro, you will want to implement the same configuration on the new server that you have on the old.
  2. Deactivate the license on the old server:
    $ sudo /opt/shiny-server/bin/license-manager deactivate
  3. Activate the license on the new server:  
    $ sudo /opt/shiny-server/bin/license-manager activate <product-key>
    $ sudo restart shiny-server # or "sudo /sbin/service shiny-server restart" or "sudo systemctl restart shiny-server", depending on your system
  4. Verify the status of the license on the new server:
    $ sudo /opt/shiny-server/bin/license-manager status

Offline license

  1. Install Shiny Server Pro on the new machine, and verify that it is functioning properly.
    1. If this machine has never had Shiny Server Pro on it before, you will have the standard 45-day trial period before a license is required.
    2. If you would like the new machine to have the same configuration as the old machine, you can copy the configuration files in the /etc/rstudio directory from the old server to the new.
    3. If you are using an authentication method with Shiny Server Pro, you will want to implement the same configuration on the new server that you have on the old.
  2. Use this application to deactivate the license on the old server:https://rs-support.shinyapps.io/offline-activation/. Note that this will make the old server unlicensed, so you will need to apply a new license if you wish to keep using it.
  3. Use that same application (https://rs-support.shinyapps.io/offline-activation/) to generate an offline activation file for the new server.
  4. Run the license-manager activate-offline command supplied by the application on the new server, then restart it:
    $ sudo reload shiny-server
  5. Verify the status of the license on the new server:
    $ sudo /opt/shiny-server/bin/license-manager status-offline

For more information on license management, see this section of the Shiny Server administrator's guide.

Comments