Running the Custom Reset Utility

Versions: 8.0+

QuerySurge has a license anti-tampering mechanism to periodically check the validity of your license. At times, possibly due to an abrupt shutdown or other similar event, the mechanism gets "out of synch".  When this occurs users will be alerted with either a License Padding Error

or a Keystore Access Error

To address either of these issues, users need to run the Custom Reset Utility.  The following steps describe the process:

1. Download the Custom Reset Utility ZIP file from one of the following links:
   for QuerySurge v 7 and lower
   for QuerySurge v 8.x - 9.1
   for QuerySurge v 9.2 - 10.2
   for Querysurge v 10.3+
   
   
2. Extract downloaded files - Note: It is recommended to place these files in the main QuerySurge folder
3. Open folder
4. Edit customResetTaskTool-x-x-x.xx
   • For Windows installations:
     • Edit the batch script (.bat file) - Items in bold may require updates depending upon extraction location of reset tool and QuerySurge installation directory
       (Note if you use a different directory than C:, please change appropriately)

       C:
       
       cd "C:\Program Files\QuerySurge"
       
       "C:\Program Files\QuerySurge\java\bin\java" -jar "C:\Program Files\QuerySurge\obf-customResetTasksTool-x.x.x.jar" installLicense --path "C:\Program Files\QuerySurge\tomcat" --override overridetoken@4AF3
       
       pause

     • Run the batch script (.bat file)- Please note all services must be up and running prior to execution and you must run as an administrator.
       
       
   • For Linux installations:
     • Edit the shell script (.sh file) - Items in bold may require updates depending upon QuerySurge installation directory
       

       /opt/QuerySurge/java/bin/java -jar obf-customResetTasksTool-x.x.x.jar installLicense --path /opt/QuerySurge/tomcat --override overridetoken@4CB2

       Note, sometimes Linux will not accept the override token and will generate an exception containing either "Option does not take a value; cannot use (overridetoken4CB2): [–override]" or "Violation: Install data already exists." To overcome this issue, add quotes around the token:
       

       /opt/QuerySurge/java/bin/java -jar obf-customResetTasksTool-x.x.x.jar installLicense --path /opt/QuerySurge/tomcat --override "overridetoken@4CB2"

     • Run the shell script (.sh file) - Please note all services must be up and running prior to execution and you must run as an administrator.
5. Try to log into QuerySurge