Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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
3
Contents
4
Contents
5
Contents
6
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation
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 languages
8
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation
9
What's new in version 7.5 of SAP BusinessObjects Financial Consolidation
10
Contents of the CD of the version
11
Contents of the CD of the version
12
Summary of the steps involved in installing the product
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
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
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
15
Summary of the steps involved in installing the product
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
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
Related Topics
• Installing SAP BusinessObjects Financial Consolidation on page 73
• Connecting to SAP BusinessObjects Financial Consolidation on page 78
Related Topics
• Connecting to SAP BusinessObjects Financial Consolidation on page 78
17
Summary of the steps involved in installing the product
18
Preparing to install SAP BusinessObjects Financial Consolidation
19
Preparing to install SAP BusinessObjects Financial Consolidation
The native OleDB provider is now mandatory with SQL Server 2005.
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
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.
21
Preparing to install SAP BusinessObjects Financial Consolidation
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
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.
23
Preparing to install SAP BusinessObjects Financial Consolidation
<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"
/>
24
Preparing to install SAP BusinessObjects Financial Consolidation
<httpRuntime
executionTimeout="3600"
maxRequestLength="4096"
useFullyQualifiedRedirectUrl="false"
minFreeThreads="8"
minLocalRequestFreeThreads="4"
appRequestQueueLimit="100"
enableVersionHeader="true"
/>
<httpRuntime
executionTimeout="3600"
maxRequestLength="4096"
useFullyQualifiedRedirectUrl="false"
minFreeThreads="8"
minLocalRequestFreeThreads="4"
25
Preparing to install SAP BusinessObjects Financial Consolidation
appRequestQueueLimit="100"
enableVersionHeader="true"
/>
Configuring IIS 6
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.
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
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
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.
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
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.
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
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.
35
Installing the client/server
36
Installing the client/server
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
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.
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.
38
Installing the client/server
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.
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.
40
Installing the client/server
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.
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.
42
Installing the client/server
43
Installing the client/server
Caution:
The name of your site must not contain the _ (underscore) character.
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.
17. In the MIME Types groupbox, click the MIME Types button.
The MIME Types dialog box opens.
45
Installing the client/server
.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.
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
47
Installing the client/server
.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.
Note:
You should select this component when you run the SAP BusinessObjects
Financial Consolidation setup.
48
Installing the client/server
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).
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.
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.
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.
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.
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
ExternalAuthenticationConfigString
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.
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
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>
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
Note:
This computer must be one of the servers you configured for the data source.
ServerComputerName
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
In the Activity column, the status of the data source appears as active.
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
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
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.
59
Installing the client/server
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.
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
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.
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”.
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.
5. Click OK.
63
Installing the client/server
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.
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
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.
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:
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:
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.
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.
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
Standalone installation
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.
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
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.
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.
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
77
Specific installation and configuration
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.
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.
80
Specific installation and configuration
81
Specific installation and configuration
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.
84
Specific installation and configuration
Note:
This component is available on the Microsoft Office installation CD.
85
Specific installation and configuration
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.
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
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.
87
Specific installation and configuration
You must follow the instructions provided when configuring the client
computer.
•
Related Topics
• Configuring the Web client on page 82
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.
89
Specific installation and configuration
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
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.
92
Specific installation and configuration
5. Click OK.
When an Excel Web schedule is opened for the first time, two folders are
created:
93
Specific installation and configuration
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\).
...
[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.
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.
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.
95
Specific installation and configuration
Caution:
Do not forget that you must use the ASP.NET 2.0 version with the SAP
BusinessObjects Financial Consolidation web services.
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.
<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.
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
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:
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.
98
Specific installation and configuration
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.
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.
<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.
103
Specific installation and configuration
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
106
More Information
More Information
Information Re-
Location
source
SAP Busines-
sObjects product http://www.sap.com
information
107
More Information
Information Re-
Location
source
https://boc.sdn.sap.com/developer/library
Developer re-
https://www.sdn.sap.com/irj/sdn/businessobjects-sd
sources
klibrary
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