Question & Answer
Question
Why am I getting the following error in my engine logs: "AddressDoctorException: -1601: Critical error: the engine usage period has expired"?
Cause
This error is caused by the expiration of the Address Doctor license.
Answer
The Address Doctor license is usually valid for one year. Normally a new license is sent 30 days prior to the expiration of the license. If you are seeing this error and you have not received your new license you will need to submit a Service Request immediately.
If you have received your licence please use the following steps to activate the new license.
- Run the following query “select * from mpi_handler”.
- The Address Doctor license key is stored in the HANDLERARGS field.
- In workbench open your project. Make sure you are in the "Configuration" perspective
- Choose the Handlers icon
- In the "Handlers Arguments" column you will see the Address Doctor Key. The record begins with the word unlockCode, copy the field in notepad in order to update the license key.
- EXAMPLE: unlockCode=AB1CDEFG23HIJKL4M5NOPQRS678T^dbPath=/initiate/software/postal
- AB1CDEFG23HIJKL4M5NOPQRS678T is the licence key
- Remove the old key and insert the new ken in the "Handler Argument" column.
- Save the changes you made.
- Select the "Deploy Handlers" under the "Initiate" option.
- Once the Handlers have been deployed run the following query “select * from mpi_handler”. You should now see the new licence key.
- Monitor your engine logs for the next 30 minutes to verify that the new key is working.
If you continue to see license key errors please submit a Service Request immediately.
[{"Product":{"code":"SSLVY3","label":"Initiate Master Data Service"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Not Applicable","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.5.0;8.7.0;9.0.0;9.2.0;9.5.0;9.7.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21516919