Red Hat Knowledgebase

If a new TPS server is brought online, any existing TPS tokens will continue to use the server that their smart cards were registered against. There is no tool for modifying the TPS server information, but you can manually modify the information and reuse the Smart Card.

IMPORTANT: A card format does not remove this information. Once the ESC Client application is started, the data is read from the token and cached in a local file.

If the Client OS is Red Hat Enterprise Linux, then modify the information by the following:

1. Shutdown ESC cleanly. Use the exit option from the menu. (IMPORTANT)
2. Now edit ~/.redhat/esc/<profile-name>/prefs.js

   For tokens that ESC has already seen (user has performed previous format/enroll operations), edit prefs.js to update the following lines with the URL for the desired TPS instance.

   [Example]:
   
   user_pref("Operation-40900062xxxxxx","http://tpsexample.redhat.com:7888/nk_service");
   user_pref("UI-40900062xxxxxx",http://tpsexample.redhat.com:7888/cgi-bin/enroll.cgi");
   user_pref("keyIssuer-40900062xxxxxx", "Red Hat Inc");
   user_pref("keyIssuerUrl-40900062xxxxxx","http://tpsexample.redhat.com:7888/cgi-bin/home.cgi");
   

NOTE: 40900062xxxxxx is the token CUID for this example. Determine the CUID from an existing prefs.js file that is associated with the token that he is attempting to re-enroll.

NOTE 2: It is very important the ESC application is closed before making changes. Otherwise, the changes will be lost the next time ESC is restarted.

If the Client OS is Windows (This was done on XP, but its the same for W2k and newer), then ESC preferences are per-user so the location of the prefs.js file is C:\Documents and Settings\<user>\Application Data\RedHat\ESC\Profiles\*.default.

Here is the format of the file:

# Mozilla User Preferences

/* Do not edit this file.
*
* If you make changes to this file while the application is running,
* the changes will be overwritten when the application exits.
*
* To make a manual change to preferences, you can visit the URL about:config
* For more information, see http://www.mozilla.org/unix/customizing.html#prefs
*/

user_pref("app.update.lastUpdateTime.background-update-timer", 1179609053);
user_pref("esc.ignore.token.browser.url", "no");
user_pref("keyIssuerUrl-40900062ffxxxxxxxxxx", "http://tpsexample.redhat.com:7888/cgi-bin/home/index.cgi");

The last line is the one that should be edited to reflect your desired TPS server. Again, make sure that the ESC application is closed before you make the change.