Hi everyone, hope you’re doing well.
This blog post is to announce that AutoUpgrade Composer has been updated to v.26.3-2.
This is what I have changed:
Reverted FOLDER parameter
If you read my previous blog post, you know that in AutoUpgrade 26.3, the parameter FOLDER is deprecated and a new parameter has been introduced: DOWNLOAD_FOLDER.
Rodrigo Jorge was talking to me earlier today and mentioned that it would be good to keep the FOLDER parameter in the Composer, at least for some more time (maybe two more updates on AutoUpgrade).
Why?
His point is valid: if someone uses the Composer to build a configuration file, it will build the file using DOWNLOAD_FOLDER. However, if the DBA is still using a version lower than 26.3, the parameter DOWNLOAD_FOLDER will not exist, only the FOLDER parameter. If you try to run a configuration file with DOWNLOAD_FOLDER in a version lower than 26.3, you will get an error:
java -jar autoupgrade.jar -config d1.cfg -patch -mode download AutoUpgrade Patching 26.2.260205 launched with default internal options Processing config file ... patch1 Overridable parameter, patch1.folder, has no value defined in the user configuration file. Set it within the global or local scope to proceed
So, following Rodrigo’s recommendation, I will keep the parameter as FOLDER for now. As you can see below:
If you create a configuration file manually using DOWNLOAD_FOLDER and use Composer to validate it, Composer will recognize that the parameter is valid, but will silently change it to FOLDER when loading the configuration file:
global.global_log_dir=/home/oracle/autoupgrade/log
patch1.log_dir=/home/oracle/autoupgrade/log/DB1
patch1.download_folder=/home/oracle/autoupgrade/patches
patch1.patch=RU
patch1.target_version=19
patch1.source_home=/u01/app/oracle/product/19.15/dbhome_1
patch1.target_home=/u01/app/oracle/product/19.30/dbhome_1
patch1.home_settings.edition=ee
patch1.home_settings.oracle_base=/u01/app/oracle
See below:
TOOLS
On the other hand, I will keep TOOLS in AutoUpgrade Composer. But be advised that TOOLS, AHF and CVU are only available to be downloaded through AutoUpgrade from version 26.3 onwards.
If you try to use TOOLS in your configuration file in a version lower than 26.3, you will also get an error:
java -jar autoupgrade.jar -config d1.cfg -patch -mode download AutoUpgrade Patching 26.2.260205 launched with default internal options Processing config file ... The following errors were found in the configuration file: The patch parameter for prefix patch1 includes a value that is not supported or is not in the required format
If you go to Composer, you will notice something like this:
Hope it helps.
Peace.
Vinicius
