Академический Документы
Профессиональный Документы
Культура Документы
Copyright
Copyright 2004 Business Objects. All rights reserved. If you find any problems with this documentation, please report them to Business Objects in writing at documentation@businessobjects.com.
Trademarks
Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise are trademarks or registered trademarks of Business Objects SA or its affiliated companies in the United States and other countries. All other names mentioned herein may be trademarks of their respective owners. Contains ICU libraries (c) 1995-2003 International Business Machines Corporation and others. All rights reserved.
Use restrictions
This software and documentation is commercial computer software under Federal Acquisition regulations, and is provided only under the Restricted Rights of the Federal Acquisition Regulations applicable to commercial computer software provided at private expense. The use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in subdivision (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.2277013. Business Objects owns the following U.S. patents, which may cover products that are offered and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and 6,289,352. 313-10-650-01
Patents
Part Number
Contents
Preface Maximizing Your Information Resources 7 Information resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Part I Preparing for Installation Chapter 1 Planning for Installation 17
Planning your deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Installation and Configuration Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Upgrading from previous versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Part II Installation Chapter 2 Installing BusinessObjects 6.5 41
Pre-install procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Installation tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Business Objects products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Types of installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Running the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Chapter 3 Administrative and Command Line Installations 69
Contents
Chapter 4
83
Adding a product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Removing products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Repairing an installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Removing BusinessObjects 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Applying a hotfix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Part III Configuration Chapter 5 Configuration Overview and Scenarios 93
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Tools and methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Deploying web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Configuration scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Scenario 1 -- Apache/Tomcat or IIS on a single machine . . . . . . . . . . . . . 102 Scenario 2 -- Two machines/web and application servers together . . . . . 104 Scenario 3 -- Two machines/E6 and application server together . . . . . . . 106 Scenario 4 -- Three machines/web and application server separate . . . . 109 Chapter 6 Configuring the ORB 113
Starting the Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Configuring the ORB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Setting cluster storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Changing cluster settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Removing a node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Chapter 7 Typical Configuration 127
Starting the Typical wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ASP technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 JSP technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Chapter 8 Configuration Tool in Command Line Mode 141
Contents
Chapter 9
155
Deploying the web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Customized web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Removing a web application instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Modifying or removing an application server . . . . . . . . . . . . . . . . . . . . . . . 178 Modifying or removing a web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Chapter 10 Deploying Web Applications Using wdeploy 181
What is wdeploy? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Wdeploy deployment modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 How do you use wdeploy? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Using wdeploy on application server machines . . . . . . . . . . . . . . . . . . . . . 192 Using wdeploy on web server machines . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Properties reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 Targets reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 Deploying a customized application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 Using unsupported web or application servers . . . . . . . . . . . . . . . . . . . . . 212 Issues requiring additional procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Making sure your web applications work . . . . . . . . . . . . . . . . . . . . . . . . . . 217 Where to go now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 Part IV Before You Start the System Chapter 11 Getting the System Ready 221
Before starting the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Before you set authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Contents
Chapter 12
231
Authentication and authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Authentication mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Authentication source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Using LDAP with Business Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Netegrity SiteMinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 Using the Security Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Setting the authentication mode and source . . . . . . . . . . . . . . . . . . . . . . . 248 If you chose Basic authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 Configuring LDAP connection parameters . . . . . . . . . . . . . . . . . . . . . . . . 255 Part V Finalizing Your Configuration Chapter 13 Getting Up and Running 265
Starting the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 After starting the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 Configuring the Demo kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 Where to go now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Part VI Appendices Appendix A Appendix B Business Objects Products and Feature Codes Language Codes 277 283
Contents
preface
Overview
Information, services, and solutions
The Business Objects solution is supported by thousands of pages of documentation, available from the products, on the Internet, on CD, and by extensive online help systems and multimedia. Packed with in-depth technical information, business examples, and advice on troubleshooting and best practices, this comprehensive documentation set provides concrete solutions to your business problems. Business Objects also offers a complete range of support and services to help maximize the return on your business intelligence investment. See in the following sections how Business Objects can help you plan for and successfully meet your specific technical support, education, and consulting requirements.
Information resources
Whatever your Business Objects profile, we can help you quickly access the documentation and other information you need.
Where do I start?
Below are a few suggested starting points; there is a summary of useful web addresses on page 12. Documentation Roadmap The Documentation Roadmap references all Business Objects guides and multimedia, and lets you see at a glance what information is available, from where, and in what format. View or download the Business Objects Documentation Roadmap at www.businessobjects.com/services/documentation.htm Documentation from the products You can access electronic documentation at any time from the product you are using. Online help, multimedia, and guides in Adobe PDF format are available from the product Help menus. Documentation on the web The full electronic documentation set is available to customers with a valid maintenance agreement on the Online Customer Support (OCS) website at www.businessobjects.com/services/support.htm Buy printed documentation You can order printed documentation through your local sales office, or from the online Business Objects Documentation Supply Store at www.businessobjects.com/services/documentation.htm Search the Documentation CD Search across the entire documentation set on the Business Objects Documentation CD shipped with our products. This CD brings together the full set of documentation, plus tips, tricks, multimedia tutorials, and demo materials. Order the Documentation CD online, from the Business Objects Documentation Supply Store, or from your local sales office.
Information resources
10
Multimedia Are you new to Business Objects? Are you upgrading from a previous release or expanding, for example, from our desktop to our web solution? Would you like to see a demonstration that shows how to use some of our more complicated or advanced features? Access our multimedia Quick Tours or Getting Started tutorials from the product, the Online Customer Support (OCS) website, or the Documentation CD.
If your issue concerns a Business Objects product and not the documentation, please contact our Customer Support experts. For information about Customer Support visit: www.businessobjects.com/services/support.htm
11
Services
A global network of Business Objects technology experts provides customer support, education, and consulting to ensure maximum benefit to your business.
Services
12
Content
Overview of Business Objects documentation. Links to Online Customer Support, Documentation Supply Store, Documentation Roadmap, Tips & Tricks, Documentation mailbox.
Business Objects product information Information about the full range of Business Objects products. www.businessobjects.com Developer Suite Online www.techsupport.businessobjects.com Knowledge Base (KB) www.techsupport.businessobjects.com Available to customers with a valid maintenance agreement and a Developer Suite license via the Online Customer Support (OCS) website. Provides all the documentation, latest samples, kits and tips. Technical articles, documents, case resolutions. Also, use the Knowledge Exchange to learn what challenges other users both customers and employees face and what strategies they find to address complex issues. From the Knowledge Base, click the Knowledge Exchange link. Practical business-focused examples.
13
Content
Starting point for answering questions, resolving issues. Information about registering with Worldwide Customer Support. The range of Business Objects training options and modules.
Business Objects Consulting Services Information on how Business Objects can help maximize your business intelligence investment. www.businessobjects.com/services/ consulting.htm
14
Audience
This guide is intended for administrators and others responsible for installation and configuration. This guide assumes that you are familiar with the following: the BusinessObjects 6.5 suite of products Windows system administration command-line tools
$DIRECTORYPATHNAME The path to a directory in the Business Objects installation/configuration directory structure. For example: $INSTALLDIR refers to the Business Objects installation directory. $LOCDATADIR refers to a subdirectory of the BusinessObjects installation directory called locData.
part
chapter
18
Overview
This chapter includes: a review of the stages involved in installation and configuration a comprehensive checklist of all the steps required a discussion of deployment issues what to do if you are upgrading from a previous version Throughout this guide, you will see the following table at the start of each major section. It is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
19
What is a cluster?
Clusters are the basic unit in a 3-tier Business Objects solution. A cluster is the node or set of nodes that collectively provide the functional operation of a given portal. Clusters can contain the following elements: The primary node serves as the central coordinator between all the nodes in the cluster. There is one and only one primary node in a cluster; if the cluster contains only one node, it is a primary node. Optional secondary nodes run the ORB components required to communicate with the primary node and start Business Objects processes on the secondary node, as well as optional services. Both primary and secondary nodes are considered cluster nodes. Under Windows, only one node can be configured per server machine. Under UNIX, multiple nodes can be hosted on a single machine, as long as each of them belongs to a different cluster.
20
Network
Secondary node
Because the application server uses CORBA to communicate with the clusters API and interface components, the application server is also considered to be part of the cluster. What is the primary nodes role? The primary node performs the following services: It tracks and manages processes throughout the system. It records various system and user activities. The primary node occupies a critical position in the Business Objects system. If it fails, the entire system needs to be stopped and restarted. What is the secondary nodes role? Secondary nodes rely on the primary node to provide the infrastructure required to allow multiple servers to work together. You can configure a secondary node to run only a subset of the full complement of Business Objects modules using the Administration Console. The Console allows you to tailor the structure of your system and more efficiently serve the needs of your users. For example, if you find that the load on a particular type of server process within the system is high, you can dedicate a machine to just that process.
21
The systems distributed component architecture provides three major benefits: Failover A distributed system can also provide failure recovery: When system components are installed on more than one server, if a server stops working, the system can continue to use the same required components on other servers. Scalability User populations using this type of Internet technology can be significantly larger than usual. As the document processing needs and the user population in your organization grow, you can manage the extra workload simply by adding servers to the system. Load balancing When you enable multiple instances of certain key Business Objects modules over several nodes, the distributed system automatically performs load balancing across component servers. You can also weight the transaction loads to optimize the use of more or less powerful processors, thus optimizing the use of server resources, reducing the workload on the web server, and improving performance. All of these advantages are made possible by the use of CORBA and the Business Objects Application Server Framework, or ASF.
22
Depending on your deployment, you can have more than one web server and application server per cluster. You can install your web server and application server on any type of node, depending on your deployment plan. In some deployments, your web servers may be completely isolated from the cluster, notably in DMZ configurations. You must still, however, install the Configuration Tool on both the application and web servers to define them as entry points.
23
In a 3-tier configuration, therefore, the following must be installed: System component What must be installed
Cluster nodes Application server Business Objects server components Administration Console (on primary node) Configuration Tool Web server pages (option under InfoView in the Installer) A third-party application server connector if the application server is on a separate machine than the web server Configuration Tool (to configure the web server) Application server pages (option under InfoView in the Installer) Configuration Tool (to configure the application server and the ORB so that it can communicate with the cluster machines)
Web server
Client machines
Any or all of the following: Desktop products (installed on the machines of their users) Administration products Demonstrations
NOTE
You can install your web server and application server on any type of node, depending on your deployment plan. There are some deployments, however, in which you do not want your web servers to be part of the cluster, most commonly where you have implemented a DMZ. You must still, however, install the Configuration Tool on both application and web servers to configure them as client nodes and to define them as entry points.
Configuration scenarios
There are four typical configuration scenarios, summarized below. You can use these as a general guide to configuration. Their use is optional. (For a more detailed explanation of each one, see Configuration scenarios on page 101.)
24
Scenario 1 -- Apache/Tomcat or IIS on a single machine Heres what Scenario 1 looks like:
Machine 1 --Business Objects server --Configuration Tool (primary node) --Application server --Web server
Users
Intranet
With this scenario, you perform a largely-automated configuration process. This makes use of the Typical wizard within the Configuration Tool.
25
Scenario 2 -- Two machines/web and application servers together Heres what Scenario 2 looks like:
Users Machine 1 --Business Objects server --Configuration Tool (primary node)
Intranet
To use Scenario 2, you must have: a machine hosting the Business Objects server and the Configuration Tool This is the primary node. a second machine with the web server, application server, and the Configuration Tool This is the client node.
26
Scenario 3 -- Two machines/BO6.5 and application server together Heres what Scenario 3 looks like:
Users Machine 1 --Business Objects server --Configuration Tool (primary node) --Application server
Intranet
To use Scenario 3, you must have: a machine with the Business Objects server, the Configuration Tool, and the application server This is the primary node. a second machine with the web server
27
Scenario 4 -- Three machines/web and application server together Heres what Scenario 4 looks like:
Users Machine 1 - Business Objects server - Configuration Tool (primary node)
Intranet
To use Scenario 4, you must have: a machine with the Business Objects server and the Configuration Tool This is the primary node. a second machine with the application server and the Configuration Tool This is the client node. a third machine with the web server
28
29
30
31
Tune and test your system Set Business Objects processes and pool size for WIQT at least. See page 269 and the System Administrators Guide for Windows. Make sure users can successfully log on to the system. Make sure you can correctly download BusinessObjects from InfoView and that BusinessObjects in 3-tier mode functions properly. Set up Broadcast Agent Define at least one Broadcast Agent. See the Broadcast Agent Administrators Guide. Check that you can correctly schedule documents from InfoView or BusinessObjects. Set up the demo kits Configure the demo kits so your users can use the WebIntelligence and BusinessObjects Getting Started tutorials. See page 272.
32
Because Business Objects 5.x desktop products must be uninstalled, the Installation wizard looks for the 5.x setup.exe file. If the file is not found, the wizard informs you that you must copy it to your hard disk. Have the version 5.x installation CDs ready in case the 5.x setup.exe file is not currently on your hard disk. WebIntelligence 2.x Although the Installation wizard detects WebIntelligence 2.x products, it does not uninstall them. If you want to upgrade, you must uninstall previous versions using the installation program on the original CD. Your configuration settings are not kept.
33
BusinessObjects 4.x and earlier The Installation wizard does not detect Business Objects 4.x or earlier. If you want to upgrade from Business Objects 4.x or earlier, you must first upgrade to version 5.x in order to preserve all corporate and user documents. You must uninstall the earlier versions using the original installation program.
34
Stop the Business Objects cluster Stop the secondary nodes first, and then the primary node. 1. From the Windows Start menu, point to Programs > Business Objects > Stop Server. Wait for the Business Objects server to shut down completely. This takes a few moments. 2. Right-click the WINotify icon and select Exit from the menu. The WINotify icon is in the status bar of your Windows desktop. Stop all WebIntelligence services Make sure you stop all WebIntelligence services. 1. From the Windows Start menu, point to Programs > Administrative Tools > Services. 2. In the Services window, right-click WebIntelligence Cluster Service and select Stop from the menu. 3. Right-click WebIntelligence DTS Manager and select Stop from the menu. 4. Right-click Olap Cache Manager and select Stop from the menu. 5. Right-click IIS Admin Service and select Stop from the menu. Stop all web and application servers Stop all web and application servers used by the Business Objects cluster. The upgrade process can be corrupted if you have web and application servers running.
NOTE
On IIS, make sure that you stop all services: WWW Publisher and IIS Admin. Make a backup of all current configuration settings and personal storage Manually backup all files containing configuration settings and personal documents, for all nodes on the cluster. This is not mandatory but enables you to make a safe recovery if anything goes wrong during the automatic upgrade. 1. Make sure the cluster has been stopped. 2. Go to the Business Objects installation nodes folder $INSTALLDIR\nodes\<hostname>\<clustername>
35
3. Make copies of the following folders and all subfolders. You can use Winzip or an equivalent tool. $INSTALLDIR\nodes\<hostname>\<clustername>\config $INSTALLDIR\nodes\<hostname>\<clustername>\documents $INSTALLDIR\nodes\<hostname>\<clustername>\locdata $INSTALLDIR\nodes\<hostname>\<clustername>\logs $INSTALLDIR\nodes\<hostname>\<clustername>\shData $INSTALLDIR\nodes\<hostname>\<clustername>\storage $INSTALLDIR\nodes\<hostname>\<clustername>\universes $INSTALLDIR\nodes\<hostname>\<clustername>\userBQY $INSTALLDIR\nodes\<hostname>\<clustername>\webi.bat These folders and files contain all configuration settings made through the Administration Console, user settings, and all personal documents. Back up WebIntelligence and InfoView files you customized manually You need to manually back up and then restore any files that you customized manually. InfoView .war file If you have modified any of the files in the infoview.war file (*.jar,* .jsp,* .asp, *.html, *.xsl,* .xslt, servlets), you need to make a manual backup of any changes before upgrading, and then restore your customized files afterwards, manually. The infoview.war is replaced during the upgrade process. Undeploy Business Objects web applications wdeploy If you originally used the wdeploy tool to deploy any web applications on a web server or application server, run wdeploy and undeploy these web applications. Configuration Tool (web/application server other than Apache, Tomcat, or IIS) If you originally used the Configuration Tool to deploy web applications on a web server or application server other than Apache, Tomcat, or IIS, run the Configuration Tool and undeploy the Business Objects web applications InfoView, Administration Console, Auditor, and any custom applications you have deployed on the web and application servers.
36
To undeploy: 1. Launch the Configuration Tool from Start > Programs > Business Objects > Configuration Tool. 2. Click Next twice. 3. On the Configuration Options page, select Custom, and then click Next. 4. On the Cluster Management page, fully expand the web application branch, for example InfoView. 5. Highlight the application server. 6. In the drop-down list, select Delete this web application, and then click Next. 7. If you are using a separate application server and web server, highlight the web server. 8. In the drop-down list, select Delete this virtual directory. 9. Complete steps 4-8 for all web applications you have deployed. 10. When you have completed all steps for all web applications, click Finish. Apache/Tomcat from Business Objects 6.1.x If you installed Apache and Tomcat using the Apache/Tomcat installer delivered with Business Objects 6.1.x, you must: 1. Undeploy your web applications, using the procedure described above. 2. Uninstall Apache and Tomcat using the 6.1.x Apache/Tomcat installer. 3. Reinstall Apache/Tomcat using the 6.5 Apache/Tomcat installer. If the Apache and Tomcat you used in your version 6.1.x deployment are still supported in BusinessObjects 6.5, then the 6.5 Setup will automatically undeploy the Business Objects 6.1.x web applications that are deployed on them. If, however, your previous Apache and Tomcat are not supported in 6.5, then you must undeploy the 6.1.x web applications using the 6.1.x Configuration Tool, as explained above. Install BusinessObjects 6.5 Upgrading an existing installation takes longer than installing BusinessObjects 6.5 from scratcha typical upgrade can take 40 minutes compared to 10 minutes for an installation from scratch. The upgrade is particularly long if you have activated antivirus software on the node where you are installing BusinessObjects 6.5.
37
The 6.5 Setup program will automatically uninstall your previous version. If, however, you choose to manually uninstall, make sure you first run the Configuration Tool to delete the node. (If you manually uninstall and then reinstall in the same directory without first deleting the node, delete the contents of $INSTALLDIR/nodes before creating a new node.) To install: 1. Run the BusinessObjects 6.5 Setup. 2. Select the products to be installed. Important: You must install BusinessObjects 6.5 using the same installation path you used for your BusinessObjects 6.1.x installation. The Business Objects installer proposes the default installation folder C:\Program Files. Make sure that you do not accept this default if your current BusinessObjects 6.x installation is installed elsewhere. If you do not install BusinessObjects 6.5 using the same installation path, the configuration settings that have been saved from BusinessObjects 6.1.x will not be valid for BusinessObjects 6.5. 3. Start the installation process. The installer detects that a previous version of BusinessObjects 6.x is already installed and switches to upgrade mode. The installer then: - runs the Configuration Tool currently installed to backup the existing configuration (ORB, services, web applications, personal settings and storage). The Configuration Tool runs in batch mode which opens a DOS window. Do not close this window; it will close automatically. - uninstalls the current BusinessObjects 6 installation. - installs BusinessObjects 6.5. - runs the new BusinessObjects 6.5 Configuration Tool, which restores the configuration. The Configuration Tool runs in batch mode which opens a DOS window. Do not close this window; it will close automatically. 4. When the Installation Wizard Complete screen appears, make sure the Configure server products checkbox is not checked, and then click Finish. You do not need to run the Configuration Tool to redeploy web applications on Apache/Tomcat or IIS; the upgrade procedure redeploys all web applications on Apache/Tomcat or IIS and restores all configuration settings. For all other web and application servers, see the next section. Deploy Business Objects web applications For all web and application servers other than Apache/Tomcat and IIS, deploy Business Objects web applications using the wdeploy tool.
38
Check that the upgrade has been successfully completed Start the Business Objects system in the following order: 1. Start the Business Objects server on the primary node. On the Windows Start menu, point to Programs > Business Objects > Start Server. 2. Start the Business Objects server on the secondary nodes. On the Windows Start menu, point to Programs > Business Objects > Start Server. 3. Start the application server. 4. Start the web server (if you are using a separate application and web server). 5. Check that your BusinessObjects 6.5 deployment is functioning correctly. Troubleshooting If you experience problems after the upgrade, check the following: Launch the Configuration Tool and check that the node has been correctly recreated. If not, run the Configuration Tool to recreate the node and reconfigure the ORB. Check that web applications have been correctly redeployed. If not, run the Configuration Tool to redeploy the web applications on Apache/ Tomcat and IIS. Use wdeploy to redeploy web applications on all other application and web servers. Check that the service parameters have been correctly reset. If not, reset them in the Configuration Tool. Check that all folders and files containing custom configuration settings made through the Administration Console, all user settings, and all personal documents have been restored. If not, restore the files and directories using the manual backup files you made. See page 34 for the list of directories.
Installation
part
chapter
42
Overview
This chapter explains how to install Business Objects products for the first time. Before you begin, read the preliminary information in the previous chapter. This chapter describes: pre-installation procedures the different types of installation and their associated products installation of BusinessObjects 6.5 using the Installation wizard
43
A note about Terminal Services You can install via Terminal Services, but with the following restrictions: When you configure the ORB, you must set the cluster to use the WebIntelligence Service If you are using Windows 2000, you cannot use a mapped drive to access the CDs on a remote machine
44
Pre-install procedures
For command-line and administrative installations, complete the pre-installation procedures, and then go to Administrative and Command Line Installations on page 69. The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This section explains the steps you must complete before you start any installation.
Licenses
You must purchase and install licenses for all the products you want to install. In the Installation wizard, you will see only the products for which you have a license.
45
License files When you purchase a Business Objects product, you receive the corresponding license file from your Business Objects representative. The license file is a readable signed XML file. It contains: a list of licensed products the expiry date for trial products the number of licenses purchased for each product You can use a text editor to see what licenses you have. Do not delete or modify the license file, otherwise you cannot install or use any of the products it covers. License file directory If you are installing different components of BusinessObjects 6.5 on different nodes within a cluster, make sure the license files are available in a network location to which all nodes have access. Copy your license files before starting the Installation wizard. During installation, you specify where the files are located. Copy any subsequent licenses to the same directory, otherwise you may not be able to use a product you have already installed. License files for clients License files must be accessible to all client users. You can either: install the license files on each client machine Although this is the simplest option, it is harder to manage if you purchase new license files, because you have to deploy them on all the client machines. install the license files in a shared network directory All machines must have access to the directory, otherwise they cannot use the Business Object products to which the license file refers, even if the product is installed at the client. The advantage is that you can track license files easily, and control which machines have access simply by adding or restricting network access rights. This is the preferred solution for larger Business Objects implementations.
Pre-install procedures
46
If you use the Apache/Tomcat Installer provided on the Business Objects installation CD, the JDK is also installed. You do not need to perform the procedure below; go to page 47. To find out if a JDK is installed on the application server machine: at the DOS prompt type: java -version If a JDK is installed, the version number is returned. If no version number is returned, no JDK is installed. To install the JDK: 1. Do either of the following: - Copy the JDK from the Business Objects installation CD. - Download Java 2 SDK Standard Edition (J2SE) from www.sun.com. Make sure you download the SDK and not the JRE. 2. Install the JDK according to the manufacturers instructions. Use a short pathname for the JDK installation folder, for example, c:\jdk_1.3.1 3. On the Windows Start menu, point to Settings > Control Panel > System. The System Properties dialog box appears. 4. On the Advanced tab, select Environment Variables. 5. Under System Variables, check whether the JAVA_HOME variable is present: ...if JAVA_HOME is not present: Click New. Enter the variable name. Enter the JDK installation folder in the value box. ...if JAVA_HOME is present: Check that the JDK installation folder is correct. If not, click Edit and point to the JDK installation folder.
NOTE
If a CLASSPATH environment variable has been set, check that there are no spaces in its path and that there are no double quotes. On Windows 2000, if you use double quotes in the classpath, Tomcat cannot locate the JAR files. 6. Restart the machine.
47
You must use version 6.5 of the Apache/Tomcat Installer with the BusinessObjects 6.5 suite. If you have an older version, follow the procedure below to update to version 6.5. The Apache/Tomcat Installer: installs the JDK installs Apache installs Tomcat installs and configures the mod_jk connector that links Apache and Tomcat Before you begin, make sure that: you have administrator rights Apache and Tomcat are not installed on the machine Ports 8009 and 8085 are available To install and configure Apache/Tomcat using the Installer: 1. From the Business Objects Installation CD 0 (folder: SetupApache2.0.46Tomcat4.1.27Jdk1.4.2_03), double click the setup.exe file. The Welcome page appears. 2. Click Next. The License Agreement page appears. 3. Read the agreement. If you accept it, select I accept the terms in the license agreement, and then click Next.
Pre-install procedures
48
4. If you want to modify the installation directory, click Change. The default directory is C:\Program Files\Business Objects\ThirdParties\ 5. Click Next. The Ready to Install the Program page appears. 6. Click Install. The tool copies the files into the installation directory and configures the connector. The Installation Wizard Completed page appears. 7. If you want to test the installation and the link between Apache and Tomcat, use the URL that appears on this page. 8. Click Finish. Stopping Apache and Tomcat Apache and Tomcat must not be running while you configure Business Objects server products. To stop Apache and Tomcat: 1. In the Windows Start menu, point to Settings > Control Panel > Administrative Tools > Services. 2. Right-click Apache and select Stop from the menu. 3. Right-click Apache Tomcat 4.1 and select Stop from the menu.
49
Installation tools
This section reviews the tools used during installation.
Installation wizard
You use the Business Objects Installation wizard for all types of installations, including Business Objects server products and desktop products. It allows you full control over the entire installation process, and has the look and feel of industry-standard Windows installations. Both desktop and server products use the Microsoft InstallShield. This has several benefits, including: built-in command-line mode reliable installation and uninstallation automatic repair of corrupted installations The wizard provides detailed information on all the installation options available. The actual steps you see when running the wizard vary depending upon whether you are: installing the product for the first time modifying an existing installation removing all or part of an installation updating to a new release performing an administrative installation repairing an installation
Command-line installation
You can use command-line installations to install entire product families or individual products. For example, you can install only BusinessObjects in 3-tier mode. Command-line mode is an important feature for deployment and integration in other products. With it, you can: remotely install products using scripts or management systems embed the installation of BusinessObjects within your own installation script Command-line installations are explained in Administrative and Command Line Installations on page 69.
Installation tools
50
The products you see in the Installation wizard depend upon your license.
Server products
Server products are network server applications. Because they must be deployed on network servers, their hardware and software requirements are not the same as those of the other product families. Because server products use CORBA for distributed processing they must be installed on each node of a cluster, and on web and application servers. See What is a cluster? on page 19 for more information.
NOTE
To enable your Business Objects server to connect to a data source, appropriate Database Access Packs and OLAP Access Packs must be installed on the Business Objects server as well.
51
To know which platforms you can install server products on, refer to the PAR (Product Availability Report) on http://www.techsupport.businessobjects.com. The installer checks to see which platform you have installed, and installation stops if you are trying to install on a different platform or one earlier than those listed. If you do not have a supported operating system, you do not see the option to install server products. Following is a list of server products. Server product
Business Objects server
Description
Required for any Business Objects server solution. It is the engine behind all the other Business Objects server components, such as InfoView and WebIntelligence. The gateway to your enterprise documents. InfoView contains: web server pages, to be installed on the machine hosting your web server. front-end components, to be installed on the machine housing your application server. Allows users to access, analyze, and share corporate data over intranets and extranets, for both relational databases (RDBMS) and OLAP servers. It includes: REPORTER: to query the database and build reports EXPLORER: to drill down to finer levels of analysis in reports Enables users to install BusinessObjects in 3-tier mode from InfoView. Broadcast Agent is the integrated enterprise report and broadcast server that allows users to publish, push, and broadcast predesigned or ad hoc reports in batch mode, via the Internet, InfoView, and a wide range of output devices. Its single component, which can be installed separately for distributed use over a network, is Scheduler, which monitors task scheduling and launches tasks. A server component that can be used to access databases.
InfoView
WebIntelligence
52
Desktop products
You can install desktop products only on Windows. Following is a list of desktop products. Desktop product
BusinessObjects
Description
BusinessObjects is the integrated query, reporting, and analysis solution that enables you to access the data in your corporate databases directly from your desktop and present and analyze this information in a BusinessObjects (.rep) document. There are two modules: REPORTER: to query the database and build reports EXPLORER: to drill down to finer levels of analysis A subset of BusinessObjects to enable users in 3-tier mode to edit reports created with BusinessObjects. An add-on tool that provides Microsoft Excel with fully functional database access. With BusinessQuery, you can access your corporate databases from Excel using familiar business terms.
Administration products
Administrative products enable you to control user access and other security issues, configure and monitor server products and Broadcast Agent, design universes.
53
Description
The tool administrators use to create, manage, and distribute universes for BusinessObjects and WebIntelligence users. A universe is a file that contains connection parameters for database middleware, and SQL structures called objects that map business terms to SQL structures in the database such as columns, tables, and database functions. The control center for the administration and security of your entire Business Objects deployment. It allows you to set up and maintain a secure environment for the overall Business Objects system with control of access to resources. This information is centralized through relational data accounts called repositories. Allows your supervisors to manage users and user groups from a web browser A web-based product that allows you to monitor and analyze user and system activity for BusinessObjects in 3tier mode, Broadcast Agent, and WebIntelligence, and display the results on a user-friendly web interface. This information provides valuable insight into your Business Objects deployment, enabling you to optimize your BI solution. Allows you to configure your Business Objects server, including: web servers application servers the ORB Available as either a Java applet or an executable application, it enables you to administer and tune the overall Business Objects system. Used by the administrator to monitor the status of processed and pending tasks and to execute actions such as running a task immediately or deleting it. Broadcast Agent Console can be deployed either on a server or a client machine. You must install and run Configuration Tool on any machine where you install Broadcast Agent Console.
Supervisor
Configuration Tool
Administration Console
54
Access packs
You must install an access pack so that your Business Objects server can connect to your database. The access pack must be on the same machine as a Business Objects server, so the same operating system restrictions apply. Consult the readme file on the product CD for instructions on obtaining currently supported database platforms, or consult the Product Availability Report (PAR) on the Business Objects Online Customer Support website at www.techsupport.businessobjects.com Like other Business Objects products, you need a license to install an access pack.
55
Demo kits
The demo kit is a collection of Business Objects demonstration materials. The demo kit contains the following files: Type of material
Universes
Files
beach.unv efashion.unv
Description
beach.unv is the universe used in most examples in the Designers Guide. efashion.unv is the universe used in other Business Objects guides. The sample databases Club and efashion. These are used by the sample universes so that BusinessObjects and WebIntelligence users can follow the Getting Started guides. Sample reports and lessons used by the BusinessObjects Getting Started Guide and the WebIntelligence Getting Started Guide.
Databases
club.mdb efashion.mdb
Documents
EFASHION.BMP EFASHION.REP EFASHION.XLS REVENUE.REP TUTORIAL.REP lesson1.pdf lesson1.wid lesson2.pdf lesson2.wid lesson2.xls lesson3.wid lesson4.wid lesson5.wid Various template files
Templates
56
Types of installation
This section describes the three types of installation and their associated products. The three types of installation are: Desktop Server Custom You use the same Installation wizard to install all products. The Desktop and Server installation options install a preselected package of products. If you want to select individual products to install, use Custom installation. You cannot change the default installation directory if you use a Desktop or Server installation. When upgrading from a previous 6.x version, Desktop and Server installations are not available. You must use Custom.
Desktop installation
Desktop products run on Windows-only client machines. The Desktop installation installs all the products you need in a desktop environment. This includes the following desktop components: BusinessObjects - Reporter - Explorer - 3-tier BusinessObjects (desktop component) - Online help - Online guides BusinessQuery for Excel
57
Server installation
If you do not have a supported operating system, you do not see the option to install server products. The Server installation installs all the products you need for network servers. This includes the following server components: Business Objects server InfoView WebIntelligence Business Objects Web Installer Enables users to download 3-tier BusinessObjects from InfoView. Broadcast Agent Scheduler Connection Server (CORBA-based version) And the following administration and related products: Access packs Supervisor Supervisor over the Web Auditor Configuration Tool Administration Console Broadcast Agent Console Demo kit
Custom installation
In a Custom installation, you can install all or part of any product family. You must use Custom installation if you: do not want to install the preselected Desktop or Server packages install only the 3-tier BusinessObjects component on a desktop machine install Business Objects Web Installer install Business Objects server and web applications on a client node want to change the default installation directory
Types of installation
58
install Broadcast Agent Scheduler or Broadcast Agent Console on a desktop machine Because Broadcast Agent Console acts as part of the cluster, you must also configure the machine to be a node within the cluster. Therefore, if you install Broadcast Agent Console on a client machine, you must also install Configuration Tool in order to be able to configure it. Connection Server
The CORBA-based version of Connection Server is installed automatically whenever you install Business Objects server components. However, you also have the option of setting up a dedicated connectivity node in the cluster. (For detailed information, see the Deploying the Business Objects System guide.) To do this, you need to select only Connection Server in the tree list, along with the appropriate data access pack. Later, you configure a secondary node as the connectivity node. All RDBMS requests are then routed through this dedicated node. Active X Active X appears in the tree list only on an administrators machine. For other machines, you must use a command-line installation (see Administrative and Command Line Installations on page 69). Active X is called using:
ADDLOCAL=bo.activex INSTALLACTIVEX=1 DEFAULT_LANGUAGE=<language code>
59
This chapter covers installation using the Installation wizard. Command-line installations are explained in Administrative and Command Line Installations on page 69. The Installation wizard starts automatically (after the Welcome screen) when you insert your Business Objects CD into the CD drive. If the installation does not start automatically, use the Windows Explorer to browse to your CD drive, and then double-click setup.exe. If your Business Objects CD includes more than one language, you must select the language in which the Installation wizard runs.
60
NOTE
If you are updating from a previous release, have the original installation CDs available. Instructions below for running the installation are divided into: Desktop installation Server installation Custom installation
Desktop installation
To run a Desktop installation: 1. Insert Business Objects installation CD1 into the disk drive. The Choose Setup Language dialog box appears. 2. Click OK, and then on the Welcome page, click Next. The License Agreement appears. 3. Read the agreement carefully. - If you do not accept it, select I do not accept the terms in the license agreement, and then click Cancel. The Installation wizard closes. - If you accept it, select I accept the terms of this license agreement, and then click Next. The Installation Notes page appears. Late-breaking information about installing and configuring Business Objects appears on this page. Read these notes carefully. 4. Click Next. The wizard checks whether a previous version of Business Objects products has been installed. - If a previous version is detected, go to Previous version detected on page 67. - If no previous version is detected, the License Files Folder page appears.
61
5. If you want to change the location of the license file, click Change, and then browse to find the directory. To see a list of the licenses you have, click Check License. 6. Click Next. The User Information page appears. The Installation wizard suggests the user and company names found in the license files or the default system values. If you want to limit access to the user currently logged in, select Only for me. 7. Click Next. The Languages to Install page appears. 8. Select the languages you want, and then click Next. If you selected more than one language, you are prompted to select a default language. The Installation Type page appears.
If your operating system does not support server products, you see only the Desktop and Custom installation options. 9. Select Desktop installation. For an explanation, see Types of installation on page 56. 10. Click Next. The Ready to Install the Program page appears. 11. Click Install. The installation begins. When the Desktop installation is finished, you are ready to use Business Objects. Restart the machine before opening any products.
62
Server installation
To run a Server installation: 1. Insert Business Objects installation CD1 into the disk drive. The Choose Setup Language dialog box appears. 2. Click OK, and then on the Welcome page, click Next. The License Agreement appears. 3. Read the agreement carefully. - If you do not accept it, select I do not accept the terms in the license agreement, and then click Cancel. The Installation wizard closes. - If you accept it, select I accept the terms of this license agreement, and then click Next. The Installation Notes page appears. Late-breaking information about installing and configuring Business Objects appears on this page. Read these notes carefully. 4. Click Next. The wizard checks whether a previous version of Business Objects products has been installed. - If a previous version is detected, go to Previous version detected on page 67. - If no previous version is detected, the License Files Folder page appears. 5. If you want to change the location of the license file, click Change, and then browse to find the directory. To see a list of the licenses you have, click Check License. 6. Click Next. The User Information page appears. The Installation wizard suggests the user and company names found in the license files or the default system values. Do not select Only for me. 7. Click Next. The Languages to Install page appears. 8. Select the languages you want, and then click Next. If you selected more than one language, you are prompted to select a default language.
63
If your operating system does not support server products, you see only the Desktop and Custom installation options. 9. Select Server installation. For an explanation, see Types of installation on page 56. 10. Click Next. The Ready to Install the Program page appears. 11. Click Install. The installation begins. When the installation is completed, the Installation Wizard Completed page appears. In order to complete your installation, you need to perform configuration. Do either of the following: If you want to begin configuration now, select the Configure Server Products box, and then click Finish. Go to Configuration Overview and Scenarios on page 93. If you want to begin configuration later, clear the Configure Server Products box, and then click Finish. When you are ready to begin, Go to Configuration Overview and Scenarios on page 93.
64
Custom installation
To run a Custom installation: 1. Insert Business Objects installation CD1 into the disk drive. The Choose Setup Language dialog box appears. 2. Click OK, and then on the Welcome page, click Next. The License Agreement appears. 3. Read the agreement carefully. - If you do not accept it, select I do not accept the terms in the license agreement, and then click Cancel. The Installation wizard closes. - If you accept it, select I accept the terms of this license agreement, and then click Next. The Installation Notes page appears. Late-breaking information about installing and configuring Business Objects appears on this page. Read these notes carefully. 4. Click Next. The wizard checks whether a previous version of Business Objects products has been installed. - If a previous version is detected, go to Previous version detected on page 67. - If no previous version is detected, the License Files Folder page appears. 5. If you want to change the location of the license file, click Change, and then browse to find the directory. To see a list of the licenses you have, click Check License. 6. Click Next. The User Information page appears. The Installation wizard suggests the user and company names found in the license files or the default system values. If you want to limit access to the user currently logged in, select Only for me. Do not select it if you are installing server products. 7. Click Next. The Languages to Install page appears. 8. Select the languages you want, and then click Next. If you selected more than one language, you are prompted to select a default language.
65
If your operating system does not support server products, you see only the Desktop and Custom installation options. 9. Select Custom installation. For an explanation, see Types of installation on page 56. 10. Click Next. Setting custom installation options You now select the individual components you want to install. The components are organized by product families. A + next to the product name indicates that it contains other components.
If the icon is grey, then some components under that product are not selected. If the icon is white, all options are selected. If the icon has a red X, the option cannot be installed.
66
To select and install products: 1. Click the server icon next to a family, product, or component, and you see the feature options:
2. Select the option you want. Selecting a product automatically selects all products beneath it. 3. To modify the installation directory, click Change. You can set the root installation directory only; the subdirectories remain the same. Click Disk Space to make sure you have enough disk space to install the products. 4. Click Next. The Configure Folders page appears. 5. Modify the locations of the local and shared .key files if you want, and then click Next. .key files contain the address of the repository security domains. The .key file must be located on 2-tier users machines, as well as on all Business Objects server machines. The Ready to Install the Program page appears. 6. Click Install. The Installation wizard installs the products and components you selected. - If you performed a Custom installation without server products: When the Installation Wizard Completed page appears, you can begin using Business Objects. Restart the machine before opening any products. - If you performed a Custom installation that includes server products: The Installation Wizard Completed page contains an option to configure server products.
67
7. Do either of the following: - If you want to begin configuration now, select the Configure Server Products box, and then click Finish. Go to Configuration Overview and Scenarios on page 93. - If you want to begin configuration later, clear the Configure Server Products box, and then click Finish. When you are ready to begin, go to Configuration Overview and Scenarios on page 93.
If you upgrade from the previous version, when the installation begins, the Installation wizard starts the Business Objects 5.x setup program to uninstall version 5.x. If you keep the existing release, the wizard installs BusinessObjects 6.5 in a separate directory and does not perform an upgrade. The previous version remains as it was.
If the Installation wizard cannot find the Business Objects 5.x setup program, you must re-install the setup program from the original Business Objects 5.x CD: 1. Quit the Installation wizard by clicking Cancel. 2. Run the installer from your original Business Objects 5.x CD. 3. On the first page, select desktop products. 4. From Choose the Products and Modules, open the Utilities group, select Setup, and then click Install. 5. When the installation has finished, quit and re-start the 6.5 Installation wizard.
68
chapter
70
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This chapter explains how to perform administrative and command-line installations of BusinessObjects 6.5. To perform an installation using the Installation wizard, see Installing BusinessObjects 6.5 on page 41. An administrative installation allows users to run products from a central network location. It replaces the Master/Shared installation of earlier versions of Business Objects.
71
Command-line mode is an important feature for deployment and integration in other products. With it, you can: remotely install products using scripts or management systems embed the installation of BusinessObjects within your own installation script You can also launch the Configuration Tool in non-interactive (command line) mode. See Configuration Tool in Command Line Mode on page 141.
72
Administrative installations
An administrative installation has two stages: 1. From the CD, you run an Administrative installation to a shared network location. This makes a copy of the CD on the network. 2. Clients run the Installation wizard from the shared network location, installing the components on their local machine.
3. Run setup.exe with the /A property (type setup /A). The Installation wizard starts in administrative mode. 4. Continue through the wizard until you see the Network Location page. 5. Specify the shared network location of your administrative installation, and then click OK. If you want to change the destination folder, click Change. 6. Click Install. If you cancel the installation, the wizard rolls back the installation completely. The installation may take several minutes. 7. Click Finish.
73
Command-line installations
To perform a command-line installation, you run setup.exe from the command prompt, specifying certain parameters. If you run setup.exe without specifying any parameters, it runs in normal interactive mode. You can use command-line installations to install entire product families or individual products. For example, you can install only BusinessObjects in 3-tier mode. The installation has three components: BusinessObjects 6.5 Installation wizard InstallShield Windows Installer Command-line installations can include parameters for each of these components.
Syntax
The general syntax for command-line installations is:
setup.exe /<parameter 1> /<parameter 2> /<parameter 3> ........
Parameters for the BusinessObjects 6.5 Installation wizard and the Windows Installer must be preceded by /v:
setup.exe /v<parameter>=<value>
The /v specifies that the parameters that follow are passed directly to the Windows Installer and are not used by InstallShield. Parameters must be enclosed by quotation marks if there are spaces in the string. For examples of commands, see Command-line installation: examples on page 79. Path names Path names must contain a final backslash. If the parameter string has one or more spaces, and if the backslash is the final character in the string, insert a space between the backslash and the quotation mark. Otherwise \ will be read as a special character and cause unintended results. For example:
setup.exe /s /v/qn LICENSEDIR=\bo\licenses\
The LICENSEDIR, LOCALKEYDIR, and SHAREDKEYDIR parameters require values that are paths.
Command-line installations
74
InstallShield InstallShield parameters must be preceded by a forward slash (/). Some parameters, such as language codes, require values immediately afterward. These take the form:
setup.exe /<parameter>[value]
Values
0 for Keep 1 for Upgrade Default: 1
Description
Desktop products only. If Business Objects 5.x desktop products are detected, it defines what occurs: 0 keeps the existing installation and installs BusinessObjects 6.5 in a different directory. 1 uninstalls the older product, performs the upgrade, and migrates settings. Interactive installation only. When set to 1, it prompts the user to choose whether to upgrade or keep an existing Business Objects 5.x installation. When set to 0, the user does not see the prompt, and upgrade occurs or does not occur according to the value of MIGRATION. Mandatory for all command-line installations except an administrative or 3-tier BusinessObjects install. Defines the path to the directory containing the license files. Copy your license files to a directory on a client or server machine before running a command-line installation.
MIGRATIONPROMPT
1 or 0 Default: 1
LICENSEDIR
License directory
75
Parameter
INSTALL_LANG
Values
ISO language code in lower case
Description
Indicates the list of languages to be installed. If this property is not specified, the products are installed in the default language shown in interactive mode. This is English in most distributions. You can install more than one language by listing the ISO codes in lower case, separated by a comma. See Language Codes on page 283. Use only if you install more than one language. For desktop products only. Defines where a product looks for .key files and user .dll files. Has no impact on where the Business Objects products themselves are installed. Must end with a backslash (\).
DEFAULTLANG LOCALKEYDIR
ISO language code Default is either an existing previous release directory or the default Business Objects directory
Command-line installations
76
Parameter
SHAREDKEYDIR
Values
As above
Description
For desktop products only. Defines where a product looks for shared .key files. Has no impact on where the Business Objects products themselves are installed. Must end with a backslash (\). When set to 1, indicates that BusinessObjects is installed for use in 3-tier mode. Some files are then installed locally to reduce the download time when a user selects the option from InfoView. Note: Sets download to 1 in InfoView. If you want to customize the InfoView page to allow other downloads, reset this to 0. Set this to 1 if installation is being run from a script or batch file on a Business Objects server. Otherwise, do not specify this parameter.
THREETIERBUSOBJ
1 or 0 Default: 0
WEB
1 or 0 Default: 0
77
Values
Company name Default: system value. Any user name Default: system value. NULL, 1, or 2
Description
Determines where the configuration information of the installed application is stored. NULL: Per-user installation using folders in user's personal profile. 1: Per-machine installation using folders in the All Users profile. Checks for administrative access privileges and returns an error message if they are not sufficient. 2: Per-machine installation using folders in the All Users profile.
INSTALLDIR ADDLOCAL
Root installation directory Must end with a backslash (\). Products to be installed Installs products on local machine. Multiple product names can be listed, separated by a comma. You must specify the code for each component of the product, not just the generic product name. At a minimum, this usually includes the application code, the online help code, and the documentation code. For product codes, see Business Objects Products and Feature Codes on page 277.
INSTALLVBA
Command-line installations
78
Parameter
INSTALLTYPE
Values
NULL if ADDLOCAL is defined 1 if desktop installation 2 if server installation Default is 1
Description
Allows you to install either desktop or server products. Only products for which you have a license are installed.
ADDSOURCE
Packages to be installed. Installs products to run from the network. Multiple product names can be listed, separated by a comma. Note that you must specify the code for each component of the product, not just the generic product name. Normally this would include the application code, the online help code and the documentation code as a minimum. Codes for the products are listed in Appendix B. Products to be removed Removes products from local machine. Multiple product names can be listed, separated by a comma. You must specify the code for each component of the product, not just the generic product name. At a minimum, this usually includes the application code, the online help code, and the documentation code. For product codes, see Business Objects Products and Feature Codes on page 277. Instructs Windows Installer component to run in silent mode. Always preceded by the Install Shield parameter /s and, because it is a Windows Installer parameter, immediately preceded by the Install Shield parameter /v. The syntax is: setup /s /v /qn...
REMOVE
/qn
None
79
InstallShield parameters
The following table shows the InstallShield parameters. Parameter
/a /x /v /s
Name
Administrative installation Uninstallation Pass to Windows Installer Silent mode
What it does
Copies the Business Objects CDs to a shared network location. Uninstalls the entire product. Passes parameters and associated values to the Windows Installer service. Suppresses the InstallShield initial Preparation and Language choice windows. Used with the Windows Installer option /qn. Must be followed by the ISO language code. See Language Codes on page 283 for a list. Forces setup.exe to wait until installation is complete before exiting.
/L
Installation language
/w
Wait
The only parameters usually used alone are /a and /x. For example, to remove the entire BusinessObjects 6.5 installation:
setup /x
Command-line installations
80
Include the names of all components that need to be removed. For example, to remove Supervisor, you would specify the Supervisor application, the online help, and the documentation:
/vREMOVE=bo.SupervisorApp,bo.SupervisorHelp,bo.SupervisorDoc
See Business Objects Products and Feature Codes on page 277 for a list of features and codes. Installing a product locally Include the names of all components that need to be installed. For example, to install Designer locally:
setup /vLICENSEDIR=c:\bolicense ADDLOCAL=bo.DesignerApp,bo.DesignerDoc, bo.DesignerHelp
Installing all desktop products This installs all desktop products for which you have a license.
setup /vLICENSEDIR=c:\bolicense INSTALLTYPE=1
Installing several languages and products When you install more than one language, you must specify the default. The example shows the command line for installing English, French, and German with French as the default, plus adding Designer to run locally:
setup /vLICENSEDIR=c:\bolicense INSTALL_LANG=en,fr,ge DEFAULTLANG=en ADDLOCAL=bo.DesignerApp,bo.DesignerDoc,bo.DesignerHelp
Performing a silent installation Performing a silent installation combines the /s parameter from InstallShield with the /qn parameter from the Windows Installer. You must include both for the installation to be totally silent:
setup /s /v /qn LICENSEDIR=D:\bolicense\
After ADDLOCAL, make sure you use the predefined.setup.invisible option. This sets the PATH environment variable. Otherwise, the user will not be able to log in to WebIntelligence. For example:
ADDLOCAL=bo.WebIntelligence,bo.WebIntelligenceReporter, bo.WebIntelligenceExplorer,......predefined.setup.invisible
81
Performing a silent install of several languages and packages This combines the different parameter types:
setup /s /v/qn LICENSEDIR=c:\bolicense\ INSTALL_LANG=en,fr,ge DEFAULTLANG=en ADDLOCAL=bo.DesignerApp,bo.DesignerDoc,bo.DesignerHelp
Command-line installations
82
chapter
84
Overview
This chapter explains how to modify or remove an existing BusinessObjects 6.5 installation. This includes: adding a product removing a product repairing an installation removing the installation entirely You can only add products for which you have a license. You must copy the license file to your license directory before you run the installer. You must log on as administrator in order to perform the procedures in this chapter.
85
Adding a product
When you purchase an additional Business Objects product, add the license file to the same directory where your other licenses are stored. If you are installing components of BusinessObjects 6.5 on different nodes within a cluster, make sure the license files are available in a network location to which all nodes have access. You add products using the BusinessObjects 6.5 Installation Wizard.
NOTE
You can add and remove products at the same time in the Installation Wizard. The instructions are divided into adding and removing for the sake of clarity. To add a product: 1. Run the BusinessObjects 6.5 Installation Wizard from either: - the Business Objects installation CD - Add/Remove Programs in the Windows Control Panel The Welcome page appears. 2. Click Next. The Program Maintenance page appears. 3. Selecte Modify, and then click Next. The Custom Setup page appears. 4. Select the products you want. See Running the installation on page 59 for instructions. A cross next to a product name means that it is not installed. You can select any combination for which you have a license. You cannot select server products if your platform does not support them.
Adding a product
86
5. When you finish your selections, click OK to return to the Custom Setup page. 6. Click Next. The Ready to Modify the Program page appears. 7. Click Install. The installation begins. If you cancel, the Installation wizard rolls back the installation by: - removing any files copied - removing any registry keys that have been set The Installation Wizard Completed page appears. 8. Click Finish. Depending on the version of your operating system and the products you added, you may need to restart the machine.
87
Removing products
When you remove products, do not delete or modify the license file. To remove products: 1. Run the BusinessObjects 6.5 Installation wizard from either: - the installation CD - Add/Remove Programs in the Windows Control Panel The Welcome page appears. 2. Click Next to continue. The Program Maintenance page appears. 3. Select Modify, and then click Next. The Custom Setup page appears. Only licensed products currently on your hard disk are displayed. 4. To select a product to remove, expand the tree by double-clicking on the product family name. Click the product, and then select This feature will be removed from your local hard drive from the menu that appears. A red X next to the product shows that it will be removed.
5. Finish making your selections, and then click Next. The Ready to Modify the Programs page appears. 6. Click Install. The product is removed.
Removing products
88
Repairing an installation
Sometimes a BusinessObjects 6.5 installation becomes disrupted and is no longer operational. This may be caused, for example, by an interrupted installation or the unintended deletion of a file. The Installation wizard usually enables you to repair the installation. The repair mechanism cannot retrieve corrupted user data, license files, or customized files. Your backup strategy is the only way to recover these files. To repair an installation: 1. Run the BusinessObjects 6.5 Installation wizard from either: - the installation CD - Add/Remove Programs in the Windows Control Panel The Welcome page appears. 2. Click Next. The Program Maintenance page appears. 3. Select Repair, and then click Next. The Ready to Repair the Program page appears. 4. Click Install. Installation wizard now checks your installation and installs any files necessary for the repair. This may take several minutes.
89
90
Applying a hotfix
Hotfixes resolve bugs that cannot wait for the next minor release or service pack. Hotfixes are available either by download from the Business Objects website or by email on request. New releases incorporate hotfixes issued since the previous minor release or service pack. Because hotfixes replace individual program or library files, there is no need to uninstall your Business Objects installation. Also, your configuration files are not affected. Always check the readme that comes with the hotfix to make sure that you can apply it to your system, and to see whether there are any special instructions. Apply the hotfix by copying the patch_<hotfix number>.exe file to a directory on your hard disk, then running it.
Configuration
part
chapter
94
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This chapter describes the different configuration tools and methods you can use to configure Business Objects server products. Your choice of tool and method depends on: the application and web servers you are using how you have organized your deployment
95
Configuration Tool
The Configuration Tool allows you to configure the ORB, and to deploy Business Objects web applications on the web server and application server. If you are using IIS or Apache/Tomcat, you can use the Configuration Tool for this entire process. In this case, you need to install the tool on the Business Objects server, web, and application server machines. If you are using other web and application servers, you must: use the Configuration Tool to configure the ORB use the wdeploy tool to deploy and configure the web applications You can run the Configuration Tool immediately after installing BusinessObjects 6.5, or any time afterward.
96
Even if your web server is not within the cluster, you must still install and run the Configuration Tool so that the web server can communicate with the cluster and vice versa. Who can use the Configuration Tool Although any user can start the Configuration Tool, some specific permissions are required. Log on as an administrator or the equivalent. The account must have the following rights: Act as part of the operating system Log on as a service Use Windows User Manager to assign these rights before you run the Configuration Tool. You must restart the Business Objects system for these rights to take effect. IIS Administration service During the deployment of IIS as web server and application server (using the Configuration Tool), the IIS Administration service is automatically stopped. Therefore, IIS is not available during this part of the configuration process. Make sure Apache and Tomcat are stopped Apache and Tomcat must not be running while you configure Business Objects server products. To stop Apache and Tomcat: 1. In the Windows Start menu, point to Settings > Control Panel > Administrative Tools > Services. 2. Right-click Apache and select Stop from the menu. 3. Right-click Apache Tomcat 4.1, and select Stop from the menu. TCP ports The server uses a number of TCP ports for inter-machine process communication. One port is allocated for each Business Objects process that is running; for example, WIAdminServer or WIQT. These ports must be free; otherwise, the system cannot function correctly. Normally, with default settings, between 20 and 30 ports are needed. The first port to be used is the one you set in the Configuration Tool. (See Configuring the ORB on page 113.) If you do not have a sufficient number of ports available, you can change the number of the first port.
97
After you complete configuration and start the Business Objects system, in the Administration Console you can start or stop processes and modify the number of instances for pools of processes. Keep in mind that this changes the number of TCP ports that are required. Using a firewall You can set up a firewall between the Business Objects server and the application server (for details, see the Deploying the Business Objects System guide). If you use this kind of firewall, you need to make sure that certain ports are open. These ports are displayed in the Administration Console, when the server is selected (Exposed Ports area). If your cluster contains primary and secondary nodes, you need to open ports for the primary and all secondary nodes. Command-line mode The Configuration Tool can also run from the command line, and you can supply it with parameters from a text file. See Configuration Tool in Command Line Mode on page 141.
wdeploy tool
wdeploy is a command-line tool that can deploy Business Objects web applications on any web server and application server for JSP deployments. If you are not using IIS or Apache/Tomcat, you must use the wdeploy tool to deploy and configure your web applications. The wdeploy tool offers great flexibility in the deployment of web applications. It enables you to: create .war files for Business Objects web applications include in the .war file elements that are specific to a cluster, an ORB, or an application server add static resources to the .war file, so that you can deploy your application server in standalone mode deploy and remove a web application Even if you use wdeploy, you still need to install the Configuration Tool to configure the ORB.
98
Manual configuration
Most of the configuration procedures can be done manually, without using the Configuration Tool or wdeploy. This may be appropriate for highly-skilled administrators with special configuration requirements. Even if you perform manual configuration, you still must use the Configuration Tool to configure the ORB. For full details on manual configuration, see the Manual Web and Application
Server Configuration guide.
99
100
What goes on the application server, and what on the web server?
Business Objects web applications are made of dynamic and static resources. Dynamic resources are contained in a .war (Web Archive) file, which must be deployed on the clusters application server. Static resources such as HTML and GIF files are contained in a .zip file, which must be unzipped on the clusters web server.
Users Business Objects server InfoView Supervisor Administration Console
These .war and .zip files are automatically installed on the Business Objects server machine by the standard setup process.
Making sure you deploy all the web applications you need
Because you probably need to deploy more than one Business Objects web application, the procedures described in this guide are often repetitive. To help keep track of what you have already deployed, you will see a standardized checklist containing the names of the web applications: Web applications to deploy InfoView Admininistration Console Supervisor over the Web Auditor
101
Configuration scenarios
The sections below explain four configuration scenarios that are based on four common deployments. You can use a scenario as a guide for your own configuration. If you do not want to follow a scenario, go to Configuring the ORB on page 113. Each scenario includes the procedures you follow for configuring the ORB, service parameters, and web applications using a scenario. There are four scenarios: Scenario 1 -- Apache/Tomcat or IIS on a single machine Scenario 2 -- Two machines/web and application servers together Scenario 3 -- Two machines/E6 and application server together Scenario 4 -- Three machines/web and application server separate
Configuration scenarios
102
Users
Intranet
With this scenario, you perform a a largely-automated configuration process. This makes use of the Typical wizard within the Configuration Tool. Within the context of this guide, a standalone deployment is one in which all the web applications resources are located on the application server. To use Scenario 1, you must have: Business Objects server products, the web server, and the application server on a single machine IIS or Apache/Tomcat one IP address one cluster with one primary node no external authentication; authentication and authorization performed only on the repository For single-machine deployments that do not meet all of these conditions, follow the configuration procedures that begin with Configuring the ORB on page 113. You must finish installation of BusinessObjects 6.5 before beginning the procedures.
103
In this scenario, you can configure and deploy InfoView, Supervisor over the Web, and the Administration Console. You cannot deploy Auditor or customized applications. The web applications are configured using the default web application names: wijsp or wiasp for InfoView, wiadmin for Admin and wsupervisor for Supervisor over the Web. These cannot be changed.
Where to go now
When you finish your configuration using the Typical wizard, go to Getting the System Ready on page 221.
104
Intranet
Machine
Machine 1 Machine 2
What is installed on it
Business Objects server Configuration Tool (to configure the ORB) Application server Configuration Tool (to configure the ORB) Web server
To use Scenario 2, you must have: a machine hosting the Business Objects server and the Configuration Tool This is the primary node. a second machine with the web server, application server, and the Configuration Tool This is the client node.
105
For two-machine deployments that do not meet these conditions, either: follow the configuration procedures that begin with Starting the Configuration Tool on page 116. follow Scenario 3 on page 106 if it fits your deployment You must finish installation of BusinessObjects 6.5 before beginning the procedures.
Configuring machine 1
On Machine 1, you configure the ORB for a primary node. Follow the instructions in Starting the Configuration Tool on page 116.
Configuring machine 2
Machine 2 contains the application server and web server. You must perform the following two procedures: Using the Configuration Tool, configure the ORB for a client node Deploy the web applications. This can be done with the Configuration Tool or with the wdeploy tool. Configuring the ORB for a client node The procedure for configuring client nodes is very similar to that of the primary node. The main differences are: On the Node page, you select Client from the Node Type drop-down list. You do not have to set service parameters for client nodes. Follow the procedure in Secondary or client node on page 120. Deploying the web applications You can deploy your web applications on the application server and web server by using the the Configuration Tool (IIS or Apache/Tomcat only) or the wdeploy tool. If you want to use the Configuration Tool, see Deploying Web Applications Using Configuration Tool on page 155. If you want to use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181. If you want to deploy and configure the web server and application server manually, see the Manual Web and Application Server Configuration guide.
106
Intranet
Machine
Machine 1
What is installed on it
Business Objects server Application server Configuration Tool (to configure the ORB) Configuration Tool Web server
Machine 2
To use Scenario 3, you must have: a machine with the Business Objects server, the Configuration Tool, and the application server This is the primary node. a second machine with the web server For two-machine deployments that do not meet these conditions, either: follow the configuration procedures that begin with Configuring the ORB on page 113. follow Scenario 2 on page 104 if it fits your deployment
107
You must finish installation of BusinessObjects 6.5 before beginning the procedures.
Configuring machine 1
Machine 1 contains the Business Objects server, the application server, and the Configuration Tool. You must perform the following two procedures: Using the Configuration Tool, configure the ORB for a primary node Deploy and configure the web applications on the application server. This can be done with the Configuration Tool or with the wdeploy tool. Configuring the ORB for a primary node On Machine 1, you configure the ORB for a primary node. Follow the instructions in Configuring the ORB on page 113. Configuring the application server You can deploy and configure your web applications on the application server by using the the Configuration Tool (Apache/Tomcat) or the wdeploy tool. If you want to use the Configuration Tool, go to Apache/Tomcat on page 164 and follow the instructions for application server only. If you want to use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181. If you want to configure the web applications manually, see the Manual Web and Application Server Configuration guide.
Configuring machine 2
Machine 2 contains the web server. You need to deploy the static resources for each web application on the web server, and then add the virtual directories and redirections. You can do this by using the the Configuration Tool (Apache/Tomcat) or the wdeploy tool. If you want to use the Configuration Tool, go to Apache/Tomcat on page 164. If you want to use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181. If you want to configure manually, see the Manual Web and Application Server
Configuration guide.
108
Where to go now
If you want to deploy customized web applications on the web server, see Customized web applications on page 168. If you have no other products to configure on this machine, click Finish to quit the Configuration Tool. You must now perform a number of procedures to finalize your installation and configuration of BusinessObjects 6.5. Go to Getting the System Ready on page 221.
109
Intranet
Machine
Machine 1 Machine 2 Machine 3
What is installed on it
Business Objects server Configuration Tool (to configure the ORB) Application server Configuration Tool (to configure the ORB) Web server Configuration Tool
To use Scenario 4, you must have: a machine with the Business Objects server and the Configuration Tool This is the primary node. a second machine with the application server and the Configuration Tool This is the client node. a third machine with the web server For three-machine deployments that do not meet these conditions, follow the configuration procedures that begin with Configuring the ORB on page 113.
110
You must finish installation of BusinessObjects 6.5 before beginning the procedures.
Configuring machine 1
On Machine 1, you configure the ORB for a primary node. Follow the instructions in Configuring the ORB on page 113.
Configuring machine 2
Machine 2 contains the application server and the Configuration Tool. You must perform the following two procedures: Using the Configuration Tool, configure the ORB for a client node Deploy the web applications on the application server This can be done with the Configuration Tool (Apache/Tomcat) or with the wdeploy tool. Configuring the ORB for a client node The procedure for configuring client nodes is very similar to that of the primary node. The main differences are: On the Node page, you select Client from the Node Type drop-down list. You do not have to set service parameters for client nodes. Follow the procedure in Secondary or client node on page 120. Deploying the web applications You can deploy and configure your web applications on the application server by using the the Configuration Tool (Apache/Tomcat) or the wdeploy tool. If you want to use the Configuration Tool, go to Apache/Tomcat on page 164 and follow the instructions for application server only. If you want to use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181. If you want to configure the web applications manually, see the Manual Web and Application Server Configuration guide.
Configuring machine 3
Machine 3 contains the web server. You need to deploy the static resources for each web application on the web server, and then add the virtual directories and redirections. You can do this by using the the Configuration Tool (Apache/Tomcat) or the wdeploy tool.
111
If you want to use the Configuration Tool, go to Web server on page 166. If you want to use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181. If you want to configure manually, see the Manual Web and Application Server Configuration guide.
Where to go now
If you want to deploy customized applications on the web server, see Customized web applications on page 168. If you have no other web applications to configure on this machine, click Finish to quit the Configuration Tool. You must now perform a number of procedures before you start the Business Objects system. Go to Getting the System Ready on page 221.
112
chapter
114
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
For a general overview of configuration, see Configuration Overview and Scenarios on page 93.
Order of configuration
You must configure the ORB on each node in the cluster. If you installed everything on one server, you must configure it as the primary node.
115
You configure the parts of your deployment in the following order: 1. Primary node. You must always configure the primary node first, as other nodes need to use its configuration information. 2. Secondary nodes. 3. Client nodes, if required. Client nodes are machines that host web or application servers that are used by the cluster, but do not actively participate in it.
Typical configuration
Typical configuration is a largely-automated configuration process that makes use of the Typical wizard within the Configuration Tool. The Typical wizard configures the ORB and deploys the web applications. For instructions, see Typical Configuration on page 127. To use Typical configuration, you must have: Business Objects server products, the web server, and the application server on a single machine IIS or Apache/Tomcat one IP address one cluster with one primary node no external authentication; authentication and authorization performed only on the repository For single-machine deployments that do not meet all of these conditions, start the ORB configuration procedures that begin in the next section.
116
To start the Configuration Tool: 1. Do either of the following: - Select it on the last page of the Installation wizard. The Tool runs in the language you chose for all products during installation. The first page to appear is Configuration Options (go to Step 4). - Run it from the Windows Start menu or from the command prompt. The Configuration Tool is located in $INSTALLDIR\bin\scripts. The Language Selection page appears. 2. Select the language you want, and then click Next. You can choose any language installed on your system. This applies to the current session. It has no impact on the language used for your Business Objects products. The Welcome page appears. 3. Click Next. The Configuration Options page appears.
117
4. Select a type of configuration: - You can choose Typical only if you have a standalone server on a single node. Go to Typical Configuration on page 127. - Otherwise, select Custom, and then click Next. The Cluster Preferences page appears. 5. Accept the default cluster name or enter a new one, and then click Next. You can use only the following characters: - letters: A-Z and a-z - numbers: 0-9 - dash: - - underscore: _ The Cluster Management page appears.
On this page, you configure all the nodes in your cluster. You must define the ORB for every node that is part of the cluster or is accessed by it.
118
Primary node
To configure the primary node: 1. On the Cluster Management page, select ORB, select Define ORB from the drop-down list, and then click Next. The Node page appears.
Because the primary node is central to the operation of your cluster, you must always configure it first. If you have already configured a primary node and want to create either of the other types, go to Secondary or client node on page 120. 2. Make sure the node type is set to Primary. 3. Change the IP address or hostname, and first TCP port, if you want. (See TCP ports on page 96.) - If you are using DHCP, you must enter a hostname. - If you want to check whether a certain number of ports are available, set the Last port for test, and then click Test ports. The last port setting is for testing purposes only. 4. Click Next. The Configuration Tool saves the ORB and primary node configuration and displays a confirmation message.
119
6. Select the services you want, and whether you want them to start automatically when the server is started: - WebIntelligence Service This defines the Business Objects server as a service. - Universal Drill Through Service (UDS) This enables WebIntelligence users to drill through between different data sources. The port must be unique and between 12000 and 65000. - WebIntelligence OLAP Cache Service This optional service improves the response time of OLAP databases having a large number of members on a dimension/level. The port must be unique and between 12000 and 65000. 7. At the bottom of the page, define the account used to start any of these services. The account must have the following rights: - act as part of the operating system - log on as a service
120
NOTE
When you specify a domain user, be aware that if you change the domain password, you must use the Configuration Tool to change the password on each individual cluster node. 8. Click Next. Configuration Tool configures the services. The Cluster Management page re-appears. If you want to configure a secondary or client node, continue to the next section. Otherwise, you are now ready to deploy and configure your web applications on the application server. To do this, go to either: Deploying Web Applications Using Configuration Tool on page 155 Deploying Web Applications Using wdeploy on page 181. To configure cluster storage (highly recommended), go to Setting cluster storage on page 122. If you want to change cluster preferences, go to Changing cluster settings on page 123.
121
To configure a secondary or client node: 1. Access the Node page of the Configuration Tool. 2. In the Node Type drop-down list, select Secondary or Client.
3. On the Local Node tab, set the IP address or hostname of the local node (the one you are configuring), and the first TCP port that will be used by the local node. (See TCP ports on page 96.) - If you are using DHCP, you must enter a hostname. - If you want to check whether a certain number of ports are available, set the Last port for test, and then click Test ports. 4. On the Primary Node tab, set the IP address or hostname of the primary node of your cluster, as well as the first TCP port used by this primary node. - The IP address or hostname must be the same as the one you used when configuring your primary node. If you are using DHCP, it must be a hostname. - The primary node must be running. Use Test connection to primary node to check whether the connection with the primary node is working correctly. 5. Click Next. The ORB and node configuration is saved. If you have configured a secondary node, the Configuration Tool prompts you to set cluster storage. Cluster storage is highly recommended (see next section). 6. Repeat the above process for any other secondary or client nodes you want to configure.
122
Where to go now
To deploy and configure your web applications on the application server and web server, go to either: Deploying Web Applications Using Configuration Tool on page 155 Deploying Web Applications Using wdeploy on page 181.
123
124
3. Make the changes you want. - Scroll down to see additional directories. - The directory you select must already exist. You cannot create new ones. 4. Click Finish. The Cluster Management page re-appears.
125
Removing a node
When you remove a node, all configuration and deployment information is deleted. You must remove the node before uninstalling BusinessObjects 6.5. If you are using IIS, stop the IIS Services before removing the node. Removing the node deletes all files located in $INSTALLDIR/nodes/<hostname>/ <clustername>/. This includes storage, Administration Console settings, and bomain.key. If you want to keep these settings, back them up before beginning the procedure below. To remove a node: 1. Open the Cluster Management page of the Configuration Tool.
2. Highlight the cluster, and then select Delete this cluster from the drop-down list. 3. Click Next, and then click Finish.
Removing a node
126
Typical Configuration
chapter
128
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. This chapter describes configuration using the Typical wizard of the Configuration Tool. For a general overview of configuration, see Configuration Overview and Scenarios on page 93. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
Typical Configuration
129
To use Typical configuration, you must have: Business Objects server products, the web server, and the application server on a single machine IIS or Apache/Tomcat as application server and web server no external authentication; authentication and authorization performed only on the repository For single-machine deployments that do not meet all of these conditions, follow the configuration procedures in Configuring the ORB on page 113.
130
To start the Typical wizard: 1. Start the Configuration Tool by either: - selecting it on the last page of the Installation wizard. The Tool runs in the language you chose for all products during installation. The first page to appear is Configuration Options (go to Step 4). - running it from the Windows Start menu or from the command prompt. The Configuration Tool is located in $INSTALLDIR\bin\scripts. The Language Selection page appears. You can select any language installed on your system. This only applies to the current session. It has no impact on the language used for your Business Objects products. 2. Select the language you want, and then click Next. The Welcome page appears. 3. Click Next. The Configuration Options page appears.
4. Select Typical, select Using Active Server Pages or Using Java Server Pages, and then click Next. The Cluster Management page appears.
Typical Configuration
131
The remainder of the instructions are divided according to the technology you selected: for ASP technology, go to ASP technology on page 132 for JSP technology, go to JSP technology on page 136 When you select ASP, your application server can be deployed in standalone mode only.
132
ASP technology
Now you configure the ORB and web applications on IIS. 1. On the Cluster Preferences page, type a name for the cluster, and then click Next. The Node page appears.
2. Change the IP address and first TCP port if you want. (See TCP ports on page 96.) If you want to check whether a certain number of ports are available, set the Last port for test, and then click Test ports. The last port setting is for testing purposes only. 3. Click Next. The Configuration Tool saves the ORB and primary node configuration and displays a confirmation message.
Typical Configuration
133
The Configuration Tool automatically detects IIS as application server. 5. Make sure IIS is selected, and then click Next. The Configuration Tool configures IIS and displays a confirmation message. 6. Click OK. The Service page appears.
ASP technology
134
Service parameters allow you to set the Business Objects server to run automatically and as a Windows service. 7. Select the services you want, and whether you want them to start automatically when the server is started: - WebIntelligence Service - Universal Drill Through Service (UDS) This enables WebIntelligence users to drill through between different data sources. Set the port. - WebIntelligence OLAP Cache Service This allows users to use the search function within WebIntelligence for OLAP. Set the port. 8. At the bottom of the page, define the account used to start any of these services. The account must have the following rights: - act as part of the operating system - log on as a service If you have not assigned these rights, click Cancel to quit the Configuration Tool, and then use Windows User Manager to assign the rights. You must restart the system for the rights to take effect.
NOTE
When you specify a domain user, be aware that if you change the domain password, you must use the Configuration Tool to change the password on each individual cluster node.
Typical Configuration
135
9. Click Next. The Configuration Tool completes the configuration, confirms that the service parameters have been set, and displays the Cluster Management page with your current configuration. InfoView, Supervisor over the Web, and the Administration Console (Admin) have been deployed on IIS.
10. Click Finish. You must now perform a number of procedures before you start the Business Objects system. Go to Getting the System Ready on page 221.
ASP technology
136
JSP technology
Now, you configure the ORB and deploy the web applications on the application server (Tomcat) and web server (Apache). 1. On the Cluster Preferences page, type a name for the cluster, and then click Next. The Node page appears.
2. Change the IP address and first TCP port if you want. (See TCP ports on page 96.) If you want to check whether a certain number of ports are available, set the Last port for test, and then click Test ports. The last port setting is for testing purposes only.
Typical Configuration
137
3. Click Next. The Configuration Tool saves the ORB and primary node configuration and displays a confirmation message. The Cluster Management page appears.
If the Configuration Tool does not detect Tomcat, select Manual application server detection, and then browse or enter the location of the Tomcat installation folder. Modify the location of the server.xml file, if necessary.
JSP technology
138
4. Click Next. The Configuration Tool completes the configuration and displays the Cluster Management page with your current configuration.
The Typical wizard automatically detects Apache. 5. Modify the following if necessary: - Location of the configuration files (httpd.conf) - Web site or virtual host
Typical Configuration
139
Service parameters allow you to set the Business Objects server to run automatically and as a Windows service. 7. Select the services you want (and whether you want them to start automatically when the server is started): - WebIntelligence Service - Universal Drill Through Service (UDS) This enables WebIntelligence users to drill through between different data sources. Set the port. - WebIntelligence OLAP Cache Service This allows users to use the search function within WebIntelligence for OLAP. Set the port. 8. At the bottom of the page, define the account used to start any of these services. The account must have the following rights: - act as part of the operating system - log on as a service If you have not assigned these rights, click Cancel to quit the Configuration Tool, and then use Windows User Manager to assign the rights. You must restart the system for the rights to take effect.
JSP technology
140
NOTE
When you specify a domain user, be aware that if you change the domain password, you must use the Configuration Tool to change the password on each individual cluster node. 9. Click Next. The Configuration Tool completes the configuration, confirms that the service parameters have been set, and displays the Cluster Management page with your current configuration. InfoView, Supervisor over the Web, and the Administration Console (Admin) have been deployed on Apache/Tomcat. 10. Click Finish. You must now perform a number of procedures before you start the Business Objects system. Go to Getting the System Ready on page 221.
Typical Configuration
chapter
142
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This chapter describes how to use the Configuration Tool in command-line mode. For Configuration Tool in interactive mode, see Configuring the ORB on page 113. For a general overview of configuration, see Configuration Overview and Scenarios on page 93.
143
Note that [value] is optional and depends on the parameter that precedes it.
144
Parameters
The following table shows the parameters used from the command line. Parameter
-cmdline -help -cmdfile <filename> -language <language code>
What it does
Starts Configuration Tool in command-line mode. Displays the help for the parameters you can use. Specifies the name of the text file containing node parameters. Specifies the language in which Configuration Tool runs. Use standard ISO format: en, fr, nl, and so on. See Language Codes on page 283. For example, to run Configuration Tool in French: configtool -cmdline -language fr Suppresses the splash screen. Deletes the current node. You must first stop the cluster.
-nosplash -delete
File format The parameters file must have the following format:
[Section header] <parameter1>=<value1> <parameter 2>=<value2> ......
145
For example, the following code fragment shows part of the creation of a primary node:
[CREATE ORB] NODE_TYPE=PRIMARY LOCAL_IPADDR=10.6.128.192 LOCALPORTMIN=1000
Value
<cluster name>
Description
The name of the cluster.
Value
<cluster name>
Description
The name of the cluster.
146
Value
PRIMARY SECONDARY CLIENT <IP address> <port range start>
Description
Type of node.
LOCAL_IPADDR LOCAL_PORTMIN
IP address or hostname of the server you want to configure. The start number of the TCP port range to use on the local node. IP address of the primary node if you are configuring a secondary or client node. The start number of the TCP port range of the primary node if you are configuring a secondary or client node.
PRIMARY_IPADDR
<IP address>
PRIMARY_PORTMIN
Value
0 1 0 1
Description
Enter a value of 1 to define the WebIntelligence Service in Windows Services. Enter a value of 1 to start the WebIntelligence service automatically when the node is started. Enter a value of 1 to start the WebIntelligence Universal Drill-Through Service automatically when the node is started. Enter a value of 1 to start the WebIntelligence Universal Drill-Through Service automatically when the node is started.
NODE_AUTOSTART
UDS_SERVICE
0 1
UDS_SERVICE_AUTOSTART
0 1
147
UDS_SERVICE_PORT
Port used by the WebIntelligence Universal Drill-Through Service. Enter a value of 1 to define the WebIntelligence OLAP Cache Service. Enter a value of 1 to start the WebIntelligence OLAP Cache Service automatically when the node is started. Port used by the WebIntelligence OLAP Cache Service. Windows domain name. If the node is defined as a service, domain used to authenticate the account that starts the service. Name of the user account. If the node is defined as a service, account used to start the service. Password for the user account used to start the service.
OLAP_CACHE_SERVICE
OLAP_CACHE_SERVICE_ AUTOSTART
USERNAME
<user account>
PASSWORD
<password>
148
Value
INFOVIEW ADMIN AUDITOR SUPERVISOR Customized Applications <application name>
Description
Type of application to delete.
APP_NAME
Section header: [ADD WEB SERVER] and [DELETE WEB SERVER] Parameter
APP_TYPE
Value
INFOVIEW ADMIN AUDITOR SUPERVISOR Customized Applications <application name> APACHE 0 1
Description
Type of application to deploy on the web server.
Name of the application you want to add. Type of web server. 0 to use JSP 1 to use ASP
<web server instance> Name of the web server instance. <virtual directory> <directory name> Name of the virtual directory. Path to the directory where the web server is installed.
149
Parameter
CFGFILE_LOC_0
Value
<directory>
Description
Directory where the configuration files for the web server are installed. For Apache only. Name of the web server configuration file. For Apache only. Mandatory if APP_TYPE=Customized Applications. Sets the name of the resources file, if applicable.
CFGFILE_NAME_0 RESFILENAME
<filename> <filename>
Section header: [ADD APP SERVER] and [DELETE APP SERVER] Parameter
APP_TYPE
Value
INFOVIEW ADMIN AUDITOR SUPERVISOR Customized Applications <application name> TOMCAT IIS <application server instance>
Description
Type of application to deploy.
Name of the application to deploy. Type of application server. Name of the application server instance. For Apache/Tomcat, this is mandatory only if ASSTANDALONE=1. Web application to deploy. Path to the directory where the application server is installed. Leave blank if ASTPE = IIS. Directory where the configuration files for the application server are installed. Set only if this is not the default directory. Name of the application server configuration file. Set only if this is not the default.
ASWEBAPPNAME ASINSTALLDIR
CFGFILE_LOC_0
<directory>
CFGFILE_NAME_0
<filename>
150
Parameter
CFGFILE_LOC_1
Value
<directory>
Description
Tomcat only. Directory where the XML files for Tomcat are installed. Set only if this is not the default directory. Tomcat only. Name of the Tomcat XML configuration file. Set only if this is not the default name. Enter: 0 if your application server is not standalone 1 if your application server is standalone and also serves as a web server Applies only if ASTYPE = IIS. Enter: 0 to use JSP 1 to use ASP Mandatory if APP_TYPE=Customized Applications. Enter the name of the WAR file to deploy.
CFGFILE_NAME_1
<filename>
ASSTANDALONE
0 1
ASP
0 1 <filename>
WARFILENAME
Value
<cluster name>
Description
The name of the cluster.
Value
<directory> <directory> <directory> <directory> <directory> <directory> <directory>
Description
locdata directory Universe directory Document directory libs directory userBQY directory shData directory Logs directory
151
Parameter
TEMP_DIR TEMPLATES_DIR SCRIPTS_DIR STORAGE_DIR IMAGE_DIR
Value
<directory> <directory> <directory> <directory> <directory>
Description
Temporary directory Templates directory Scripts directory Storage directory. It must be shared by the cluster. Image directory
152
ASSTANDALONE=1
153
154
chapter
156
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
Now that youve defined your cluster and configured its ORB, the next step is deploying the Business Objects web applications on the clusters web and application servers, then configuring those servers to work with the applications. This chapter explains how to do this using the Configuration Tool. To use the wdeploy tool, see Deploying Web Applications Using wdeploy on page 181.
NOTE
If you are not using IIS or Apache/Tomcat, you must use wdeploy.
157
If you want to deploy and configure the web server and application server manually, see the Manual Web and Application Server Configuration guide. You can deploy and configure the following web applications: InfoView Allows users to access WebIntelligence and WebIntelligence for OLAP. Every cluster must have this. Admin Allows administrators to access the Administration Console. Every cluster must have this. Supervisor over the Web Needed if you want your supervisors to manage users and user groups from a web browser. BusinessObjects Auditor Customized applications Web applications to deploy InfoView Administration Console Supervisor over the Web Auditor
158
2. Highlight the web application (in this case InfoView), select Create an instance from the drop-down list, and then click Next. The Instance Name page appears.
159
3. Give the instance a name, and then click Next. The instance and new branches for web server and application server appear on the Cluster Management page.
The instructions are now divided into IIS standalone (continue below), IIS/Tomcat (page 161), and Apache/Tomcat (page 164).
IIS standalone
You now define the application server to be used with the web applications. 1. Under the new instance, highlight Application server, select Add a web application from the drop-down list, and then click Next. The Configuration Tool automatically detects the application servers. If there is more than one, it displays a list of those available for configuration.
160
2. In the Automatic Application drop-down list, select IIS, and then click Next. You cannot use manual server detection for IIS. The Configuration Tool detects and displays the available instances.
The default names are: - wijsp for InfoView JSP - wiadmin for Administration Console - wsupervisor for Supervisor over the Web - wiauditor for Auditor 3. Select the server instance you want, and select This application server is standalone. This must be selected because IIS acts both as application and web server. 4. Click Next. Configuration Tool configures the application server and displays the result under the instance.
5. Repeat the above procedure for any other web applications that you want to deploy and configure on the application server. If you want to deploy and configure customized web applications on an application server, see Customized web applications on page 168.
161
If you have no other web applications to configure on this machine and have configured all the other nodes: Click Finish to quit the Configuration Tool. Go to Getting the System Ready on page 221.
IIS/Tomcat
For IIS/Tomcat, you must define both the application server and web server. Application server 1. Under the new instance, highlight Application server, select Add a web application from the drop-down list, and then click Next. The Configuration Tool automatically detects the application servers. If there is more than one, it displays a list of those available for configuration.
If the Configuration Tool does not detect Tomcat, select Manual application server detection, and then browse or enter the location of the Tomcat installation folder. 2. In the Choose JSP or ASP drop-down list, select JSP. 3. In the Automatic Application drop-down list, select Tomcat, and then click Next. The Location of Configuration Files page appears. 4. Change the directories if you want, and then click Next. The Configuration Tool detects and displays the available instances.
162
5. Select the server instance and web application you want. The web application is the virtual directory name that is used for the application files, and appears as part of the URL on the client browser. The default names are: - wijsp for InfoView JSP - wiadmin for Administration Console - wsupervisor for Supervisor over the Web - wiauditor for Auditor The web application name you enter here must be the same as the virtual directory name you enter when deploying and configuring the web server. Do not select Standalone, which is only for IIS in standalone mode. 6. Click Next. The Configuration Tool configures the application server and displays the result under the instance.
7. Repeat the above procedure for any other web applications you want to deploy.
163
Web server To deploy and configure the web server: 1. On the Cluster Management page, under the instance, highlight Web server.
2. Select Add virtual directory from the drop-down list, and then click Next. The Configuration Tool automatically detects the web servers. If there is more than one, it displays a list of those available for configuration. If the Configuration Tool does not detect the web servers, select Manual web server detection, and then browse or enter the location of the IIS installation folder. 3. In the Choose JSP or ASP drop-down list, select JSP. 4. Select Automatic web server detection, select IIS, and then click Next. The Location of Configuration Files page appears. 5. Make sure the path is correct, and then click Next. The Configuration Tool detects and displays the available instances. 6. Select the website you want and confirm the virtual directory. - The website you select depends on which port you configured the IIS web server. - The name of the virtual directory you enter here must be the same as the name you entered when configuring Tomcat. 7. Click Next. The Configuration Tool displays your current configuration. 8. Repeat the above procedure for any other web applications you want to deploy. If you want to deploy and configure customized web applications on a web server, see Customized web applications on page 168.
164
If you have no other products to configure on this machine and have configured all the other nodes: Click Finish to quit the Configuration Tool. Go to Getting the System Ready on page 221.
Apache/Tomcat
For Apache/Tomcat, you must define both the application server and web server. Application server 1. Under the new instance, highlight Application server, select Add a web application from the drop-down list, and then click Next. The Configuration Tool automatically detects the application servers. If there is more than one, it displays a list of those available for configuration.
If the Configuration Tool does not detect Tomcat, select Manual application server detection, and then browse or enter the location of the Tomcat installation folder. 2. In the Choose JSP or ASP drop-down list, select JSP. 3. In the Automatic Application drop-down list, select Tomcat, and then click Next. The Location of Configuration Files page appears. 4. Change the directories if you want, and then click Next. The Application Server Instance page appears.
165
5. Change the name of the web application, if you want. The web application is the virtual directory name that is used for the application files, and appears as part of the URL on the client browser. The default names are: - wijsp for InfoView JSP - wiadmin for Administration Console - wsupervisor for Supervisor over the Web - wiauditor for Auditor The web application name you enter here must be the same as the virtual directory name you enter when deploying and configuring the web server. Do not select Standalone, which is only for IIS. 6. Click Next. The Configuration Tool configures the application server and displays the result under the instance.
7. Repeat the above procedure for any other web applications you want to deploy.
166
Web server To deploy and configure the web server: 1. On the Cluster Management page, under the instance, highlight Web server.
2. Select Add virtual directory from the drop-down list, and then click Next. The Configuration Tool automatically detects the web servers. If there is more than one, it displays a list of those available for configuration. If the Configuration Tool does not detect the web servers, select Manual web server detection, and then browse or enter the location of the Apache installation folder. 3. In the Choose JSP or ASP drop-down list, select JSP. 4. Select Automatic web server detection, select Apache for Tomcat, and then click Next. The Location of Configuration Files page appears. 5. Make sure the path is correct, and then click Next. The Configuration Tool detects and displays the available instances.
167
6. Select the website you want and confirm the virtual directory. - The website you select depends on which port you configured the Apache web server. - The name of the virtual directory you enter here must be the same as the name you entered when configuring Tomcat. 7. Click Next. The Configuration Tool displays your current configuration. 8. Repeat the above procedure for any other web applications you want to deploy. If you want to deploy and configure customized web applications on a web server, see Customized web applications on page 168. If you have no other products to configure on this machine and have configured all the other nodes: Click Finish to quit the Configuration Tool. Go to Getting the System Ready on page 221.
168
IIS
To deploy and configure customized applications with IIS: 1. In the Configuration Tool, open the Cluster Management page.
2. Highlight Custom Applications, select Create an instance from the dropdown list, and then click Next.
169
3. Give the instance a name, and then click Next. The instance and new branches for application server and web server appear on the Cluster Management page.
You now define IIS as the application server. (You do not have to define it as a web server.) 4. Under the new instance, highlight Application server, select Add a web application from the drop-down list, and then click Next.
170
The Configuration Tool automatically detects the application servers. If there is more than one, it displays a list of those available for configuration.
5. Select Automatic application server detection, and then click Next. You cannot use manual server detection for IIS. The Configuration Tool detects and displays the available instances.
171
6. Select the instance, and then provide the following information: - Web application: Type the name of the application. - Standalone: Select this box. - War file: Type or browse for the location of the ASP file you want to distribute. - Resources files: Optional. Type or browse for the location of the resources file. Resource files contain static mapping and other information needed by the application servers web server component. 7. Click Next. The Configuration Tool configures the application server and displays the result under the instance.
8. Repeat the above procedure for any other customized web applications which you want to deploy and configure on the application server. 9. If you have no other web applications to configure on this machine and have configured all the other nodes: - Click Finish to quit Configuration Tool. - Go to Getting the System Ready on page 221.
172
Apache/Tomcat
Application server (Tomcat) To deploy and configure customized web applications on the application server: 1. In the Configuration Tool, open the Cluster Management page.
2. Highlight Custom Applications, select Create an instance from the dropdown list, and then click Next.
173
3. Give the instance a name, and then click Next. The instance and new branches for application server and web server appear on the Cluster Management page.
You now define Tomcat as the application server. 4. Under the new instance, highlight Application server, select Add a web application from the drop-down list, and then click Next. The Configuration Tool automatically detects the application servers. If there is more than one, it displays a list of those available for configuration.
174
If the Configuration Tool does not detect Tomcat, select Manual application server detection, and then browse or enter the location of the Tomcat installation folder. 5. In the Choose JSP or ASP drop-down list, select JSP. 6. In the Automatic Application server detection drop-down list, select Tomcat, and then click Next. The Location of Configuration Files page appears. 7. Change the directories if you want, and then click Next. The Configuration Tool detects and displays the available instances. 8. Select the instance, and then provide the following information: - Web application: Type the name of the web application. It must be the same as the virtual directory you entered when configuring your web server. - Standalone: Do not select this. It is used only with IIS. - War file: Type or browse for the location of the WAR file you want to deploy. 9. Click Next. Configuration Tool configures the application server and displays the result under the instance. 10. Repeat the above procedure for any other customized web applications that you want to deploy and configure on the application server. Web server (Apache) To deploy and configure customized web applications on the web server: 1. In the Configuration Tool, go to the Cluster Management page.
2. Under Custom Applications, highlight Web server, select Add virtual directory from the drop-down list, and then click Next.
175
The Configuration Tool automatically detects the web servers. If there is more than one, it displays a list of those available for configuration.
If the Configuration Tool does not detect the web servers, select Manual web server detection, and then browse or enter the location of the Apache installation folder. 3. In the Choose JSP or ASP drop-down list, select JSP. 4. Select Automatic web server detection, select Apache for Tomcat, and then click Next. The Location of Configuration Files page appears. 5. Change the directories if you want, and then click Next. The Configuration Tool detects and displays the available instances.
6. Select the instance, and then provide the following information: - Virtual directory: Type the name of the application. It must be the same as the virtual directory you entered when configuring your web server. - Resources file: Type or browse for the path to the ZIP file for your customized application.
176
7. Click Next. The Configuration Tool configures the web server and displays the result under the instance.
8. Repeat the above procedure for any other customized web applications that you want to deploy and configure on a web server. 9. If you have no other products to configure on this machine and have configured all the other nodes: - Click Finish to quit the Configuration Tool. - Go to Getting the System Ready on page 221.
177
2. Highlight the instance you want to remove. 3. In the drop-down list, select Delete this instance, and then click Next. The instance and its associated files are removed from both the web and application servers where they were deployed. 4. Click Finish.
178
2. Highlight the application server you want to remove or modify. 3. In the drop-down list, select one of the following: - Delete this web application All information, web pages, and files will be removed from the application server. - Update this web application You will follow the same procedure as in Application server (Tomcat) on page 172. Each page, however, shows current configuration information. 4. Click Next, and then Finish.
179
2. Highlight the web server you want to modify or remove. 3. In the drop-down list, select one of the following: - Delete this virtual directory All information, web pages, and files will be removed from the web server. - Update this virtual directory You will follow the same procedure as in Web server (Apache) on page 174. Each page, however, shows current configuration information. 4. Click Next, and then Finish.
180
chapter
182
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy Afterward, complete any additional manual steps described in the Manual Web and Application Server Configuration for Windows guide. 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 Starts on... page 19 page 44 page 59 page 113
If youre using IIS or Apache/Tomcat, you can deploy the web applications automatically with the Configuration Tool (see Deploying Web Applications Using Configuration Tool on page 155). If youre using any other application and/or web servers, however, you must either use wdeploy, or deploy the applications resource files manually. This chapter explains how to deploy and configure Business Objects web applications on the application server and web server using the wdeploy tool.
183
This chapter includes: What is wdeploy? Wdeploy deployment modes How do you use wdeploy? Using wdeploy on application server machines Using wdeploy on web server machines Properties reference Targets reference Deploying a customized application Using unsupported web or application servers Issues requiring additional procedures Making sure your web applications work Business Objects also recommends you look at The wdeploy readme.doc file on page 191.
NOTE
Depending on the type of application server youre using, you may need to perform additional steps manually after using wdeploy. These steps are displayed on screen when wdeploy completes the deployment; full instructions are available in the Manual Web and Application Server Configuration for Windows guide.
184
What is wdeploy?
wdeploy is a command-line tool that you can use to deploy and/or undeploy Business Objects web applications on web and application servers in JSP environments. wdeploy is installed automatically in the $INSTALLDIR\deployment directory whenever you install the Configuration Tool on a server machine. wdeploy was developed with ANT technology. ANT is a Java- and XML-based build tool from Apache that uses XML as its scripting language. Because ANT is Java based, its scripts are cross-platform.
You can find more information about ANT at:
http://ant.apache.org/index.html
Parameter
Description If youre running wdeploy on an application server, this must be a type of application server. If youre running wdeploy on a web server, this must be a type of web server.
A specific property you set for a specific action The specific action you want wdeploy to take
<target>
All these parameters are described in more detail later on in this chapter.
185
Conditions of use
To use wdeploy to deploy Business Objects web applications on certain types of application servers, an administration instance of the application server must be started. For information, see the documentation for your application server.
What is wdeploy?
186
Standalone mode
You can configure some application servers to function as both an application server and a web server. The deployment contains no web server. This is known as standalone mode:
Users Application server in standalone mode Web applications dynamic and static resources Business Objects server
When web applications are deployed using wdeploy, both their static and dynamic resources are bundled in the applications WAR files and deployed on the application server. This makes deployment simpler, but performance may suffer, as every type of transaction, even those requiring static content only, must pass through the application server. How to deploy in standalone mode To deploy a web application in standalone mode on the application server, simply run wdeploy on the application server machine. For instructions, see page 192.
Distributed mode
The application server can also run in conjunction with a separate web server, in distributed mode. The web and application servers can be hosted either on the same server, or on separate ones:
187
Users
Web server + application server in distributed mode Web applications dynamic resources on application server, static resources on web server Business Objects server
Figure 10-2 Distributed web deployment with web and application server on same machine
Users Business Objects Application server server in distributed mode Web applications dynamic resources
Figure 10-3 Distributed web deployment with web and application servers on different machines
In distributed deployments, web applications dynamic resources are deployed on the application server, and their static resources are deployed on the web server. This may enhance performance because the web server can serve up static pages without having to communicate with the application server.
188
How to deploy in distributed mode Regardless of where your web and application servers are located, to deploy a web application in distributed mode: 1. Run wdeploy on the application server machine (see page 192). You must make sure that the as.mode property is set to distributed, either in the command line, or in the config.properties file. 2. Run wdeploy on the web server machine (see page 196).
189
3. Type the most basic wdeploy command line, containing the type of application or web server and target only. Heres an example to deploy a web application on a WebLogic 7 application server:
wdeploy weblogic 7 deploy
4. Wait a few seconds. wdeploy displays the complete command line with all the properties required for that application server and target. 5. Enter valid values for each parameter, making sure that every parameter requiring spaces or special characters (such as file locations) is wrapped in double quotes. 6. When youre done, press OK.
190
This simplifies the use of the command line by eliminating the need to include multiple lines of property settings, and reduces the risk of error. 1. Open the $INSTALLDIR\deployment\config.properties file in a standard text editor. 2. At the top of the file, in the sections containing generic parameters which do not pertain to specific web or application servers, type in valid values for each required setting following the commented instructions. These lines do not begin with a double pound sign (##).
191
3.
4. 5. 6.
The bo.domain and webapp.lang parameters have default values. You can change them if you want. Make sure there are no extra spaces before or after the property value. For example, if you define the as.mode parameter as standalone, leaving a space at the end, the system will not interpret the value correctly. In the section pertaining to the specific web or application server youre using, delete the double pound signs from the beginning of each parameter line, then type in valid values. When youre done, save your changes then close the file. Now open a DOS window by clicking Start > Programs > Accessories > Command Prompt. Navigate to the wdeploy folder by typing:
cd $INSTALLDIR\deployment
7. Type the most basic wdeploy command line, containing the type of application or web server and target only. Heres an example to deploy a web application on a WebLogic 7 application server:
wdeploy weblogic 7 deploy
8. Press OK.
NOTE
You can override the properties in the config.properties file by using the -Dproperties.file property to define another configuration file.
192
Running wdeploy
To run wdeploy, type the following at the command prompt:
cd $INSTALLDIR\deployment wdeploy <application server type> [<-Dproperty>=<value>]* <target>
NOTE
See the wdeploy readme.doc file for more example command lines.
193
Short name
Application Server Property
Description
The type of application server youre using. See the following section. Various properties specific to your deployment. For complete information, see page 198. Action to be taken. Possible targets are: buildwar buildwars clean deploy deployall help undeploy undeployall For complete information, see page 202.
Target
194
Description
You can use generic with the buildwar and buildwars targets only. If you use generic, wdeploy creates a generic WAR file that is not designed for a specific application server. You use this value only if you want to use an unsupported application server that you havent yet added to your deployment (see page 212). Depending on the type of application server youre using, additional manual procedures may be required before actually deploying the WAR. See Issues requiring additional procedures on page 215.
You can indicate a specific application server, such as websphere5, that is currently supported by Business Objects. When wdeploy is installed in the $INSTALLDIR\deployment folder, it comes with a separate XML file for each application server officially supported with this release. The value you enter for the Application Server parameter must exactly match the name of the XML file corresponding to your application server. If it is not an exact match, wdeploy will not be able to find the XML file.Business Objects suggests you browse the $INSTALLDIR\deployment folder for the precise name of the file used for your application server. For a full list of currently supported application servers, see the PAR (Product Availability Report): 1. Go to www.techsupport.businessobjects.com 2. Log into the site. 3. Click Enterprise 6 > PAR > BI Platform 6. Note regarding WebSphere: If youre using a WebSphere 5.0.2 application server, you cannot run wdeploy if WebSphere security is enabled.
You can also add new application servers that are not supported by Business Objects. To do this, you will need to add a new XML file corresponding to the type and version of the new application server before deploying any web applications. For instructions, see page 212.
195
196
NOTE
See the wdeploy readme.doc file for more example command lines.
Short name
Web Server Property
Description
The type of web server youre using. See the following section. Various properties specific to your deployment. For complete information, see page 198. Action to be taken. Possible targets are: deploy undeploy For complete information, see page 202.
<target>
Target
197
IHS web servers use the same XML file as Apache, and are configured in exactly the same way. Using unsupported web servers If youre using an unsupported web server with your deployment, youll need to add a new XML file to the $INSTALLDIR\deployment\webservers folder corresponding to the new web server before deploying your web applications. For instructions, see page 212.
Required properties
You may also be required to set other properties pertaining to either the target or the type of web server youre using: Each property is described in detail starting on page 198. The properties required with each target are described in Targets reference on page 202. The properties required for specific web servers are described in the following files: - the config.properties file ($INSTALLDIR\deployment) - the XML files for each web server ($INSTALLDIR\deployment\webservers) - the wdeploy readme.doc file ($INSTALLDIR\deployment)
198
Properties reference
This parameter defines properties that are specific to your deployment. You prefix each property with -D. For example:
-DAPP=infoview
The Properties parameter modifies and adds values to the default config.properties file, which contains the specific configuration information pertaining to a clusters web applications, web server and application server. The following table lists the available properties for wdeploy. To define any of these properties, you must type, without spaces: -D<value from Property column>=<value from Values column> You can define as many properties as you want in the command line, separating them with a space, as long as the properties dont contradict each other. Property
APP
Values
infoview admin auditor <custom_app>
Description
Type of web application, taken from the name of the <APP>.properties file located in the application server machines $INSTALLDIR\deployment\apps folder. For information on deploying customized web applications, see page 210. The directory in which the prepackaged WAR files are located. Password for administration of the application server. Only needed for certain application servers. The port for administration of the application server. Only needed for certain application servers. User name for administration of the application server. Only needed for certain application servers. Installation directory of the application server.
<port number>
<user name>
<directory>
199
Property
as.host
Values
<host_name>
Description
Host name for the application server. For any application server but WebSphere 4, enter the long name, such as myserver.product.businessobjects.com. For WebSphere 4, use the short name, such as myserver. The name of the application server instance on which youre deploying the web application(s). Type of application server deployment. If you enter distributed you must also enter information concerning the web server. In this case, you must at least specify the type of web server, using the ws.type property. More information about the web server may be required depending on the type of server being used. Mandatory on the application server. Port number used by the application server. Only needed for certain application servers. If any value is entered, sets up a trace on application server activity. If no value is entered, the trace is not activated. Type of application server. This value can match that used for the Application Server parameter. Mandatory for configurations with Apache web servers. Name of the cluster. The bo.domain cluster must be configured on the node from which you run wdeploy. You do this either by configuring the ORB using Configuration Tool, or by making sure that a <bo.domain>.cfg file is present on the node. Mandatory when using the buildwar, buildwars, deploy or deployall target. If you dont enter a value: mycluster is used. This is the default used by the Configuration Tool when you create a cluster.
as.instance as.mode
as.port as.trace
as.type
bo.domain
<cluster_name>
Properties reference
200
Property
jsp.app.name
Values
<web application name>
Description
Name of the web application youre deploying, as it will appear in the URL used to access it. If you dont enter a value: wdeploy uses: wijsp for InfoView wiadmin for the Administration Console wsupervisor for Supervisor over the Web auditor for Auditor
prop properties.file
<name of property> Overrides a particular value in the default config.properties file. <file_name> Overrides the default config.properties file entirely by using a different properties file. Use this when you want to use a file with many different values than those set in the config.properties file. Default language of the web application. Chinese uses five characters; for example, zh_CN. If you dont enter a value: en (English) is used. Directory into which the created WAR files are placed. Installation directory of the web server. Host name for the web server. Enter the long name, such as myserver.product.businessobjects.com. Mandatory for deploying the Administration Console with the deploy target.
webapp.lang
<language_code>
201
Property
ws.instance ws.port
Values
<instance name> <port_number>
Description
The name of the web server instance on which youre deploying the web application(s). Port number used by the web server. This information is saved in the clustermanager.cfg file, which contains the URL for the Administration Console servlet. Mandatory for deploying the Administration Console with the deploy target. Type of web server. Use this property to deploy the web application(s) on both the web and application servers (distributed mode). In this case, the static pages will be on the web server, and dynamic resources on the application server.
ws.type
N/A
Properties reference
202
Targets reference
The Target parameter defines wdeploys action, which is a sequence of actions described in an XML file. Heres a summary of these actions, each one of which is covered in more detail below: Target
deploy deployall buildwar buildwars
Action
Deploy a specific web application on the application and/or web servers. Deploy all available web applications on the application and/or web servers. Create a WAR file for a specific web application, so that you can then deploy it on the application server manually. Create WAR files for all available web applications (InfoView, Admin, Supervisor over the Web, and Auditor), so that you can then deploy them on the application server manually. Remove the deployment of a specific web application on a given application or web server. Remove the deployment of all deployed applications on a given application or web server. Delete the contents of the default directory where the new WAR files are stored once they are no longer needed. Provide a list of supported application servers and available web applications. It also explains their use.
Certain targets must be accompanied by specific properties. When this is the case, it is mentioned in the sections below.
203
Keep in mind that you must deploy Auditor in a different cluster than the other web applications. For this reason, you may not want to use buildwars, which will automatically build a WAR file for Auditor, InfoView, Supervisor over the Web, the Administration Console and any other available applications, all adapted to the same application server and the same cluster. Depending on the application server youre using, you may need to perform some manual procedures before actually deploying the WAR file(s) on the application server. See Issues requiring additional procedures on page 215. Parameters to use with buildwar and buildwars Application Server
Application Server parameter
Brief description
Type of application server.
Required?
Yes: you can use either generic or the specific type of application server.
Properties
APP archive.dir
Brief description
Name of the web application.
Required?
Yes, for buildwar.
No. Directory in which the prepackaged WAR files are located, if the directory is not the default $INSTALLDIR\ archives. Name of application server host. Application server deployment mode: standalone or distributed. Port number used by application server. Name of the cluster. Name of the web application. Customized properties file to override properties.config file. Default language of the web application. Directory where the generated WAR files are stored. No. Yes. No. Yes. No. No. If the web applications language is not English. Yes.
Targets reference
204
Properties
ws.dir
Brief description
Web server installation directory.
Required?
Yes, if youre using wdeploy on an application server machine and as.mode is distributed. Yes, if youre deploying the Administration Console. Yes, if youre deploying the Administration Console. Yes, if youre using wdeploy on an application server machine and as.mode is distributed.
Name of the machine on which the web server is running. Number of the port used by the web server. Type of web server.
205
clean
The clean property deletes the generated WAR files from the folder on the application server where they are stored (by default, this folder is defined by the work.dir property). When should you use clean? Use clean once youve successfully deployed your web applications, and are therefore sure you have no more need of the generated WAR files stored in this directory. By cleaning out this folder you are freeing space for other uses. Parameters to use with clean With this target, you must set the work.dir property, which defines the directory containing the generated WAR files to be deployed.
Targets reference
206
deployall is a good solution when you want to get your system up and running
quickly for testing or demo purposes.
As deployall deploys all installed web applications, however, Business Objects recommends that you not install Auditor on the same cluster nodes as InfoView. Auditor should be installed and deployed in a separate cluster, with its own repository.
207
Required?
The specific type of web or application server is required; you cannot use generic.
Properties
APP archive.dir
Brief description
Name of web application to be deployed.
Required?
Yes, with the deploy target.
No. Directory in which the prepackaged WAR files are located, if the directory is not the default $INSTALLDIR\ archives. Application server installation directory. Name of application server host. Yes. No.
as.dir as.host as.mode as.port bo.domain jsp.app.name properties.file webapp.lang work.dir ws.dir
Application server deployment mode: Yes. standalone or distributed. Port number used by application server. The name of the cluster. The name of the web application. No. Yes. No.
Customized properties file to override No. properties.config file. Default language of the web application. Target directory where WAR files to be deployed are stored. Web server installation directory. If the web applications language is not English. Yes. If youre using wdeploy on an application server machine which also hosts the web server, and as.mode is distributed.
Targets reference
208
Properties
ws.host ws.port ws.type
Brief description
Name of the web servers host machine.
Required?
If youre deploying the Administration Console.
Port number used by the web server. If youre deploying the Administration Console. Type of web server. If youre using wdeploy on an application server machine and as.mode is distributed.
Brief description
Required?
209
Properties
as.instance
Brief description
The name of the application server instance on which the web application(s) is/are deployed. Name of the Business Objects cluster. Name of the web application you deployed, as it appears in the URL used to access it.
Required?
Yes, on an application server machine. Yes. Yes, for undeploy.
bo.domain jsp.app.name
help
The help target provides a list of supported application servers and available web applications, and explains wdeploy parameters. To launch help, type:
cd $INSTALLDIR\deployment wdeploy help
Targets reference
210
- Change the name of the ZIP file, by default ivres.zip, to the name you want
for your customized application: jsp.stat.file=<name of ZIP file>.zip
- Change the name of the web application when it is deployed to the name
you want for your application. By default it is wijsp: jsp.app.name=<name of web application when deployed>
- Change the name of the build file (used by ANT) to the name you want for
the new application. The default is infoview.xml: buildfile=<name of new web application>.xml
211
212
213
Syntax for target parameters Following is the syntax to use for adding the target parameters, where newappserver is the name of the new application server you are adding: help
<target name=help > <echo>Create war files for newappserver</echo> </target>
buildwar
<target name=buildwar description=Create distribution for newappserver>
deployapp
<target name=deployapp description=Deploy application in newappserver>
undeployapp
<target name=undeployapp description=Undeploy application from newappserver>
214
Syntax for target parameters Following is the syntax to use for adding the target parameters, where newwebserver is the name of the new web server youre adding: help
<target name=help > <echo>Deploy app on newwebserver</echo> </target>
deployapp
<target name=deployapp description=Deploy application on newwebserver>
undeployapp
<target name=undeployapp description=Undeploy application from newwebserver>
215
ORB incompatibility
The ORB provided by Business Objects (Orbix from Iona) may not be compatible with the ORB provided by the application server. Should you encounter this type of conflict, you must overload the ORB used by the application server to make it use the ORB Business Objects uses.
Security problems
The BusinessObjects 6.5 Java code that runs within the application server communicates through CORBA with processes outside the application server. The same code also accesses the disk to store temporary information and read information from property files. BusinessObjects 6.5 may not function if the application server security settings are too high. In this case try to lower the security level of the application server. The exact procedures depend on the application server you are using, so refer to your application server documentation for more information.
216
217
1. Open an Internet browser. 2. Type in the URL for the application, replacing the properties in brackets with
the applications property values: http://<ws.host>:<ws.port>/<jsp.app.name>
3. Hit Return. If your application opens in the browser, you have succeeded.
NOTE
Make sure you have restarted your application and/or web servers beforehand, in order to take all wdeploy modifications into account.
218
Where to go now
When you finish your configuration using wdeploy, go to Getting the System Ready on page 221.
part
chapter
222
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This chapter describes what you need to do to get the Business Objects system ready, before you set user authentication and authorization.
223
Data access
Make sure the connectivities to all the databases used in the system, for both the repository and corporate data, are installed and have been checked. Connectivity environment variables must be correctly set. See the Data Access Guide for more information.
224
You have the option to save the bomain.key file in the default directory, $INSTALLDIR\nodes\<hostname>\<clustername>\locdata, or enter a path to a directory of your choosing.
Universes
Using Designer, create at least one functioning universe, configured with a valid, secure connection to the corporate database. Export the universe to the repository. See the Designers Guide for information on how to create universes and the Supervisors Guide for information on how to export universes.
Fonts
Verify that the fonts you need to display documents in the languages used in your deployment are installed on the Business Objects servers. For information about font management, see Deploying the Business Objects System.
Time zone
When you set the clusters locale in the Administration Console or at setup, it must be identical to the OS locale on the clusters servers. For information about setting locales, see Deploying the Business Objects System.
225
If you have installed your separate or combined web and application servers on primary or secondary nodes, you have ensured that the cluster can communicate.
226
5. Highlight Internet Information Service, and then click Add. Internet Information Service appears in the list in the Add/Remove Snap-in dialog box. 6. Click OK. 7. On the left panel of the Console window, highlight Web Service Extensions. If you do not see it, open the various levels of the tree. 8. On the right panel, switch Active Server Pages to Allowed. 9. Close the Console window. Enabling the parent path To enable the parent path: 1. Open the IIS Console. 2. In the left panel, under the default website: Point to wiasp, right-click, and select Properties. The wiasp Properties dialog box appears. 3. On the Virtual Directory tab, click Configuration. (If the button is disabled,
227
click Create, and then click Configuration.) The Application Configuration dialog box appears. 4. Click the App Options tab. 5. Select the Enable Parent Paths check box. 6. Click OK twice, and then close the IIS Console. Setting system environmental variables Set the following system environmental variables: Point BO_TRACE_CONFIGFILE to the file BO_trace.ini Point BO_TRACE_LOGDIR to the folder that contains BO_trace.ini By default, BO_trace.ini is located in $INSTALLDIR\bin\scripts\preconf\ Restarting the server When you have finished the above steps, restart the Windows 2003 Server.
228
229
230
chapter
232
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
After you install the Business Objects products and deploy the web applications, you set the systems authentication and authorization modes and sources. With this release, you do this using the Security Configuration Tool. The system uses the options you choose for both 2- and 3-tier Business Objects applications. This chapter describes authentication and authorization and how they work, the types of systems you can use to manage users and their security profiles, and how to set authentication and authorization for your cluster.
233
234
Authentication mode
When you first launch the Security Configuration Tool, you are asked to choose an authentication mode. Your choice determines the mechanism by which users are authenticated for both 2- and 3-tier Business Objects applications. The following authentication modes are available: Authentication mode
Business Objects
In a 2-tier system
In a 3-tier system
The Business Objects system performs the entire authentication process. The 2 and 3-tier modes use the same user name and password. Authorization can be carried out by: Business Objects, based on the repository LDAP SiteMinder The user is authenticated on The user is authenticated by an IIS web server. the Windows workstation and on the repository. The workstation asks the SSO server to authenticate the user. The SSO system then returns the authentication ticket to the workstation. The user is authenticated by the SSO server. After authentication, the server sends an authorization ticket to the web server, and the authentication ticket is checked again by Business Objects. User authentication is delegated to the web server. The web server is trusted without being checked. Business Objects verifies the user name, but not the password, in the repository.
Windows
Basic authentication
235
Authentication source
To authenticate a user, the system checks the username and password the user enters at login against pre-registered authentication information required for access to the system. You decide where BusinessObjects 6.5 finds this information. This is called the authentication source. As a Business Objects administrator, you can manage this type of user information by creating accounts for users in the repository, in an external application and/or directory such as Netegrity SiteMinder, an LDAP (Lightweight Directory Access Protocol) directory, or a combination of these options.
Authentication source
236
External
For more detailed information on the mapping between externalized users and the security profiles in the repository, see Using LDAP with Business Objects on page 239.
237
Start authentication
External
Repository
Yes
No
External-only user Read security profiles in external authorization based on mapping between external user profiles and repository
Authentication source
238
This improves scalability and ease of administration of the BusinessObjects 6.5 suite, and it allows you to lighten the amount of information stored in the repository by storing it elsewhere. Using SiteMinder with the Business Objects system lets you enable SSO for Business Objects users, which means they authenticate only once for subsequent access to multiple applications. Depending on how you configure SiteMinder, this can be when users enter the operating system, an enterprise portal, or elsewhere. SiteMinder is often deployed using an LDAP directory to store its authentication information. Users no longer managed in the repository are referred to as externalized users. Supported external user management systems You can find an up-to-date list of the versions of external user management systems supported by Business Objects in the PAR: 1. Go to www.techsupport.businessobjects.com. 2. Log into the site. 3. Select Enterprise 6 > PAR > BI Platform 6.
239
When mapping your external users to repository groups, you must use only static, enumerated groups. Business Objects does not support dynamic groups or LDAP references.
240
The LDAP user is mapped to the user instances in the repository, in this case to Instance 1 and 2 of John Smith. In this case, more than one LDAP user can be mapped to a single repository user.
North America Ontario cn = John Smith Roles = Group 1 Group 22 South America
241
The LDAP server maps the external user attribute chosen during configuration to groups in the repository, in this case to Group 1 and Group 22. In this example, the attribute, NSROLE, includes 'Group 1' and 'Group 22' for user John Smith. Therefore, when John logs in, he will inherit the access rights defined for groups 1 and 22 in the repository.
North America Ontario cn = John Smith Group = Group 11 Members = John Smith Mary Jones South America Group = Group 2 Members = John Smith Steve Adams
The LDAP user groups are mapped to groups in the repository, in this case to Group 11 and Group 2. The LDAP user group Group 2 has the members John Smith and Steve Adams, who inherit the Business Objects group rights of Group 2. Therefore, the user John Smith also inherits group rights of Group 11.
242
243
Broadcast Agent requires a Broadcast Agent user to execute tasks. This user must still be declared and authenticated through the repository; you can't externalize Broadcast Agent users through LDAP. Business Objects cannot migrate Broadcast Agent tasks. Broadcast Agent account For batch scheduling purposes, Broadcast Agent requires the Broadcast Agent user to be in the repository. Therefore, if an externalized user has the same name as a Broadcast Agent user, they both must have the same password. Otherwise, Broadcast Agent cannot authenticate the user and scheduled tasks will not be executed. To avoid this problem, the Broadcast Agent user must either: be declared in the repository only and have a Broadcast Agent-specific name, such as bca123 hold the same name and password as the corresponding LDAP user Refreshing a Broadcast Agent document When logged into Business Objects in Business Objects authentication mode, a user has BOUSER and BOPASS variable values, specifically the name and password entered for external authentication. This user can use any connection to build or refresh documents and use Broadcast Agent as long as the document is refreshed in the users name, whether relying on a BOUSER/BOPASS dynamic connection or a fixed credential static connection. When the user wants to schedule a document to be refreshed in the name of other users, however, the static connection works, but dynamic connections do not. When logged in to Business Objects with an external authentication source, users have a BOUSER variable value, but no BOPASS value. As a result, they cannot use dynamic connections. A solution to this issue is the option available in the Configuration Tool to store, in the repository, the passwords of externalized users. This permits dynamic connections and scheduling in the name of specifc users. Be aware, however, that this may render the password non-secure. For more information about the BOUSER and BOPASS variables, see the Designers Guide.
244
Netegrity SiteMinder
SiteMinder provides SSO, which allows users to authenticate once and then access other protected resources without re-authenticating. Using SiteMinder with the Business Objects system lets you enable SSO for Business Objects users, which means they authenticate only once for subsequent access to multiple applications. Depending on how you configure SiteMinder, this can be when users enter the operating system, an enterprise portal, or elsewhere. The following diagram illustrates how SSO works:
2 3
The SSO Agent redirects the users calls to the web server according to the Security Server policy, and adds the appropriate ticket to the HTTP headers. This is the ticket used to identify the session. The SSO Agent queries the Security server to authenticate the user. If the user is authenticated, the security server instructs the Agent on the policy to follow for the user.
1
The user logs into InfoView. The call is redirected by the SSO Agent for credential checks.
Security Server
Client
You can use two different authentication modes with SiteMinder: Basic authentication SSO authentication The procedures are explained in the sections below.
245
NOTE
For general information on configuring SiteMinder to work with Business Objects, see Using Netegrity SiteMinder with Business Objects, available on the Business Objects Customer Support website.
Netegrity SiteMinder
246
247
- Click Start > Programs > Business Objects > Security Configuration Tool 6.5. The Login dialog box appears.
2. Enter your general supervisor user name and password. 3. Select or browse for the repository KEY file, and then click Next. The Authentication Mode page appears.
248
For an explanation of these modes, see Authentication mode on page 234. Select the authentication mode you want, and then click Next. The Authentication and Authorization Source page appears. The procedures you now follow depend on the authentication mode you selected: If you selected Business Objects, Windows, or Basic authentication, go to Selecting the authentication source for standard modes on page 249. If you selected Single Sign-on, go to Setting the authentication source for SSO mode on page 250.
249
NOTE
If you choose Basic authentication for your cluster, after you select and configure the clusters authentication/authorization source, you must configure the web server to use Basic authentication as well. This procedure is not necessary if you are using SiteMinder. For instructions, see If you chose Basic authentication on page 252.
To set the authentication source: 1. Select an authentication source: - Repository - External then repository - External For a full description of the sources, see Types of authentication source on page 235.
250
2. Do either of the following: - If you selected Repository, there is no further configuration required; click Next and then Finish. Go to Confirming your configuration on page 262. - If you selected External then Repository or External, you must configure the LDAP server connection by following the steps below. 3. Select a source from the External source drop-down list. If you have chosen the Windows authentication mode, you must select MS Active directory. 4. In the Host name box, type the name or the IP address of the server hosting the external user management system. 5. In the Port box, type the port number through which the LDAP server is accessed. 6. Click Connect. 7. If the connection is successful, click OK, and then click Next. The Choose LDAP Connection page appears. Go to Configuring LDAP connection parameters on page 255.
251
To do so: 1. In the Policy server host box, type the name or the IP address of the SiteMinder server. 2. In the Accounting port box, type the port number through which the SiteMinder server is accessed. 3. Type the authentication and authorization port numbers. 4. In the Business Objects agent name box, type the name of the Business Objects Agent that you created in SiteMinder. See Using SiteMinder with SSO authentication on page 245. 5. In the Shared secret box, type the password. 6. Click Connect. If the SSO server responds, a confirmation message appears. 7. Click OK, and then Next. The SSO Administrator page appears. 8. Enter the account name and password of the administrator, and then click Next. The Final Confirmation page appears. 9. Click Finish.
252
Make sure that the users created with htpasswd are already declared in the repository. 3. Using a standard text editor, open the httpd.conf file located in <Web Server Install Dir>\conf, then add the following to the end of it:
<Location /> AuthName "BA Authentication" AuthType Basic AuthUserFile "<Web Server Install Dir>\conf\users" require valid-user </Location>
Save your changes and close the editor. 4. Do either of the following: - If youre using an Apache web server with a Tomcat application server, follow the instructions in the next section. - If youre using any other web/application server combination, start the Business Objects server, the application server, and the web server. If youre using Apache/Tomcat 1. Open the server.xml file in an XML editor. You can find this file in the <Tomcat Install Dir>. 2. Comment the Coyote connector by doing the following:
253
just below the line: Name="org.apache.jk.server.JkCoyoteHandler"/> 3. Uncomment and adapt the ajp13 connector by doing the following: - Remove the <!-- preceding the line:
<Connector className="org.apache.ajp.tomcat4. Ajp13Connector"
4. Remove the --> in the next line. This part of the server.xml file should now look like this:
<!-- Define a Coyote/JK2 AJP 1.3 Connector on port 8009 --> <!-<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8009" minProcessors="5" maxProcessors="75" enableLookups="true" redirectPort="8443" acceptCount="10" debug="0" connectionTimeout="0" useURIValidationHack="false" protocolHandlerClassName="org.apache.jk.server. JkCoyoteHandler"/> --> <!-- Define an AJP 1.3 Connector on port 8009 --> <Connector className="org.apache.ajp.tomcat4.Ajp13Connector" port="8009" minProcessors="5" maxProcessors="75" acceptCount="10" debug="0" tomcatAuthentication="false"/>
5. Save your changes and close the editor. 6. In a standard text editor, open the httpd.conf file, located in <Apache Install Dir>\conf.
254
7. Add the two lines in bold to the following section, in order to permit the downloading and installation of BusinessObjects in 3-tier mode (the path used in the Alias line is an example):
Alias /wijsp/distribution "C:/Program Files/ Business Objects/BusinessObjects Enterprise 6/ distribution" <Directory "C:/Program Files/Business Objects/ BusinessObjects Enterprise 6/distribution"> Options FollowSymLinks Allow from All Satisfy Any </Directory>
8. Save your changes and close the editor. 9. Start the Business Objects server, the application server, and the web server.
255
To configure the LDAP connection parameters: 1. In the Root DN drop-down list, select or type the naming attribute. 2. If you want to display a name attribute, select Display name attribute, then type the attribute name in the text box. 3. In the LDAP Connection section, select whether to bind anonymously or with an Administrator account. This option is available only if you selected External then Repository or External as the authentication source for Business Objects or Basic modes. 4. If you selected Bind with the following account, enter the account name and bind password of your LDAP account in the Account DN and Bind Password boxes. Read access is sufficient.
256
The Bind user name and password are for the LDAP account used to log into LDAP and query for user attributes and groups. Business Objects does not make modifications in the LDAP directory. If you have...
Sun ONE
Active Directory
257
To map to a group or user: 1. On the Mapping page, select the type of mapping you want. - If you select LDAP user to Business Objects group, you have two options: LDAP group membership LDAP attribute If you select LDAP attribute, type the attribute name in the Attribute box. - If you select LDAP user to Business Objects user, security is inherited from the repository user. 2. If you want to set LDAP attributes and filter queries, click Advanced, and go to Customizing the LDAP query parameters on page 257. If you use a standard LDAP schema (users identified by ID or user to repository profile mapping based on group or LDAP attributes) then you do not need to set the Advanced Security Configuration. 3. Click Next. The Final Confirmation page appears. Go to Confirming your configuration on page 262. Customizing the LDAP query parameters The Advanced LDAP Configuration page enables you to: adapt to non-standard LDAP schemas by defining new queries to be used by the LDAP connector define the attributes you use in Business Objects applications
258
When you click Advanced on the Mapping page, the Advanced LDAP Configuration page appears.
259
Adding an attribute To add a new attribute: 1. Under the Attribute Returned area, click New. The LDAP Attribute Configuration dialog box appears.
2. Type the name of the new attribute. 3. If you select the Extract Only check box, type the value you want extracted. 4. Select the Group Attribute check box if the attribute value corresponds to a group. 5. From the Use drop-down list, select an attribute type: - User Unique Identifier - User Display Name - Business Objects Group - Business Objects User - Business Objects Variable 6. If you selected Business Objects Variable, the BO Variable Name text box becomes active. Type the BO Variable name. 7. Click OK. The Advanced LDAP Configuration page re-appears. Customizing parameters for LDAP queries To customize parameters for LDAP queries: 1. Enter the LDAP attributes that are to be read by the system (filter formula). 2. Enter the base (root) at which the query begins. 3. Select the Business Objects variable name that corresponds to the LDAP attribute.
260
5. If you want to change the name of the attribute, type a new name in the Attribute box. 6. If you select the Extract Only check box, type the value you want extracted. 7. Select the Group Attribute check box if the attribute value corresponds to a group. 8. From the Use drop-down list, select an attribute type: - User Unique Identifier - User Display Name - Business Objects Group - Business Objects User - Business Objects Variable 9. If you selected Business Objects Variable, the BO Variable Name text box becomes active. Type the BO Variable name. 10. Click OK. The Advanced LDAP Configuration page re-appears. Defining the Send To search To specify the filter formula used for the search mechanism in the Send To feature: 1. In the Filter formula text box, enter the filter formula you want. 2. In the Base box, set the Base (root) at which the query is to begin its search. 3. In the Scope drop-down list, select the scope of the query. 4. In the Attribute requested box, type the attribute the query is to return. If you click the Extract only check box, enter the value you want to extract. 5. Enter the maximum number of users queried. 6. Click OK, or continue to Specifying group membership query on page 261.
261
Specifying group membership query To specify the filter formula used to query groups for the Broadcast Agent Send To feature: 1. In the Filter formula box, enter the filter formula you want. 2. In the Base box, set the Base (root) at which the query is to begin its search. Select the corresponding value in the Scope drop-down list. 3. In the Attribute returned box, enter the attribute the query is to return. If you check the Extract only option, enter the value you want to extract. 4. Enter the maximum number of users queried. 5. Click OK. The LDAP Mapping page appears. 6. Click Next. The Final Confirmation page appears. Continue to the next section. Store Password for Broadcast Agent You can store an external users password for use with Broadcast Agent. To store the password, select the Store Passwords in Repository check box.
262
part
chapter
266
Overview
The following table is designed to help you keep track of where you are in the installation and configuration process. The current stage is indicated by a checkmark. Where you Stage in the process are now 1. Plan your deployment. 2. Complete pre-installation procedures. 3. Install the required Business Objects products. 4. Define the cluster and its ORB using the Configuration Tool. 5. Deploy the required Business Objects web applications using one of the following tools: - the Configuration Tool - wdeploy 6. Get the Business Objects system ready. 7. Set user authentication. 8. Start the system and complete the final steps required to get your BusinessObjects solution up and running. page 155 page 181 page 221 page 231 page 265 Starts on... page 19 page 44 page 59 page 113
This chapter explains the final steps that you must follow in order to complete the installation and configuration of BusinessObjects 6.5. Getting up and running includes: starting the Business Objects system testing and tuning the system configuring the Demo kit
267
268
Verifying InfoView
Make sure that you can start InfoView: Open a web browser and type in the following URL: http://<server name>:<port number>/<wijsp or wiasp> where <server name> is the name of the server on which you installed Business Objects server products, and <port name> is the port on which you configured the web server. The InfoView Login page appears.
269
Troubleshooting If you cannot log into InfoView, check that all of the Business Objects server processes have been correctly started: 1. Press Ctrl + ALT + Delete, and then select Task Manager. The Windows Task Manager dialog box appears. 2. Click the Processes tab. 3. Click Image Name to display the list of processes in alphabetical order. 4. Check that the following processes are in the list: - one BOMgr process - two busobj processes These are the last processes to start. If they are running, all required processes have been started. 5. If these processes have not started after some time, restart your machine and then restart the Business Objects server, the application server, and the web server.
270
Recommended Settings guide The Recommended Settings Guide for Business Objects Deployments presents recommendations on BusinessObjects 6.5 and the underlying environment. It covers all supported hardware and software stacks, including settings for web and application servers as well as for Business Objects applications. This guide also covers the minimum supported O/S versions and patch levels, web browser versions, and web and application server versions and patch levels. This guide provides a starting point for setting parameters in a production environment. You may need to adjust parameters depending upon the exact nature of the deployment (number of users and user profiles, number of documents, projected workflows, and so on). This guide is not a substitute for ensuring that the product is properly installed or for having a good working understanding of the product. You can access the Recommended Settings Guide for Business Objects Deployments at www.techsupport.businessobjects.com
271
and not in the Business Objects installation directory. This means that if you want to refresh the document with Broadcast Agent, the connection to the data source will fail, and the document cannot be refreshed. To solve this issue, you must manually copy the sdac.lsi file to all nodes in the cluster. Copy the file into: $INSTALLDIR\nodes\<machine name>\<cluster name>\locdata\ After the file is copied, all Schedulers on the cluster will be able to refresh the document.
272
273
Both zip files contain a Readme that describes the SQL scripts, DAT files, and any RDBMS-specific issues you need to be aware of when running the scripts. Business Objects recommends checking the Readme before you generate either database.
274
Where to go now
Your BusinessObjects 6.5 suite should now be fully operational. If you want to modify or remove an installation or product, go to Modifying and Removing Installations on page 83.
Appendices
part
appendix
278
Overview
This appendix lists the Business Objects products and components, along with their feature codes. These codes are used when running the installer from the command line or in a batch file. Feature code
bo bo.3TierBusinessObjects bo.AccessPacks bo.AdminConsole bo.AdminProducts bo.Auditor bo.AuditorDocComponents bo.AuditorDocExporter bo.AuditorDocs bo.AuditorUniverse Components bo.AuditorUniverseExporter bo.AuditorUniverses bo.AuditorWebPages bo.BCAConsole bo.BCAScheduler bo.BroadcastAgent
Product or component
BusinessObjects 6.5 3-tier BusinessObjects Access Packs Administration Console Administration products Auditor Document components Document Exporter Documents Universe components Universe Exporter Universes Web Pages Broadcast Agent Console Scheduler Broadcast Agent
Description
The BusinessObjects suite of products. BusinessObjects, for use in 3-tier mode. Data access packs The Administration Console enables you to configure and monitor your cluster. Products intended for administrators and IT experts. Auditor monitors user and sytem activity Components to manage Auditor documents Exports Auditor documents to repository. Auditor documents Components to manage Auditor universes. Exports Auditor universes to repository. Auditor universes Auditor portal Monitors Broadcast Agent activity The core of Broadcast Agent Broadcast Agent processes and distributes documents automatically and securely at scheduled dates and times. The integrated query, reporting, and analysis solution for your desktop. BusinessObjects documentation
bo.BusinessObjects bo.BusinessObjectsDoc
279
Feature code
bo.BusinessObjectsExplorer bo.BusinessObjectsHelp bo.BusinessObjectsReporter bo.BusinessQuery
Product or component
Explorer Online Help Reporter BusinessQuery for Excel
Description
BusinessObjects module to carry out multidimentional analysis in drill mode. BusinessObjects online help BusinessObjects module for report creation and consultation. Add-in to Microsoft Excel to query relational databases and produce reports. BusinessQuery add-in BusinessQuery documentation BusinessQuery help The Configuration Tool enables you to configure your Business Objects server products. Demo kit, including sample databases and universes. Demonstrations and Quick Tours Designer enables you to create universes. Designer application Designer documentation Designer help End-user products for desktop machines. Enables users to download 3-tier BusinessObjects from InfoView. (This installs the entire package.) The InfoView portal. Application server pages and front-end components, installed on the machine that hosts the application server. HTML pages and images, installed on the machine that hosts your web server. Access packs for OLAP data sources
Demo Kit Demonstrations Designer Designer Online Guides Online Help desktop products BusinessObjects Web Installer InfoView Application Server pages
bo.InfoView bo.InfoViewASPages
bo.InfoViewWSPages bo.olap
280
Feature code
bo.olap.BWConnect bo.olap.BWConnectDoc bo.olap.BWConnectDriver bo.olap.Essbase bo.olap.EssbaseDoc bo.olap.EssbaseDriver bo.olap.Express bo.olap.ExpressDoc bo.olap.ExpressDriver bo.olap.IBMDB2 bo.olap.IBMDB2Doc bo.olap.IBMDB2Driver bo.olap.MDXConnect bo.olap.MDXConnectDoc bo.olap.MDXConnectDriver bo.QuickTour bo.rdbms bo.rdbms.IBMDB2 bo.rdbms.IBMDB2Client bo.rdbms.Microsoft
Product or component
BW Connect Online Guides BW Connect Essbase Online Guides Essbase Express Online Guides Express DB2 OLAP Server Online Guides DB2 OLAP Server MDX Connect Online Guides MDX Connect Quick Tour RDBMS Access Packs IBM DB2 DB2 Client Microsoft
Description
SAP Business Warehouse Access Pack and documentation SAP Business Warehouse Access Pack documentation SAP Business Warehouse Access Pack Hyperion Essbase Access Pack and documentation Hyperion Essbase Access Pack documentation Hyperion Essbase Access Pack Oracle Express Access Pack and documentation Oracle Express Access Pack documentation Oracle Express Access Pack IBM DB2 OLAP Server Access Pack and documentation IBM DB2 OLAP Server Access Pack documentation IBM DB2 OLAP Server Access Pack Microsoft Analysis Services Access Pack and documentation Microsoft Analysis Services Access Pack documentation Microsoft Analysis Services Access Pack Multimedia Quick Tour of Business Objects products Access packs for relational databases IBM DB2 Access Pack Enables you to access an IBM DB2 database server Microsoft Access Pack
281
Feature code
bo.rdbms.MSAccessODBC bo.rdbms.MSSQLServerODB C bo.rdbms.ODBC bo.rdbms.ODBC2 bo.rdbms.ODBC3 bo.rdbms.Oracle bo.rdbms.OracleClient bo.ServerBackEnd bo.ServerProducts bo.Supervisor bo.SupervisorApp bo.SupervisorDoc bo.SupervisorHelp bo.WebIntelligence bo.WebIntelligenceExplorer bo.WebIntelligenceReporter
Product or component
Microsoft Access ODBC Driver Microsoft SQL Server ODBC Driver Generic ODBC Generic ODBC 2 Driver Generic ODBC 3 Driver Oracle Oracle Client Business Objects server server products Supervisor Supervisor Online Guides Online Help WebIntelligence Explorer Reporter
Description
Enables you to access a Microsoft Access database Enables you to access Microsoft SQL Server ODBC Access Pack Enables you to access various databases through ODBC level 2 driver. Enables you to access various databases through ODBC level 3 driver. Oracle Access Pack Enables you to access an Oracle database server. Server components, to be installed on a secured machine. Products running on server machines. Supervisor defines and administers users, user groups, and profiles. Supervisor application Supervisor documentation Supervisor help WebIntelligence engine, for query, analysis, and reporting from the web. WebIntelligence module for report analysis (drill) WebIntelligence module for report creation and consultation
282
Language Codes
appendix
284
Overview
ISO 639 defines standard language codes that can be used as values within HTML and other documents requiring language properties. Business Objects uses these codes for command-line and Configuration Tool properties.
Language
Abkhazian Afrikaans Amharic Arabic Assamese Aymara Azerbaijani Bashkir Byelorussian Bulgarian Bihari Bislama Bengali; Bangla Tibetan Breton Catalan Corsican Czech Welsh Danish German
Language Codes
285
Code
dz el en eo es et eu fa fi fj fo fr fy ga gd gl gn gu he ha hi hr hu hy ia id ie ik in
Language
Bhutani Greek English Esperanto Spanish Estonian Basque Persian Finnish Fiji Faeroese French Frisian Irish Scots, Gaelic Galician Guarani Gujarati Hebrew Hausa Hindi Croatian Hungarian Armenian Interlingua Indonesian Interlingue Inupiak Indonesian
286
Code
is it iu iw ja ji jw ka kk kl km kn ko ks ku ky la ln lo lt lv mg mi mk ml mn mo mr
Language
Icelandic Italian Inuktitut Hebrew (obsolete; see he) Japanese Yiddish (obsolete; see y) Javanese Georgian Kazakh Greenlandic Cambodian Kannada Korean Kashmiri Kurdish Kirghiz Latin Lingala Laothian Lithuanian Latvian, Lettish Malagasy Maori Macedonian Malayalam Mongolian Moldavian Marathi
Language Codes
287
Code
ms mt my na ne nl no oc om or pa pl ps pt qu rm rn ro ru rw sa sd sg sh si sk sl sm sn
Language
Malay Maltese Burmese Nauru Nepali Dutch Norwegian Occitan (Afan), Oromo Oriya Punjabi Polish Pashto, Pushto Portuguese Quechua Rhaeto-Romance Kirundi Romanian Russian Kinyarwanda Sanskrit Sindhi Sangro Serbo-Croatian Singhalese Slovak Slovenian Samoan Shona
288
Code
so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ug uk ur uz vi vo wo xh
Language
Somali Albanian Serbian Siswati Sesotho Sundanese Swedish Swahili Tamil Tegulu Tajik Thai Tigrinya Turkmen Tagalog Setswana Tonga Turkish Tsonga Tatar Twi Uigur Ukrainian Urdu Uzbek Vietnamese Volapuk Wolof Xhosa
Language Codes
289
Code
y yo za zh zu
Language
Yiddish Yoruba Zuang Chinese Zulu
290
Language Codes
291
Index
$INSTALLDIR 116, 130, 143, 212, 223 .key file 223 /a parameter 79 /L parameter 79 /s parameter 79 /v parameter 79 /w parameter 79 /x parameter 79 application server adding a web application 159, 161, 164, 169, 173 configuring 107, 110, 158 modifying or removing 178 application server connector 23 application servers what you install on 23 ASINSTALLDIR 149 ASINSTANCENAME 149 ASP 148, 150 ASSTANDALONE 150 ASTYPE 149 ASWEBAPPNAME 149 audit information 269 Auditor 53, 269 Authentication before you configure the system 228 authentication 250 defined 233 authentication modes delegated to the web server 234 SSO authentication 234 Windows 234 authentication source 250 selecting standard 249 authentication vs. authorization 232 authorization defined 233
Symbols
2-tier architecture see also 2-tier deployments 2-tier deployments what to install where 22 3-tier architecture see also 3-tier deployments 3-tier deployments clusters 19 what to install where 22
A
Access Packs 42, 54, 228, 238 Access packs 50 adding a product 85 ADDLOCAL parameter 77 ADDSOURCE Windows Installer parameter 78 Administration Console 53, 57 Administration Products 52 Administration products 50, 52 advanced LDAP configuration specifying LDAP authentication query 259 ALLUSERS parameter 77 Apache 138, 164 Apache/Tomcat Installer 47 APP_NAME 148, 149 APP_TYPE 148, 149, 150
B
Basic authentication 234 bomain.key 223 Broadcast Agent 57, 270 Console component 53 description 51 Scheduler component 51 Broadcast Agent Console 53, 57
Index
292
buildwar target 202 buildwars target 202 Business Objects consulting services 11, 13 documentation 10 Documentation Supply Store 9 support services 11 training services 11, 13 Business Objects processes 269 Business Objects products 278 what you install where 22 Business Objects server products 60, 62, 64 Business Objects system clusters 19 Business Objects Web Installer 57 BusinessObjects 56 description 52 description 52 Explorer module 52 Reporter module 52 BusinessObjects 4.x and earlier upgrading 33 BusinessObjects 5.x upgrading 32 BusinessObjects in 3-tier mode 51, 56 BusinessObjects Web Installer 51 BusinessQuery description 52 BusinessQuery for Excel 29, 56
C
CFGFILE_LOC_0 149 CFGFILE_LOC_1 150 CFGFILE_NAME_0 149 CFGFILE_NAME_1 150 classpath JDK 46 clean target 202 client machines what you install on 23 client node 120 configuration 120 Cluster Management page 123, 130, 137, 158, 168 cluster node removing 125
cluster nodes defined 19 what you install on 23 cluster preferences 123 Cluster Preferences page 117, 136 CLUSTER_NAME 145, 150 clusters defined 19 clusters and nodes 21 -cmdfile 144 -cmdline 144 command-line installations 70, 73 examples 79 path names 73 syntax 73 command-line mode parameters 144 syntax 143 COMPANYNAME parameter 77 Configuration Options page 116, 130 Configuration Tool 53, 57, 95 command-line mode 143 command-line parameters 144 parameters text file 144 permissions 96 starting 116 text file parameters 145 configuring authentication before you start 228 Security Configuration Tool 246 configuring LDAP confirmation 262 connection parameters 255 configuring the application server 107, 110, 158 configuring the ORB 118, 130, 132, 136 configuring the web applications 105, 182 configuring the web server 158 confirming your LDAP configuration 262 connectivities 223 Console (Broadcast Agent) description 53 consultants Business Objects 11 creating universes 224 custom configuration 117
Index
293
custom installation 57, 65 Custom Setup page 85, 87 customer support 11 customized web applications 168 customizing the LDAP query parameters 257
E
education see training Essbase 225 EssConfig.exe 225 Explorer 56 module of BusinessObjects 52 module of WebIntelligence 51 external user Business Objects authentication 234 external user management system mapping to groups based on external attributes 241 mapping to groups based on external user groups 241 supported directories 228, 238 external user management system restrictions Broadcast Agent 242 InfoView 242 Supervisor 242 externalized users 235, 238
D
data access 223 data sources OLAP 51 RDBMS 51 default language 61, 63, 65 DEFAULTLANG parameter 75 delegated to the web server mode 234 -delete 144 demo materials 9 demo kit 57 Demonstrations 50 filenames 55 deploy target 202 deployall target 202 deploying an application 158 Deploying static resources 216 deployment application servers and web servers 21 Designer 29, 57, 224 Designer (description) 53 Desktop installation 56, 61, 63, 65 Desktop products 52 Developer Suite 10, 12 distributed configurations advantages 20 documentation CD 9 feedback on 10 on the web 9 printed, ordering 9 roadmap 9 search 9 Documentation Supply Store 9 DOCUMENTS_DIR 150 domain user 120, 134, 140
F
feature codes 278 feedback on documentation 10 final backslash 73 final steps 266
G
general system availability 271 generic WAR file 194 generic.xml file 212
H
-help 144 help target 202 hotfix applying 90 httpd.conf file 138
I
IIS 105, 115, 129, 133, 159, 168 IIS Administration service 96
Index
294
IIS Services 125 IMAGE_DIR 151 InfoView 51, 57, 270 Login page 268 troubleshooting 269 verifying 268 Infoview core functionality of WebIntelligence 51 INSTALL_LANG parameter 75 installation custom 65 which products on what machines 22 Installation Type page 61, 63, 65 installation types 56 Installation wizard 49 parameters 74 Installation Wizard Completed page 86 INSTALLDIR parameter 77 installing JDK 45 installing the software 42 installing to the client 72 Installing to the network 72 InstallShield 73, 74 parameters 74, 79 INSTALLTYPE parameter 78 INSTALLVBA parameter 77 instance removing 177 IP address 115, 118, 132, 136 ISO 639 284 ISO language codes 284
LDAP defining mapping parameters 256 Security Configuration Tool 246 LDAP authentication query specifying 259 LDAP connection parameters configuring 255 LDAP mapping specifying LDAP authentication query 259 LDAP query parameters customizing 257 license agreement 60, 62, 64 license files 45 installing in a shared network directory 45 installing on each machine 45 LICENSEDIR parameter 74 licenses 44 LOCAL_IPADDR 146 LOCAL_PORTMIN 146 LOCALKEYDIR parameter 75 LOCDATA_DIR 150 LOGS_DIR 150
M
manual application server detection 137, 161, 164 manual configuration 98, 115 Microsoft Excel 52 MIGRATION parameter 74 MIGRATIONPROMPT parameter 74 multidimensional data providers using WebIntelligence 51 multimedia quick tours 10
J
Java 53 JDK 45 classpath 46
N
network location 72 Node page 118, 121 NODE_AUTOSTART 146 NODE_SERVICE 146 NODE_TYPE 146 nodes and clusters 21 -nosplash 144
K
Knowledge Base 12
L
-language 144 language codes 284 Language Selection page 116, 130
Index
295
O
objects using Designer 53 OLAP 225 using WebIntelligence 51 OLAP Cache Service 119, 134, 139 Online Customer Support 11 ORB 118, 130, 132, 136 order of configuration 114
repairing an installation 88 Reporter 56 module of BusinessObjects 52 module of WebIntelligence 51 repositories 223 repository 53 RESFILENAME 149 review of tools 49, 95 rights 96
P
PAR 42 parameter components 73 parameters file 144 path names 73 Possible issues Deploying static resources 216 pre-install procedures 44 primary node configuration 117 defined 19 what it does 20 PRIMARY_IPADDR 146 PRIMARY_PORTMIN 146 Product Availability Report 42 Program Maintenance page 85, 87, 88, 89 Properties parameter 198
S
Scheduler (Broadcast Agent) 51 SCRIPTS_DIR 151 search documentation 9 secondary node 120 configuration 121 secondary nodes defined 19 what they do 20 Security Configuration Tool installation 246 logging in 247 who can use it 246 selecting SSO 250 selecting standard authentication source 249 server installation 57 Server products 50 Service parameters 119, 134, 139 setup.exe 59 SHAREDKEYDIR parameter 76 SHDATA_DIR 150 silent install 80 specifying LDAP authentication query 259 SQL 53 SQL structures 53 SSO configuring server connection 251 SSO authentication mode 234 SSO server connection 251 SSO source selecting 250 starting the system 267 Supervisor 29, 57, 269
Q
qn parameter 78
R
Ready to Modify the Program page 86 Ready to Repair the Program page 88 relational databases using WebIntelligence 51 REMOVE parameter 78 Remove the Program page 89 removing a node 125 removing a product 87 removing an installation 89 removing an instance 177 removing individual products 87
Index
296
T
targets 202 TCP ports 118, 132, 136 TEMPLATES_DIR 151 testing the system 270 THREETIERBUSOJ parameter 76 Tips & Tricks 10 Tomcat 161, 164 tools 49, 95 training on Business Objects products 11 tuning the system 269 types of configuration custom 117 types of installation 56 Typical configuration 117 Typical wizard 115, 128, 138
U
UDS 119, 134, 139 undeploy target 202 undeployall target 202 Universal Drill Through Service 119, 134, 139 universes creating 224 UNIVERSES_DIR 150 UNIX multiple nodes on single servers 19 upgrading 32, 67 WebIntelligence 32 USERNAME parameter 77
W
WARFILENAME 150 wdeploy deployment considerations 186
wdeploy tool 97 adding an application server 212 deploying a customized application 210 generic WAR file 194 Properties parameter 198 targets 202 web customer support 11 getting documentation via 9 useful addresses 12 web application deploying static resources 107, 110 web applications configuring 105, 182 customized 168 WEB parameter 76 web server configuring 158 web servers what you install on 23 WebIntelligence 51 description 51 Explorer module 51 InfoView 51 OLAP Cache Service 119, 134, 139 Reporter module 51 WebIntelligence 2.x 32 WebIntelligence OLAP 225 Welcome page 85, 89, 116, 130 Windows authentication mode 234 Windows Explorer 59 Windows Installer 73 parameters 77 Windows Start menu 130 Windows User Manager 96, 134, 139 WIQT 269 wmainkey utility 223 wping 271 WSDIRNAME 148 WSINSTALLDIR 148 WSINSTANCENAME 148 WSTYPE 148
Index
297
Z
Zero Admin BusinessObjects definition 52
Index
298
Index