Salesforce

What is the purpose of the proupdt utility ?

« Go Back

Information

 
TitleWhat is the purpose of the proupdt utility ?
URL NameP40614
Article Number000138952
EnvironmentProduct: Progress
Version: 7.x, 8.x, 9.x

Product: OpenEdge
Version: All supported versions

OS: All supported platforms
Question/Problem Description
What is the purpose of the proupdt utility 
What is the purpose of the License Update tool setup.exe -u 
What causes the error "INSTALLATION ERROR (133): Product not installed. Unable to update product"
What causes the error "INSTALLATION ERROR (146): Serial number did not match"
Can License Update be used to add an additional License to an existing installation.
Can Proupdt be used to add an additional package to an existing installation.
Can Proupdt be run to exchange the Serial Number on the installed product.
Can the serial number from one Progress product version be used by the 'proupdt' utility to increase the user count of the same product using a different version?
How to update the user count?
How do I update my user count on a Windows operating platform?
What is the "License Update" option used for?
How to update the user count for Progress on UNIX
How to update the Progress user license on the UNIX operating system
How to update an expired product license
Steps to Reproduce
Clarifying Information
Error MessageINSTALLATION ERROR (133): Product not installed. Unable to update product
INSTALLATION ERROR (146): Serial number did not match

Adding new license on the existing installation using proupdt will show following error:
Error in serial or control numbers, Product not installed. Unable to update product list.
Defect Number
Enhancement Number
Cause
Resolution
The License Update / PROUPDT utility:

The UNIX proupdt utility (Windows this is License Update (%DLC%\setup.exe -u)) can be used to:
  • Update the license counts and extend expiration dates on installed licenses.  
  • Since OpenEdge 11 the License Update utility can be used to remove specific installed licenses without having to run a complete uninstall and re-install. Refer to Article  How to uninstall one OpenEdge product from a multi-product installation. 
  • Effectively there's no 'install', it's simply a process whereby the 'license information' aka DLC/progress.cfg is updated.
  • Unlike the install utility (when adding new licenses), proupdt can be run while Brokers and/or sessions for the component are running. However, the change in license will not take effect until the Broker is next restarted (where it reads the changes in the updated progress.cfg)

The proupdt utility cannot be used to:
Starting from 10.1A onward:

Since OE 10.1A, the "License Update" (proupdt) will update the user count (or expiry date or evaluation license to full license) of an existing installed license file (progress.cfg) when the Serial Number is the same or different. As long as it is:
a. The same License viz not WorkGroup vs Enterprise
b. The same OpenEdge version viz same major minor version
c. The same Operating System License viz same OS and bit version of the OpenEdge license

In prior releases, the update process would not accept different Serial Numbers; you had to uninstall an existing license and then install the newer product license.

This new update process can be used to:
  • Change the user count on an existing license using a serial number that is different from the installed serial number.
  • Update licenses obtained through either the product evaluation process or PSDN subscription renewal process by simply entering a new, different product serial number during the installation process to automatically update the current license data in the progress.cfg.
For example, since OpenEdge 10.1A in order to update an evaluation license to a commercial release (non-evaluation license), you no longer have to first uninstall the evaluation license and then install the non-evaluation license; you can simply perform the procedure to update the License using the License Update utility, entering your new valid serial and control codes.

The proupdt / License Update utility cannot be used to add a new product license, this requires an install using the setup executable from downloaded installation media in order to add the new license to the progress.cfg and associated environment tailoring to allow the license to run.

Prior to OpenEdge 10.1A 

The proupdt utility cannot be used to replace one license with another for the same product when the serial numbers are not the same.
For the proupdt utility to work, the new set of license keys (serial number and control codes) must have the same serial number as the old set. The control codes will be different.

If the serial numbers are different, the new license keys will be seen as an entirely new license and proupdt will not work. This is common in case of upgrading to a new Progress release (9.1D to 9.1E for example), or when changing components (Upgrading Workgroup to Enterprise database). Which results in: INSTALLATION ERROR (146): Serial number did not match

In this case, the new license need to be added to the existing installation using the proinst utility (Unix) or Setup.exe (Windows) from the original installation media. Use the same installation directory as the existing license to add the new components. Also, re-apply the installed service packs after installing a new component to ensure no outdated files are re-installed.

In the case of WebSpeed Transaction Server, when you go from a 5 or 25 user count that is found on the basic server to a 50 or 250 user count there is a change in the product to the enterprise version.  The only way to get this increase in the user count is to install the Enterprise product, as a separate product being added to the existing installation, since it is considered a different product at installation time.

Process for using proupdt utility:
For OpenEdge 12.2, refer to the following documentation for more detailed steps:
https://docs.progress.com/bundle/openedge-install-122/page/Update-existing-product-licenses.html

For OpenEdge 12.8 and later releases, refer to the following documentation for more detailed steps:
https://docs.progress.com/bundle/openedge-install/page/Update-existing-product-licenses.html

On Windows
Start the License Update tool by running the "License Update" option from within the Progress program group in the Start menu.
- OR-
From a cmd prompt run:
%DLC%\bin\proenv.bat
%DLC%\SETUP.EXE -u

 
Follow the dialogue to enter serial number(s) and control code(s)


On UNIX:
0. su root and open a proenv shell
1. cd $DLC
2. At the system prompt, type ./proupdt and press RETURN.
3. Enter your company name, existing serial number and control numbers when prompted. Enter, Enter, CTRL-E to finish.
Workaround
Notes
Keyword Phrase
Last Modified Date8/13/2024 4:01 PM

Powered by