Sei sulla pagina 1di 110

SAP BusinessObjects Financial Consolidation Installation

Guide
■ SAP BusinessObjects Financial Consolidation 7.5

2009-02-13
Copyright © 2009 SAP® BusinessObjects™. All rights reserved. SAP BusinessObjects and
its logos, BusinessObjects, Crystal Reports®, SAP BusinessObjects Rapid Mart™,
SAP BusinessObjects Data Insight™, SAP BusinessObjects Desktop Intelligence™,
SAP BusinessObjects Rapid Marts®, SAP BusinessObjects Watchlist Security™,
SAP BusinessObjects Web Intelligence®, and Xcelsius® are trademarks or
registered trademarks of Business Objects, an SAP company and/or affiliated
companies in the United States and/or other countries. SAP® is a registered
trademark of SAP AG in Germany and/or other countries. All other names
mentioned herein may be trademarks of their respective owners.

2009-02-13
Contents

Chapter 1 What's new in version 7.5 of SAP BusinessObjects Financial


Consolidation.......................................................................................7

Chapter 2 Contents of the CD of the version....................................................11

Chapter 3 Summary of the steps involved in installing the product..............13


Installing SAP BusinessObjects Financial Consolidation Server for the first
time with an empty database.....................................................................13
Upgrading SAP BusinessObjects Financial Consolidation Server with an
existing database.......................................................................................14
Installing SAP BusinessObjects Financial Consolidation Web for the first
time with an empty database.....................................................................15
Upgrading SAP BusinessObjects Financial Consolidation Web with an existing
9 version database....................................................................................15
Installing the SAP BusinessObjects Financial Consolidation client...........16
Installing the SAP BusinessObjects Financial Consolidation Web client...17
First standalone installation without an existing database.........................17
Upgrading a standalone installation with an existing database.................17

Chapter 4 Preparing to install SAP BusinessObjects Financial


Consolidation.....................................................................................19
List of the prerequisites installed by the setup...........................................19
Installation prerequisites for the SQL Server client...................................20
Installation prerequisites for the Oracle client............................................21
Installation prerequisites for Windows 2003 web components..................21
Installing and configuring the .NET framework in Windows 2003 SP1......22

3
Contents

Configuring IIS 6........................................................................................26


Installation prerequisites for Windows 2008 web components..................27
Installing IIS 7............................................................................................27
Creating application pools with IIS 7.........................................................29
Increasing limit size of HTTP requests......................................................32
Installing ActivePDFServer........................................................................32
Installing the BusinessObjects Enterprise XI 3.1 platform or the SAP
BusinessObjects User Management System............................................34

Chapter 5 Installing the client/server.................................................................35


Installing the SAP BusinessObjects Financial Consolidation client...........35
Installing the SAP BusinessObjects Financial Consolidation server.........37
Deploying a SAP BusinessObjects Financial Consolidation website........40
Installing the SAP BusinessObjects Financial Consolidation Web server..41
Deploying the SAP BusinessObjects Financial Consolidation site............43
Deploying the SAP BusinessObjects Financial Consolidation web site under
Windows 2008...........................................................................................47
Deleting a SAP BusinessObjects Financial Consolidation site..................48
Presentation of the Administration console...............................................48
Creating a data source..............................................................................50
Configuring standard parameters..............................................................53
Starting and stopping data sources...........................................................58
Initializing the database.............................................................................58
Initializing the database.............................................................................59
Defining the database languages..............................................................59
Defining a Top or child database...............................................................61
Connecting to SAP BusinessObjects Financial Consolidation..................62
Upgrading your SAP BusinessObjects Financial Consolidation version....64
Uninstalling SAP BusinessObjects Financial Consolidation......................64
Migrating the database..............................................................................65
Migrating an Oracle database...................................................................68
Adding and removing components............................................................69

4
Contents

Chapter 6 Specific installation and configuration............................................73


Standalone installation...............................................................................73
Introduction to the standard / standalone configuration.............................73
Installing SAP BusinessObjects Financial Consolidation..........................73
Initializing the database.............................................................................77
Connecting to SAP BusinessObjects Financial Consolidation..................78
Creating another database........................................................................79
Configuring the Administration console after adding a database or connecting
to an existing database..............................................................................81
Configuring the client workstation..............................................................82
Configuring the Web client.........................................................................82
Configuring the SAP BusinessObjects Financial Consolidation client with
Internet Explorer 7.....................................................................................84
Configuring the client for Excel Link..........................................................85
Installing and configuring under Windows Terminal Services....................85
Installation modes in Windows Terminal Services.....................................86
Installing under Windows Terminal Services.............................................87
Configuring the Windows Terminal Services server..................................88
Configuring SAP BusinessObjects Financial Consolidation Excel Web
Schedules..................................................................................................88
Configuring the client computer.................................................................88
Installing and configuring SAP BusinessObjects Financial Consolidation Web
Services.....................................................................................................96
Deploying the SAP BusinessObjects Financial Consolidation Web
Services.....................................................................................................96
Deploying the SAP BusinessObjects Financial Consolidation Web Services
under Windows 2008...............................................................................101
Deleting the SAP BusinessObjects Financial Consolidation Web Services
website.....................................................................................................103
Testing the SAP BusinessObjects Financial Consolidation Web Services
deployment..............................................................................................104

Appendix A More Information..............................................................................107

5
Contents

6
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation

What's new in version 7.5 of SAP


BusinessObjects Financial Consolidation

The following technical features are new in version 7.5 of SAP


BusinessObjects Financial Consolidation:

The following platforms are now supported:


• Microsoft Windows Server 2008
Only x86 32 bits edition supported
• Oracle 11g
All editions are supported (Windows, Unix, 32 or 64 bits, etc.)

The following platforms are no longer supported:


• Oracle 9i
• Microsoft Windows 2000
• Microsoft SQL Server 2000
• Microsoft Office 2000

Changes to components:
• New setup technology:
• You must remove previous versions using the Add or Remove
Programs option in Microsoft Windows.
• Additional languages are available through separate language packs
• .NET 1.1 is no longer supported and is replaced by .NET 2.0
This concerns the web server (ASP.NET 2.0), but also application
server and Windows client.

• Adobe Flash Player is required on the client site to access the new
dashboards.
• The Flash Player is not required on the application or web server; only
on the client side (Windows or Web).

7
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation

• If Flash is not installed, the dashboard will not be displayed, but SAP
BusinessObjects Financial Consolidation can still be used.
• Flash Player 10 or greater is recommended.
• The Flash Player setup is not provided.

New database settings:


• SAP BusinessObjects Financial Consolidation now uses new OleDB
providers:
• The previous default Microsoft OleDB provider for SQL Server is no
longer supported.
• The new OleDB provider is available with the Microsoft SQL 2005
client. This client must be installed on each application server, along
with the latest Service Pack.
• For Oracle, SAP BusinessObjects Financial Consolidation now uses the
Oracle OleDB provider:
• The previous Microsoft OleDB provider for Oracle is no longer
supported.
• The Oracle client along with its OleDB must be installed on each
application server.
• UNICODE is now supported with Oracle databases, due to the new Oracle
native OleDB provider. All strings will now be stored in UNICODE in Oracle
databases.
• All SQL commands used by SAP BusinessObjects Financial Consolidation
now use binded parameters, which enhances reusability of SQL
commands and improves performance.

New languages

Sixteen application languages are now available, of which five working


languages are available in the application:
• The five working languages are now customizable, and can be selected
from among the 16 application languages.
• By default, the previous five languages are still used (English, French,
German, Spanish, Japanese).
• You can only select the working languages when a new empty database
is created. The working languages cannot be changed later.
A tool is provided to customize the default list of working languages.

8
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation

New security mode

Only BOE authentication is now supported:


• BOE authentication allows Single Sign On (SSO) between all EPM
applications (SAP BusinessObjects Extended Analytics, SAP
BusinessObjects Intercompany, etc.)
• SSO is available for web clients only, not Windows clients.
• Once you are logged on to a web application, and while the browser
is open, you can access other web applications without having to
re-enter your credentials.
• The BOE platform supports many authentication mechanisms, including
Enterprise mode (internal), LDAP and Active Directory.
With the BOE authentication mode, SAP BusinessObjects Financial
Consolidation requires one of the following components:
• BusinessObjects Enterprise XI 3.1 or
• SAP BusinessObjects User Management System
Note:
• To connect SAP BusinessObjects Financial Consolidation with the SAP
BusinessObjects User Management System or the BusinessObjects
Enterprise XI 3.1 platform, the setup automatically installs a tool called
SAP BusinessObjects User Management Client.
• Existing clients can use previous authentication modes but are encouraged
to migrate to the BusinessObjects Enterprise XI mode.

New EWS settings:

SAP BusinessObjects Financial Consolidation 7.5 improves upon EWS:


• EWS can now be used for Analysis, and not just for data entry.
• EWS is always activated, so no additional setup or specific license key
is needed.

9
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation

10
Contents of the CD of the version

Contents of the CD of the version

SAP BusinessObjects Financial Consolidation is composed of one CD: SAP


BusinessObjects Financial Consolidation

This CD contains all setups for the SAP BusinessObjects Financial


Consolidation application. Instructions on how to use this CD are available
in this guide.
• In the FC_75_INSTALLER folder: the SAP BusinessObjects Financial
Consolidation setup.
• In the FC_75_XL_INSTALLER folder: the SAP BusinessObjects Financial
Consolidation Excel Link setup, which can be operated via a Web server.
• This CD also contains in the FC_75_ABOUT\en folder, the following
documentation:
• Master Guide
• Release Notes
• Installation Guide
• Administrator's Guide
• Web User Guide
• Windows User Guide

11
Contents of the CD of the version

12
Summary of the steps involved in installing the product

Summary of the steps involved in installing


the product

Installing SAP BusinessObjects Financial


Consolidation Server for the first time with
an empty database
1. Install SAP BusinessObjects Financial Consolidation.
2. Install the appropriate database connectivity (Microsoft SQL Server 2005
client or Oracle client and its OleDB provider that corresponds to the
version of your database engine) on all application servers.
3. Configure the data source in the Administration console.
4. Initialize or migrate the database.
5. If you use SAP BusinessObjects Financial Consolidation Web, install
activePDFServer on all the application servers.
6. Start SAP BusinessObjects Financial Consolidation.

Related Topics
• Installing the SAP BusinessObjects Financial Consolidation server on
page 37
• Presentation of the Administration console on page 48
• Initializing the database on page 58
• Installing ActivePDFServer on page 32
• Connecting to SAP BusinessObjects Financial Consolidation on page 62

13
Summary of the steps involved in installing the product

Upgrading SAP BusinessObjects Financial


Consolidation Server with an existing
database
1. Disconnect all clients and stop the SAP BusinessObjects Financial
Consolidation servers using the Administration Console.
2. Stop the CtBroker and CtController services manually.
3. Save all the database connection information so that you can easily
configure your databases once the new version is installed.
4. Uninstall SAP BusinessObjects Financial Consolidation.
5. Restart the server.
6. Manually delete any files that were not deleted when Cartesis Finance
was uninstalled and delete the following tree structure from the registry:
HKEY_LOCAL_MACHINE/SOFTWARE/CARTESIS/ObjectServer
7. Install SAP BusinessObjects Financial Consolidation.
8. Install the appropriate database connectivity (Microsoft SQL Server 2005
client or Oracle client and its OleDB provider that corresponds to the
version of your database engine) on all application servers.
9. Configure the data source in the Administration console.
10. Migrate the database using the Administration console.
11. Start the data source once your entire environment has been migrated.

Related Topics
• Initializing the database on page 58
• Upgrading your SAP BusinessObjects Financial Consolidation version
on page 64
• Installing the SAP BusinessObjects Financial Consolidation server on
page 37
• Installation prerequisites for the SQL Server client on page 20
• Presentation of the Administration console on page 48
• Migrating the database on page 65
• Installing the SAP BusinessObjects Financial Consolidation server on
page 37

14
Summary of the steps involved in installing the product

Installing SAP BusinessObjects Financial


Consolidation Web for the first time with
an empty database
1. Check that SAP BusinessObjects Financial Consolidation is installed on
the application servers.
2. Check that activePDFServer is installed on the application servers.
3. Configure the .NET framework and IIS.
4. Install SAP BusinessObjects Financial Consolidation Web on the HTTP
server.
5. Deploy the application in IIS.
6. If required, configure the advanced settings (AutoRestoreDirectory,
technical log, etc.) and the SAP BusinessObjects Financial Consolidation
Web Home page in the web.config file.
7. Start the servers in the Administration console.

Related Topics
• Installing the SAP BusinessObjects Financial Consolidation server on
page 37
• Installing ActivePDFServer on page 32
• Installation prerequisites for Windows 2003 web components on page 21
• Installing the SAP BusinessObjects Financial Consolidation server on
page 37
• Deploying a SAP BusinessObjects Financial Consolidation website on
page 40
• Starting and stopping data sources on page 58

Upgrading SAP BusinessObjects Financial


Consolidation Web with an existing 9
version database
1. Delete the virtual directory on the HTTP server.
2. Delete the Finance applications on the servlet engines.
3. Stop the servlet engines.

15
Summary of the steps involved in installing the product

4. Uninstall BusinessObjects Finance and any servlet engines that are no


longer needed.
5. Restart the server.
6. Configure the .NET framework and IIS.
7. Install SAP BusinessObjects Financial Consolidation.
8. Install SAP BusinessObjects Financial Consolidation Web on the HTTP
server.
9. Deploy the SAP BusinessObjects Financial Consolidation Web application
in IIS.
10. If required, configure the advanced settings (AutoRestoreDirectory,
technical log, etc.) and the home page in the web.config file.
11. Start the servers in the Administration console.

Related Topics
• Installation prerequisites for Windows 2003 web components on page 21
• Installing the SAP BusinessObjects Financial Consolidation Web server
on page 41
• Deploying the SAP BusinessObjects Financial Consolidation site on
page 43
• Starting and stopping data sources on page 58

Installing the SAP BusinessObjects


Financial Consolidation client
1. Install SAP BusinessObjects Financial Consolidation.
2. Start SAP BusinessObjects Financial Consolidation and select the data
source manager that corresponds to your data source in the application
Start window.

Related Topics
• Installing the SAP BusinessObjects Financial Consolidation client on
page 35
• Connecting to SAP BusinessObjects Financial Consolidation on page 62

16
Summary of the steps involved in installing the product

Installing the SAP BusinessObjects


Financial Consolidation Web client
Caution:
You do not need to install SAP BusinessObjects Financial Consolidation.
1. Install Internet Explorer 7.
2. Install Acrobat Reader 6 or later.
3. Install Microsoft Excel if the Excel Web Schedules module is used.

First standalone installation without an


existing database
1. Install Microsoft SQL Server 2005.
2. Install SAP BusinessObjects Financial Consolidation.
3. During the setup, select the option for creating an empty database.
4. Start SAP BusinessObjects Financial Consolidation.

Related Topics
• Installing SAP BusinessObjects Financial Consolidation on page 73
• Connecting to SAP BusinessObjects Financial Consolidation on page 78

Upgrading a standalone installation with


an existing database
1. Save the database connection information so that you can easily configure
your database once the new version is installed.
2. Uninstall SAP BusinessObjects Financial Consolidation.
3. Install the new version of SAP BusinessObjects Financial Consolidation.
4. Create and configure the data source in the Administration console.
5. Migrate the database using the Administration console.
6. Start SAP BusinessObjects Financial Consolidation.

Related Topics
• Connecting to SAP BusinessObjects Financial Consolidation on page 78

17
Summary of the steps involved in installing the product

• Creating a data source on page 50

18
Preparing to install SAP BusinessObjects Financial Consolidation

Preparing to install SAP BusinessObjects


Financial Consolidation

List of the prerequisites installed by the


setup
• SAP BusinessObjects User Management Client
• Microsoft DHTML Editing Component (For Windows Vista and +)
• MSXML 6.0 SP1
• MSXML 6.0 SP1 (x64)
• Microsoft Component Category Manager Library (comcat.dll)
• MDAC 2.8 (English)
• Microsoft DCOM 95
• Visual C++ 8.0 ATL (x86) WinSXS MSM
• Visual C++ 8.0 CRT (x86) WinSXS MSM
• Visual C++ 8.0 MFC (x86) WinSXS MSM
• Visual C++ 8.0 MFCLOC (x86) WinSXS MSM
• Visual C++ 8.0 OpenMP (x86) WinSXS MSM
• MFCDLL 6
• MFCDLL 6 Unicode
• MFCDLL 7.1
• MFCDLL 7.1 Localized
• Microsoft C++ Runtime Library 6
• Microsoft C++ Runtime Library 7.1
• Microsoft C Runtime Library 6
• Microsoft C Runtime Library 7.1
• Microsoft OLE 2.40 for Windows NT(TM) and Windows 95(TM) Operating
Systems
• VC User ATL71 RTL X86
• VC User CRT71 RTL X86
• VC User MFC71 RTL X86

19
Preparing to install SAP BusinessObjects Financial Consolidation

• VC User MFC71 Localized RTL X86


• VC User STL71 RTL X86
• Windows Scripting Host 5.6
• Microsoft .Net Framework 2.0
• Microsoft .Net Framework 2.0 Language Pack (Chinese, Danish, Dutch,
Finnish, French, German, Italian, Japanese, Korean, Norwegian,
Portugese (Brazil), Russian, Spanish, Swedish)

Installation prerequisites for the SQL


Server client
These requirements apply to the client part of the database engines. To find
out more about how to configure these engines, please refer to Administrating
the databases in the Administration Guide.

With SQL Server 2005, SAP BusinessObjects Financial Consolidation shows


optimal performance when used with a native OLE DB data provider. If you
use this data provider, you can configure the connection to the database
directly in the Administration console without creating an ODBC data source.

The native OleDB provider is now mandatory with SQL Server 2005.

An SQL Server client is integrated in Microsoft MDAC, which is part of the


Windows operating system. However, this client is not suitable for Financial
Consolidation.

So, it is mandatory to install the SQL Server 2005 native client on all the
application servers, and apply the SQL Server 2005 Service Pack 2 or higher.

Note:
• If you have problems connecting to the database, you may have to perform
the full SQL Server client installation so that you can use the application's
configuration and analysis tools. The setup is available on the SQL Server
installation CD. The optimal setup for SAP BusinessObjects Financial
Consolidation is an SQL Server client configured in TCP/IP mode.
• If an SQL client is already installed, you should check that it is configured
to function in English.

Related Topics
• DbConnectionString on page 55

20
Preparing to install SAP BusinessObjects Financial Consolidation

Installation prerequisites for the Oracle


client
These requirements apply to the client part of the database engines. To find
out more about how to configure these engines, please refer to Administrating
the databases in the Administration Guide.

The Oracle client and its OleDB provider that corresponds to the version of
your database engine must be installed on the computers that have the
server applications so that SAP BusinessObjects Financial Consolidation
can be installed and used with Oracle.

Note:
Only one Oracle client can be installed on each SAP BusinessObjects
Financial Consolidation application server. The key HKEY_LOCAL_MA
CHINE\SOFTWARE\ORACLE\ALL_HOMES\HOME_COUNTER\can only have the
value of 1.
You should make sure that the character set used is AMERICAN_AMERICA.
WE8MSWIN1252. You can check this parameter in the registry by changing
the following key:

[HKEY_LOCAL_MACHINE\Software\Oracle]

"NLS_LANG"=" AMERICAN_AMERICA.WE8MSWIN1252"

If the value of the parameter is NA, the character set used by the client
computer is the default defined on the Oracle instance of the server. If you
do not want to change the value of the NLS_LANG parameter on the client
computer, check that the value defined on the Oracle server is correct.

Installation prerequisites for Windows


2003 web components
Before deploying SAP BusinessObjects Financial Consolidation Web, the
following requirements must be met:
• Windows Server 2003 operating system
• Internet Information Services (IIS) 6
• Microsoft .NET framework 2.0

21
Preparing to install SAP BusinessObjects Financial Consolidation

• ActivePDFServer if you want to print in .PDF format

Installing and configuring the .NET framework


in Windows 2003 SP1

Activating the .NET framework 2.0

The .NET framework 2.0 is installed as a prerequisite. However, you may


have to activate it.

In the IIS management console, check that the extension of the Web service
associated with ASP.NET 2.0 is authorized as indicated below:

22
Preparing to install SAP BusinessObjects Financial Consolidation

Configuring the .NET framework


Creating application pools in native IIS 6 isolation mode
We recommend you configure one application pool for each SAP
BusinessObjects Financial Consolidation application that you want to deploy.

Caution:
The native IIS 6 isolation mode is mandatory for Business Objects with
Windows Server 2003. IIS 5 Isolation mode is no longer supported.
1. Access the IIS management console.
2. Right-click on Application pools. Next, click on New > Application pool.
The Add New Application Pool dialog box appears.

3. Give the application pool a name and check the Use default settings
for new application pool.
Note:
If you have already created an application pool for SAP BusinessObjects
Financial Consolidation, you can use it as a template by checking the
Using existing application pool as template option
The new application pool appears.

Configuring the new application pool


1. Right-click on the new pool that you have just created and click on
Properties.
The Properties window appears.

2. In the Recycling tab, uncheck the options selected.


3. In the Performance tab, uncheck the first option.
4. Click on the Health tab.
5. Do not make any changes in the Health tab.
6. In the Identity tab, select the Configurable option and enter the login
and password of a user account with the following rights:
• Use the DCOM protocol,
• Have read/write access to the BusinessObjects Financial Consolidation
intallation folders,

23
Preparing to install SAP BusinessObjects Financial Consolidation

• Have read/write access to the BusinessObjects Financial Consolidation


Web site deployment folder,
• Be part of the local IIS_WPG group.

Configuring the .NET framework 2.0


1. Edit the machine.config file located in the C:\WINDOWS\Mi
crosoft.NET\Framework\v2.0.50727\CONFIG folder.
2. Search for the following rows:

<processModel

requestQueueLimit="5000"
memoryLimit="10"
maxWorkerThreads="20"
maxIoThreads="20"/>
...
<httpHandlers />

<httpRuntime
executionTimeout="3600"
maxRequestLength="16384"
useFullyQualifiedRedirectUrl="false"
minFreeThreads="20"
minLocalRequestFreeThreads="4"
appRequestQueueLimit="200"
enableVersionHeader="true"
/>

3. Change the maxWorkerThreads and maxIoThreads parameters to


indicate the maximum number of threads for each CPU.
These parameters must be changed depending on how many concurrent
SAP BusinessObjects Financial Consolidation Web users there are. A
user connection can require up to two threads, you must therefore provide
enough threads for each connection.
Note:
In the example above, the maximum number of threads allowed is 40 for
a bi-processor server. This means that no more than 40 queries can be
run simultaneously for all the ASP.NET applications.

4. Assign the value 3600 to the executionTimeout parameter to increase


the timeout authorized for tasks in SAP BusinessObjects Financial
Consolidation Web.

24
Preparing to install SAP BusinessObjects Financial Consolidation

5. Assign the value 16384 to the maxRequestLength parameter to define


the maximum size of HTTP queries and therefore the maximum size of
the Excel import files.
Note:
The default value is 4MB. We recommend that you set it at 16 MB
depending on the size of your documents.

Increasing timeout for tasks


You must also increase the timeout authorized for tasks in BusinessObjects
Financial Consolidation Web.
1. Edit the machine.config file located in the C:\WINDOWS\Mi
crosoft.NET\Framework\v2.0.50727\CONFIG folder.
2. Add the following rows in the <system.web> section:

<httpRuntime
executionTimeout="3600"
maxRequestLength="4096"
useFullyQualifiedRedirectUrl="false"
minFreeThreads="8"
minLocalRequestFreeThreads="4"
appRequestQueueLimit="100"
enableVersionHeader="true"
/>

3. Assign the value 3600 to the executionTimeout parameter.

Configuration for Excel Web Link


The following setting defines the maximum size of HTTP queries and therefore
the maximum size of the Excel import files. This is the maximum size of an
Excel worksheet used to retrieve data. The default value is 4MB. We
recommend that you set it at 16 MB depending on the size of your documents.
1. Backup and edit the machine.config file located in the
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\ folder.
2. Add the following rows in the <system.web> section:

<httpRuntime
executionTimeout="3600"
maxRequestLength="4096"
useFullyQualifiedRedirectUrl="false"
minFreeThreads="8"
minLocalRequestFreeThreads="4"

25
Preparing to install SAP BusinessObjects Financial Consolidation

appRequestQueueLimit="100"
enableVersionHeader="true"
/>

3. Assign the value 16384 to the maxRequestLength parameter.


Tip:
The value 16384 corresponds to 16 MB files. You can change this parameter
if required.

Configuring IIS 6

Enabling HTTP compression

You now enable HTTP compression directly in SAP BusinessObjects


Financial Consolidation. You should therefore not enable it in IIS. If you do
so, BusinessObjects Financial Consolidation will not function properly.

Tip:
If you want to deactivate HTTP compression or change the compression
level, refer to the Configuring advanced Web options section of the
Administration Guide.

Increasing HTTP connection timeout

When using Windows 2003 and IIS 6, we recommend you increase the
lifespan of persistent connections, especially if you plan to open schedules
via SAP BusinessObjects Financial Consolidation Excel Web Schedules.
1. Access the IIS management console.
2. Right-click Web Sites and edit the properties of the Web sites.
3. Next, select the Web Site tab.
4. In the Connection timeout tab, increase the number to 1800 seconds.
5. Check the Enable HTTP Keep-Alives option
6. Click Apply then OK.

26
Preparing to install SAP BusinessObjects Financial Consolidation

Installation prerequisites for Windows


2008 web components
Before deploying BusinessObjects Financial Consolidation Web, the following
requirements must be met:
• Windows Server 2008 operating system
• Microsoft .NET framework 2
• ActivePDFServer if you want to print in .PDF format
• The BusinessObjects Financial Consolidation application server and Web
server

Installing IIS 7
1. In the Server Manager, click Roles > Add Roles.
The Add Roles Wizard opens.
2. In the Select Server Roles window, select the Web Server (IIS) option.
The Select Role Services window opens.
3. In the Application Development zone, select the ASP.NET option.
If a message appears, click Yes.
4. Select the following options:

27
Preparing to install SAP BusinessObjects Financial Consolidation

The options to select are the following:


• Common HTTP Features
• Static Content
• Default Document
• Directory Browsing
• HTTP Errors
• Application Development
• ASP.NET
• .NET Extensibility
• ISAPI Extensions
• ISAPI Filters
• Health and Diagnostics
• HTTP Logging

28
Preparing to install SAP BusinessObjects Financial Consolidation

• Request Monitor
• Security
• Request Filtering
• Performance
• Static Content Compression
• Management Tools
• IIS Management Console

5. Click Next.
Click Next and then Install.

Creating application pools with IIS 7


Once IIS 7 is installed, you need to create one application pool for each
BusinessObjects Financial Consolidation application that you want to deploy.
1. Open the IIS Manager.
2. In the Connections pane, expand and select the Application Pools.
3. Right-click Application Pools and select Add Application Pool.
The Add Application Pool dialog box opens.

4. In the .Net Framework version zone, select the .Net Framework 2.0
option.
5. In the Managed pipeline zone, select the Classic option.

29
Preparing to install SAP BusinessObjects Financial Consolidation

6. Click OK.
You then need to configure this new application pool.
7. Right-click on the application pool and click Recycling.
The Recycling Conditions dialog box opens.
8. Unselect all options.
9. Click Next.
10. In the Recycling Events to Log, you do not need to modify anything.
11. Click Next and Finish.
12. Right-click the application pool ans click Advanced Settings.
The Adanced Settings dialog box opens.

30
Preparing to install SAP BusinessObjects Financial Consolidation

13. In the Process Model zone, next to Identity, click the NetworkService
button.
14. n the Application Pool Identity dialog box, enter the login and password
of a user account with the following rights:
• Use the DCOM protocol,
• Have read/write access to the BusinessObjects Financial Consolidation
intallation folders,
• Have read/write access to the BusinessObjects Financial Consolidation
Web site deployment folder,
• Be part of the local IIS_IUSRS group.

31
Preparing to install SAP BusinessObjects Financial Consolidation

Increasing limit size of HTTP requests


By default, the size of files to download is limited up to 4 MB. If you want to
use Data Link or EWS files, this parameter may be insufficient. To increase
the size of this parameter, you must follow this procedure:
• Open a DOS prompt and run the following command:

appcmd set config /section:requestfiltering /requestlimits.


maxallowedcontentlength:40000000

In this example, the size has been increased to 40 GB.

Installing ActivePDFServer
ActivePDFServer (by ActivePDF, www.activepdf.com) is a component that
lets you create PDF files. The SAP BusinessObjects Financial Consolidation
Web client computer can then print reports that are better presented than
reports in HTML format. You must install activePDF Server on the SAP
BusinessObjects Financial Consolidation application server, which then will
generate and send the PDF files to the client computer. Once the client
computer has received the files, it can read them using Acrobat Reader.

Note:
• You will need to register the ActivePDF Server license on the Internet
during the installation. Therefore, your server must have Web access.
• You must uninstall the old version then reinstall the new one, rather than
upgrade directly from the new version.
1. Insert the CD-ROM in the drive or double-click apsrvr.exe.
2. In the Welcome dialog box, click Next.
3. In the License agreement dialog box, click I agree to the terms of this
license agreement then click Next.
4. In the User Information dialog box, enter a user name and the name of
your company, then click Next.
The Installation Folder dialog box appears.

5. Select the folder where you want to install ActivePDF, then click Next.
The Ready to Install dialog box appears.

32
Preparing to install SAP BusinessObjects Financial Consolidation

6. Click Next to start the installtion (or click Back if you want to change the
installation settings).
The Server3.8 - Activation dialog box appears.

7. Click Install License File, then select the appropriate license file.
Note:
The licenses for versions 3.5.2 are no longer valid.
Once the installation is complete, check the Yes option to open the
configuration editor.

8. Click Finish.
The activePDFServer Configuration Editor dialog box appears.

9. Click OK.

33
Preparing to install SAP BusinessObjects Financial Consolidation

Note:
We recommend that you restart the server.
Tip:
When the server has been restarted, you can check that ActivePDF works
properly by selecting Start > Programs > ActivePDF > Server > Test
Utility.

Installing the BusinessObjects Enterprise


XI 3.1 platform or the SAP BusinessObjects
User Management System
You can now use two platforms with SAP BusinessObjects Financial
Consolidation:

• BusinessObjects Enterprise XI 3.1 (BOE XI 3.1)


If you want to install BusinessObjects Enterprise XI 3.1. For more
information on how to install it, see the SAP web site: http://help.sap.com.
• Or SAP BusinessObjects User Management System
If you want to install the SAP BusinessObjects User Management System.
For more information on how to install it, see the SAP BusinessObjects
User Management System Installation Guide and the SAP web site:
http://help.sap.com.

The SAP BusinessObjects User Management System implements the


BusinessObjects Enterprise XI user management sub system. It allows
Enterprise Performance Management Solutions to use the BOE authentication
without having to install a full BusinessObjects Enterprise XI platform.

The SAP BusinessObjects User Management System does not include any
BI tools available in the full BusinessObjects Enterprise XI platform. BI tools
like WebI, InfoView or Voyager are only available with the full BOE XI
platform.

Note:
You can migrate from SAP BusinessObjects User Management server to
the full BusinessObjects Enterprise platform if needed.

34
Installing the client/server

Installing the client/server

Installing the SAP BusinessObjects


Financial Consolidation client
Remember:
As SAP BusinessObjects Financial Consolidation 7.5 now uses a new setup
technology, you are not prompted to uninstall earlier versions of SAP
BusinessObjects Financial Consolidation but you need to manually uninstall
all previous versions via the Windows Control Panel before you can install
SAP BusinessObjects Financial Consolidation 7.5.
Note:
Do not forget to install Adobe Flash Player as it is required on the client site
to access the new dashboards.
1. Double-click on Setup.exe located at the root of the installation CD.
2. Click Run.
If one of the components required is missing or not in the minimum version
supported, the List of requirements to install dialog box opens.

3. Click Install.
The Welcome to the setup wizard dialog box opens.
4. Click Next.
5. The License Agreement dialog box opens.
6. Select the I accept the terms in the license agreement option.
7. Click Next.
The Destination Folder dialog box opens.
8. Select the folder or enter the name of the folder where you want to install
SAP BusinessObjects Financial Consolidation and click Next.
The Setup Type window opens.

9. Select the Client installation option and click Next.

35
Installing the client/server

The Custom setup dialog box opens.

10. Select the following components:


• Application: If you check this option, all of the components required
for running SAP BusinessObjects Financial Consolidation will be
installed.
• Console: This option is optional and enables you to access the tool
used for managing the data sources.
• Online help: This option enables you to access the documentation in
electronic format.
• Excel Link: this option lets you install Excel Link.

The Ready to install the program dialog box opens.


11. If the settings are correct, click Next.
Note:
The actual installation then begins. Depending on the performance of
your computer, the installation may last several minutes. You should not
perform any other task until the installation is complete in order to ensure
that the application is correctly installed.
Once the installation is complete, the Installation completed dialog box
opens.

36
Installing the client/server

12. Click Finish.


13. Restart your computer.
14. If you are planning to choose the Use Windows account option when
connecting to the application, check that you are logged on windows with
the same account you used to configure your SAP BusinessObjects
Financial Consolidation user.
15. Then you need to run the following command line in a DOS prompt on
the client workstation.

Finance.exe /AuthWindows

Caution:
If you do not run the script, you will not be able to connect to the
application using the Windows authentication.
Note:
if you want to revert to the default authentication mode (no Windows
authentication), then run the following command line:

Finance.exe /AuthNone

Installing the SAP BusinessObjects


Financial Consolidation server
• You must have a valid Windows account with the Log on as a batch job
and Log on as a service privileges, with a password that never expires.
• The built-in system account can not be used.
• You must have write access rights on the following folders:
• the SAP BusinessObjects Financial Consolidation installation folder
• the folder where the Applicationdatasource.xml file is stored
• folders where the logs are stored

Remember:
As SAP BusinessObjects Financial Consolidation 7.5 now uses a new setup
technology, you are not prompted to uninstall earlier versions of SAP
BusinessObjects Financial Consolidation but you need to manually uninstall
all previous versions via the Windows Control Panel before you can install
SAP BusinessObjects Financial Consolidation 7.5.

37
Installing the client/server

Note:
You should not install SAP BusinessObjects Financial Consolidation on a
server whose name contains the _ (underscore) character.

1. Double-click on Setup.exe located at the root of the installation CD.


2. Click Run.
If one of the components required is missing or not in the minimum version
supported, the List of requirements to install dialog box opens.

3. Click Install.
The Welcome to the setup wizard dialog box opens.
4. Click Next.
Note:
If you carry out an installation using the "Remote Desktop Connection"
tool, you are required to do this with the "Console" (mstsc /console)
session. Otherwise, SAP BusinessObjects Financial Consolidation may
not work properly.

5. The License Agreement dialog box opens.


6. Select the I accept the terms in the license agreement option.
7. Click Next.
The Destination Folder dialog box opens.
8. Select the folder or enter the name of the folder where you want to install
SAP BusinessObjects Financial Consolidation and click Next.
The Setup Type window opens.

9. Select the Server installation option and click Next.


The DCOM Configuration dialog box opens.
10. Enter the user login and password that will be used to start SAP
BusinessObjects Financial Consolidation and click Next.
Caution:
This account must have the Log on as a batch job privilege.
The Custom setup dialog box for selecting the required components
opens.

38
Installing the client/server

11. Select the following components:


• Application: If you check this option, all of the components required
for running SAP BusinessObjects Financial Consolidation, including
the application server, will be installed.
• Console: This option enables you to access the tool used for managing
the data sources.

Note:
• The Finance Web Services ( this option enables you to interface other
tools via Web Services) are automatically installed. You will then have
to deploy it later if needed.
• If your Web server is on the same computer, you must check the
Finance Web site option. If you do not do so, you will not be able to
deploy the SAP BusinessObjects Financial Consolidation web site.
12. Click Next.
The Ready to install the program dialog box opens.

13. If the settings are correct, click Install.

39
Installing the client/server

Note:
Depending on the performance of your computer, the installation may
last several minutes. You should not perform any other task until the
installation is complete in order to ensure that the application is correctly
installed.
Once the installation is complete, the Installation complete dialog box
opens.

14. Click Finish.


15. Restart the server.
Note:
• We recommend that you change the environment variables of the
TEMP and TMP server so that they correspond to folders that are not
linked to a user profile.
• If you are installing under Windows 2003 SP1 and your environment
is made up of different domains or some computers are outside of the
domain, you must follow the instructions provided in the Administration
guide's appendix (in the "DCOM configuration" chapter).

Deploying a SAP BusinessObjects


Financial Consolidation website
You install SAP BusinessObjects Financial Consolidation Web in six steps:
• Install the HTTP server.
• Install the SAP BusinessObjects Financial Consolidation Web server on
the HTTP server.
• Configure the 2.0 .NET framework.
• Deploy the SAP BusinessObjects Financial Consolidation application in
IIS.
• Create the corresponding ASP.NET application in IIS.
• Configure SAP BusinessObjects Financial Consolidation Web in the
Administration console.

40
Installing the client/server

Installing the SAP BusinessObjects Financial


Consolidation Web server
Note:
• You should not install SAP BusinessObjects Financial Consolidation on
a server whose name contains the _ (underscore) character.
• If IIS is located on a different computer than your SAP BusinessObjects
Financial Consolidation application server, you must install SAP
BusinessObjects Financial Consolidation Web before deploying the site.
Remember:
As SAP BusinessObjects Financial Consolidation 7.5 now uses a new setup
technology, you are not prompted to uninstall earlier versions of SAP
BusinessObjects Financial Consolidation but you need to manually uninstall
all previous versions via the Windows Control Panel before you can install
SAP BusinessObjects Financial Consolidation 7.5.
1. Double-click on Setup.exe located at the root of the installation CD.
2. Click Run.
If one of the components required is missing or not in the minimum version
supported, the List of requirements to install dialog box opens.

3. Click Install.
The Welcome to the setup wizard dialog box opens.
4. Click Next.
5. The License Agreement dialog box opens.
6. Select the I accept the terms in the license agreement option.
7. Click Next.
The Destination Folder dialog box opens.
8. Select the folder or enter the name of the folder where you want to install
SAP BusinessObjects Financial Consolidation and click Next.
The Setup Type window opens.

9. Select the Server installation option and click Next.


The DCOM Configuration dialog box opens.

41
Installing the client/server

10. Enter the user login and password that will be used to start SAP
BusinessObjects Financial Consolidation and click Next.
Caution:
This account must have the Log on as a batch job privilege.
The Custom setup dialog box for selecting the required components
opens.

11. Select the following components:


• Application: If you check this option, all of the components required
for running SAP BusinessObjects Financial Consolidation, including
the application server, will be installed.
• Console: This option enables you to access the tool used for managing
the data sources.
• Finance Web site: This option installs all of the components required
for running SAP BusinessObjects Financial Consolidation Web.
Note:
The Finance Web Services ( this option enables you to interface other
tools via Web Services) are automatically installed. You will then have to
deploy it later if needed.

42
Installing the client/server

12. Click Next.


The Ready to install the program dialog box opens.

13. If the settings are correct, click Install.


Note:
Depending on the performance of your computer, the installation may
last several minutes. You should not perform any other task until the
installation is complete in order to ensure that the application is correctly
installed.
Once the installation is complete, the Installation complete dialog box
opens.

14. Click Finish.


15. Restart the server.
Note:
• We recommend that you change the environment variables of the
TEMP and TMP server so that they correspond to folders that are not
linked to a user profile.
• If you are installing under Windows 2003 SP1 and your environment
is made up of different domains or some computers are outside of the
domain, you must follow the instructions provided in the Administration
guide's appendix (in the "DCOM configuration" chapter).

Deploying the SAP BusinessObjects Financial


Consolidation site
Caution:
You should not deploy SAP BusinessObjects Financial Consolidation on a
server whose name contains the _ (underscore) character.
1. In the SAP BusinessObjects Financial Consolidation installation folder,
copy the Web subfolder.
2. Paste the subfolder to \Inetpub\wwwroot\.
3. Change the subfolder's name to the name you want to assign to your
website.

43
Installing the client/server

Caution:
The name of your site must not contain the _ (underscore) character.

4. In the IIS management console, click on Default Web Site.


The new application opens.

5. Right-click on the folder and select Properties.


The website Properties window opens.

6. In the Directory tab, click Create.


If you are in native IIS 6 isolation mode, the Application settings
groupbox becomes active:

7. In the Application pool field select the data pool created previously in
the chapter "Installing and configuring the .NET framework in Windows
2003 SP1".
8. Click Configuration...
The Application Configuration dialog box opens.

44
Installing the client/server

9. Click Add.
The Add/Edit Application Extension Mapping dialog box opens.

10. In the Executable field, select the C:\WINDOWS\Microsoft.NET\Frame


work\v2.0.50727\aspnet_isapi.dll file.
11. In the Extension field, type .xls.
Caution:
Do not forget to uncheck the Verify that file exists option.

12. Click OK twice.


13. In the Documents tab, check the Enable default content page option,
and add the Default.aspx content page.
14. Then select the HTTP headers tab.
15. Select the Enable content expiration option.
16. Check Expire after and enter 1 day.
Note:
By enabling content expiration, you can improve performance and reduce
network traffic. Enabling content expiration is not compulsory but it is
strongly recommended.

17. In the MIME Types groupbox, click the MIME Types button.
The MIME Types dialog box opens.

18. Click on New....


The following dialog box opens.

45
Installing the client/server

19. In the Extension groupbox, add the .xll extension.


20. In the MIME type groupbox, enter the following: application/vnd.ms-
excel.
21. Click OK.
22. Repeat the same operation for the following file extensions:

File extension MIME Type

.xll application/vnd.ms-excel
.xlam application/vnd.ms-excel
.ini text/plain

Caution:
SAP BusinessObjects Financial Consolidation Excel Web Schedules will
not work properly if you do not select these configuration options.

23. Select the ASP.NET tab.


24. In the ASP.NET version field, select the 2.0.50727 version.
25. Click Apply then OK.
The SAP BusinessObjects Financial Consolidation Web site is now
deployed.

Note:
You can deploy the SAP BusinessObjects Financial Consolidation site
in a folder other than the default wwwroot folder. To do so, create a virtual
folder in IIS that points to the folder that you use.

46
Installing the client/server

Deploying the SAP BusinessObjects Financial


Consolidation web site under Windows 2008
1. In the SAP BusinessObjects Financial Consolidation installation folder,
copy the Web subfolder.
2. Paste the subfolder to \Inetpub\wwwroot\.
3. Change the subfolder's name to the name you want to assign to your
website.
Caution:
The name of your site must not contain the _ (underscore) character.

4. Open the IIS Manager.


5. right-click on the folder you pasted at step 3 and click Convert to
Application.
The Add Application dialog box opens.
6. In the Application Pool field, select the Application Pool you defined for
the SAP BusinessObjects Financial Consolidation application and click
OK.
Click the Test Settings button if you want to test the deployment.
7. Click OK.
8. Select the new site you deployed and double-click the HTTP Response
Headers icon.
9. In the Actions pane, click Set Common Headers.
The Set Common HTTP Response Headers dialog box opens.
10. Select the Enable HTTP keep-alive and Expire Web content after
options and set the Expire Web content after 1 day.
11. Click OK.
12. Double-click the MIME Types icon.
The MIME Type window opens.
13. In the Actions pane, click Add.
The Add MIME Type dialog box opens.
14. In the file name extension field, add the .xls extension.
15. In the MIME type field, enter the following: application/vnd.ms-excel.

47
Installing the client/server

16. Click OK.


17. Repeat the same operation for the following file extensions:

File extension MIME Type

.xll application/vnd.ms-excel
.xlam application/vnd.ms-excel
.ini text/plain

Caution:
SAP BusinessObjects Financial Consolidation Excel Web Schedules will
not work properly if you do not select these configuration options.

Deleting a SAP BusinessObjects Financial


Consolidation site
1. In the IIS administration console, select the web site that you want to
delete.
2. Right-click on this web site and select Properties.
The web site Properties window appears.

3. In the Directory tab, click on Remove.


4. Click OK.
5. Then delete the corresponding folder in \Inetpub\wwwroot\.

Presentation of the Administration console


The SAP BusinessObjects Financial Consolidation administration console
is a software component that can be snapped in to the Microsoft Management
Console (MMC). It is used to perform all the application's administration
tasks. This console is also used to manage Windows user accounts or SQL
Server engines for example.

Note:
You should select this component when you run the SAP BusinessObjects
Financial Consolidation setup.

48
Installing the client/server

To start the console, carry out one of the actions below:


• Select Start > All programs > SAP BusinessObjects Financial
Consolidation > Administration console,
• or double-click the CtAdmin.msc file which is in the SAP BusinessObjects
Financial Consolidation installation folder.

The Administration console appears.

The Administration console contains four views for each of the data sources:
• Standard configuration: this view is used to define the settings for the
data source. For more information, Configuring standard parameters on
page 53.
• Advanced configuration: this view is used to define the advanced
settings for the data source. To find out more, see the Administration
guide ("Managing data sources" chapter).
• Operation: this view enables you to start the data source. For more
information, "Starting and stopping data sources". this view displays the
list of computers defined for a given data source and the statuses of the
instances run on each computer. To find out more, see the Administration
guide ("Managing data sources" chapter).

49
Installing the client/server

• Activity: this view shows the list of users connected to each data source.
To find out more, see the Administration guide ("Managing data sources"
chapter).

Creating a data source


You can create a new data source in the Administration console using the
Application Data Source Wizard.
1. To access the wizard, right-click BusinessOBjects Administration and
select New > Data source.
The Application Data Source Wizard appears.

2. Click Next.
The Select a name window appears.

3. Enter the name for the new data source and click on Next.
The Choose a software product window appears.

4. Select Finance in the list of available products, then click Next.


The Select the OleDB connection string window appears.

5. Enter or select the connection string containing the information required


for connecting to the database.
The drop-down menu displays a selection of connection strings with the
relevant syntax, depending on the database engine used (SQL and
Oracle).
• For SQL Server:

Provider=SQLNCLI;Data Source=<database_servername>;Initial
Catalog= <database_name>
• For Oracle:

Provider=OraOLEDB.Oracle;Data Source=<service_name>

Caution:
The Oracle provider for OleDB must be installed on all application
servers.

50
Installing the client/server

Caution:
The databases clients (Oracle and SQL Server) must be installed on all
application servers.
Note:
For more information, see "Configuring standard parameters".

6. Enter the login and password of the database owner and click on Next.
The Configure the internal authentication window appears.

7. Select Internal authentication.


8. Click Next.
The Configure external authentication window appears.

9. Select the BusinessObjects XI R3 authentication to use the


BusinessObjects XI R3 platform as the authentication provider.
10. Enter the name of the Central Management Server (CMS) of your
Business Objects XI R3 platform.
Note:
For more information, see "Configuring standard parameters".
Note:
If your BOE platform uses a CMS cluster, then you need to indicate, in
the CMS server name field, all the cluster members, one by one,
separated by a coma.
Note:
The other types of authentication are no longer supported by SAP
BusinessObjects Financial Consolidation. The only reason they are
avalaible is to ensure compatibility with previous versions. You should
always use the BOE authentication, unless you are migrating from a
previous Finance version, and your authentication mode must remain the
same.

11. Click Next.


The Configure the servers window appears.

12. Select the computer on which the application server will be hosted.
If you are in a multi-server configuration, enter or select the computer
that will host the first server in the architecture

51
Installing the client/server

Tip:
You can now add as many application servers as required in the
Administration console by right-clicking on the Configuration view of the
data source you have just created and selecting Add Machine.

13. Click Finish.


The Administration console appears, displaying the new data source.

If you installed the SAP BusinessObjects Financial Consolidation


component, you can now add the URL(s) for connecting to the HTTP
server(s). You can also edit the other information if required.

14. In the Configuration view, double-click on the ServerComputerName


parameter to edit its properties.
The properties window for this parameter appears as follows:

15. Check the Activate machine box.

52
Installing the client/server

Caution:
If you do not check this box, the application server will not start.
Tip:
Once you have created one data source, you can create another without
using the Application Data Source Wizard by right-clicking on the data
source and using the cut and paste function. The default name of the
data source you then create using the Paste function will be [Datasource1].
Its properties will be identical to those of the data source you duplicated.
You can, however, change them if required.

Configuring standard parameters


Note:
You cannot change the console's settings once the data source is running.
The Standard Configuration view is used to define the settings for the data
source.

The information that is in the ApplicationDataSources.xml file is displayed


in this view. Because this file is encrypted for security reasons, the only way
you can define a data source is via the Administration console.

53
Installing the client/server

Tip:
All these values may be edited by double-clicking on them. A properties box
appears and you can change or delete the value in it as required.

InternalAuthenticationConfigString

This parameter authorizes the application to manage login and passwords


internally.

The internal authentication mode is no longer supported, it is avalaible just


to help you initialize a database. Once the database is initialized, you should
always use the BOE authentication.

It can take on the following values:


• Internal authentication if you authorize the authentication to be
performed directly in SAP BusinessObjects Financial Consolidation.
• Deactivated if you only want to use an external authentication, e.g. the
BusinessObjects XI3.1 platform or LDAP. To find out more, see Exter
nalAuthenticationConfigString on page 54.

ExternalAuthenticationConfigString

If authentication is managed by the Business Objects Enterprise XI platform,


this setting should be filled in as follows:
• select the Business Objects Enterprise XI authentication option.
• CMS server name: enter the name of the Central Management Server
(CMS) of your Business Objects Enterprise XI platform.

Caution:
The following authentication modes are no longer supported by SAP
BusinessObjects Financial Consolidation. The only reason they are avalaible
is to ensure compatibility with previous versions. You should always use the
BOE authentication, unless you are migrating from a previous SAP
BusinessObjects Financial Consolidation version, and your authentication
mode must remain the same.

• Active Directory / LDAP authentication


• LDAP authentication

54
Installing the client/server

• Script authentication
• Plug-in authentication
Caution:
If you want to use the LDAP or Active Directory authentication, you must do
it into the Business Objects Enterprise XI Central Management Console.
Additional authentication modes like SAP NetWeaver are also supported
through the BOE XI 3.1 platform.

DbConnectionString

This parameter specifies the information for connecting to the database. It


can take on different values, depending on the type of connection to the
database used.

Caution:
You must use one of the OLE DB providers described below to connect to
the database.
• For SQL Server 2005:

Provider=SQLNCLI.1;Data Source=<database_servername>;Initial
Catalog= <database_name>

• For Oracle:

Provider=OraOLEDB.Oracle;Data Source=<service_name>

• For Oracle RAC:


With Oracle RAC, you should use the following OLE DB connection string
to ensure high availability:

Provider=OraOLEDB.Oracle;Data Source=<ser
vice_name>;FEN=T;FRC=5;FDL=5

Note:
You must configure the Oracle clients so that Oracle RAC can be
implemented (TNSListener.ora file).

Note:
Please note that you must fill in the login and password for connecting to the
database.

55
Installing the client/server

Tip:
When you create a data source using the Wizard, a drop-down menu will
display an example of each type of syntax. You should then complete the
syntax with information specific to your SAP BusinessObjects Financial
Consolidation environment, e.g. server and database names, logins and
passwords.

ProductName

This is the name of the product. You must therefore specify Finance. This
is important because the same console can be used with other SAP Business
Objects products that have components in common.

WebServerURL

This setting displays the URL of the HTTP server on which SAP
BusinessObjects Financial Consolidation is deployed. The Administration
console uses this URL to stop and start the SAP BusinessObjects Financial
Consolidation Web server. You should enter the SAP BusinessObjects
Financial Consolidation Web URL. If you deployed the application in IIS and
defined /Finance as the application URL, then the URL displayed here will
be http://myWebServer/Finance. If you do not have a Web configuration,
then you should leave this parameter empty.
Caution:
Do not forget to stop and start the datasource if you restarded IIS after
deploying the application.
Note:
If this setting is filled in, then when you start SAP BusinessObjects Financial
Consolidation, the web application will also start automatically.
WebServerURL In the case of an architecture with multiple HTTP servers,
you can specify several SAP BusinessObjects Financial Consolidation Web
URLs. If you do so, the WebServerURL parameter will display the
"multi-servers" value.

56
Installing the client/server

SchedulerComputerName

In a multi-server configuration, this parameter is used to specify the


application server on which tasks scheduled in the SAP BusinessObjects
Financial Consolidation Task Scheduler view will be performed. If you run
a task scheduled for immediate execution, the properties defined in the
parameter will not be taken into account. Tasks that have been scheduled
for immediate execution will be run on the application server to which you
are connected.

Note:
This computer must be one of the servers you configured for the data source.

ServerComputerName

This parameter indicates the computer on which the BusinessObjects Finance


application server is located.

When you edit this parameter, you can select a load balance for the
application server so that the users connected are distributed over the
application servers available.

You can also use this parameter to activate the computer that is inactive by
default.
Note:
• You must check the Activate workstation option. If you do not check
this box, SAP BusinessObjects Financial Consolidation will not start.
• You can activate or deactivate all the computers of the data source by
right-clicking Configuration > Activate All Machines or Deactivate All
Machines.
Tip:
All the other advanced parameters in the Administration console are
documented in the Administration guide.

57
Installing the client/server

Starting and stopping data sources


1. Double-click on CtAdmin.msc.
The Administration console opens.

2. Right-click on Operation. Next, click on All Tasks > Start Source or


Stop Source as shown below:

In the Activity column, the status of the data source appears as active.

Initializing the database


Once you have installed a new version of SAP BusinessObjects Financial
Consolidation and configured the data sources, you must initialize the
database before you connect to SAP BusinessObjects Financial
Consolidation.

Caution:
If you already have a database in an older version of BusinessObjects
Financial Consolidation, refer to "Migrating the database" chapter.

58
Installing the client/server

There are two types of SAP BusinessObjects Financial Consolidation


databases:
• Databases used by the setup sites (Top databases).
• Databases used by the operation sites (child databases).

Top databases are used to customize the setup while child databases can
only be used for operating purposes. The databases used at local data entry
sites (on standalones) are child databases.

Note:
By default, SAP BusinessObjects Financial Consolidation initializes empty
databases as child databases, because this constitutes the majority of the
databases that are installed.
You define whether the SAP BusinessObjects Financial Consolidation
database will be a Top or child database when you initialize it. During the
initialization process, SAP BusinessObjects Financial Consolidation will adapt
the structure of the database depending on whether it is a Top or child
database. Once you have created a BusinessObjects Finance database,
you cannot change its type.

Related Topics
• Migrating the database on page 65

Initializing the database


If the database is empty, you should first create the structure of the SAP
BusinessObjects Financial Consolidation database. To do this, you use the
Migrate command in the Administration console to initialize the database
from its present version 0.0.0.0.

If the database is not empty, i.e if you are migrating from a previous version,
see the Migrating the database on page 65 chapter.

Defining the database languages


An SAP BusinessObjects Financial Consolidation database can store text
in 5 different languages. By default, these languages are French, English,

59
Installing the client/server

German, Spanish and Japanese. It is possible to define the list of languages


supported from 16 different ones.

You can define these languages only when initializing a new empty database.
If the database already exists, it is not possible to change the list of languages
available.

Note:
If you change the default list of languages, all your database have to use the
same list (Top and Child databases must use the same list.

To define the database languages:


1. Open the defaultlanguages.xml file located in the SAP BusinessObjects
Financial Consolidation installation folder.

<?xml version="1.0" encoding="utf-8" ?><setup


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.sap.com/2008/04/29/Finance">
<lang1>fr</lang1>
<lang2>en</lang2>
<lang3>de</lang3>
<lang4>es</lang4>
<lang5>ja</lang5>
<site>child</site>
</setup>

2. Enter the code of the languages you want to set into your database. The
list of available languages is:

Language Code

English En
French Fr
German de
Japanese ja
Spanish es
Chinese simplified zh-CHS
Italian it

60
Installing the client/server

Language Code

Dutch nl
Russian ru
Korean ko
Portuguese Brazil pt
Swedish sv
Polish pl
Norwegian Bokmal nb-NO
Danish da
Finnish fi

3. Save and close the file.

Defining a Top or child database


If you want the SAP BusinessObjects Financial Consolidation database to
be defined as a Top database, you should run an executable on the
application server. This script will change the SQL files used by SAP
BusinessObjects Financial Consolidation to initialize the database.

Caution:
• There can only be one TOP database in a group.
• Please note that this executable must be run on the application server
BEFORE the database is migrated via the Administration console.
To define the database as a Top database:
1. Edit the defaultlanguages.xml file located at the root of the installation
folder of the application.

<?xml version="1.0" encoding="utf-8" ?>


<setup xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.sap.com/2008/04/29/Finance">
<lang1>fr</lang1>

61
Installing the client/server

<lang2>en</lang2>
<lang3>de</lang3>
<lang4>es</lang4>
<lang5>ja</lang5>
<site>top</site>
</setup>

2. Complete the XML file with the languages you want to define into your
database.
3. In the site parameter, indicate the type of site you want to define: top or
child.
4. Save and close the file.
5. Open a DOS prompt command and enter the following command:
“DatabasePreInitialization.exe defaultlanguages.xml”.

Connecting to SAP BusinessObjects


Financial Consolidation
Once SAP BusinessObjects Financial Consolidation is installed on the client
computer, you can connect to the application.

Note:
Do not forget to install Adobe Flash Player in order to be able to use the
dashboard.
1. Select Start > All Programs > SAP BusinessObjects > Financial
Consolidation.
Tip:
You can also double-click the Finance.exe file.
The Start the Application dialog box appears.

62
Installing the client/server

Note:
If the Data source manager groupbox is not displayed, click Options.

2. In the Data source manager groupbox, select the computer on which


the data source manager is located, which will then provide the list of
available SAP BusinessObjects Financial Consolidation data sources.
3. In the Data source groupbox, select the name of the data source you
want to use.
4. In the Authentication groupbox, specify the authentication information,
along with the SAP BusinessObjects Financial Consolidation user name
and password, or select the Use Windows account option.
Note:
If you do not know your username or password, please contact your
system administrator.

5. Click OK.

63
Installing the client/server

Upgrading your SAP BusinessObjects


Financial Consolidation version

Uninstalling SAP BusinessObjects Financial


Consolidation
Remember:
As SAP BusinessObjects Financial Consolidation 7.5 now uses a new setup
technology, you are not prompted to uninstall earlier versions of SAP
BusinessObjects Financial Consolidation but you need to manually uninstall
all previous versions via the Windows Control Panel before you can install
SAP BusinessObjects Financial Consolidation 7.5.
Caution:
• When upgrading your version, it is mandatory that you run the uninstall
program directly from the Windows Control Panel.
• You must close all the active applications before uninstalling a version.
Tip:
Do not forget to stop manually the processes Ctserver, CtBroker, CtController
or Finance.
1. Select Start > Settings > Control Panel and double-click Add/Remove
Programs.
The dialog box for adding or removing programs appears.

2. Select SAP BusinessObjects Financial Consolidation and click on


Add/Remove.
A message appears.

3. Click Yes.
Another message may appear indicating that a process (CtServer,
CtBtroker, CtController or Finance) is still running and that you need to
stop it before uninstalling the product.
4. Click OK and open Administrative tools > Services and stop one of
these above mentioned service.

64
Installing the client/server

5. Once you stopped it, you can uninstall SAP BusinessObjects Financial
Consolidation.
A message appears, asking you to restart the machine.
6. Click OK.

Migrating the database


Caution:
Before migrating the database, you must modify the connection string
(DbConnectionString) forthe OleDB providers. The OleDB providers currently
supported are SQLNCLI and OraOLEDB. If you do not modify the connection
string, the application will not function.

The structure of the database may change from one version of SAP
BusinessObjects Financial Consolidation to another. If this is the case, when
the application server tries to connect to a database whose schema is earlier
than the one in the current version, the following message appears. "The
software version number [7.5.x] and the database version number [10.x.x.x]
are incompatible for the "MAG" schema. Please contact your system
administrator."

Note:
The third set of figures indicates the database schema number. In order for
the versions to be compatible, the schema number on the server and
database should be identical.

65
Installing the client/server

If this is the case, then you should migrate the database to the new version.

Before performing the migration, you should make a backup of the database.
This is because the migration process may fail if the data in the database is
inconsistent. For example, if there are duplicates, this will prevent unique
indexes from being created during the migration process.

Tip:
To check data intergrity in your database, you can contact Business Objects.
Note:
The migration process from one version of SAP BusinessObjects Financial
Consolidation to another only includes SAP BusinessObjects Financial
Consolidation components, that is, the executables and the objects of the
database. If you have set up additional components in the database (tables,
index, stored procedures, etc.) or other executables (specific developments),
these components will not be included in the migration, and may no longer
work. In such a case, please contact Business Objects to assess the solution
to be implemented.
1. Start the Administration console.
2. Migrate the database to the current version of SAP BusinessObjects
Financial Consolidation by right-clicking on the server and selecting All
Tasks and Migrate as shown below.

66
Installing the client/server

The Migrate action carried out on a server connected to a database in


an earlier version of SAP BusinessObjects Financial Consolidation gives
the following result:

67
Installing the client/server

3. Check that the migration report ends with the following row: "database
migration succeeded". This indicates that the processing has ended and
that the migration has been correctly performed.
Tip:
You can consult the last migration report at any time, even after you have
closed the Migration Report window. It is saved in the
CtMigrationReport.txt file located in the installation folder on the computer
used to perform the migration.
Note:
The migration of the database fails when there are duplicates in the tables.
If this happens, you should check the migration report to see in which
table the migration process was interrupted.

Migrating an Oracle database


Caution:
Before migrating the database, you must modify the connection string
(DbConnectionString) forthe OleDB providers. The OleDB providers currently

68
Installing the client/server

supported are SQLNCLI and OraOLEDB. If you do not modify the connection
string, the application will not function.
If you are migrating an Oracle database, it is recommended that you create
a new Oracle instance. Previous Oracle instances of SAP BusinessObjects
Financial Consolidation used the following settings:

NLS_CHARACTERSET = WE8MSWIN1252 or WE8ISO8859P1 or USC7ASCII


(ANSI coding)
NLS_ NCHAR_CHARACTERSET = AL16YTF16 (UNICODE coding)

With the new 7.5 release of SAP BusinessObjects Financial Consolidation,


you must now use the following settings:

NLS_CHARACTERSET = AL32UTF8 (UNICODE coding)


NLS_NCHAR_CHARACTERSET = UTF8 (UNICODE coding)

If you want to keep your existing instance, the application will be able to work
and migrate your database. But it will not be possible to store UNICODE
characters. So, if you want to use UNICODE languages, like Japanese, you
should proceed as indicated below:

1. Export your SAP BusinessObjects Financial Consolidation database.


2. Create a new Oracle instance with the recommended settings.
3. Import your database in this new instance.
4. Execute the migration process.

Adding and removing components


You can add components to or remove them from your version of SAP
BusinessObjects Financial Consolidation. This can occur if you want to
reinstall the version using different settings, for example, by installing the
documentation in PDF format.

To do this, you should run the SAP BusinessObjects Financial Consolidation


setup again.
1. Double-click on Setup.exe located on the installation CD.
The following message appears:

69
Installing the client/server

2. Click Yes.
The Maintenance panel appears. It offers various operations on the version
already installed: Modify, Repair and Remove.

3. Select the Modify option and click Next.


The Setup Type dialog box appears.
4. Select the type of installation you want to perform and click Next.
The Application Languages to install dialog box appears.
5. If required, check the application language you want to add or uncheck
the one you want to remove and click Next.
If you select several languages, the Default Application Language
dialog box appears, enabling you to specify the working language.

Note:
If you only select one language, this dialog box will not appear. You will
proceed directly to the Custom Setup dialog box.

6. If required, change the working language of the application and click Next.
The Custom Setup dialog box appears, displaying the components
selected when you installed SAP BusinessObjects Financial Consolidation.

7. Check the component you want to add or uncheck the component you
want to remove and click Next.
The Ready to Modify the Program dialog box appears. Check the
settings entered before starting the installation.

8. If the settings are correct, click Next.


The Setup Status dialog box enables you to check on the progress of the
installation.

Once the installation is complete, the Maintenance complete dialog box


appears.

70
Installing the client/server

9. Click Finish.
Tip:
We strongly recommend that you restart your computer immediately in
order to optimize performance.

71
Installing the client/server

72
Specific installation and configuration

Specific installation and configuration

Standalone installation

Introduction to the standard / standalone


configuration
The standard / standalone configuration enables you to install SAP
BusinessObjects Financial Consolidation on decentralized data entry
workstations. You can use the Microsoft SQL Server 2005 SP2 Express
edition to store data at data collection sites.

You perform the following 3 steps to install SAP BusinessObjects Financial


Consolidation in a standard / standalone configuration:
• Install Microsoft SQL Server 2005 SP2
• Install SAP BusinessObjects Financial Consolidation
• Connect to SAP BusinessObjects Financial Consolidation

Installing SAP BusinessObjects Financial


Consolidation
Remember:
As SAP BusinessObjects Financial Consolidation 7.5 now uses a new setup
technology, you are not prompted to uninstall earlier versions of SAP
BusinessObjects Financial Consolidation but you need to manually uninstall
all previous versions via the Windows Control Panel before you can install
SAP BusinessObjects Financial Consolidation 7.5.

73
Specific installation and configuration

Note:
Do not forget to install Adobe Flash Player as it is required on the client site
to access the new dashboards.
1. Double-click on Setup.exe located at the root of the installation CD.
2. Click Run.
If one of the components required is missing or not in the minimum version
supported, the List of requirements to install dialog box opens.

3. Click Install.
The Welcome to the setup wizard dialog box opens.
4. Click Next.
5. The License Agreement dialog box opens.
6. Select the I accept the terms in the license agreement option.
7. Click Next.
The Destination Folder dialog box opens.
8. Select the folder or enter the name of the folder where you want to install
SAP BusinessObjects Financial Consolidation and click Next.
The Setup Type window opens.

9. Select the Client installation option and click Next.


The Custom setup dialog box for selecting the required components
appears.

74
Specific installation and configuration

10. Select the components you want to install for the standard / standalone
configuration.
• Application: If you check this option, all of the components required
for running SAP BusinessObjects Financial Consolidation will be
installed.
• Administration console: This option enables you to access the tool
used for managing the data sources.
• Create an empty database: This option enables you to create an
empty database called Finance in your SQL database engine.

Caution:
Do not select the Create an empty database option if you already
have a database called Finance and if you are upgrading the version.
Tip:
If you want to be able to access the Online Help and the
documentation, we recommend that you select the Online help and
Documentation options. If you do not select these options here, you
will not have access to this functionality once SAP BusinessObjects
Financial Consolidation is installed. You can, however, install them at
a later time.

75
Specific installation and configuration

11. Click Next.


The following dialog box appears. Enter the relevant information for
connecting to SQL Server.

12. Enter the administrator login and password and click on Next.
The Ready to install the program dialog box enables you to review your
settings before starting the installation.

13. If the settings are correct, click Next.


Note:
The actual installation then begins. Depending on the performance of
your computer, the installation may last several minutes. You should not
perform any other task until the installation is complete in order to ensure
that the application is correctly installed.
Once the installation is complete, the Installation complete dialog box
appears.

14. Click Finish.


15. Restart your computer.

76
Specific installation and configuration

Note:
If you do not restart your computer, the database will not be migrated and
you will not be able to connect to SAP BusinessObjects Financial
Consolidation.

16. Double-click the ExclusiveModeInStandAlone.reg file located in the


Tools subfolder of the SAP BusinessObjects Financial Consolidation
installation folder.
Note:
This creates a registry key located in
[HKEY_LOCAL_MACHINE\SOFTWARE\CARTESIS\Cartesis
Finance\StandAlone] "ExclusiveMode"=dword:00000001. This key
authorizes the SAP BusinessObjects Financial Consolidation server to
perform transfer operations usually carried out in exclusive mode. In
standalone mode, there is no point in connecting in exclusive mode as
only one user will be connected to the server.

17. If you are working on a Windows XP SP2 platform, open Internet Explorer.
18. Select Internet Options > Advanced tab.
19. Under the Security heading, check the Allow active content to run in
files on My Computer option.

Related Topics
• Configuring the Web client on page 82

Initializing the database


If you install SAP BusinessObjects Financial Consolidation in standalone
configuration, where all the components are installed on the same computer,
the setup will provide the option of creating an empty database if it detects
an SQL Server engine on the machine. The empty database will therefore
be initialized automatically by the setup. The initialization process will run in
a command prompt window that will close automatically when the process
ends. You are not required to perform any action.

77
Specific installation and configuration

Connecting to SAP BusinessObjects Financial


Consolidation
As the database has been migrated automatically, you can connect to SAP
BusinessObjects Financial Consolidation.
1. Select Start > All Programs > SAP BusinessObjects and click on
Financial Consolidation.
Note:
In the installation folder, you can also double-click on the Finance.exe
file.
The Start the Application dialog box appears.

Note:
If the Data source manager groupbox does not appear, click Options.

2. In the Data source manager groupbox, select the machine where the
list of data sources is located. As you are in a standard local configuration,
you should select the name of your computer, i.e. Local.

78
Specific installation and configuration

3. In the Data source groupbox, select the name of the data source you
want to use. If you opted to create an empty database, the Finance data
source appears.
4. In the Authentication groupbox, enter the username and password.
When you connect to BusinessObjects Financial Consolidation for the
first time, the default user will be ADMIN and there will be no password.
Note:
This login and password is not to be confused with the SQL login and
password.
Note:
When you connect to BusinessObjects Financial Consolidation for the
first time, the ADMIN user appears by default. This enables you to connect
to BusinessObjects Financial Consolidation and create different users
and user profiles, which you can then use when reconnecting.

5. Click OK.
Note:
This dialog box is filled in by default during the installation, because during
installation, an empty database called Finance and its corresponding OLE
DB data source were automatically created. When you connect to
BusinessObjects Financial Consolidation for the first time, the ADMIN
user also appears by default because the database is still empty.

Creating another database


You may need to create a new database in addition to the one created when
SAP BusinessObjects Financial Consolidation was installed.
1. Select Start > Programs > Microsoft SQL Server > Enterprise
Manager.
SQL Server Enterprise Manager will open.

2. Click on SQL Server Group to expand it and select the computer where
you want to add a database.
3. Right-click on Databases and select New Database.
The Database Properties dialog box appears.

79
Specific installation and configuration

4. In the General tab, enter the name of the new database in the Name
field.
5. In the File properties groupbox of the Data Files tab, select the
Automatically grow file, By percent and Unrestricted file growth
options as shown below.

6. Click OK.
You should change the properties of the new database.

7. To do this, right-click on the database and select Properties as shown


above.
The [Database name] Properties dialog box appears.

8. Select the Options tab.


9. In the Settings groupbox, select the options as shown below.

80
Specific installation and configuration

10. Click OK.


You have finished creating a new database.

Configuring the Administration console after


adding a database or connecting to an existing
database
To find out more about using the Administration console, see "Creating a
data source" and follow the procedure for the SQL Server database. The
default login to be used is "sa".

81
Specific installation and configuration

Configuring the client workstation

Configuring the Web client


Note:
The settings indicated here are not compulsory but enable you to improve
the performance of SAP BusinessObjects Financial Consolidation Web.
Before applying these settings, please check that they are authorized by
your network administrator.
Caution:
SAP BusinessObjects Financial Consolidation does not work when two Web
sessions are started on the same client workstation.

Configuring the Web browser cache

In order to optimize navigation in SAP BusinessObjects Financial


Consolidation Web, you should use the Internet Explorer automatic cache
management mode. You do this as follows:
1. Open Internet Explorer.
2. In the Tools > Internet Option menu, select the General tab.
3. In the Temporary Internet files groupbox, click on Settings.
The Settings window appears.

4. In the Check for newer versions of stored pages groupbox, select


Automatically.
5. Click on OK to close this dialog box and on OK again in the Internet
Options dialog box.
Caution:
• SAP BusinessObjects Financial Consolidation will not work if you
select Never.
• You should also clear the cache regularly, especially each time a new
version of SAP BusinessObjects Financial Consolidation is installed.

82
Specific installation and configuration

Other recommendations

You must activate support for the HTTP 1.1 protocol. This option is located
in the Avanced tab of the Internet Options of your Web browser, as shown
below.

If your computers are located on a network using a proxy server, you must
also select the Use HTTP 1.1 through proxy connections as well as the
Use HTTP 1.1 option, as shown below.

83
Specific installation and configuration

Note:
If you do not check this option and the Web site is accessed through the
proxy, SAP BusinessObjects Financial Consolidation Web may not work
correctly.

Configuring the SAP BusinessObjects Financial


Consolidation client with Internet Explorer 7

Adding the SAP BusinessObjects Financial


Consolidation site to the list of trusted sites

With Internet Explorer 7, the site in which SAP BusinessObjects Financial


Consolidation Web is deployed must be added to the list of trusted sites.

84
Specific installation and configuration

To do this, you must follow the procedure below:


1. Start Internet Explorer and select Tools > Internet Options.
2. Select the Security tab.
3. Click the Trusted sites icon, and then the Sites button.
4. The Trusted sites dialog box appears.
5. Enter the URL of your SAP BusinessObjects Financial Consolidation Web
site and click Add.
6. Click OK.

Configuring other options with Internet Explorer 7


1. Start Internet Explorer and select Tools > Internet Options.
2. Select the Advanced tab.
3. In the security settings, check the "Allow active content to run in files
on My Computer " option.
Note:
You should not select the "Always open pop-ups in a new tab" option.
SAP BusinessObjects Financial Consolidation Web will not work correctly.

Configuring the client for Excel Link


In order to ensure that Excel Link functions correctly, you must install the
Microsoft Office Tools Visual Basic for Applications (VBA) component.

Note:
This component is available on the Microsoft Office installation CD.

Installing and configuring under Windows


Terminal Services
The Windows Terminal Services architecture supports "application server
computing", which enables the application to run on a server for multiple
users.

85
Specific installation and configuration

SAP BusinessObjects Financial Consolidation clients can be installed in


Windows Terminal Services as part of the 3-tier architecture, in which screen
changes in the user interface are sent to the individual client computer.

All of the processing in the application will be performed on the Windows


Terminal Services server. Regardless of the line speed, the server will be
able to send screen changes to the client computer without any loss in
performance, using any type of LAN, WAN or other communication network.

Windows Terminal Services also coordinates all of the printing jobs to be


performed by managing communication between input/output drivers.

Installing an application in a Windows Terminal Services environment, is


different than installing an application in a standard Windows environment.

Note:
If complementary applications are used (e.g. Citrix MetaFrame), additional
operations may be necessary (e.g. deploying the application in Citrix
MetaFrame). To find out more, contact your software provider.

Installation modes in Windows Terminal


Services
Caution:
You should connect with the local system administrator account when
installing SAP BusinessObjects Financial Consolidation.
To install an application on a Windows Terminal Services server, you must
disconnect all users and switch the server to install mode.

You can install an application in Windows TS in two different ways:


• Select Start > Settings > Control Panel and select Add/Remove
programs.

Note:
When you perform the above action, the server will switch automatically
to Install mode..
• Enter the following command line to switch to install mode: change user
/install.

86
Specific installation and configuration

Installing under Windows Terminal Services


When you install SAP BusinessObjects Financial Consolidation, the setup
will automatically restart your computer. To maintain the Windows Terminal
Services server in install mode after opening a session, you can create a
temporary registry key which positions the server in install mode when the
session is opened.
1. In the registry, create a string key in: HKEY_LOCAL_MACHINE\SOFT
WARE\Microsoft\Windows\CurrentVersion\Run.
2. Name the key ChangeUser.
3. Assign the change user /install value to the key.
Note:
You must delete this key once the installation has been completed.

4. You can now run the SAP BusinessObjects Financial Consolidation setup.
Note:
Only the SAP BusinessObjects Financial Consolidation client is supported
in Windows Terminal Services. Ther application servers and SAP
BusinessObjects Financial Consolidation Web servers must not be
installed in Windows TS under any circumstance.

5. Continue in Install mode. Print a SAP BusinessObjects Financial


Consolidation object (not a schedule or report). For example, print a
scope. The printouts are managed by an ActiveX control that is saved
the first time that it is called up. You must print a schedule on the SAP
BusinessObjects Financial Consolidation client on the Terminal Services
server to complete the installation.
6. If you are working on a Windows Server 2003 TS, refer to the section
entitled Specific configuration for Windows Server 2003 SP1 in the
Administration Guide and configure the Internet Explorer as indicated.

87
Specific installation and configuration

Configuring the Windows Terminal Services


server
In order to optimize network traffic, you must deactivate the animation in
SAP BusinessObjects Financial Consolidation using a registry key.
1. In the registry, create a DWORD type key in HKEY_LOCAL_MA
CHINE\SOFTWARE\Cartesis\Magnitude\HideMagnitudeProgression.
2. Name the key HideProgressionAnimation.
3. Assign the value 1 to the key.

Configuring SAP BusinessObjects


Financial Consolidation Excel Web
Schedules

Configuring the client computer

Configuring the Web client

You must follow the instructions provided when configuring the client
computer.

Related Topics
• Configuring the Web client on page 82

Configuring Internet Explorer

Caution:
If you are planning to use Excel Web Schedules with Microsoft Excel 2007,
Internet Explorer version 7 is mandatory.

88
Specific installation and configuration

For computers with access only to Intranet and not to the Internet, you should
check the Check for publisher's certificate revocation option in Internet
Explorer.
You do this by selecting Tools > Internet Options > Advanced tab.

If you do not do so, each time you open a SAP BusinessObjects Financial
Consolidation Excel Web Schedules, Internet Explorer will check that the
security certificates are up-to-date. This results in poor performance.

Specific configuration for using EWS folders offline

By default, Internet Explorer refuses to give pages displayed on the Internet


access to local items on the computer. The items cannot be uploaded even
if they have valid certificates. This problem occurs when a user tries to
reconnect to EWS after entering data in a EWS workbook offline. To display
the workbook correctly, the following options must be selected:

89
Specific installation and configuration

1. Start Internet Explorer and select Tools > Internet Options.


2. Select the Advanced tab.
3. Under the Security heading, check the Allow active content to run in
files on My Computer option.
4. Edit the following registry key:
[HKEY_CURRENT_USER\Software\Microsoft\Windows\
CurrentVersion\Internet Settings\Zones\0]
5. In the 0 zone, enter 1 as the value for the 2101 value.
Note:
Internet Explorer will ask you to confirm the action each time you reconnect
an Excel workbook to EWS.
Caution:
You can avoid the confirmation message by entering 0 as the value for
the registry key. However, if you do so, you will no longer receive any
confirmation message for any of the Internet sites you consult. This
obviously represents a security risk for the computer. Business Objects
does not recommend this solution.

Specific configuration in Microsoft Excel

Caution:
SAP BusinessObjects Financial Consolidation Excel Web Schedules will not
work if the Microsoft Office Tools Visual Basic for Applications component
has not been installed.
Note:
The first time you open a schedule using EWS, a warning message appears.
This is the standard behaviour of the application.
So that EWS functions correctly, some options must be configured in Microsoft
Excel:
1. The XLS extension should be assigned to the Microsoft Excel worksheets
in the Edit File Type window in Windows Explorer (Tools > Folder
Options > File Type tab > Microsoft Excel XLS Worksheet > Advanced
button).
You must also check the Browse in same window option.

90
Specific installation and configuration

2. A printer should be defined for the client computer.


3. The macro security level should be configured with the Trust all installed
add-ins and templates and Trust access to Visual Basic Project
options. You can access these options in Excel by clicking on Tools >
Macros > Security.

91
Specific installation and configuration

Enabling macros

Depending on the version of Excel used, you should follow one of the
procedures described below to enable the macros used for Excel Web
schedules.

Enabling macros with Excel XP and Excel 2003


1. When the schedule is opened, the Security Warning dialog box appears.
2. Check the Always trust macros from this source option.
3. Click Enable Macros.

Enabling macros with Excel 2007


To enable macros with Excel 2007, you must follow the procedure below:
1. In Excel 2007, click the Office button and then the Excel Options button.
The Excel Options dialog box opens.
2. Select Trust Center and click the Trust Center Settings button.
The Trut Center dialog box opens.
3. Select Macro Settings.
4. Select the Disable all macros except digitally signed macros and
Trust access to the VBA project object model options as indicated
below.

92
Specific installation and configuration

5. Click OK.

Configuring SAP BusinessObjects Financial


Consolidation Excel Web Schedules installation folder

When an Excel Web schedule is opened for the first time, two folders are
created:

• The first one is: %UserProfile% \Application Data\EWS\. It contains all


files related to the executable (macro). It is possible to customize a registry
key to define the folder once for every time, in which all the macros are
going to be downloaded. For example, if you use Citrix, the macros are
being downloaded for all users only once, instead of being downloaded
each time by each user.

93
Specific installation and configuration

For example, this key will be:


[HKEY_LOCAL_MACHINE\SOFTWARE\CARTESIS\Magnitude\Planning]
"EWSDirectory"="d:\ews"
• The second one is: %UserProfile% \Application Data\SAP\EWS\. It
contains all files related to the user settings: log files, ini files.This folder
also contains the CtPlConfig.ini file.

If you open a document from a previous version, the default folder of the
EWS application is %TMP%\Magnitude Planning\. (For example,
C:\Document and Setting\jdoe.INTL\Local Setting\Temp\).

Settings in the CtPlConfig.ini file

...
[UserOption]

HookIEDisabled
=FALSE
------------- variables to be added if required ----------
---
LoadServerXllDisabled
=FALSE
LoadBlankWorkbookEnabled
=FALSE

HookIEDisabled
This variable is used to disable the CtHookIE.dll file. Enabled by default,
this file is required in order to work around a referenced Microsoft bug that
affects the integration of Excel in Internet Explorer. By applying this
workaround solution, you will be able to work online in an SAP
BusinessObjects Financial Consolidation Excel Web Schedules schedule
as well as in an Excel workbook on the local host.

The possible values are:


• FALSE (default value): this library is loaded by the system.
• TRUE: The system does not load this library.

94
Specific installation and configuration

LoadServerXllDisabled
Caution:
By default, this variable is not found in the CtPlConfig.inifile. You should
insert it manually if you want to use it.
This variable is used to check whether or not the version of Excel Web
Schedules CtPlanning.xll) on the Web server and on the client are identical.

The possible values are:


• FALSE (default value): the version of the CtPlanning.xll file will be
checked automatically. This means that if the version on the client
computer is earlier than the one on the Web server, then it will
automatically be upgraded.
• TRUE: the version of the CtPlanning.xll file will not be checked. This
means that the version of SAP BusinessObjects Financial Consolidation
Excel Web Schedules on the client computer will not be automatically
upgraded.

LoadBlankWorkbookEnabled
Note:
By default, this variable is not found in the CtPlConfig.ini file. You should
insert it manually if you want to use it.
This variable is used to specify a specific mode in which local changes will
not be loaded when the schedule is opened. If enabled, all local changes
will be removed when the schedule is corrupted and cannot be opened with
them. This is done without querying the database.

The possible values are:


• FALSE (default value): the mode is disabled.
• TRUE: the mode is enabled. You should proceed as described below.
This enables you to open a schedule even if it is corrupted.

1. In the installation folder of the module, open the CtPlConfig.ini file.


2. Insert LoadBlankWorkbookEnabled=TRUE in the file.
3. Save and close the file.
4. Open a package that contains the uncorrupted and corrupted schedules.
5. Open the uncorrupted schedule.

95
Specific installation and configuration

The schedule opens with its local modeling.

6. Open the corrupted schedule.


The schedule will open without its local modeling.
7. To ensure that the schedule will open subsequently, you can select SAP
BusinessObjects Financial Consolidation > Local modeling > Remove
local modeling.
8. Close the package.
9. Open the CtPlConfig.ini file again.
10. Enter FALSE instead of TRUE.
11. Save and close the file.

Installing and configuring SAP


BusinessObjects Financial Consolidation
Web Services
There is no specific installation to perform as the SAP BusinessObjects
Financial Consolidation web services are automatically installed when
runnning the SAP BusinessObjects Financial Consolidation setup.

Caution:
Do not forget that you must use the ASP.NET 2.0 version with the SAP
BusinessObjects Financial Consolidation web services.

Deploying the SAP BusinessObjects Financial


Consolidation Web Services

Configuring the web.config file


1. In the SAP BusinessObjects Financial Consolidation installation folder,
copy the WebServices subfolder.
2. Paste the subfolder to \Inetpub\wwwroot\.
3. You can rename this folder to reflect the URL that you want to display.

96
Specific installation and configuration

Note:
You can deploy the WebServices site in a folder other than the default
wwwroot folder. To do so, create a virtual folder in IIS that points to the
folder that you use.

4. In this folder, edit the web.config file.


5. Search for the following rows:

<configuration>
<system.web>
<httpRuntime executionTimeout="3600" maxRequestLength="65536"
useFullyQualifiedRedirectUrl="false" minLocalRequest
FreeThreads="4" appRequestQueueLimit="100" />
</system.web>
<appSettings>
<add key="BrokerHostName" value="BrokerServerName" />
<add key="DataSource" value="DataSourceName" />
<add key="DefaultLogin" value="Login" />
<add key="DefaultPassword" value="Password" />
</appSettings>
</configuration>

6. Change these rows by entering the values that correspond to your SAP
BusinessObjects Financial Consolidation environment
Enter the login and password corresponding to a SAP BusinessObjects
Financial Consolidation user who needs no specific rights. You can
therefore create a user dedicated to these Web Services that does not
have any rights.

7. Save your changes.


8. However, if you want to encrypt this login and password for security
reasons, follow the instructions provided in the next chapter.

Encrypting the settings of the web.config file (optional)

To enhance security, you can encrypt the login and password given in the
web.config file using the method recommended by Microsoft for ASP.NET
applications.
1. Download the aspnet_setreg.exe tool available at the following Microsoft
URL: http://download.microsoft.com/download/2/9/8/29829651-e0f0-412e-
92d0-e79da46fd7a5/aspnet_setreg.exe.

97
Specific installation and configuration

2. Run the following command: aspnet_setreg.exe -k:SOFTWARE\Carte


sis\Cartesis Finance\WebServices -u:"yourdomainname\username"
-p:"password"

Note:
The registry key name given here can have a different value from
WebServices, especially when you want to deploy several applications.

3. Edit the web.config file and look for the following rows:

<add key="DefaultLogin" value="registry:HKLM\SOFTWARE\Carte


sis\Cartesis Finance\
WebServices\ASPNET_SETREG,username" />
<add key="DefaultPassword" value="registry:HKLM\SOFT
WARE\Cartesis\
Cartesis Finance\WebServices\ASPNET_SETREG,password" />

4. Change these rows as shown above.


Next, you must authorize the account that runs the .NET framework to
access these new registry keys if your operating system is Windows
Server 2003.

5. Run the regedt32.exe command in the Start > Run menu and click on
OK.
6. Select the registry key
HKEY_LOCAL_MACHINE\SOFTWARE\Cartesis\Cartesis
Finance\WebServices\ ASPNET_SETREG and right-click Permissions.
7. Click on Add and select the account that runs the ASP.NET framework
and assign the Read permission to this account.
Note:
In Windows Server 2003, this account is called Network service by default.

8. Close the registry editor.


Note:
To find out more, please see the official Microsoft documentation at the
following address: http://support.microsoft.com/kb/329290/en-us

98
Specific installation and configuration

Creating the .NET application under Windows 2003 in


native IIS 6 isolation mode
1. In the IIS Administration console, select Application Pools > New >
Application Pool.
2. The Add New Application Pool dialog box appears.
3. In the Pool Application ID groupbox, specify the name that you want to
give it.
4. Check theUse default settings for new application pool option
5. Click OK.
6. In the IIS administration console, select Default Web Site.
The new application appears.

7. Right-click on the folder and select Properties.


8. In the Directory tab, click on Create.
The Application Settings groupbox then becomes active.

99
Specific installation and configuration

9. As for the Application Pool field, select the data pool that you created
in step 2.
10. Next, select the Folder Security tab.
11. In the Authentication and access control groupbox, click Modify.
The following dialog box appears.

100
Specific installation and configuration

12. Check the Enable anonymous access option and keep the default user
name and password.
13. In the Authenticated Access groupbox, make sure that no other option
is checked.
14. Click OK.

Deploying the SAP BusinessObjects Financial


Consolidation Web Services under Windows
2008
1. Open the IIS Manager.
2. In the Connections pane, expand and select the Application Pools.
3. Right-click Application Pools and select Add Application Pool.
The Add Application Pool dialog box opens.

101
Specific installation and configuration

4. In the .Net Framework version zone, select the .Net Framework 2.0
option.
5. In the Managed pipeline zone, select the Classic option.
6. Click OK.
7. In the SAP BusinessObjects Financial Consolidation installation folder,
copy the WebServices subfolder.
8. Paste the subfolder to \Inetpub\wwwroot\.
9. You can rename this folder to reflect the URL that you want to display.
Note:
You can deploy the WebServices site in a folder other than the default
wwwroot folder. To do so, create a virtual folder in IIS that points to the
folder that you use.

10. In this folder, edit the web.config file.


11. Search for the following rows:

<configuration>
<system.web>
<httpRuntime executionTimeout="3600" maxRequestLength="65536"
useFullyQualifiedRedirectUrl="false" minLocalRequest
FreeThreads="4" appRequestQueueLimit="100" />
</system.web>
<appSettings>
<add key="BrokerHostName" value="BrokerServerName" />
<add key="DataSource" value="DataSourceName" />
<add key="DefaultLogin" value="Login" />
<add key="DefaultPassword" value="Password" />
</appSettings>
</configuration>

102
Specific installation and configuration

12. Change these rows by entering the values that correspond to your SAP
BusinessObjects Financial Consolidation environment
Enter the login and password corresponding to an SAP BusinessObjects
Financial Consolidation user who needs no specific rights. You can
therefore create a user dedicated to these Web Services that does not
have any rights.

13. Save your changes.


14. In the IIS Manager, create an application pool with the .NET 2.0 and
Integrated options.
15. Select the application pool you created at step 3.
16. Right-click on the folder and select Convert To application in order to
deploy the web site.
17. Once the application is created, click on it and open the Authentication
feature.
Select the Anonymous Authentication line and edit it.
18. In the Edit Anonymous Authentication Credentials, select the IUSR
user and click OK.
19. Right-click on Anonymous Authentication and select Enable.

Deleting the SAP BusinessObjects Financial


Consolidation Web Services website
1. In the IIS administration console, select the folder containing the site that
you want to delete.
2. Right-click on the folder and select Properties.
The website Properties window appears.

3. In the Directory tab, click on Remove.


4. Click OK.
5. Then delete the corresponding folder in \Inetpub\wwwroot\.
6. If you are working in Windows Server 2003 in native IIS 6 isolation mode,
make sure that you delete the data pool that corresponds to your
application.

103
Specific installation and configuration

Testing the SAP BusinessObjects Financial


Consolidation Web Services deployment
Note:
This procedure must be carried out on the computer on which the SAP
BusinessObjects Financial Consolidation Web services are deployed. For
security reasons, this test cannot be carried out on other computers.
1. Make sure that the SAP BusinessObjects Financial Consolidation data
source is started.
2. Start Internet Explorer and enter the URL for connecting to the SAP
BusinessObjects Financial Consolidation Web Services that you deployed.
In this documentation, this is the application called WebServices. The
URL is therefore: http://localhost/WebServices/security/Authen
ticationServices.asmx

The following window appears.

3. Click the Authenticate link.


The following window appears.

104
Specific installation and configuration

4. In the User and Password fields, enter the login and password for
connecting to SAP BusinessObjects Financial Consolidation.
5. Click Invoke.
If the application has been correctly deployed, the following window
appears.

105
Specific installation and configuration

If this window does not appear, check that:


• The SAP BusinessObjects Financial Consolidation Web Services
application exists and has been correctly deployed.
• The SAP BusinessObjects Financial Consolidation Web Services
application is connected to a valid data source.
• The SAP BusinessObjects Financial Consolidation data source is
started and is operating correctly.
• Anonymous connection is authorized in IIS for the SAP
BusinessObjects Financial Consolidation WebServices site.

106
More Information

More Information

Information Re-
Location
source

SAP Busines-
sObjects product http://www.sap.com
information

Select http://help.sap.com > SAP BusinessOb-


jects.
You can access the most up-to-date documentation
covering all SAP BusinessObjects products and their
deployment at the SAP Help Portal. You can down-
load PDF versions or installable HTML libraries.
SAP Help Portal Certain guides are stored on the SAP Service Market-
place and are not available from the SAP Help Portal.
These guides are listed on the Help Portal accompa-
nied by a link to the SAP Service Marketplace. Cus-
tomers with a maintenance agreement have an au-
thorized user ID to access this site. To obtain an ID,
contact your customer support representative.

107
More Information

Information Re-
Location
source

http://service.sap.com/bosap-support > Documen-


tation
• Installation guides: https://ser
vice.sap.com/bosap-instguides
• Release notes: http://service.sap.com/re
leasenotes
The SAP Service Marketplace stores certain in-
SAP Service stallation guides, upgrade and migration guides,
Marketplace deployment guides, release notes and Supported
Platforms documents. Customers with a mainte-
nance agreement have an authorized user ID to
access this site. Contact your customer support
representative to obtain an ID. If you are redirect-
ed to the SAP Service Marketplace from the SAP
Help Portal, use the menu in the navigation pane
on the left to locate the category containing the
documentation you want to access.

https://boc.sdn.sap.com/developer/library
Developer re-
https://www.sdn.sap.com/irj/sdn/businessobjects-sd
sources
klibrary

SAP Busines- https://www.sdn.sap.com/irj/boc/businessobjects-


sObjects articles articles
on the SAP
These articles were formerly known as technical pa
Community Net-
pers.
work

https://service.sap.com/notes
Notes These notes were formerly known as Knowledge
Base articles.

108
More Information

Information Re-
Location
source

Forums on the
SAP Community https://www.sdn.sap.com/irj/scn/forums
Network

http://www.sap.com/services/education
From traditional classroom learning to targeted e-
Training learning seminars, we can offer a training package
to suit your learning needs and preferred learning
style.

http://service.sap.com/bosap-support
The SAP Support Portal contains information about
Customer Support programs and services. It also has
Online customer links to a wide range of technical information and
support downloads. Customers with a maintenance agree-
ment have an authorized user ID to access this site.
To obtain an ID, contact your customer support rep-
resentative.

http://www.sap.com/services/bysubject/busines
sobjectsconsulting
Consultants can accompany you from the initial
analysis stage to the delivery of your deployment
Consulting
project. Expertise is available in topics such as rela
tional and multidimensional databases, connectivity,
database design tools, and customized embedding
technology.

109
More Information

110

Potrebbero piacerti anche