Red Hat SummitEste contenido no está disponible en el idioma seleccionado.
10.2. Patching Process
Red Hat JBoss Data Virtualization 6.3 and greater uses fuse-patch’s patch application system.
Previous versions of Red Hat JBoss Data Virtualization used other patch systems (Red Hat JBoss EAP’s for DV 6.2 and 6.1). EAP receives updates more quickly than Red Hat JBoss Data Virtualization. To ensure users can receive server patches more quickly, there are now concurrent and separate EAP and DV streams.
To patch EAP, read these instructions: https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html-single/Installation_Guide/#chap-Patching_and_Upgrading_JBoss_EAP_6
The self-executing jar patch distro-format can be executed in the same manner as the installer jar.
Red Hat JBoss Data Virtualization’s patch jars include the packages for all 6.3 and 6.4 versions up to the current release. This also enables a form of rollback, in that the package can be downgraded by re-installing the prior version.
Help text is provided by the jar when an argument is incorrect/unrecognised, or the --help switch is provided.
Important
Note that you will need at least 4 GB available in your tmp directory to apply patches.
Procedure 10.2. Upgrading
- Ensure the server is shut down.
- To update to the latest version contained in the jar’s repository, run these commands:
java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --update jboss-dv
$ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server jboss-dv-6.4.x $ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --update jboss-dv INFO - Upgrade from jboss-dv-6.4.0 to jboss-dv-6.4.xCopy to Clipboard Copied! Toggle word wrap Toggle overflow Alternatively, you can manually specify the version using these commands:java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --install jboss-dv-6.4.x
$ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server jboss-dv-6.4.0 $ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --install jboss-dv-6.4.x INFO - Upgrade from jboss-dv-6.4.0 to jboss-dv-6.4.xCopy to Clipboard Copied! Toggle word wrap Toggle overflow Note
The --server argument is optional. If it is not specified, the JBOSS_HOME environment variable, and then the current/working directory will be tried. A basic test will be undertaken to make sure the directory appears to be the server root, otherwise an error will be returned.
Procedure 10.3. Downgrading
- Ensure the server is shut down.
- Roll back by specifying a version lower than the current version as the install argument’s value:
java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --install jboss-dv-6.4.0
$ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server jboss-dv-6.4.x $ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --install jboss-dv-6.4.0 INFO - Downgrade from jboss-dv-6.4.x to jboss-dv-6.4.0Copy to Clipboard Copied! Toggle word wrap Toggle overflow
If you encounter an error during the upgrade process, you will see a message like this:
In this situation, you can revert the changes. To do so, run this command:
java -jar [path]/63-patching/jboss-dv-6.4.x-patch.jar --server dist/ --update jboss-dv --force
$ java -jar [path]/63-patching/jboss-dv-6.4.x-patch.jar --server dist/ --update jboss-dv --force
INFO - Upgrade from jboss-dv-6.4.0 to jboss-dv-6.4.x
WARN - Overriding an already modified file: dataVirtualization/vdb/teiid-odata.war
WARN - Overriding an already modified file: modules/system/layers/dv/org/jboss/teiid/api/main/teiid-api-8.12.5.redhat-7.jar
Warning
An uninstall command is available, but Red Hat advises against using it. Running it will remove all files associated with the package name, not just that particular version. This is not a downgrade/rollback command (use install for that, as described above).
If you run this command accidentally, running "install" or "update" should put the files back into place.
Here are some miscellaneous commands:
To see the contents of the patch repository, run this command:
java -jar /path/to/jboss-dv-6.4.x-patch.jar --query-repository
$ java -jar /path/to/jboss-dv-6.4.x-patch.jar --query-repository
jboss-dv-6.4.0
jboss-dv-6.4.x
This command lets you see the current packages on the server:
java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server
$ java -jar /path/to/jboss-dv-6.4.x-patch.jar --server some-server/ --query-server
jboss-dv-6.4.x
This shows you the paths owned by the currently installed package:
The argument value allows you to filter based on the the prefix of the paths. Passing an empty string ('' or "" in most shells) will return all paths (unfiltered).
You can also view an audit log of previous actions using this command:
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}