How do I offload Realtime Accumulators from Chronicall onto the Realtime Node?

Reasoning

Whether due to the JRE crash or simply wanting to be less taxing on the Chronicall server, some clients will want to offload some(or all) of their Realtime accumulators onto a separate node.

Steps

1. Update:
   
   • Update Chronicall to 3.12.0 or later
     
     
2. Configure Chronicall
   
   1. Open up Chronicall and configure the new Realtime Node
      
      
   2. Go to Admin (System) > System Settings
      
      
      
      
   3. Open Advanced Settings and go to the ellipses for Realtime Nodes
      
      
      
      
   4. With Realtime Nodes opened, if you want to completely offload all accumulators from the ChronicallServer service onto the Realtime node you can go ahead and un-check the Track Realtime Metrics box. This is found in the Chronicall Server section at the top. (If this box is left checked, Realtime accumulators will be shared between Chronicall and the Realtime Node)
      
      
      
      
   5. Whether offloading completely or not, go ahead and change Do Not Scale to Scale Manually.
      
      
   6. Next, input the IP Address of where the Realtime Node is going to be located into the Local Access Point line (Do NOT use 127.0.0.1 even if it will be on the same server as Chronicall).
      
      
      
      
   7. As long as the Realtime Node is being installed on a separate server than the Chronicall server you should be able to leave the Node Registration Port alone.
      
      
   8. If the node will be installed on the same server as Chronicall then you will need to change the Node Registration Port to a different one to avoid port conflicts (Typically 9094 will work as it is no longer being used by Multimedia. Do NOT use 9093 as that is the default File Transfer Port).
      
      
   9. At this point, it is a good idea to ensure that all configured ports are open on both servers as anyone opening a Realtime or Desktop interface will need to have access to the Chronicall Server and the Realtime nodes.
      
      
   10. *Note* If they are going to have remote users, the Remote Access Point needs to be publicly accessible and must be port forwarded to the local access point. The Chronicall Server has a similar setting but that is configured elsewhere.
        
   11. Take a screenshot of the Realtime Node configuration or make note of it, as you will need this information for the installation of the Realtime Node.
       
       
   12. After configuration, go ahead and save your changes in Chronicall but do not restart the ChronicallServer service just yet.
       
       
   13. Install the Realtime Node following the same instructions as the Data Grid Node installer but install the Realtime Node instead.
       
       
   14. Lastly, while you can install as many Realtime Nodes as you like, you can only install ONE Realtime Node per server (including one on the Chronicall Server).
       
       
3. Setup
   1. During installation input the same information from the Realtime Node configuration (Node Registration Port = Cluster Registration Port, Node Port = Local Access Point Port)
      
      
      
      
   2. This configuration is important as the Realtime Node does not pull any settings from Chronicall, the settings in Chronicall just tell it where to find the Realtime Node. 
      
      
   3. Ideally, you would set the port you want the Realtime Node to use during installation, but you can always change it in the node properties file later. This is typically found in the C:\Program Files\Chronicall\realtime node folder. (You can also reference the Note at the bottom of this guide if you need to change the IP Address)
      
      
      
      
      
      
4. Finalization
   1. Once the installation is complete go ahead and restart the ChronicallServer service
      
      
   2. After service restart, you can verify that the Accumulators are offloading properly by navigating to http://localhost:9080/diag on the server and opening up the Realtime Debug
      
      
      
      
   3. With that open, you should see both of your Realtime nodes at the top, Node 0 (Chronicall) and Node 1 (Realtime Node)
      
      
      
      
   4. If you elected to completely offload the accumulators then your Realtime Diag should look like this instead:
      
      
      (You will notice that there are still Objects Sent to Node 0, but that the Accumulators are gone from it and completely onto Node 1.)
      
      
   5. If your Realtime Debug does not look like either of these screens then you will want to double check your ports are configured and opened, the Realtime Node properties file matches your settings, and check the tomcat/node logs for any errors.
      

       

Note: Changing the IP Address for the Node

1. If you have to change your IP address for the Realtime Node for any reason, adjust it in the Realtime Nodes menu, and the Node Properties file (As outlined in step 3.3).
   
   
2. After that, you will also need to adjust the Ddocumentbase setting in the ChronicallRealtimeNodeW Java menu. 
   
   
3. This can be found in the Chronicall\realtime node\bin\app folder. Make sure to run the application as an Administrator.
   
   
   
   
4. Go to the Java menu and adjust the IP Address that the Ddocumentbase is pointed towards.