Summary


This article describes various aspects of Platform management.


Platform Queues


A platform queue controls the number of concurrent document refreshes, by document type, InfoBurst will submit to a platform.


Default Queues


The following are queue abbreviations and default/maximum queue lengths for each document type:

  • CR: Crystal Reports (5/50)
  • CR_CATALOG: Crystal Reports cataloging requests (1/2)
  • WI: Web Intelligence (10/500)
  • WI_CATALOG: Web Intelligence cataloging requests (5/5)
  • DI: Desktop Intelligence (5/100)
  • DI_CLIENT: Desktop Intelligence client requests (1/3)
  • DI_CATALOG: Desktop Intelligence cataloging requests (1/2)


Display Platform


Display a platform to view existing queue lengths.

  • Log into the Command Shell 
  • Enter List Platforms 
  • Enter Disp Platform [Platform_ID]


Adjust Queue Length

  • Enter Modify Queue Platform="<Platform_ID>" Name="<Queue_Name>" Size="<Queue_Length>" 
  • Display platform to confirm change


Recommendations


Please review the processing capabilities of your BusinessObjects environment with your BusinessObjects administrator before increasing a document queue. General BusinessObjects processing guidelines are for users, not for the use of a programmatic interface leveraging BusinessObjects. InfoBurst can and will put more load on a BusinessObjects environment than interactive users ever could.


If you do decide to increase a document queue, you should do so slowly, and test how well the BusinessObjects environment handles the change. For example, if the queue is set to the default of 10, and InfoBurst is not processing enough documents at a time, then you could increase the queue to 15. Then, make sure you test for several days worth of high volume to ensure BusinessObjects users do not experience performance issues and/or BusinessObjects do not start occurring.


If you increase the queue limits and BusinessObjects errors start occurring, it is most likely because the BusinessObjects environment is not configured properly to scale. Should errors occur, reduce the queue and discuss with your BusinessObjects administrator. InfoSol provides consulting regarding BusinessObjects scalability.


Validate Platform


Validate Platform is used to verify document information on the current reporting platform. When a BusinessObjects document ID changes, the reference in InfoBurst is broken. Validate Platform can locate the document by path/name and fix up broken references without having to rebuild Bursts or XDCs that reference the document.


Recommendations

  • A server backup should be performed prior to executing Validate Platform
  • Validate Platform can only be performed by a user with Administrator role where the user has a platform logon configured for the target platform
  • The original BusinessObjects document path/name must remain unchanged
  • No documents from the target platform should be in use when Validate Platform is executed


Validate Platform


Validate all documents associated with a platform.

  • Open a command prompt (Run as administrator) on the InfoBurst Platform server
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBMaint
  • Enter number for Validate Platform
  • Enter user
  • Enter number of target platform
  • View ibmaint.log in application root folder for validation results (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)


Validate Folder


Validate all documents in a specific folder.

  • Open a command prompt (Run as administrator) on the InfoBurst Platform server
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBMaint
  • Enter number for Validate folder
  • Enter user
  • Enter number of target platform
  • View ibmaint.log in application root folder for validation results (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)


Migrate Platform


Migrate Platform is used to migrate the version of a platform (BusinessObjects only). Migrate Platform will locate documents by path/name and fix up broken references without having to rebuild Bursts or XDCs that reference the document.


Example:

  • XIR2 > XI3 
  • XI3 > BI4 
  • XIR2 > BI4


Recommendations

  • A server backup should be performed prior to executing Migrate Platform
  • Migrate Platform can only be performed by a user with Administrator role where the user has a platform logon configured for the source platform
  • The original BusinessObjects document path/name must remain unchanged
  • No documents from the target platform should be in use when Migrate Platform is executed
  • Migrate Platform must be staged and migrated documents/bursts validated before executing Migrate Platform in production. Please consult InfoSol Help Desk via support ticket for staging recommendations.


Migrate Platform

  • Open a command prompt (Run as administrator) on the InfoBurst Platform server
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBMaint
  • Enter number for Migrate Platform
  • Enter user
  • Enter number of target platform
  • View ibmaint.log in application root folder for migration results (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)


Update Platform


Update Platform is used to update the CMS name of a platform. Update Platform may be used to address the following scenarios:

  • CMS name changes on existing BusinessObjects server 
  • CMS name changes as a result of the CMS being moved to a new BusinessObjects server of the same version
  • Original CMS is BusinessObjects development. Update platform to re-point all development documents to their production CMS equivalents.


Recommendations

  • A server backup should be performed prior to executing Update Platform
  • Update Platform can only be performed by a user with Administrator role where the user has a platform logon configured for the source platform
  • The original BusinessObjects document path/name must remain unchanged
  • No documents from the target platform should be in use when Update Platform is executed
  • Update Platform should tested and validated in a non-production InfoBurst environment before executing Update Platform in production. Please consult InfoSol Help Desk via support ticket for staging recommendations.


Update Platform

  • Open a command prompt (Run as administrator) on the InfoBurst Platform server
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBMaint
  • Enter number for Update Platform
  • Enter User
  • Enter number of target platform
  • Enter CMS Name
  • At End of Maint, view ibmaint.log in application root folder for update results (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)


See Also


Platform Configurations