Detailed instructions for use are in the User's 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. [. . . ]