You are on page 1of 32

BusinessObjects Enterprise XI 3.

0 Portal
Integration Kit Installation Guide for
Microsoft SharePoint

BusinessObjects Enterprise XI 3.0 Portal Integration Kit


Patents 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.

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.

Copyright Copyright © 2005 Business Objects. All rights reserved.


Contents
Chapter 1 Welcome to the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
5
About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Who should read this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Business Objects information resources . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 2 Installing the Portal Integration Kit on a Microsoft SharePoint Server 7


Installation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing the BusinessObjects Enterprise XI 3.0 Portal Integration Kit . . . 10
Uninstalling the BusinessObjects Enterprise XI 3.0 Portal Integration Kit . 13

Chapter 3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit


15
Configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Considerations when enabling SharePoint on virtual servers post install . 16
Template configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Updating web.config for subsequent SharePoint-enabled virtual servers . 17
Updating web.config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
General considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Creating additional SharePoint sites . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Updating managed paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Updating virtual directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Appendix A Business Objects Information Resources 25


Documentation and information services . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
What’s in the documentation set? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Where is the documentation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 3
Contents

Send us your feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27


Customer support, consulting and training . . . . . . . . . . . . . . . . . . . . . . . . . 27
How can we support you? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Looking for the best deployment solution for your company? . . . . . . . . 28
Looking for training options? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Index 31

4 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Welcome to the
BusinessObjects Enterprise
XI 3.0 Portal Integration Kit

chapter
1 Welcome to the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
About this guide

About this guide


This guide provides information on installing and configuring the
BusinessObjects Enterprise XI 3.0 Portal Integration Kit.

Who should read this guide


This guide is intended for administrators who are responsible for installing the
BusinessObjects Enterprise XI 3.0 Portal Integration Kit. Familiarity with
Windows SharePoint Services and/or Office SharePoint Portal Server 2003 is
beneficial, as is a working knowledge of Crystal Reports and BusinessObjects
Enterprise.
For more information about the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit, consult the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit User’s Guide and the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit Administrator’s Guide.

Business Objects information resources


For more information and assistance, see Appendix A: Business Objects
Information Resources. This appendix describes the Business Objects
documentation, customer support, training, and consulting services, with links
to online resources.

6 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Installing the Portal
Integration Kit on a Microsoft
SharePoint Server

chapter
2 Installing the Portal Integration Kit on a Microsoft SharePoint Server
Installation overview

Installation overview
Setting up and installing the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit includes two main activities:
• Installing the Web Part Package
The BusinessObjects Enterprise XI 3.0 Portal Integration Kit includes an
installation program that adds a Web Part Package on your SharePoint
system. For information about installing the Web Part Package, see
“Installing the BusinessObjects Enterprise XI 3.0 Portal Integration Kit” on
page 10.
• Configuring your deployment
After installing the BusinessObjects Enterprise XI 3.0 Portal Integration
Kit, you can set additional configuration options that are specific to your
deployment. For information about advanced configuration options, see
“Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit”
on page 15.
The Web Part Package that is installed with the BusinessObjects Enterprise
XI 3.0 Portal Integration Kit is part of the Intelligence Tier of the
BusinessObjects Enterprise framework.
The web parts enable you to integrate the report-viewing and distribution
features of BusinessObjects Enterprise and Crystal Reports with your
SharePoint system. For more information about the BusinessObjects
Enterprise architecture, see the “BusinessObjects Enterprise Architecture”
chapter in the BusinessObjects Enterprise Administrator’s Guide.
Note: After you install the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit, no icons or shortcuts are added to your Start menu.
The setup program installs five items on your SharePoint deployment: three
functional web parts (Document List, Document View, and Crystal Report
View) and two sample web parts. These web parts are located in the Virtual
Server Gallery folder on your SharePoint system.
ASPX files are installed in the following folder: ..\Program Files\Common
Files\Microsoft Shared\web server
extensions\60\TEMPLATE\LAYOUTS.
Two specific ASPX pages are added—these pages control the display of
Business Objects documents:
• CrystalCalendar.aspx
• CrystalReport.aspx

8 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Installing the Portal Integration Kit on a Microsoft SharePoint Server
System requirements 2
In addition, the template configuration file for the BusinessObjects Enterprise
XI 3.0 Portal Integration Kit is installed here: c:\Program Files\Common
Files\Microsoft Shared\web server
extensions\60\CONFIG\webconfig.businessobjects.xml.
The documentation is available for download from the BusinessObjects
Enterprise web site. This includes this install guide, the administrator’s guide,
and the user’s guide. The user’s guide is also available when you click Help
while using your installed web parts.

System requirements
For a list of system requirements, consult the Platforms.txt file included
with your product distribution. For additional important information that may
pertain to your deployment, it is also strongly recommended that you consult
the Release Notes included with your product distribution.
In general, the following components must be installed and configured
correctly before you install the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit:
• Microsoft Windows SharePoint Services or Office SharePoint Portal
Server 2003.
• BusinessObjects Enterprise XI .NET SDK (on your SharePoint machine
or machines).
• Microsoft Windows Server 2003 (any edition).
• BusinessObjects Enterprise and Crystal Reports (on either the same
machine and/or on a different machine).
Note:
• Ensure that you are logged on as a user with administrator privileges.
• In your BusinessObjects Enterprise installation, install OLAP Intelligence
if you want to include analytic reporting for your SharePoint solution.
Your SharePoint deployment can be on a different machine from your
BusinessObjects Enterprise machine or machines. In addition, the
BusinessObjects Enterprise XI 3.0 Portal Integration Kit can be deployed to
multiple SharePoint servers.

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 9
2 Installing the Portal Integration Kit on a Microsoft SharePoint Server
Installing the BusinessObjects Enterprise XI 3.0 Portal Integration Kit

Installing the BusinessObjects Enterprise XI


3.0 Portal Integration Kit
You must install the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
on the same machine as your SharePoint Server, and you must be logged on
with administrator privileges. Ensure that the BusinessObjects Enterprise XI
3.0 .NET SDK is also installed on the same machine. For more information on
installing BusinessObjects Enterprise and its related components, refer to the
BusinessObjects Enterprise Installation Guide, which is included in your
BusinessObjects Enterprise product distribution. For more information about
post-installation steps, see “Configuring the BusinessObjects Enterprise XI
3.0 Portal Integration Kit” on page 15.
To install the portal integration for SharePoint
1. On the CD, open the Add-Ons directory, and then open SharePoint
Services. Click Setup.exe to begin the install.
The BusinessObjects Enterprise XI SharePoint Web Part Package Setup
screen appears.
2. Follow the instructions in the setup program until you reach the
Deployment Options dialog box.

3. Specify the URL for your SharePoint virtual server, site, or subsite (for
example, http://machinename/).

10 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Installing the Portal Integration Kit on a Microsoft SharePoint Server
Installing the BusinessObjects Enterprise XI 3.0 Portal Integration Kit 2
4. Select whether you want the setup program to overwrite any existing
duplicate Web Part Packages.
Note: If you select Yes for “Overwrite existing Web Part Package with
this Web Part Package,” the installation program overwrites any existing
BusinessObjects Enterprise web parts. It is recommended that you select
Yes; web parts unrelated to BusinessObjects Enterprise are not
overwritten.
5. Click Next.
The Configuration Settings dialog box appears.

6. Specify your BusinessObjects Enterprise servers and authentication


settings.
• Name of the BusinessObjects Enterprise Central Management
Server
Specify the machine name or IP address of your BusinessObjects
Enterprise Central Management Server. This server can be on a
machine that is different from your SharePoint deployment.

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 11
2 Installing the Portal Integration Kit on a Microsoft SharePoint Server
Installing the BusinessObjects Enterprise XI 3.0 Portal Integration Kit

• Authentication mode
By default, Enterprise is selected. To change to a different
authentication mode, select a value from the list. Choose the
authentication method that is implemented in your BusinessObjects
Enterprise installation.
Note: Single Sign On works only with Windows NT and AD
authentication. Single Sign On is not supported for Enterprise or
LDAP authentication. In addition, for Enterprise and LDAP
authentication, the BusinessObjects Enterprise XI 3.0 Portal
Integration Kit requires that users have blank passwords in
BusinessObjects Enterprise.
7. Click Next.
The next Configuration Settings dialog box appears.

8. Specify whether you want to use the Document List Web Part.
When you install the Document List web part, the web.config file will
update the path in the Document Viewer URL.
9. Click Next to start your installation.
10. After the installation is complete, click Finish.

12 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Installing the Portal Integration Kit on a Microsoft SharePoint Server
Uninstalling the BusinessObjects Enterprise XI 3.0 Portal Integration Kit 2
Uninstalling the BusinessObjects Enterprise
XI 3.0 Portal Integration Kit
When you uninstall the BusinessObjects Enterprise XI 3.0 Portal Integration
Kit, all web parts, samples, and documentation are removed from all virtual
servers. Note that instances and any other content in BusinessObjects
Enterprise that Web Site Creators and Information Consumers have added
are not removed during the uninstall process.
To uninstall the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
1. While logged on as an Administrator, go to Start > Settings > Control
Panel.
2. Select Add or Remove Programs.
3. In the list of currently installed programs, select BusinessObjects
Enterprise 11.5 SharePoint Web Part Package.
4. Click Remove.
5. When asked to confirm your uninstall, click Yes.

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 13
2 Installing the Portal Integration Kit on a Microsoft SharePoint Server
Uninstalling the BusinessObjects Enterprise XI 3.0 Portal Integration Kit

14 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Configuring the
BusinessObjects Enterprise
XI 3.0 Portal Integration Kit

chapter
3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Configuration overview

Configuration overview
This chapter is intended for administrators who have good working
knowledge of SharePoint, BusinessObjects Enterprise, and web servers. It
details specific steps for various installation scenarios that apply to specific
SharePoint deployments. For more information on general administrative
tasks, see the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Administrator’s Guide.
Related topics:
• “Considerations when enabling SharePoint on virtual servers post install”
on page 16
• “Updating web.config for subsequent SharePoint-enabled virtual servers”
on page 17
• “General considerations” on page 22

Considerations when enabling SharePoint


on virtual servers post install
This section provides information on updating the template configuration file
when you enable Microsoft Windows SharePoint Services or Office
SharePoint Portal Server 2003 on a new virtual server after the installation of
the BusinessObjects Enterprise XI 3.0 Portal Integration Kit.

Template configuration file


The template configuration file for the BusinessObjects Enterprise XI 3.0
Portal Integration Kit is located in the following directory:
c:\Program Files\Common Files\Microsoft Shared\web server
extensions\60\CONFIG\webconfig.businessobjects.xml.
Every time a web site is created through your SharePoint solution,
SharePoint uses this XML configuration template file to generate
web.config entries.
This template also specifies the BusinessObjects Enterprise system that you
entered during installation. Thus, if you change the machine on which your
BusinessObjects Enterprise Central Management Server (CMS) is located,
you need to update this XML file. In particular, you need to update the value
for the “BusinessObjects Enterprise Central Management Server” key to
ensure that the value matches the name of your CMS.

16 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Updating web.config for subsequent SharePoint-enabled virtual servers 3
Updating web.config for subsequent
SharePoint-enabled virtual servers
This section provides information about updating the web.config file.
Specifically, this section details the tags and configuration settings for the
BusinessObjects Enterprise XI 3.0 Portal Integration Kit.

Updating web.config
The BusinessObjects Enterprise XI 3.0 Portal Integration Kit installer updates
the web.config file that is located in the standard root space of your web
server (..\Inetpub\wwwroot). The installer also creates a backup of your
original web.config file, called “backup web.config”. The backup file is
stored in the installation directory.
Note: In some instances, your web.config file may be located elsewhere.
Consider this example: you host your SharePoint site on port 81, instead of
the default port 80. In this case, your web.config for port 80 is located at
c:\machine_name\webroot\web.config, instead of the default location
(c:\Inetpub\wwwroot\web.config). Although you specify the correct
URL and port number during setup, the installation program always attempts
to update the configuration file in c:\Inetpub\wwwroot. If there is no
SharePoint or .NET deployment on port 80, there may not be a web.config
file in c:\Inetpub\wwwroot. In this case, you need to update your
web.config file manually.
During the installation process, extra tags are added to the bottom of the
web.config file. The tags contain the following text:
<appSettings>
<!-- Authentication mode can be secWinAD, secWindowsNT,
secEnterprise -->
<add key="BusinessObjects Enterprise Authentication Mode"
value="%AUTHENTICATIONMODE%" />
<!-- Management server is the name of the server where the
CMS resides -->
<add key="BusinessObjects Enterprise Management Server"
value="%CMSNAME%" />
<!-- Token expiry in minutes to limit re-authentication -->
<add key="BusinessObjects Enterprise Token Timeout"
value="600" />
<!-- InfoObject ProgID Exclusion Types (any valid Enterprise
Prog-Id comma separated) -->

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 17
3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Updating web.config for subsequent SharePoint-enabled virtual servers

<add key="BusinessObjects Enterprise Object Exclusions"


value="CrystalEnterprise.ObjectPackage,CrystalEnterprise
.Program,CrystalEnterprise.AFDashboardPage" />
<!-- Displaying problem tracking messages in web part pages
-->
<add key="BusinessObjects Enterprise Trace Enabled"
value="False" />
<!-- Whether to prompt the logon page for the user to input
the username&password -->
<add key="BusinessObjects Enterprise Credential Prompt"
value="False" />
<!-- Analytic viewer Url Object Types that use Analytic
Viewer Url Key -->
<add key="BusinessObjects Enterprise Analytic Viewer Object
Types" value="CrystalEnterprise.Analytic" />
<!-- Document viewer Url Object Types that use Document
Viewer Url Key -->
<add key="BusinessObjects Enterprise Document Viewer Object
Types"
value="CrystalEnterprise.Report,CrystalEnterprise.Analys
is,CrystalEnterprise.Webi,CrystalEnterprise.Rtf,CrystalE
nterprise.Txt,CrystalEnterprise.Pdf,CrystalEnterprise.Ex
cel,CrystalEnterprise.Powerpoint,CrystalEnterprise.Word,
CrystalEnterprise.FullClient" />
<!-- Analytic viewer Url %id%, %type%, %lang% and %token%
are substitution variables -->
<add key="BusinessObjects Enterprise Analytic Viewer Url"
value="http:// %JAVAINFOVIEW%/businessobjects/
enterprise115/desktoplaunch/jsp/
openAnalytic.jsp?sType=%type%&amp;DocumentId=%id%&amp;to
ken=%token%&amp;lang=%lang%&amp;RepositoryType=C" />
<!-- Document viewer Url %id%, %type%, %lang% and %token%
are substitution variables -->
<add key="BusinessObjects Enterprise Document Viewer Url"
value="http:// %JAVAINFOVIEW%/businessobjects/
enterprise115/InfoView/scripts/
openDocument.aspx?sKind=%type%&amp;sIDType=CUID&amp;iDoc
ID=%id%&amp;token=%token%&amp;lang=%lang%" />
</appSettings>
If your web.config file is not in the default location, configure and copy these
tags to the correct web.config file.
Note: These tags must be at the end of your web.config file, after the </
system.web> tag, but before the </configuration> tag.

18 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Updating web.config for subsequent SharePoint-enabled virtual servers 3
Configuring the web.config tags
Each setting consists of two lines: a comment line (contained within !-- and
--) and the actual tag. Before copying the tags, you need to first configure the
settings for your deployment. For each tag line (other than comment lines),
update the information in the value section that is contained within the set of
double quotes.
For example, if your authentication mode is Enterprise, replace
value="secWinAD" with value"secEnterprise".

Authentication mode
• <!-- Authentication mode can be secWinAD, secWindowsNT,
secEnterprise -->
• <add key="BusinessObjects Enterprise Authentication Mode"
value="secEnterprise" />
In the value section, specify the authentication method that matches your
BusinessObjects Enterprise deployment. Ensure that you type the full
authentication name (secWinAD, secEnterprise, and so on).
Note: Single Sign On works only with Windows NT and AD authentication.
Single Sign On is not supported for Enterprise or LDAP authentication and
users in BusinessObjects Enterprise must have blank passwords.
Central Management Server
• <!-- Management server is the name of the server where
the CMS resides -->
• <add key="BusinessObjects Enterprise Management Server"
value="yourCMSname" />
In the value section, within the quotations, specify the name of your CMS.
BusinessObjects Enterprise token
• <!-- Token expiry in minutes to limit re-authentication -
->
• <add key="BusinessObjects Enterprise Token Timeout"
value="60" />
By default, the value is set to 60 minutes. This value specifies how long a
BusinessObjects Enterprise token is valid for.
ProgID exclusion types
• <!-- InfoObject ProgID Exclusion Types (any valid
Enterprise Prog-Id comma separated) -->

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 19
3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Updating web.config for subsequent SharePoint-enabled virtual servers

• <add key="BusinessObjects Enterprise Object Exclusions"


value="CrystalEnterprise.ObjectPackage,CrystalEnterprise
.Program,CrystalEnterprise.AFDashboardPage" />
This tag contains a comma-separated list of BusinessObjects Enterprise
ProgIDs. You can specify which BusinessObjects Enterprise objects you want
to exclude from your SharePoint deployment. These object types can still
exist in your BusinessObjects Enterprise system, but this tag provides a
means for your to filter out unwanted types in your SharePoint deployment.
Tracing
• <!-- Displaying problem tracking messages in web part
pages -->
• <add key="BusinessObjects Enterprise Trace Enabled"
value="False" />
Change this value to True if you want to enable tracing. For more information
about tracing, refer to the “Troubleshooting” chapter in the BusinessObjects
Enterprise XI 3.0 Portal Integration Kit Administrator’s Guide.
Credential Prompt
• <!-- Whether to prompt the logon page for the user to
input the username&password -->
• <add key="BusinessObjects Enterprise Credential Prompt"
value="False" />
If you want to enable the logon page, change the value to True. If the value is
False, the system will use the SharePoint Server's administrator account to
login.
You also can use the following to specify the username and password:
<!-- Username is the name of the logon name -->
<add key="BusinessObjects Enterprise Static Username"
value="administrator" />
<!-- Password is the password for the logon user -->
<add key="BusinessObjects Enterprise Static Password"
value="" />
Analytic Viewer object types
• <!-- Analytic viewer Url Object Types that use Analytic
Viewer Url Key -->
• <add key="BusinessObjects Enterprise Analytic Viewer
Object Types" value="CrystalEnterprise.Analytic" />
In the value section, specify the objects that Analytic Viewer can view.

20 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
Updating web.config for subsequent SharePoint-enabled virtual servers 3
Document Viewer object types
• <!-- Document viewer Url Object Types that use Document
Viewer Url Key -->
• <add key="BusinessObjects Enterprise Document Viewer
Object Types"
value="CrystalEnterprise.Report,CrystalEnterprise.Analys
is,CrystalEnterprise.Webi,CrystalEnterprise.Rtf,CrystalE
nterprise.Txt,CrystalEnterprise.Pdf,CrystalEnterprise.Ex
cel,CrystalEnterprise.Powerpoint,CrystalEnterprise.Word,
CrystalEnterprise.FullClient" />
In the value section, specify the objects that Document Viewer can view
Analytic Viewer
• <!-- Analytic viewer Url %id% and %token% are
substitution variables -->
• <add key="BusinessObjects Enterprise Analytic Viewer Url"
value="http://%JAVAINFOVIEW%/businessobjects/
enterprise11/desktoplaunch/jsp/
openAnalytic.jsp?sType=%type%&amp;DocumentId=%id%&amp;to
ken=%token%&amp;RepositoryType=C" />
This tag is used to set the url for the analytic document viewer.
BusinessObjects Enterprise Performance Management uses the analytic
document viewer.
Note:
• The JAVAINFOVIEW parameter must point to the server where
BusinessObjects Performance Management is installed.
• The path is determined by the Java InfoView path on that server.

Document Viewer
• <!-- Document viewer Url %id%, %type%, %lang% and %token%
are substitution variables -->
• <add key="BusinessObjects Enterprise Document Viewer Url"
value="http://%JAVAINFOVIEW%/businessobjects/
enterprise115/InfoView/scripts/
openDocument.aspx?sKind=%type%&amp;sIDType=CUID&amp;iDoc
ID=%id%&amp;token=%token%&amp;lang=%lang%" />
This tag is used to set the url for the document viewer and document list.

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 21
3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
General considerations

General considerations
This section provides information about creating additional SharePoint sites,
updating managed paths, and updating virtual directories.

Creating additional SharePoint sites


When you create a new SharePoint site, you need to provide web parts to the
virtual server web part repository. Ensure that you install
BusinessObjectsEnterprise.Sharepoint.CAB before you use the
BusinessObjects Enterprise XI 3.0 Portal Integration Kit with your new site.
Use stsadm.exe to install the CAB file that is located at c:\Program
Files\Business Objects\BusinessObjects Enterprise 11.5\
SharePoint Web Part Package. For more information on using
stsadm.exe, refer to your SharePoint documentation.
In addition, update the web.config file that is specific to your new
SharePoint site. For more information on updating the web.config file, see
“Updating web.config” on page 17.

Updating managed paths


During the installation process, the setup program excludes specific
BusinessObjects Enterprise URLs from the SharePoint system. These paths
are excluded to ensure that the web parts can communicate with
BusinessObjects Enterprise.
If your SharePoint deployment and BusinessObjects Enterprise deployment
are on the same port, but not on port 80, you need to update the managed
paths. This update is important when you run BusinessObjects Enterprise
and Windows SharePoint Services or Office SharePoint Portal Server 2003
on the same machine.
Run stsadm.exe with the following parameters to update the managed
paths:
“c:\Program Files\Common Files\Microsoft Shared\Web Server
Extensions\60\BIN\stsadm.exe” -o addpath -url http://
Machine_name:port/<path>/ -type exclusion

22 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
General considerations 3
The following lists the values to be used in <path> when you update the
managed paths:
• crystalreportviewers115
• analysishelp
• businessobjects
• styles
• analysisviewer

Updating virtual directories


If you are deploying the BusinessObjects Enterprise XI 3.0 Portal Integration
Kit to a SharePoint site that is not on the default web site, you need to define
a new virtual directory in IIS to point to CrystalReportsViewers115. For more
information about defining a new virtual directory, refer to the
BusinessObjects Enterprise Installation Guide, which is included with your
BusinessObjects Enterprise product distribution.
If you are using a non-default port (that is, a port other than port 80), and
BusinessObjects Enterprise is not on the same port, you need to create
virtual servers, which point to the folders in the corresponding virtual servers
installed with BusinessObjects Enterprise on port 80.
The following list includes the names of the virtual servers that you must
create:
• AnalysisHelp
• AnalysisViewer
• BusinessObjects
• CrystalReportViewers115
• Styles
Note that “BusinessObjects” is required only if you want to access the Central
Management Console, the BusinessObjects Enterprise web desktop, and
other sample desktops from this alternative port.

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 23
3 Configuring the BusinessObjects Enterprise XI 3.0 Portal Integration Kit
General considerations

24 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Business Objects
Information Resources

appendix
A Documentation and information services

Documentation and information services


Business Objects offers a full documentation set covering its products and
their deployment. Additional support and services are also available to help
maximize the return on your business intelligence investment. The following
sections detail where to get Business Objects documentation and how to use
the resources at Business Objects to meet your needs for technical support,
education, and consulting.

Documentation
You can find answers to your questions on how to install, configure, deploy,
and use Business Objects products from the documentation.

What’s in the documentation set?


View or download the Business Objects Documentation Roadmap, available
with the product documentation at http://www.businessobjects.com/support/.
The Documentation Roadmap references all Business Objects guides and
lets you see at a glance what information is available, from where, and in
what format.

Where is the documentation?


You can access electronic documentation at any time from the product
interface, the web, or from your product CD.

Documentation from the products


Online help and guides in Adobe PDF format are available from the product
Help menus. Where only online help is provided, the online help file contains
the entire contents of the PDF version of the guide.

Documentation on the web


The full electronic documentation set is available to customers on the web
from support web site at: http://www.businessobjects.com/support/.

Documentation on the product CD


Look in the docs directory of your product CD for versions of guides in Adobe
PDF format.

26 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Customer support, consulting and training A
Send us your feedback
Do you have a suggestion on how we can improve our documentation? Is
there something you particularly like or have found useful? Drop us a line,
and we will do our best to ensure that your suggestion is included in the next
release of our documentation: documentation@businessobjects.com.
Note: If your issue concerns a Business Objects product and not the
documentation, please contact our Customer Support experts. For
information about Customer Support visit: http://www.businessobjects.com/
support/.

Customer support, consulting and training


A global network of Business Objects technology experts provides customer
support, education, and consulting to ensure maximum business intelligence
benefit to your business.

How can we support you?


Business Objects offers customer support plans to best suit the size and
requirements of your deployment. We operate customer support centers in
the following countries:
• USA
• Australia
• Canada
• United Kingdom
• Japan

Online Customer Support


The Business Objects Customer Support web site contains information about
Customer Support programs and services. It also has links to a wide range of
technical information including knowledgebase articles, downloads, and
support forums.
http://www.businessobjects.com/support/

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 27
A Customer support, consulting and training

Looking for the best deployment solution for your


company?
Business Objects consultants can accompany you from the initial analysis
stage to the delivery of your deployment project. Expertise is available in
relational and multidimensional databases, in connectivities, database design
tools, customized embedding technology, and more.
For more information, contact your local sales office, or contact us at:
http://www.businessobjects.com/services/consulting/

Looking for training options?


From traditional classroom learning to targeted e-learning seminars, we can
offer a training package to suit your learning needs and preferred learning
style. Find more information on the Business Objects Education web site:
http://www.businessobjects.com/services/training

28 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Useful addresses at a glance A
Useful addresses at a glance

Address Content
Business Objects product Information about the full range of
information Business Objects products.
http://www.businessobjects.com
Product documentation Business Objects product
http://www.businessobjects.com/ documentation, including the
support Business Objects Documentation
Roadmap.
Business Objects Documentation Send us feedback or questions
mailbox about documentation.
documentation@businessobjects.com
Online Customer Support Information on Customer Support
http://www.businessobjects.com/ programs, as well as links to
support/ technical articles, downloads, and
online forums.
Business Objects Consulting Information on how Business
Services Objects can help maximize your
http://www.businessobjects.com/ business intelligence investment.
services/consulting/
Business Objects Education Information on Business Objects
Services training options and modules.
http://www.businessobjects.com/
services/training

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 29
A Useful addresses at a glance

30 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts
Index
A I
architecture 8 information resources 26
ASPX files 8 installing
overview 8
B procedure 10
system requirements 9
Business Objects
consulting services 28, 29
support services 27 M
training services 28, 29, 29 managed paths. See configuring

C O
configuring Online Customer Support 27
overview 16
to use a port other than the default R
updating managed paths 22
resources 26
updating virtual directories 23
updating web.config 17
consultants, Business Objects 28 S
creating additional SharePoint sites 22 samples, web parts 8
customer support 27 SharePoint sites, creating additional 22
support
customer 27
D
locations 27
documentation
technical 27
feedback on 27
web site 27
on product CD 26
on the web 26
roadmap 26 T
technical support 27
template configuration file, location and uses 16
E
training, on Business Objects products 28
education. See training
enabling SharePoint on virtual servers 16
V
virtual directories. See configuring
F
feedback, on documentation 27
W
web

Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts 31
Index

customer support 27
getting documentation via 26
useful addresses 29
web parts, samples 8
web sites
support 27
training 28
web.config
backup file 17
web.config. See configuring

32 Portal Integration Kit Installation Guide for Microsoft SharePoint Web Parts