Skip to Content
author's profile photo Former Member
Former Member - What is it used for?

Hello Folks,

BO Admin guide says, in a cluster environment, we have to configure the cluster name in the SIA properties, and modify the file to make the cluster work.

I tried to not give a cluster name, and do nothing to the file, seems the cluster is still working fine?

Do you know what is the file used for? How about the cluster name?

Best Regards,


Add a comment
10|10000 characters needed characters exceeded

Related questions

2 Answers

  • Best Answer
    author's profile photo Former Member
    Former Member
    Posted on Sep 05, 2013 at 05:07 AM

    Eventhough if you didn't give the cluster name. it will still work with the existing CMS name.

    Please check the below document for the defining the cluster name

    below is the content of the above url. Let me know if you need any additional details.

    change the cluster name on Windows:

    Use the CCM to stop any SIA that is a member of the cluster.

    Click SIA Properties on the toolbar.

    Click the Configuration tab.

    Select the Change Cluster Name to check box.

    Type the new name for the cluster.

    But the cluster name is prefixed by the @ symbol.

    For instance, if your existing CMS is called PROD1, then the default cluster name is @BI-PROD

    Click OK and then start the Central Management Server.

    The CMS cluster name is now changed. All other CMS cluster members are dynamically notified of the new cluster name (although it may take several minutes for your changes to propagate across cluster members).

    Go to the Servers management area of the CMC and check that all of your servers remain enabled. If necessary, enable any servers that have been disabled by your changes

    Update Cluster Name in Web Applications:

    Cluster name is defined in the BO, now we have to update the same in the Business Intelligence 4.0 web applications (Netweaver, Websphere, Tomcat, Weblogic, JBOSS)

    If you have added additional CMSs to your deployment, and you are using a Java application server, you must modify the file in the webapps/BOE/WEB-INF/config/custom directory of your web application deployment.

    To define cluster properties for the BOE web application :

    1.Access the custom folder for the BOE.war file on the computer hosting the web applications.
    If you are using the Tomcat web application server installed with SAP BusinessObjects Business Intelligence platform, you can access the following folder:

    C:Program Files (x86)/SAP BusinessObjects/Tomcat6/webapps/BOE/WEB-INF/config/custom


    If you are using a web application server that does not enable direct access to the deployed web applications, you can use the following folder in your product installation to modify the BOE.war file.

    <INSTALLDIR>SAP BusinessObjects /Business Intelligence platform 4.0/warfiles/webapps/BOE/WEB-INF/config/custom.

    You will have to later redeploy the modified BOE.war file.

    2.Create a new file.Use Notepad or any other text editing utility.
    3. Specify CMC cluster properties for each cluster in your deployment.
    Precede each cluster name with an @ symbol, and separate each CMS name with a comma (,).
    The port number is separated from the CMS name with a colon (:). The port number is assumed to be 6400 unless it is specified.
    Use the cms.clusters property to specify each cluster in your deployment. For example,

    cms.clusters=@samplecluster,@samplecluster2, @samplecluster3. Use the

    cms.clusters.[cluster name] property to specify each CMS in the cluster. For example:

    cms.clusters=@samplecluster,@samplecluster2, @samplecluster3


    cms.clusters.samplecluster2=cms3,cms4, cms5


    Below is the example:


    cms.clusters.BI-PROD=BXY.PROD1.XYZ.COM:6400, BXY.PROD2.XYZ.COM:6400, BXY.PROD3.XYZ.COM:6400, BXY.PROD4.XYZ.COM:6400

    Make sure that there are no syntax issues.

    4. Save the file with the name.

    5. Restart the web application server.

    If you create the file in the war files (i.e C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config\custom). You need to redeploy the BOE webapps.

    The new properties take affect only after the modified BOE web application is redeployed on the computer running the web application server. Use WDeploy to redeploy the WAR file on the web application server.

    For more information on using WDeploy, see the SAP BusinessObjects Business Intelligence Platform Web Application Deployment Guide.

    Once you complete the activity and update your cluster name in BI Launchpad properties and Opendocument properties to reflect in the login screens.

    Add a comment
    10|10000 characters needed characters exceeded

  • author's profile photo Former Member
    Former Member
    Posted on Sep 05, 2013 at 03:36 PM

    Hi Da,

    Below is the information on adding clusters to the web.xml file in PLATFORMSERVICES.

    If you have added additional CMSs, and you are using a Java application

    server, you can modify the web.xml file in the PlatformServices\WEBINF\

    directory of your web application deployment.

    To modify the web.xml to define clusters:

    1. Open the web.xml:

    In a default deployment on Tomcat 5.5 the file is located in the following


    C:\Program Files\Business Objects\Tomcat55\webapps\Plat


    2. Locate the following section in the file:

    <!-- EXAMPLE:



    <param-value>@samplecluster, @samplecluster2,





    <param-value>cmsone:6400, cmstwo</param-value>




    <param-value>cms3, cms4, cms5</param-value>







    3. Remove the comment tags from this section.

    4. In the param-value tag under <param-name>cms.clus

    ters</param-name>, list the names of each cluster in your deployment.

    A “@” character must go before each cluster name in this tag as shown

    in the example. Separate each cluster name with a comma.


    Remove the sample cluster names from the section.

    5. In the param-name tag after the cluster list, type the name of the first

    cluster .

    In the example replace “samplecluster” in


    with the cluster name. Cluster names should not include the “@” character

    in this tag.

    6. In the param-value tag, list the name of each CMS in the cluster and

    enter the CMS port number if required.


    Separate each CMS name with a comma. The port number is separated

    from the CMS name with a colon; The port number is assumed to be

    6400 unless a specific port number is provided.

    7. Repeat steps 5-6 for each cluster in your deployment.

    8. Save your changes.

    9. Restart your application server.



    Add a comment
    10|10000 characters needed characters exceeded

    • Former Member Former Member

      Hi Da,

      The end users shouldn't know the actual CMS names and they should know the BI server by some of your company standard naming convention to avoid getting into internal technical know how of the BI server ......hope this make it simple...



Before answering

You should only submit an answer when you are proposing a solution to the poster's problem. If you want the poster to clarify the question or provide more information, please leave a comment instead, requesting additional details. When answering, please include specifics, such as step-by-step instructions, context for the solution, and links to useful resources. Also, please make sure that you answer complies with our Rules of Engagement.
You must be Logged in to submit an answer.

Up to 10 attachments (including images) can be used with a maximum of 1.0 MB each and 10.5 MB total.