Moving (rehosting) a Sentinel Softkey
Sentinel softkeys can be moved between computers using the "rehosting" procedures described below. In this context, the "host" computer is the one on which the softkey is currently installed and the "recipient" computer is the one receiving the softkey.
A rehostable softkey is indicated by the "rehostable" tag and icon displayed in the Sentinel Keys page of the ACC on the host computer. If your license does not have this tag and icon then it cannot be rehosted.
It is important to note that moving a softkey will interrupt any FRED sessions currently connected to the softkey - you can use the ACC to check whether the softkey being moved has any active FRED sessions.
The general flow of moving a softkey from a host computer to the recipient computer is the following:
| 1. Generate a computer ID file on the recipient computer (.id file) |
| 2. On the host computer, use the recipient ID file to generate a "host-to-host" file (.h2h file, this removes the softkey from the host) |
| 3. On the recipient computer, apply the host-to-host file (this re-instantiates the softkey on the recipient) |
Two procedures for softkey rehosting are provided below, one procedure that uses the FRED interface on both the recipient and host computers, and a second procedure using the Sentinel ACC interface on the recipient computer. The end result of the license rehosting will be the same regardless of the procedure used.
IMPORTANT: We do not recommend rehosting a network softkey that has detached licenses. Cancel the license detachments, or wait until all detached licenses have expired and are returned to the host, before proceeding with the softkey rehosting.
Rehosting a softkey using FRED
| The following steps are performed on the recipient computer |
| 1. Start FRED. It does not need to be configured to access the Sentinel softkey being moved. |
| 2. If the License Search Strategy dialog does not automatically open, Navigate to Help > License Search Strategy. Press the "Sentinel Dialog" button. |
| 3. Select the "Recipient information for detach or rehost (.id)" option in the License Registration Actions section of the dialog. Use the "..." button in the "Create recipient information file (.id)" row to designate a custom output file name and location. If left unmodified, FRED will write the output .id file to the Desktop. |
| 4. Press the "Do Action" button in the License Registration Actions section of the dialog. Check that the Action Status portion of the dialog reports a successful generation of the file. Make the .id file accessible to the license manager of the host computer for the next steps. |
| The following steps are performed on the host computer |
| 5. Start FRED. |
| 6. If the License Search Strategy dialog does not automatically open, Navigate to Help > License Search Strategy. Press the "Sentinel Dialog" button. IMPORTANT - Ensure that the FRED session is NOT connected to the softkey being rehosted, which would cause the rehosting procedure to fail. It is generally necessary to change the FRED License Search Strategy configuration to make sure that the FRED session does not connect to the softkey being rehosted. This can be accomplished by configuring the FRED License Search Strategy as shown below and then closing and restarting FRED so that the changes take effect. |
| When restarting FRED after this step you should be faced with the License Search Strategy dialog (above) and can proceed to step 7. |
| 7. Select the "Rehost softkey (.h2h)" option in the License Registration Actions section of the dialog. |
| 8. Use the "..." button in the "Create rehost file (.h2h)" row to designate a custom output file name and location for the host-to-host file. If left unmodified, FRED will write the output .h2h file to the Desktop. |
| 9. Use the "..." button in the "Select recipient information file (.id)" row to browse to the recipient ID file generated from step 4 above. |
| 10. Use the "Key identifier" listbox to select the softkey intended to be moved from the host. |
| 11. Press the "Do Action" button in the License Registration Actions section of the dialog. A message will be presented indicating that proceeding with the current action will interrupt any FRED instances connected to the softkey being moved. Press OK to continue. Check that the Action Status portion of the dialog reports a successful generation of the file. Make the the output .h2h file accessible to the license manager of the recipient computer for the next steps. |
| 12. Though not required, you may check the Sentinel Keys page of the ACC on the host computer to confirm that the softkey is no longer present on the host computer. |
| The following steps are performed on the recipient computer |
| 13. In a FRED session, navigate to Help > License Search Strategy. Press the "Sentinel Dialog" button. |
| 14. Select the "Apply update (.v2c .h2h .r2h or .h2r)" option in the License Registration Actions section of the dialog. Use the "..." button in the "Select update (.v2c .h2h .r2h or .h2r)" row to open a file browser dialog allowing selection of the .h2h file generated in step 11 above. Note that in the file browser dialog there is a file extension filter on the bottom right of the dialog (default is "Update Files *.v2c") that can be changed to allow visibility of the desired file types. |
| 15. Press the "Do Action" button in the License Registration Actions section of the dialog. A message will be presented indicating that proceeding with the current action will interrupt any FRED instances connected to the softkey being moved. Press OK to continue. If the rehosting operation is successful, a message box will be presented indicating so. |
| 16. Open a web browser and navigate to the Sentinel Admin Control Center (ACC) at http://localhost:1947. Click on the Sentinel Keys link in the Options list on the left hand side of the webpage. Check to see that the rehosted license appears in the key list. |
Rehosting a softkey using the Sentinel Admin Control Center (ACC)
Due to limitations in the ACC capability (as of ACC version 7.103), rehosting a Sentinel softkey cannot be performed through the use of the ACC by itself. Specifically, generating the host-to-host file on the host computer requires the use of FRED as described below.
| The following steps are performed on the recipient computer using the ACC |
| 1. In a web browser, navigate to http://localhost:1947 to access the Sentinel Admin Control Center running on the recipient computer. |
| 2. Click on the Diagnostics link of the Options menu on the left hand side of the ACC. |
| 3. Press the "Create ID File" button on the far right hand side of the second row in the Diagnostics page. An *.id file will be saved by the web browser subject to your web browsers file download settings. Make the .id file accessible to the license manager of the host computer for the next steps. |
| The following steps are performed on the host computer using FRED |
| 4. Start FRED. |
| 5. If the License Search Strategy dialog does not automatically open, Navigate to Help > License Search Strategy. Press the "Sentinel Dialog" button. Ensure that the FRED session is NOT connected to the softkey being rehosted, which would cause the rehosting procedure to fail. If necessary, change the FRED License Search Strategy configuration to make sure that the FRED session does not connect to the softkey being rehosted. This can be accomplished by configuring the FRED License Search Strategy as shown below and then closing and restarting FRED so that the changes take effect.  |
| 6. Select the "Rehost softkey (.h2h)" option in the License Registration Actions section of the dialog. |
| 7. Use the "..." button in the "Create rehost file (.h2h)" row to designate a custom output file name and location for the host-to-host file. If left unmodified, FRED will write the output .h2h file to the Desktop. |
| 8. Use the "..." button in the "Select recipient information file (.id)" row to browse to the recipient ID file generated from step 4 above. |
| 9. Use the "Key identifier" listbox to select the softkey intended to be moved from the host. |
| 10. Press the "Do Action" button in the License Registration Actions section of the dialog. A message will be presented indicating that proceeding with the current action will interrupt any FRED instances connected to the softkey being moved. Press OK to continue. Check that the Action Status portion of the dialog reports a successful generation of the file. Make the the output .h2h file accessible to the license manager of the recipient computer for the next steps. |
| 11. Though not required, you may check the Sentinel Keys page of the ACC on the host computer to confirm that the softkey is no longer present on the host computer. |
| The following steps are performed on the recipient computer using the ACC |
| 12. In a web browser, navigate to http://localhost:1947 to access the Sentinel Admin Control Center running on the recipient computer. |
| 13. Click on the Update/Attach link of the Options menu on the left hand side of the ACC. |
| 14. Press the "Browse" button in the Apply File section of the page and browse to the .h2h file generated from step 10 above. The web interface will present a message indicating success or failure of the rehosting operation. |
| 15. Click on the "Sentinel Keys" link of the Options menu on the left hand side of the ACC. Confirm that the rehosted key is now available in the keys list. |