Chapter 2. Product Changes
2.1. Library Mode Configuration Update
The XML schema for Library mode configurations has been changed to be more consistent with the remote client-server schema. This results in several changes that must be made to the configuration file.
To assist in these configurations a tool is provided in the library distribution. The following steps discuss using this tool to automatically convert existing infinispan configuration files to the latest supported schema.
Procedure 2.1. Windows Instructions for Using the Library Mode Configuration Converter
- Open a command prompt.
- Navigate to the
bin\directory of the library distribution:cd C:\path\to\jboss-datagrid-${jdg-version}-library\bin\ - If any custom classes were referenced in the original configuration then the .jar files containing these classes must be placed in the
C:\path\to\jboss-datagrid-${jdg-version}-library\directory. If no custom classes were referenced then this step may be skipped. - Execute the
config-converter.batutility, passing in the name of the existinginfinispan_6.0.xmlconfiguration file and the destination as arguments:config-converter C:\path\to\infinispan_6.0.xml C:\path\to\infinispan-new.xml
- Ensure that
infinispan-new.xmlhas been created with the new Library mode configurations. This file may now be used in Library mode applications with JBoss Data Grid 7.0.
Procedure 2.2. Linux Instructions for Using the Library Mode Configuration Converter
- Open a console to execute the following commands.
- Navigate to the
bin/directory of the library distribution:cd /path/to/jboss-datagrid-${jdg-version}-library/bin/ - If any custom classes were referenced in the original configuration then the .jar files containing these classes must be placed in the
/path/to/jboss-datagrid-${jdg-version}-library/directory. If no custom classes were referenced then this step may be skipped. - Execute the
config-converter.shutility, passing in the name of the existinginfinispan_6.0.xmlconfiguration file and the destination as arguments:./config-converter.sh /path/to/infinispan_6.0.xml /path/to/infinispan-new.xml
- Ensure that
infinispan-new.xmlhas been created with the new Library mode configurations. This file may now be used in Library mode applications with JBoss Data Grid 7.0.
Note
If no destination file is specified, such as
infinispan-new.xml in the above examples, the utility will instead display the converted xml to the console.
