How to invalidate the Information Link Cache using JMX and JConsole Java utility.

This is the procedure to enable up JMX monitoring and invalidating IL cache using JMX and JConsole Java utility.

Step 1: Enable JMX monitoring of the TIBCO Spotfire Server if not enabled before.

-------------------------------------------------------------------------------------------------------------

a). Open a command prompt or shell prompt and browse to the "<TSS installation folder>\tomcat\bin" bin folder.

b). Use the following command to export the currently running/active config from DB to configuration.xml file. Enter tool password when asked.

    config.bat export-config -f     

c). Run the config-jmx command to enable JMX.

    config.bat config-jmx --enabled=true

d). Import the configuration into the database.

    config.bat import-config --comment=”Enabled JMX”

e). Create a JMX user. 

    config.bat create-jmx-user --username="MyJMXUser" --password="MyJMXPassword" --access-level=rw

f).  Restart TIBCO Spotfire Server service to apply the modification.

--------------------------------------------------------------------------------------------------------------

Note: Replace config.bat with config.sh for UNIX/LINUX SHELL Prompt.


Step 2: Use JConsole to monitor server through MBeans and invalidate IL cache.

---------------------------------------------

a). Launch the JConsole application. In a default TSS installation: <TSS installation folder>\jdk\bin\jconsole.exe.

    Note: JConsole requires a Graphical DISPLAY. In a UNIX/LINUX environment, export the DISPALY to a X11 client system before running JConsole . 
    Note: JDK Tools such as JConsole, JVisulavm and jstat are not available in Spotfire server 7.0 and later. So to use JConsole in Spotfire server 7.0 and later, refer below KB article :
             https://support.tibco.com/s/article/Tibco-KnowledgeArticle-Article-44379

b). In the JConsole New Connection dialog, select Remote Process, enter the <hostname>:1099, and provide the JMX user name and password created earlier.

c). In the JConsole window, go to the MBeans tab. Expand 'com.spotfire.server' MBean group from the left hand side MBean list.

d). Expand InformationLinkCache and select Operations.

e). Use invalidate to invalidate any specific Information Link cache by providing the GUID of the IL in the input box.

f).  Use invalidateAll to invalidate all current IL cache on the server. Refer to the attached image (Filename: InvalidateILCache.jpg).

---------------------------------------------

Using JConsole: http://docs.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html