Like what you see? Have a play with our trial version.

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleModifications to web.xml for DYNAMIC mode

The following servlet definition needs to be added to the web.xml on each node:

 

Code Block
languagexml
 
<!-- Cluster Management -->
<servlet>
       <servlet-name>ClusterManagement</servlet-name> 
       <servlet-class>com.hof.mi.servlet.ClusterManagement</servlet-class> 
       <init-param> 
             <param-name>ClusterType</param-name> 
             <param-value>DYNAMIC</param-value> 
       </init-param> 
       <init-param> 
             <param-name>SerialiseWebserviceSessions</param-name> 
             <param-value>true</param-value> 
       </init-param> 
       <init-param> 
             <param-name>CheckSumRows</param-name>
             <param-value>true</param-value> 
       </init-param> 
       <init-param> 
             <param-name>EncryptSessionId</param-name> 
             <param-value>true</param-value> 
       </init-param> 
       <init-param> 
             <param-name>EncryptSessionData</param-name> 
             <param-value>true</param-value> 
       </init-param>
<init-param> 
             <param-name>AutoTaskDelegation</param-name> 
             <param-value>true</param-value> 
       </init-param>
       <load-on-startup>11</load-on-startup> 
 </servlet>



 

 

 

 

 

 

Multicast with Repository Discovery (REPOSITORY mode)

...

Expand
titleModifications to web.xml for REPOSITORY mode

 

 The following servlet definition needs to be added to the web.xml on each node:

 

Code Block
languagexml
 
<!-- Cluster Management -->
<servlet>
     

<servlet>
       <servlet-name>ClusterManagement</servlet-name>

     
 
       <servlet-class>com.hof.mi.servlet.ClusterManagement</servlet-class>

     
 
       <init-param>

           
 
             <param-name>ClusterType</param-name>

           
 
             <param-value>REPOSITORY</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>SerialiseWebserviceSessions</param-name>

            <param-value>true</param-value>
     
 
             <param-value>true</param-value> 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>CheckSumRows</param-name>

           

             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>EncryptSessionId</param-name>

           
 
             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>EncryptSessionData</param-name>

           
 
             <param-value>true</param-value>

     
 
       </init-param>

<init-param>

            <param-name>AutoTaskDelegation</param-name>
           
 
             <param-name>AutoTaskDelegation</param-name> 
             <param-value>true</param-value>

     
 
       </init-param>

     

       <load-on-startup>11</load-on-startup>

 
 </servlet>




 

 

 

Web Service Cluster Messaging (LEGACY mode)

...

Expand
titleModifications to web.xml for LEGACY mode

 

The following servlet definition needs to be added to the web.xml on each node:

 

Code Block
languagexml
 
<!-- Cluster Management -->
<servlet>
     

<servlet>
       <servlet-name>ClusterManagement</servlet-name>

     
 
       <servlet-class>com.hof.mi.servlet.ClusterManagement</servlet-class>

     
 
       <init-param>

           
 
             <param-name>ServiceUser</param-name>

            <param-value>admin@yellowfin.com.
 
             <param-value>admin@yellowfin.com.au</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>ServicePassword</param-name>

           
 
             <param-value>test</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>ServiceAddress</param-name>

           
 
             <param-value>/services/AdministrationService</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>ServicePort</param-name>

           
 
             <param-value>80</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>ClusterHosts</param-name>

            <param-value>
                 
 
             <param-value> 
                   192.168.4.184

           
 
             </param-value>

     
 
       </init-param>

      <init-param>
           
 
       <init-param> 
             <param-name>SerialiseWebserviceSessions</param-name>

           
 
             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>CheckSumRows</param-name>

           

             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <init-param>

            <param-name>EncryptSessionId</param-name>
           
 
             <param-name>EncryptSessionId</param-name> 
             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <init-param>

           
 
             <param-name>EncryptSessionData</param-name>

           
 
             <param-value>true</param-value>

     
 
       </init-param>

     
 
       <load-on-startup>11</load-on-startup>

 
 </servlet>




 

 

 

Web.xml File Parameters

...

Disable the background system tasks by removing (or commenting-out) the following XML block from the web.xml. This will disable system tasks, like Group Flattening, LDAP synchronization, Event Archiving, Document Cleanup and Average Run time calculations.

 

...

Code Block
languagexml
 
<servlet> 
      <servlet-name>SystemTaskManager</servlet-name>

...

 
      <servlet-class>com.hof.servlet.SystemTaskManager</servlet

...

-class> 
      <load-on-startup>8</load-on-startup>

...

 
</servlet>
 

 

Task Scheduler

Disable the task scheduler by adding the following to the web.xml file, inside the MIStartup Servlet block.

This will disable all tasks visible in the Task Schedule menu within the Yellowfin interface. This includes broadcasting, populating cached filters, scheduled reports and populating cached views.

 

Code Block
languagexml
 
<init-param>

...

 
        <param-name>DisableTaskScheduler</param-name>

...

 
        <param-value>TRUE</param-value>

...

 
</init-param>
 

 

 

Dynamic Delegation

In DYNAMIC and REPOSITORY modes, delegation of background tasks can be done dynamically. If a node running background tasks fails, tasks will be delegated to another node.

 

...

Code Block
languagexml
 
<init-param> 
        <param-name>AutoTaskDelegation</param-name>

...

 
        <param-value>TRUE</param-value>

...

 
</init-param>
 

 

 

Container Level Session Replication

...

The text “<distributable/>” needs to be added to the web.xml file on each node underneath the “<webapp>” line.

 

Code Block
languagexml
 
<web-app>

...


      <distributable/>

...


      <!-- System Event and Debug classes -->

...


      <listener> 
            <listener-class>com.hof.servlet.SysSessionListener</listener-class>

...

 
      </listener>

...

 
 

 

 

Modifications to server.xml

Changes need to be made to the server.xml file in the Yellowfin/appserver/conf directory.

Add the additional XML entry within the “<host>” XML block.

 

Add:

 <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

 

The IP address “228.0.0.4” is a multicast address that session replication messages will be received on. This does not need to be modified, but a linux/unix server may need to register a valid multicast route to receive broadcasts on this address. This can be done by running the following command on the console:

sudo route add -net 224.0.0.0 netmask 224.0.0.0 dev eth0

 

This syntax may be different for different flavours of linux / unix. This example uses “eth0” as the network device that will be used for this route.

...

Remove the lines from the ROOT.xml in the Yellowfin/appserver/conf/Catalina/localhost directory:

 

Code Block
languagexml
 
<Manager className="org.apache.catalina.session.PersistentManager" debug="0" distributable="false" saveOnRestart="false">

...

 
      <Store className="org.apache.catalina.session.FileStore" />

...

 
</Manager>

...


 



These lines were previously added to suppress session serialisation to disk in Yellowfin.

...