Support

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

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.
    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 following files over from the old to the new:
      • /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
    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. Deactivate the license on the old server.  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:
    $ sudo /opt/shiny-server/bin/license-manager deactivate-offline
  3. Generate an offline activation request on the new server:  
    $ sudo /opt/shiny-server/bin/license-manager activate-offline-request <product-key>
  4. Send the output from steps 2 and 3 to support@rstudio.com
  5. Support will reply with an activation file, which you can apply to the server with this command:
    $ sudo /opt/shiny-server/bin/license-manager activate-offline <activation-file>
    $ sudo reload shiny-server
  6. 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.

Have more questions? Submit a request

Comments