User manual BUSINESS OBJECTS POLESTAR ADMINISTRATION AND DEPLOYMENT GUIDE

[. . . ] BusinessObjects Polestar Administration and Deployment Guide BusinessObjects Polestar Copyright © 2008 Business Objects. patents, which may cover products that are offered and licensed by Business Objects: 5, 555, 403; 5, 857, 205; 6, 289, 352; 6, 247, 008; 6, 490, 593; 6, 578, 027; 6, 831, 668; 6, 768, 986; 6, 772, 409; 6, 882, 998; 7, 139, 766; 7, 299, 419; 7, 194, 465; 7, 222, 130; 7, 181, 440 and 7, 181, 435. Business Objects and the Business Objects logo, BusinessObjects, Business Objects Crystal Vision, Business Process On Demand, BusinessQuery, Crystal Analysis, Crystal Applications, Crystal Decisions, Crystal Enterprise, Crystal Insider, Crystal Reports, Desktop Intelligence, Inxight, the Inxight Logo, LinguistX, Star Tree, Table Lens, ThingFinder, Timewall, Let there be light, Metify, NSite, Rapid Marts, RapidMarts, the Spectrum Design, Web Intelligence, Workmail and Xcelsius are trademarks or registered trademarks in the United States and/or other countries of Business Objects and/or affiliated companies. All other names mentioned herein may be trademarks of their respective owners. [. . . ] If you want to install another Polestar server on another separate machine, repeat these steps. BusinessObjects Polestar Administration and Deployment Guide 19 3 Polestar deployment Deploying Polestar in a complex environment 20 BusinessObjects Polestar Administration and Deployment Guide Polestar administration 4 4 Polestar administration Managing Polestar web application settings This chapter will discuss how to administrate Polestar, it includes information on: · · · · · Managing Polestar web application settings on page 22 Configuring Polestar settings on page 24 Starting and stopping Polestar servers on page 29 Configuring the BusinessObjects Enterprise CMC for users on page 29 Logs in Polestar on page 31 Managing Polestar web application settings You can adjust various application settings via a single properties file: default. settings. properties The file is stored under the Polestar Tomcat directory, for example: C:\Program Files\Business Objects\Tomcat\webapps\polestar\WEB-INF\classes\ The various settings are: Setting product. name default. locale Description For internal use only. For example, English. Example Default Values en default. cms. name The name and port number myserver:6400 of your CMS. Determines if the value stored in de fault. cms. name is displayed in the CMS Name field of the Log On page. true false show. cms. name 22 BusinessObjects Polestar Administration and Deployment Guide Polestar administration Managing Polestar web application settings 4 Setting Description Disables the CMS name textbox within the Log On page. You cannot change the textbox value. Example Default Values true false disable. cms. name default. authentica tion. method The default log on authentication to use. The value is secEnterprise displayed in the Authentication list of the Log On page. secWindowsNT, secLDAP authentications hide. authentica tion. method Determines if the Authentication list is displayed in the Log On page. For example, after clicking Log On the Log On box has a graphical effect applied to it. The period of time in sec30 onds before Polestar times out after an operation, such 100 as logging into the system. The root location for the Polestar tutorial. true false true false disable. authentica tion. method true false use. effects request. timeout help. url /polestar_help_ /polestar_tu torial tutorial. url BusinessObjects Polestar Administration and Deployment Guide 23 4 Polestar administration Configuring Polestar settings Setting disable. password. en cryption Description Determines if password encryption is to be used. Example Default Values true false Configuring Polestar settings Polestar settings are configured (in order of priority) via: · the command line in the CCM (for a single server on a single node) · a properties file (for all servers on a single node) · the CMC (for all nodes within your deployment cluster) For example, if you configure the settings via a properties file on a node, the CCM settings are ignored for that node. · · · · · The number of Corba threads to improve server communication. The unit to use for validating bookmarks, possible values include: DAYS, MINUTES, HOURS, or WEEKS. The period of time (in milliseconds) before a session object (handled by an underlying watchdog) is deleted. The delay (in milliseconds) between each update of when slave servers inform the master server about their workload in order that the load is balanced. Configuring the Polestar index path To change the indexing path, an administrator can either: · Amend the value within the CMC administration page. In this case, the value is taken into account by all slave nodes. 24 BusinessObjects Polestar Administration and Deployment Guide Polestar administration Configuring Polestar settings 4 Logon to the CMC. Copy any existing indexes to the new location before changing the path. The indexes are stored within folder directories, ensure that you copy the entire directories. Create or edit a properties file named polestar. service. properties located under C:\Program Files\Business Objects\Polestar11. 5\, and add this entry: in dex. path=C:/Index. 1. · Add the following to the command line to configure a single server: #-index. path#C:/Index For example: "\\polestar_node\C$\Program Files\Business Ob jects\Polestar11. 5\poleMast. exe" //RS//BOBJPolestarMasterSer vice --StartParams="-ns#polestar-test#-loggingPath#C:\Program Files\Business Objects\BusinessObjects Enterprise 11. 5\Log ging#-trace#false#-servers#polestarMaster#-index. path#C:/In dex" --JvmMx="1024" Note: If you copy existing indexes, the Polestar Indexing Server has to be stopped. Configuring the number of Polestar Corba threads To change the number of Corba threads, an administrator can either: · Amend the value within the CMC administration page. Change the Number of threads: value and click Update. BusinessObjects Polestar Administration and Deployment Guide 25 4 Polestar administration Configuring Polestar settings · Change a setting for a single node. Create or edit a properties file named polestar. service. properties located under C:\Program Files\Business Objects\Polestar11. 5\, and add this entry: nb_threads=150. Amend the value accordingly and restart the servers. · Add the following to the command line to configure a single server: #-nb_threads#150 For example: "\\polestar_node\C$\Program Files\Business Ob jects\Polestar11. 5\poleMast. exe" //RS//BOBJPolestarMasterSer vice --StartParams="-ns#polestar-test#-loggingPath#C:\Program Files\Business Objects\BusinessObjects Enterprise 11. 5\Log ging#-trace#false#-servers#polestarMaster#-nb_threads#150" --JvmMx="1024" Configuring the Polestar bookmark validity period To change the bookmark validation period, an administrator can either: · Amend the value within the CMC administration page. Create or edit a properties file named polestar. service. properties located under C:\Program Files\Business Objects\Polestar11. 5\, and add the following entries: bookmark. validity. time=365 bookmark. validity. unit=DAYS Amend the values accordingly and restart the servers. [. . . ] For example: C:\Program Files\Business Objects\BusinessObjects Enterprise 11. 5\Logging\PolestarServ er_polestarSearch_XXXXXXXX_XXXXXX. log This file logs the server operations by using log4j. Web application logging. BusinessObjects Polestar Administration and Deployment Guide 31 4 Polestar administration Logs in Polestar By using Apache Tomcat logging services, you can log the Polestar application operations. Via the Tomcat configuration, you can also change the logging level and change the logging path. By default, log files are stored in the Tomcat logs directory: C:\Program Files\Business Objects\Tomcat\logs\ You can also view logs by running Tomcat via a command line such as Command Prompt. [. . . ]