19.10. Custom Cache Stores

Procedure 19.8. Deploy Custom Cache Store .jar file to JDG server using deployments

1. Add the following Java service loader file META-INF/services/org.infinispan.persistence.spi.AdvancedLoadWriteStore to the module and add a reference to the Custom Cache Store Class, such as seen below:

   my.package.CustomCacheStore

   Copy to Clipboard Toggle word wrap
2. Copy the jar to the $JDG_HOME/standalone/deployments/ directory.
3. If the .jar file is available the server the following message will be displayed in the logs:

   JBAS010287: Registering Deployed Cache Store service for store 'my.package.CustomCacheStore'

   Copy to Clipboard Toggle word wrap
4. In the infinispan-core subsystem add an entry for the cache inside a cache-container, specifying the class that overrides one of the interfaces from Section 19.10, “Custom Cache Stores”:

   <subsystem xmlns="urn:infinispan:server:core:8.3">
     [...]
     <distributed-cache name="cacheStore" mode="SYNC" segments="20" owners="2" remote-timeout="30000"">
       <store class="my.package.CustomCacheStore">
         <!-- If custom properties are included these may be specified as below -->
         <property name="customStoreProperty">10</property>
       </store>
     </distributed-cache>
     [...]
   </subsystem>

   Copy to Clipboard Toggle word wrap

Procedure 19.9. Deploying Custom Cache Store .jar file to JDG server using the CLI

1. Connect to the JDG server by running the below command:

   [$JDG_HOME] $ bin/cli.sh --connect --controller=$IP:$PORT

   Copy to Clipboard Toggle word wrap
2. Deploy the .jar file by executing the following command:

   deploy /path/to/artifact.jar

   Copy to Clipboard Toggle word wrap

Procedure 19.10.  Deploying Custom Cache Store .jar file to JDG server using JBoss Operation Network

1. Log into JON.
2. Navigate to Bundles along the upper bar.
3. Click the New button and choose the Recipe radio button.
4. Insert a deployment bundle file content that references the store, similar to the following example:

   <?xml version="1.0"?>
   <project name="cc-bundle" default="main" xmlns:rhq="antlib:org.rhq.bundle">
    
     <rhq:bundle name="Mongo DB Custom Cache Store" version="1.0" description="Custom Cache Store">
     	<rhq:deployment-unit name="JDG" compliance="full">
     	  <rhq:file name="custom-store.jar"/>
     	</rhq:deployment-unit>
     </rhq:bundle>
   
     <target name="main" />
       
   </project>

   Copy to Clipboard Toggle word wrap
5. Proceed with Next button to Bundle Groups configuration wizard page and proceed with Next button once again.
6. Locate custom cache store .jar file using file uploader and Upload the file.
7. Proceed with Next button to Summary configuration wizard page. Proceed with Finish button in order to finish bundle configuration.
8. Navigate back to the Bundles tab along the upper bar.
9. Select the newly created bundle and click Deploy button.
10. Enter Destination Name and choose the proper Resource Group; this group should only consist of JDG servers.
11. Choose Install Directory from Base Location's radio box group.
12. Enter /standalone/deployments in Deployment Directory text field below.
13. Proceed with the wizard using the default options.
14. Validate the deployment using the following command on the server's host:

    find $JDG_HOME -name "custom-store.jar"

    Copy to Clipboard Toggle word wrap
15. Confirm the bundle has been installed in $JDG_HOME/standalone/deployments.