7/25/2019 Crs2011 Install Linux En
1/62
SAP Crystal Server Installation Guide for Linux
SAP Crystal Server 2011 Feature Pack 3
2012-08-13
7/25/2019 Crs2011 Install Linux En
2/62
2012 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, SAP HANA and other SAP products and services mentioned
Copyright
herein as well as their respective logos are trademarks or registered trademarks of SAP AG in
Germany and other countries.Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects productsand services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase andAdaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase,Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360, B2B 360 Services areregistered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAPcompany. All other product and service names mentioned are the trademarks of their respectivecompanies. Data contained in this document serves informational purposes only. National productspecifications may vary.These materials are subject to change without notice. These materials areprovided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only,without representation or warranty of any kind, and SAP Group shall not be liable for errors oromissions with respect to the materials. The only warranties for SAP Group products and services
are those that are set forth in the express warranty statements accompanying such products andservices, if any. Nothing herein should be construed as constituting an additional warranty.
2012-08-13
7/25/2019 Crs2011 Install Linux En
3/62
Contents
Document History...................................................................................................................5Chapter 1
Introduction.............................................................................................................................7Chapter 2
About this Document...............................................................................................................72.1
Purpose...................................................................................................................................72.2
Integration................................................................................................................................72.3
Constraints..............................................................................................................................82.4
Planning..................................................................................................................................9Chapter 3
Upgrade support....................................................................................................................103.1
Object types and feature requirements..................................................................................113.1.1
Product co-existence.............................................................................................................113.1.2
Web application servers.........................................................................................................123.2
Web servers..........................................................................................................................133.3
Database servers...................................................................................................................133.4
Preparation............................................................................................................................15Chapter 4
System requirements.............................................................................................................164.1
Account permissions..............................................................................................................164.1.1
Network permissions.............................................................................................................184.1.2
Preparing the CMS system or Auditing Data Store database.................................................194.2
Extra requirements for IBM DB2............................................................................................214.2.1
Extra requirements for Sybase...............................................................................................234.2.2
Set ulimit to unlimited.............................................................................................................234.3
Final checklist.........................................................................................................................234.4
Installation.............................................................................................................................25Chapter 5
To download the installation program.....................................................................................255.1
To run an interactive installation.............................................................................................265.2
To select an install type..........................................................................................................275.2.1
While the installation program runs.........................................................................................375.2.2
2012-08-133
7/25/2019 Crs2011 Install Linux En
4/62
When installation is complete.................................................................................................385.2.3
To run a silent installation.......................................................................................................385.3
Command-line switch parameters..........................................................................................395.3.1
Installation option parameters ................................................................................................415.3.2
Post-Installation....................................................................................................................53Chapter 6
Launching the CMC...............................................................................................................536.1
Troubleshooting login issues..................................................................................................536.2
Creating additional Adaptive Processing Servers...................................................................546.3
Deploying web applications....................................................................................................556.4
Post-install diagnostic checks.................................................................................................556.5
Making changes to SAP Crystal Server.................................................................................556.6
To modify SAP Crystal Server................................................................................................556.6.1
To repair SAP Crystal Server.................................................................................................566.6.2To remove SAP Crystal Server..............................................................................................576.6.3
When the administrator account password is lost..................................................................586.7
More Information...................................................................................................................59Appendix A
Index 61
2012-08-134
Contents
7/25/2019 Crs2011 Install Linux En
5/62
Document History
DescriptionDateVersion
First release of this documentNov. 2011SAP Crystal Serv-
er 2011
Updated information on supported Web application servers
Updated information on supported Web servers
New instructions on downloading the installation program New instructions on adding additional Adaptive Processing
Servers (post installation)
May 2012
SAP Crystal Serv-
er 2011 FeaturePack 3
2012-08-135
Document History
7/25/2019 Crs2011 Install Linux En
6/62
2012-08-136
Document History
7/25/2019 Crs2011 Install Linux En
7/62
Introduction
This document guides you through the installation of SAP Crystal Server.
2.1 About this Document
The following documentation provides administrators with information, procedures, and options for the
installation, removal, and modification of an SAP Crystal Server. Two versions of this guide exist:
SAP Crystal Server Installation Guide for Unix: for use with Unix or Linux operating systems (this
document).
SAP Crystal Server Installation Guide for Windows: for use with Microsoft Windows operating
systems.
2.2 Purpose
This document is intended for system administrators installing SAP Crystal Server. For the latest
information, patches, and other information, visit the SAP BusinessObjects support site:ser
vice.sap.com/bosap-support .
2.3 Integration
SAP Crystal Server is a suite of enterprise-level business intelligence analysis and reporting systems.
The suite will integrate into your existing network, database, authentication, security, and operating
systems. For an overview of the technologies and architecture used in SAP Crystal Server, and how
they can fit into your organization's existing infrastructure, read the SAP BusinessObjects Business
Intelligence Platform Planning Guide.
2012-08-137
Introduction
https://service.sap.com/bosap-supporthttps://service.sap.com/bosap-supporthttps://service.sap.com/bosap-supporthttps://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
8/62
Note:SAP Crystal Server is a variant of the BI platform so the recommendations here are applicable to both
products.
2.4 Constraints
This guide does not describe how to set up a supported host operating system, database, web
application, or web server. If you are planning to use a dedicated database, web application, or web
server, it must be installed and functioning before attempting to install SAP Crystal Server.
2012-08-138
Introduction
7/25/2019 Crs2011 Install Linux En
9/62
Planning
SAP Crystal Server can be installed on Windows or Linux platforms, with a combination of supported
web servers, web application servers, database servers, and web technologies.
You decidehow the components that make upSAP Crystal Server will be deployed. A small development
deployment might use the setup program's default options to install SAP Crystal Server, a database,
and a web application server on a single computer system. A larger scale deployment might install
individual server components on dedicated systems to host individual server functions over a network.
For example: a dedicated host for a web application server; a dedicated host for the SAP Crystal Servercore system; and a dedicated host for the database.
Before installing:
Review your systems to ensure they meet the basic requirements.
For a detailed list of supported environments and hardware requirements, consult the Supported
Platforms Guide available on the SAPCrystal Server support site at service.sap.com/bosap-support.
This document includes specific version and patch-level requirements for web application servers,
web browsers, databases, and operating systems.
When setting up a deployment comprised of two or more hosts, ensure that the hosts can
communicate with each other across the network.
Decide whether to use the included DB2 database server.
If you do not have a database server in place for use with SAP Crystal Server, the installation program
can install and configure one for you. It is recommended that youevaluate your requirements against
information from your database server vendor to determine which supported database would best
suit your organization's requirements.
Note:An existing database must have database user accounts with the appropriate database privileges
ready, and the appropriate drivers must be installed and verified as working. The setup program
attempts to connect to, and initialize, the database as a part of the installation process.
The installation program will only install a database on the local host. It cannot install across a
network.
Decide whether to use the included Tomcat web application server.
If you do not have a web application server system to serve SAP Crystal Server web applications,
the installation program can install and configure one for you. It is recommended that you evaluate
your requirements against information from your web application server vendor to determine which
supported webapplication server wouldbest suit your organization's requirements. To useany other
2012-08-139
Planning
https://service.sap.com/bosap-supporthttps://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
10/62
supported web application server, it must be installed, configured, enabled, and accessible before
you install SAP Crystal Server.
The installation program will only install Tomcat to the local machine. It cannot install to remote
systems across a network. Decide which installation option to use.
The installation program offers three installation options:
1. "Full": install all available components, including a bundled web application server and database
server.
2. "Custom / Expand": select and install all or any of the available components.
3. "Web Tier": install web applications on a dedicated web application server. You can use an
previously installed web application server, or the bundled Tomcat web application server.
Determine the location of the components to be installed.
This includes the specific subnet, machines, database, security, or cluster systems to be used.
For instructions on installing the Mobile BI add-on, see the SAP BusinessObjects Mobile Installation
and Deployment Guide.
3.1 Upgrade support
To upgrade to SAP Crystal Server 2011 Feature Pack 3 , you must install the program, then migrate
settings and content using the Upgrade management tool.
For information on how to upgrade from a previous version, see the SAP Crystal Server Upgrade Guide.
When the installation program detects a previously installed version of SAP Crystal Server, it presents
the option to perform a side-by-side installation, which installs the new version, leaving the previously
installed version intact. A system can host more than one version of SAP Crystal Server, although
system performance may be degraded if both are running at once.
New Features
Features new to this release include:
Lifecycle Management
Mobile Support
Dashboards Server support
Language Support
WDeploy support
2012-08-1310
Planning
7/25/2019 Crs2011 Install Linux En
11/62
3.1.1 Object types and feature requirements
Ensure that the machine on which you run the upgrade management tool has the SAP Crystal Server
features that correspond to the object types that you want to upgrade. The following table lists the
available object types and the features associated with them.
Remember:If a feature is not installed on the machine, the corresponding object type will not be upgraded.
Required featureObject type
BI workspace ServicesBI workspaces (Dashboards)
noneCrystal reports
noneExplorer
Platform Processing ServicesorPlatform
Scheduling Services
Lifecyclemanagement console (LifeCycle Manag-
er) data
Connectivity Processing ServicesUniverses, connections
CMS plugin for MoibleMobile
3.1.2 Product co-existence
Several SAP Crystal Server products can exist on the same host.
Note:All SAP Crystal Server products installed at your organization must have the same patch level. For
example, if your organization upgrades SAP Crystal Server products to a service pack or fix pack, all
add-ons, Client Tools, and stand-alone products must also be upgraded. Similarly, if one product is
downgraded, all other products should also be downgraded.
To install add-on products, ensure that any required server components are present. A dependency
check that identifies missing or outdated components is run by SAP BusinessObjects installation
programs. If a dependency requirement is not met, the installation program identifies and suggests
ways to meet the requirement. An add-on product which requires server components will not install
until the appropriate server components are available.
SAP Crystal Server cannot be installed on the same host as SAP BusinessObjects Business Intelligence
platform.
2012-08-1311
Planning
7/25/2019 Crs2011 Install Linux En
12/62
When installing SAP Crystal Server products, the user has the option to select a custom destination
parent folder, into which the software is installed. Subsequent installations of other SAP Crystal Server
products uses the same folder given for the original installation, and cannot be changed.
If an SAP Crystal Server product is removed from a host, any remaining SAP Crystal Server productinstallation will be unaffected. Any component shared by the both installations will remain, and will only
be removed when the last product that requires the shared component is removed.
Add-on products with dependencies on other products should be removed before the product on which
they depend.
3.2 Web application servers
You can integrate SAP Crystal Server with a Java web application server.
If you do not have a web application server in place for use with SAP Crystal Server, the installation
program can install and configure a Tomcat 6.0 web application server for you. It is recommended that
youevaluate your requirements against information from your webapplicationservervendor to determine
which supported web application server would best suit your organization's requirements.
Note:When configuring a production environment, it is recommended that the web application server is hosted
on a separate system. Running SAP Crystal Server and a web application server on the same host in
a production environment may decrease performance.
If Tomcat 6.0 does not meet your organization's requirements, the following web application servers
are supported:
JBoss
SAP NetWeaver Application Server
Tomcat 7.0
WebLogic
WebSphere
For a detailed list of supported web application servers, versions, and patch levels, consult the Supported
Platforms Guideavailable athttp://service.sap.com/bosap-support.
Note:
To use a supported web application server other than the bundled version of Tomcat 6.0, it must berunning and accessible before you attempt to install.
The "Web Tier" option installs only web applications to a supported Java web application server.
This is useful for deploying web applications to nodes in a web application server cluster.
2012-08-1312
Planning
http://service.sap.com/bosap-support/http://service.sap.com/bosap-support/7/25/2019 Crs2011 Install Linux En
13/62
3.3 Web servers
You can use a dedicated web server to host static web content, such as images, HTML, or multimedia
files. This is known as a split deployment. Split deployments increase the performance of the web
application server as it no longer needs to serve static content, and returns dynamic content only when
required.
The WDeploy tool is able to separate static dynamic content for deployment to separate web and web
application servers. For more information on split deployments, see the SAP BusinessObjects Business
Intelligence Platform Web Application Deployment Guide.
The web and web application servers can run on the same machine, or on separate machines across
a network. SAP Crystal Server supports the following combinations of web servers and web application
servers:
Apache 2.2 web server with Tomcat (6.0.20 or newer) or (7.0.8 or newer)
Apache web server with WebLogic 10.x
IBM IHS web server 6 with WebSphere 6.1 (6.1.0.7 or newer)
IBM IHS web server 7 with WebSphere 7.0 (7.0.0.11 or newer)
Apache 2.2 web server with Tomcat (6.0.20 or newer) or (7.0.8 or newer)
Apache web server with WebLogic 10.x
IBM IHS web server 6 with WebSphere 6.1 (6.1.0.7 or newer)
IBM IHS web server 7 with WebSphere 7.0 (7.0.0.11 or newer)
For a detailed list of supported web servers, versions, and patch levels, consult the Supported PlatformsGuideavailable athttp://service.sap.com/bosap-support.
3.4 Database servers
If you do not have a database server in place for use with SAP Crystal Server, the installation program
can install and configure one for you. It is recommended that you evaluate your requirements against
information from your database server vendor to determine which supported database would best suit
your organization's requirements.IBM DB2 is the default database server. Any other database server must be running and accessible
when you run the installation program. SAP Crystal Server also supports the following database servers:
MySQL
Oracle
MaxDB
Sybase
2012-08-1313
Planning
http://service.sap.com/bosap-support/http://service.sap.com/bosap-support/7/25/2019 Crs2011 Install Linux En
14/62
Note:The database client and server must use the Unicode character set.
For a list of supported database versions, revision levels, and requirements, consult the Supported
Platforms Guide, available athttp://service.sap.com/bosap-support.
2012-08-1314
Planning
http://service.sap.com/bosap-support/http://service.sap.com/bosap-support/7/25/2019 Crs2011 Install Linux En
15/62
Preparation
This section details how to prepare for the installation of SAP Crystal Server.
Process Flow
1. Ensure that sufficient disk space is available. Allow for both the operating system and the software
to grow over time as patches or new components become available.
2. Gather the installation media or download the latest release and any patches or service packs from
the support portal athttp://service.sap.com/bosap-support.
To download SAPCAR, go to http://service.sap.corp/bosap-support>Software Downloads>Support Packages and Patches>Browse our Download Catalog>SAP Technology
Components>SAPCAR.
To download SAP HOST AGENT, go to http://service.sap.corp/bosap-support>Software
Downloads>Support Packages and Patches>Browse our Download Catalog>SAP
Technology Components>SAP HOST AGENT
3. Decide which options you will want to change during the installation process. In most cases, you
can accept the default values. More advanced installations require that you plan the installation
process. The installation program prompts for the following information:
License information(the name of theuser and company associated with your SAPCrystal Server
license).
Web application server configuration, including type, connection, and authentication details. Database server configuration, including type, connection, and authentication details.
CMS system and Auditing Data Store configuration information, including type, connection, and
authentication details.
Folder where SAP Crystal Server will be installed.
Central Management Console (CMC) administrator account password and cluster key.
CMS port number to receive incoming connections.
Server Intelligence Agent (SIA) name.
Server Intelligence Agent (SIA) port number for incoming connections.
SAP Solution Manager Diagnostics (SMD) configuration.
CA Wily Introscope Enterprise Manager configuration.
Subversion or ClearCase version control system configuration to store configuration files. Lifecycle management (LCM) configuration.
Installation type and components ("Full", "Custom / Expand", "Web Tier").
2012-08-1315
Preparation
http://service.sap.com/bosap-supporthttp://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
16/62
4.1 System requirements
Use the following guidelines when you install SAP Crystal Server:
Ensure that the operating system is supported. Only 64-bit operating systems are supported.
Before you run the installation program, ensure that the destination partition has enough room for
the deployment to expand (when updates and new features are added in the future).
If you install the deployment on the operating system partition, ensure that there is enough room for
the deployment and the operating system. It is recommended that you have at least 2 gigabytes
available for temporary files and web applications.
If you have previously installed any SAP BusinessObjects products, the installation program uses
the existing directory.
For a detailed list of supported operating systems and hardware requirements, consult the Supported
Platformsdocumentation available athttp://service.sap.com/bosap-support.
4.1.1 Account permissions
To install SAP Crystal Server on a Unix or Linux host, a user must have the following permissions:
2012-08-1316
Preparation
http://service.sap.com/bosap-support/http://service.sap.com/bosap-support/7/25/2019 Crs2011 Install Linux En
17/62
Required accessCategory
Permission to read, write, and execute scripts in the destination directory.
For a system install, root access is required (the installation program creates
start-up run control scripts in /etc/rcthat start or stop the servers when thehost machine is started or stopped).
Operating system
Network connectivity through appropriate ports to all machines in the deploy-
ment.
Access to shared file system directories.
Appropriate network authentication privileges.
Network
Permission for the SAP BusinessObjects user account to create, edit, and
drop tables.
Permission for the SAPBusinessObjects user account to create storedproce-
dures (required by the Central Management Server (CMS) system database).
Database
4.1.1.1 Additional Unix and Linux requirements
User account
Create a user account and group under which the software's background processes can run. Use this
account to perform the installation and run the software. The account does not require root privileges.
Locale
Before you install, set the installing account's environment to use a supported UTF-8 locale and ensure
that your console software supports UTF-8 character sets. To ensure that your operating system uses
the correct locale, set the LC_ALLandLANGenvironment variables to your preferred locale in your
login environment.
For example, the followingbashshell commands set the locale to the United States English UTF-8
locale:
export LANG=en_US.utf8export LC_ALL=en_US.utf8
Tip:
Typelocaleto check that all of the related locale environment variables (such as LC_MONETARY,LC_NUMERIC) were properly set by LC_ALL.
For a detailed list of supported Unix and Linux environments, see the Supported Platforms guide
available on the SAP Crystal Server support site service.sap.com/bosap-support.
2012-08-1317
Preparation
https://service.sap.com/bosap-supporthttps://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
18/62
Commands
In order for the installation program to run correctly, the following utilities must be installed on your
system and available on the path:
touchreadpwd/bin/sh
sedhostnameexpruname
tailgrepchownawk
gzipdirnameidtar
pingwhichulimitstty
If one of them is not available on your system, install a version from your operating system vendor
rather than a third-party vendor (such as the GNU project).
Note:The output from a GNU version of a utility can differ significantly from the version provided by your
operating system vendor. To prevent the installation program from encounteringoutput in an unexpected
format, ensure that no GNU utilities are used in the installing user account's environment.
Installations
A new installation can be one of two different types.
User installation
The installed software is owned by the account that was used to run the installation program. This
account must be used to start and stop the servers. Access to the root user account is not required
to perform a user installation, and installation program will exit if it detects that it is being run as root.
System installation
A system installation is a finished user installation with system startup and shutdown run control
scripts added. These scripts automatically start and stop SAP Crystal Server server functions as
the operating system starts up or shuts down. The script to install the run control scripts must be
run with root privileges after a user installation has completed.
4.1.2 Network permissions
When you install SAP Crystal Server across multiple machines, use the following guidelines to ensure
your network functions properly:
Servers running on all hosts must be able to communicate with each other.
Each machine must be able to communicatewith thewebapplicationserver, theCentral Management
Server (CMS) host, all SIA hosts, and clients.
2012-08-1318
Preparation
7/25/2019 Crs2011 Install Linux En
19/62
On any host with more than one network interface card (NIC), ensure that the primary NIC is routable
before running the installation program. If the primary NIC is not routable, you will have to re-configure
the networking settings after the installation. For information on how to bind to routable NICs, see
the Managing and Configuring Servers chapter of the SAP BusinessObjects Business Intelligence
Platform AdministratorGuide. Each machine must use a fixed hostname. Fully-qualified hostnames are supported.
Note:Ensure that deployment hostnames do not include any of the following characters: underscore (_),
period (.), backslash (\), or forward-slash (/).
If you run the installation program behinda firewall, see the Securing SAP BusinessObjects business
intelligenceplatform chapterof the SAP BusinessObjects Business Intelligence Platform Administrator
Guide.
4.1.2.1 Choosing a server location
When planning a distributed installation, consider the latency between servers. To maintain high CMS
performance, place your CMS on the same subnet as the CMS system and Auditing Data Store database
servers.
The CMS can also be clustered, so that CMS server processes run on different host systems in the
cluster. When creatinga CMS cluster, ensure that each machine experiences thesame network latency
to the CMS system or Auditing Data Store.
Consult the Managing and Configuring Servers section of the SAP BusinessObjects Business
Intelligence Platform Administrator Guidefor more information on clustering CMS server processes.
4.2 Preparing the CMS system or Auditing Data Store database
To use a database server other than the database bundled with SAP Crystal Server, the following tasks
must be completed before installing SAP Crystal Server.
Create a database (or tablespace or schema, if applicable to your database), and account to store
CMS configuration and system information. A second tablespace or scheme is required to hold
auditing information. Record the database, tablespace, and account information so you can enterthe details when prompted by the SAP Crystal Server installation program.
Caution:If you have an existingSAP Crystal Server installation, you must create a fresh database and migrate
existing content after the install is complete.
Ensure that your databaseserver is configured to useUnicode character encoding (such as UTF-8).
2012-08-1319
Preparation
7/25/2019 Crs2011 Install Linux En
20/62
Ensure that the databaseaccounts have privileges to create, modify, and delete tables, and to create
stored procedures.
When using a database server on a network, the appropriate database client drivers must be installed
and verified as working before installing SAP Crystal Server. Contact your database administrator
to establish which drivers are required for your database.
During your installation, you will be prompted for the connection and authentication credentials so that
the installation program can initialize the database. The table below shows which information is required
for supported databases:
Information required by installation programDatabase
MySQL database name
Server hostname
Port number (default is 3306)
Account username
Account password "Reset existing database" checkbox (recommended setting)
MySQL
DB2 Alias name
Account username
Account password
"Reset existing database" checkbox (recommended setting)
IBM DB2
Oracle TNSNAME connection identifier
Account username
Account password
"Reset existing database" checkbox (recommended setting)
Oracle
Database name
Server hostname
Port number (default is 7210)
Account username
Account password
"Reset existing database" checkbox (recommended setting)
MaxDB
2012-08-1320
Preparation
7/25/2019 Crs2011 Install Linux En
21/62
Information required by installation programDatabase
Service name
Note:
The Sybase service name is a combination of the hostname and the port
number, set by your database administrator in the sql.iniand interfaces
files.
SAP Crystal Server will connect to the default database for the user you
specify. The default is set by the database administrator.
Account username
Account password
"Reset existing database" checkbox (recommended setting)
Sybase
4.2.1 Extra requirements for IBM DB2
IBM DB2 has requirements that must be met before installing either SAP Crystal Server with the
integrated IBM DB2 database, or your own IBM DB2 database.
If you plan to use the integrated IBM DB2 database bundled with SAP Crystal Server, or you plan to
install and use your own IBM DB2 database server for use with SAP Crystal Server:
Ensure that the ID of the user account used to host the DB2 database meets the following
requirements from IBM. For more information an IBM's requirements for Unix or Linux systemshosting DB2, see DB2 users and groups (Linux and UNIX)in the Database Fundamentalssection
of the DB2 Solution Information Center athttp://www.ibm.com/support.
Must have a primary group other thanguests,admins,users, orlocal
Can include only lowercase letters (a-z), numbers (0-9), or the underscore character (_)
Cannot be longer than eight characters
Cannot begin with IBM, SYS, SQL, or a number
Cannot be a DB2 reserved word (USERS,ADMINS,GUESTS,PUBLIC, orLOCAL), or an SQL
reserved word
Cannot use any user IDs withrootprivilege for the DB2 instance ID, DAS ID, or fenced ID.
Cannot include accented characters
If existing user IDs are specified instead of creating new user IDs, ensure that the user IDs:
Are not locked
Do not have expired passwords
The primary group of the user must meet the following requirements:
Cannot be one ofguests,admins,users, orlocal
Cannot start withsqloribm
2012-08-1321
Preparation
http://www.ibm.com/supporthttp://www.ibm.com/support7/25/2019 Crs2011 Install Linux En
22/62
Cannot start with a number
Must contain only lowercase letters (a-z), or numbers (0-9) .
If you plan to install and use an IBM DB2 database server for use with SAP Crystal Server:
Ensure that the DB2 database is created with the following settings:
Collating Sequence = "Identity"Codeset = "UTF-8"Territory = "XX"
ReplaceXXwith the code that is appropriate for your location. Consult your DB2 documentation for
more information. If your DB2 database does not have the Collating Sequence = "Identity"
setting, the user and user group objects may not sort as expected in the CMC.
Create a user temporary table space before installing SAP Crystal Server. If you do not create a
user temporary table space, theSAPCrystal Server installationprogramwill not be able to configure
the DB2 database.
For more information on user temporary table spaces in IBM DB2, see DB2 Basics: Table spaces
and buffer poolsin the IBMtechnical library: http://www.ibm.com/developerworks/data/library/techar
ticle/0212wieser/0212wieser.html .
When using IBM DB2 to host an Auditing Data Store database, ensure that the page size for the
auditing table space is set to a minimum of 8192 (8 KB).
Ensure that the CMS system database is not partitioned. The Auditing Data Store database may be
partitioned.
4.2.1.1 Interprocess Communications (IPC) settings when using the bundled DB29.7 FP1 database
The database bundled with SAP Crystal Server is IBM DB2 9.7 FP1. If using the bundled database,
prior to installation, ensure the following IPC parameters have been set with a value equal to or greater
than the following minimum values:
2012-08-1322
Preparation
http://www.ibm.com/developerworks/data/library/techarticle/0212wieser/0212wieser.htmlhttp://www.ibm.com/developerworks/data/library/techarticle/0212wieser/0212wieser.htmlhttp://www.ibm.com/developerworks/data/library/techarticle/0212wieser/0212wieser.htmlhttp://www.ibm.com/developerworks/data/library/techarticle/0212wieser/0212wieser.html7/25/2019 Crs2011 Install Linux En
23/62
Enforce minimum settingIPC kernel parameter
1 073 741 824 (64-bit kernel)kernel.shmmax (SHMMAX)
1 024kernel.sem (SEMMNI)1 024kernel.msgmni (MSGMNI)
65 536kernel.msgmax (MSGMAX)
65 536kernel.msgmnb
4.2.2 Extra requirements for Sybase
If you are using Sybase for the CMS or auditing database:
Create a database with a page size of 8 KB. The Sybase database default page size is 2KB, which
is too small for the CMS system database to run efficiently. The page size is set up during the
database creation and cannot be changed after the database is created.
Use a Unicode character set, such as UTF-8.
4.3 Set ulimit to unlimited
To successfully build and deploy SAP Crystal Server web applications, the host operating system or
user accountulimitsetting must be configured asunlimited.
Set theulimitconfiguration with theulimitcommand, or modify the system configuration file
/etc/security/limits.conf . For more information about the ulimitsetting, see the
documentation included with your operating system.
4.4 Final checklist
Prior to installing SAP Crystal Server, review the following checklist.
Have you decided on the installation destination folder?
Note:
The use of Unicode characters in the destination folder is not supported.
2012-08-1323
Preparation
7/25/2019 Crs2011 Install Linux En
24/62
Ensure that the installation destination folder is not the same folder in which the installation
program has been extracted (do not install to the current working directory when running the
installation program from the current working directory).
Have you verified appropriate network connectivity between all machines that will be part of yourdeployment?
If you are using your own database server:
Have you created a database, tablespace (if required), and accounts for the CMS system and
Auditing Data Store databases?
Have you made sure you can log onto the database from the SAP Crystal Server host?
If you are using DB2 or Sybase, have you verified that your database was created with the correct
settings? (Some settings can't be modified after the database has been created.)
Has the database client software been properly configured?
If you are using your own web application server:
Have you decided on which web application server to use? Has the server already been installed and configured?
Have you ensured that your existing web application server has the required JDK installed?
2012-08-1324
Preparation
7/25/2019 Crs2011 Install Linux En
25/62
Installation
There are two different methods of running the installation program for SAP Crystal Server:
Interactive installation
An interactive wizard prompts for all information related to the installation. Use this option to select
individual installation options from a series of screens. This is the default installation method.
Silent installation
Installation options are given on the command-line, which override the installation program's defaultvalues. The command-line can be used to give some or all installation options. When an installation
option is not given on the command-line, the installation program uses a default value.
Installation options can be given in a response file rather than directly on the command-line. This
type of silent installation uses the -rcommand-line parameter to read installation options from the
response file. Use this option if you want to install multiple machines with the same configuration.
Installation options stored in a response file can be overridden by giving them on the command-line.
When the-q(quiet mode) switch is used, the installation program does not prompt for any user
input during the installation.
If the installation program encounters an unexpected condition, and is unable to continue, it will undo
any work completed up to that point, and return the system to the state that it was in before the installationstarted.
5.1 To download the installation program
1. Go tohttps://service.sap.com/bosap-support>Software Downloads.
2. On the "Find your software" tab, under the "AZ Index", selectInstallations and Upgrades.
3. SelectC>Crystal Server>Crystal Server 2011.
4. SelectInstallation and Upgradeand then select your platform.
5. Select all of theobjects titled"SBOP BI PLATFORM SERVER" plus anyadditional add-on
products you require, then follow the instructions on the website to download and extract the objects.
Note:The software may take a long time to download, and you may need to contact the system administrator
to ensure your company's firewall will not terminate the download process.
2012-08-1325
Installation
https://service.sap.com/bosap-supporthttps://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
26/62
Support Packages and Patches are installation programs that contain updates to BI platform software.
You can download them fromhttps://service.sap.com/bosap-support>Software Downloads. On the
"Find your software" tab, under the "AZ Index", click Support Packages and Patches. For more
information on installing Support Packages and Patches, see the SAP BusinessObjects Business
Intelligence Platform Upgrade Master Guide.
5.2 To run an interactive installation
Load, mount, or download the SAP Crystal Server installation media. Ensure that LC_ALL has been
set to a supported UTF-8 character set, such as en_US.utf8. For example:
export LANG=en_US.utf8export LC_ALL=en_US.utf8
The installation log file will be saved to /InstallData/logs//InstallDU.log.
1. Change directory to the folder containing thesetup.shinstallation program.
Use the InstallDir=parameter to set the destination folder from the
command line. Forexample, to install SAPCrystal Server into the folder/opt/sap, use the command
./setup.sh InstallDir=/opt/sap.
2. Choose a language for the setup program to use during the installation process. The language
setting is used by the installation program to display information to you in the language of your
choice. If you select a non-English language, the corresponding language pack is automatically
installed on the server.
Note:The installation program will automatically run in the same language as your operating system. The
language used by the installation program will determine thenames used for components configured
by the installation program. These names cannot be changed later and are not affected by language
settings once the installation is complete.
3. Review the destination folder shown. This is the folder into which the installation program will install
SAP Crystal Server. If the folder does not exist, the installation program creates it.
Note:
The use of Unicode characters in the destination folder is not supported.
Ensure that the destination folder is not the same folder in which the installation program has
been extracted (do not install to thecurrent working directory when running the installationprogram
from the current working directory).
4. The installation program checks for required components and conditions. Review the results and
decide whether to continue with the installation, or abort and correct any unmet requirements.
If a dependency prerequisite condition is critical, the installation program will not allow the installation
to proceed. If the missing or unsupported component is optional, you have the option to either
continue with the installation or stop and correct the condition.
5. Review the installation welcome screen.
2012-08-1326
Installation
https://service.sap.com/bosap-supporthttps://service.sap.com/bosap-support7/25/2019 Crs2011 Install Linux En
27/62
6. Review and accept the license agreement.
7. Enter theproduct keycode. The product keycode wasgiven to youwhen youpurchased SAPCrystal
Server. Store the keycode and registration information in a safe place in case you need to re-install.
8. To install support for a language, select it from the list.
Note:Carefully consider which languages need to be installed for your organization. To add or remove
language support later requires that you remove and re-install SAP Crystal Server.
The language currently being used by the operating system is selected automatically. English
language support cannot be deselected because SAP Crystal Server falls back to using English if
a problem is detected with an individual language.
9. Select one of the following install type options:
User install
A user installation causes the installation program to install the software as a self-contained
package within a directory, where the software must be started and stopped manually from the
command-line.
System install
A system installation causes the installation program to install start-up and shutdown scripts in
the run control (rc) folder of the operating system (/etc/rcor similar) so that the software will
start and stop automatically with the operating system.
Note:A system installation requires root user privileges.
The "Choose Install Type" screen appears.
5.2.1 To select an install type
SAP Crystal Server requires a database server and web application server to function. If you do not
have an existing database, the installation program can automatically install and configure an IBM DB2
database. If youdo nothave an existing webapplicationserver, the installationprogram canautomatically
install and configure a Tomcat web application server.
The "Choose Install Type" screen is used to select the installation component options.
1. Select one of the following install type options:
Full
Installs all required server components onto a single machine. Use this option to create a
single-host deployment, such as a pre-production development or test environment.
Custom / Expand Install
Allows experienced users to select individual components. Use this option:
2012-08-1327
Installation
7/25/2019 Crs2011 Install Linux En
28/62
When distributing server components between more than one host, such as creating a CMS
cluster.
When you want full control over which components are deployed to a host.
Web Tier
The web tier hosts web applications and serves content to users over the web. Use the Web
Tierinstallation option to install Java web applications onto a dedicated Java web application
server.
If you do not have a web application server in place for use with SAP Crystal Server, the installation
program can install and configure a Tomcat web application server for you. It is recommended
that youevaluate your requirements against information from your web application servervendor
to determine which supported web application server would best suit your organization's needs.
If you already have a supported web application server installed, you can deselect the option to
install Tomcat, and only install the Java web applications
2. Proceed to the next screen to start configuring the selected installation.
You may return to the install type options screen at any time later.
3. If you selected a "Full" installation, proceed to the followingFullsection.
4. If you selected a "Custom / Expand" installation, proceed to the followingCustom / Expandsection.
5. If you selected a "Web Tier" installation, proceed to the followingWeb Tiersection.
5.2.1.1 Full Installation of Crystal Server
The following steps are performed for full installations of SAP Crystal Reports Server.
1. A database is required to store Central Management Server (CMS) configuration and run-time
information. A second database is required for Auditing Data Store (ADS) information.
If you do not have a database server in place for use with SAP Crystal Server, the installation program
can install and configure one for you. It is recommended that youevaluate your requirements against
information from your database server vendor to determine which supported database would best
suit your organization's needs.
To install the bundled database server, select Install and use the default database.
IBM DB2 will be installed and configured to store Central Management Server (CMS) and auditing
data.
To use an existing supported database server, select Use an existing database server. The
installation program prompts for information on the database type and connection credentials for
both the CMS system and Auditing Data Store databases.
Note:An existing database must have user accounts with the appropriate privileges ready, and the
appropriate drivers must be installed and verified as working. The installation program attempts to
connect to, and initialize, the database as a part of the installation process.
2012-08-1328
Installation
7/25/2019 Crs2011 Install Linux En
29/62
2. If you selected Use an existing database server:
a. Select the database type to use for the CMS database.
b. Select the database type to use for the Auditing database (Auditing Data Store).
If you do not want to use the auditing feature, selectNo Auditing Database.
3. A Java web application server is required to host SAP Crystal Reports Server 2011 Feature Pack
3 web applications.
If you do not have a web application server in place for use with SAP Crystal Reports Server 2011
Feature Pack 3, the installation program can install and configure a Tomcat web application server
for you. It is recommended that you evaluate your requirements against information from your web
application server vendor to determine which supported web application server would best suit your
organization's needs.
Note:When configuring a production environment, it is recommended that the web application server is
hosted on a separate system. Running SAP Crystal Reports Server 2011 Feature Pack 3 and a web
application server on the same host in a production environment may decrease performance.
Note:This release of SAP Crystal Server does not support the automatic deployment of web applications
to any web application server other than the bundled Tomcat web application server. To deploy web
applications to a different supported web application server, use the WDeploy tool. For more
information, see the SAP BusinessObjects Business Intelligence platform Web Application Deployment
Guide.
To use the bundled Tomcat Java web application server, select Install Tomcat application server
and automatically web applications and services to it.
To manually deploy web applications to an existing supported Java web application server later,
using the WDeploy tool, select Manually deploy to a preinstalled web application server.If you have already set up a Java web application server, or you only require support for the Central
Management Server (CMS) or BI launchpadapplications, select Install Web Application Container
Server and automatically deploy web applications and services to it.
4. Decide whether to install and use the Subversion version control system to keep track of configuration
versions with the SAP Lifecycle Manager. To use an existing version control system, you must
manually configure the Lifecycle Manager after the installation is complete.
Lifecycle Manager stores each configuration change in a version control system, making it easier
to revert to a previous configuration when needed.
5. Enter a name and port number for the SystemIntelligence Agent (SIA) node. The name must consist
of English alphanumeric characters (A-Z, a-z, and 0-9) and contain no spaces or other punctuation.
The SIA name cannot start with a number.This is the name that you will see in the Central Configuration Manager (CCM). Many CMS servers
can be managed by a single SIA.
The port is used for the SIA to listen for incoming connections from the CMS. The SIA must be able
to receive incomingconnections on this port, so ensure that your firewall is configured appropriately.
Port 6410 is a standard TCP/IP port number reserved for use with an SAP Crystal Server SIA.
2012-08-1329
Installation
7/25/2019 Crs2011 Install Linux En
30/62
6. Review the default value for the Central Management Server (CMS) port number. This is the port
on which the CMS listens for incoming connections from the web application server, web server (if
applicable), other CMS nodes (if applicable) and servers. The CMSmust be able to receive incoming
connections on this port, so ensure that your firewall is configured appropriately.
Port 6400 is a standard TCP/IP port number reserved for usewith SAP Crystal Server CMS systems.
7. Enter and confirm the CMS Administrator account password and the CMS cluster key.
Note:The CMS Administrator is a super-user account in the SAP Crystal Reports Server 2011 Feature
Pack 3 authenticationsystem, used only to administer your SAPBusinessObjects serverconfiguration.
It is not part of any operating system or single sign-on authentication system.
Communication between some CMS components is encrypted to provide a higher level of security
when using clusters.
8. Configure the CMS system database.
a. If you chose to install the bundled database, the installation program uses your choices to install
and configure the database for use with SAP Crystal Server.
Enter the port number for DB2 to listen for incoming database queries. The DB2 database must
be able to receive incoming connections on this port, so ensure that your firewall is configured
appropriately.
b. If you deselected the Integrated Databaseoption in the feature list, enter the connection
information for an existing database to use for the CMS system database.
c. If youdeselected the Integrated Database option in the feature list, and you plan to use auditing,
enter the connection information for the Auditing Data Store (ADS) database.
9. Decide whether to start the servers as soon as the installation is complete. If you do not start the
servers after the installation process is complete, the servers must be started manually with the
Central Configuration Manager (CCM).10.Configure the web application server.
If you selected Tomcat 6.0 in the feature list, review the default values for the web application server
connection port number, the shutdown port number, and the redirect port number.
TheConnection portis the port on which the web application server listens for incoming
connections from web clients.
TheShutdown portallows the web application to be shut down remotely.
TheRedirect portenables redirects to secure web connections.
11. If youchose to install thebundledSubversion version control systemforusewith Lifecycle Manager,
confirm the port number and enter and confirm a password for SAP Crystal Server to use when
accessing the Subversion repository.
12.SAP Crystal Server can integrate with your organization's deployment of SAP Solution Manager
Diagnostics (SMD). If your organization uses SAP SMD, selectConfigure connectivity to SAP
SMD Agent. You will be prompted for information. If you chose not to configure SMD at this time,
you can configure SMD Agent in the Central Management Console (CMC) "Placeholders" screen
later.
Note:Touse SAP Solution Manager Diagnostics (SMD), SAP Host Agent and SMD Agent must be installed:
2012-08-1330
Installation
7/25/2019 Crs2011 Install Linux En
31/62
For information on installing the SAP Host Agent before SAP Crystal Reports Server 2011 Feature
Pack 3, see "To enable SAP System Landscape Directory (SLD) support".
For information on installing the SAP Host Agent after SAP Crystal Reports Server 2011 Feature
Pack 3 , see "To configure System Landscape Directory (SLD) Data Supplier (DS) post
installation".
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with SMD, enter the SMD Agent hostname and port number.
13.SAP Crystal Server can integrate with your organization's deployment of CA Wily Introscope
Enterprise Manager. If your organization uses Introscope Enterprise Manager, select Integrate
connectivity to Introscope Enterprise Manager. You will be prompted for information.
Note:
To use CA Wily Introscope Enterprise Manager, SMD Agent must be installed: For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with Introscope Enterprise Manager, enter the hostname and port number
for the Introscope Enterprise Manager server.
The "Start Installation" screen appears. Click "Next" to install.
Proceed to While the installation program runs.
5.2.1.2 Custom / Expand installation
The following steps are performed forCustom / Expandinstallations of SAP Crystal Server.
The "Select Features" screen displays selectable components that can be installed.
1. Review the list of features to install. Only features with a selected checkbox are installed.
Features are grouped under the following headings:
Web Tier
The web tier components serve content to web browsers.
If you do not have a web application server in place for use with SAP Crystal Server, the installation
program can install and configure a Tomcat web application server for you. It is recommended
that youevaluate your requirements against information from your web application servervendor
to determine which supported web application server would best suit your organization's needs.
If you already have a supported web application server installed, you can deselect the option to
install Tomcat, and only install the Java web applications
2012-08-1331
Installation
7/25/2019 Crs2011 Install Linux En
32/62
Servers
Server features include the Business Intelligence platform servers (such as processing and
scheduling servers), major system components (such as the CMS, Event Server, bundled
database, and a version control system).
Administrator Tools
The Administrator Tools features help administrators maintain an installation.
Note:If you plan to use the upgrade management tool to upgrade objects from an older version of SAP
Crystal Server, see "Object types and feature requirements".
Database Access
To access, analyze, and report on the data in your organization's existing databases, select the
appropriate Database Accessfeatures. If your organization does not use a particular database,
you can deselect it.
Samples
The samples features installs sample reports, templates, and reporting databases. If you do not
need samples, you can deselect it.
2. Select the type of installation being performed.
If you are installing a stand-alone server, or the first server in a cluster, selectStart a new SAP
Crystal Server deployment. If you already have a CMS and want to create a new server as part
of a cluster, select Expand an existing SAP Crystal Server deployment.
If you selectedStart a new SAP Crystal Server deploymenton the last screen, proceed to Custom
(New) installation.
If you selectedExpand an existing SAP Crystal Server deploymenton the last screen, proceed to
Custom (Expand) installation.
5.2.1.2.1 Custom (New) installation
If you chose theStart a new SAP Crystal Server deploymentoption for a "Custom / Expand"
installation:
1. If you deselected the Integrated Databaseoption in the feature selection screen:
a. Select the type of database to use for the CMS system database.
b. Select the type of database to use for the Auditing Data Store (ADS) database. If you do not
want to use auditing, selectNo Auditing Database.
Note:An existing database must have database user accounts with the appropriate database privileges
ready, and the appropriate drivers must be installed and verifiedas working. The installation program
attempts to connect to, and initialize, the database as a part of the installation process.
2012-08-1332
Installation
7/25/2019 Crs2011 Install Linux En
33/62
2. Enter a name and port number for the SystemIntelligence Agent (SIA) node. The name must consist
of English alphanumeric characters (A-Z, a-z, and 0-9) and contain no spaces or other punctuation.
The SIA name cannot start with a number.
This is the name that you will see in the Central Configuration Manager (CCM). Many CMS serverscan be managed by a single SIA.
The port is used for the SIA to listen for incoming connections from the CMS. The SIA must be able
to receive incomingconnections on this port, so ensure that your firewall is configured appropriately.
Port 6410 is a standard TCP/IP port number reserved for use with an SAP Crystal Server SIA.
3. Review the default value for the Central Management Server (CMS) port number. This is the port
on which the CMS listens for incoming connections from the web application server, web server (if
applicable), other CMS nodes (if applicable) and servers. The CMSmust be able to receive incoming
connections on this port, so ensure that your firewall is configured appropriately.
Port 6400 is a standard TCP/IP port number reserved for usewith SAP Crystal Server CMS systems.
4. Enter and confirm the CMS Administrator account password and the CMS cluster key.
Note:The CMS Administrator is a super-user account in the SAP Crystal Server authentication system,
used only to administer your server. It is not part of any operating system or single sign-on
authentication system.
Communication between some CMS components is encrypted, to provide a higher level of security
when using clusters.
5. Configure the CMS system database.
a. If you chose to install the bundled database, the installation program uses your choices to install
and configure the database for use with SAP Crystal Server.
Enter the port number for DB2 to listen for incoming database queries. The DB2 database must
be able to receive incoming connections on this port, so ensure that your firewall is configuredappropriately.
b. If you deselected the Integrated Databaseoption in the feature list, enter the connection
information for an existing database to use for the CMS system database.
c. If youdeselected the Integrated Database option in the feature list, and you plan to use auditing,
enter the connection information for the Auditing Data Store (ADS) database.
6. Decide whether to start the servers as soon as the installation is complete. If you do not start the
servers after the installation process is complete, the servers must be started manually with the
Central Configuration Manager (CCM).
7. Configure the web application server.
If you selected Tomcat 6.0 in the feature list, review the default values for the web application server
connection port number, the shutdown port number, and the redirect port number.
TheConnection portis the port on which the web application server listens for incoming
connections from web clients.
TheShutdown portallows the web application to be shut down remotely.
TheRedirect portenables redirects to secure web connections.
2012-08-1333
Installation
7/25/2019 Crs2011 Install Linux En
34/62
8. If youchose to install thebundledSubversion version control systemforusewith Lifecycle Manager,
confirm the port number and enter and confirm a password for SAP Crystal Server to use when
accessing the Subversion repository.
9. SAP Crystal Server can integrate with your organization's deployment of SAP Solution ManagerDiagnostics (SMD). If your organization uses SAP SMD, selectConfigure connectivity to SAP
SMD Agent. You are prompted for information. If you chose not to configure SMD at this time,
you can configure SMD Agent in the Central Management Console (CMC) "Placeholders" screen
later.
Note:Touse SAP Solution Manager Diagnostics (SMD), SAP Host Agent and SMD Agent must be installed:
For information on installing the SAP Host Agent before SAP Crystal Server, see "To enable
SAP System Landscape Directory (SLD) support".
For information on installing the SAP Host Agent after SAP Crystal Server, see "To configure
System Landscape Directory (SLD) Data Supplier (DS) post installation".
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with SAP Solution Manager Diagnostics (SMD), enter the SMD Agent
hostname and port number.
10.SAP Crystal Server can integrate with your organization's deployment of CA Wily Introscope
Enterprise Manager. If your organization uses Introscope Enterprise Manager, select Integrate
connectivity to Introscope Enterprise Manager. You are prompted for information.
Note:To use CA Wily Introscope Enterprise Manager, SMD Agent must be installed:
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution ManagerDiagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with Introscope Enterprise Manager, enter the hostname and port number
for the Introscope Enterprise Manager server.
The "Start Installation" screen appears. Click "Next" to install.
Proceed toWhile the installation program runs.
5.2.1.2.2 Custom (Expand) installation
If you chose the Expand an existing SAP Crystal Server deployment option for a "Custom / Expand"
installation:
1. The expand host must be able to connect to the CMS database. Select the type of server used for
the CMS system database.
The installation program prompts for information on the CMS database type and connection
credentials.
2012-08-1334
Installation
7/25/2019 Crs2011 Install Linux En
35/62
Note:The appropriate drivers must be installed and verified as working on the expand host.
2. Enter a name and review the port number for the System Intelligence Agent (SIA) node. The name
must consist of English alphanumeric characters (A-Z, a-z, and 0-9) and contain no spaces orpunctuation. The SIA name cannot start with a number.
This is the name that you will see in the Central Configuration Manager (CCM). Many CMS servers
can be managed by a single SIA.
The port is used for the SIA to listen for incoming connections from the CMS. The SIA must be able
to receive incomingconnections on this port, so ensure that your firewall is configured appropriately.
Port 6410 is a standard TCP/IP port number reserved for use with a SAP Crystal Server SIA.
3. Enter connection information for the existing CMS.
This includes the hostname and port number of the primary CMS. Fully qualified domain names are
supported.
4. Enter and confirm a value for the CMS cluster key.Communication between some CMS components is encrypted to provide a higher level of security.
5. Review the default value for the new Central Management Server (CMS) port number. This is the
port on which the new CMS listens for incoming connections from the web application server, web
server (if applicable), other CMS nodes (if applicable)and servers. TheCMSmust be able to receive
incoming connections on this port, so ensure that your firewall is configured appropriately.
Port 6400 is a standard TCP/IP port number reserved for usewith SAP Crystal Server CMS systems.
6. If you are installing the bundled database, enter a database administrator account password and
an Enterprise user account name and password. If you are using a previously installed database,
enter connection credentials for the CMS to connect to the database.
The installation program uses your choices to install, configure the database for use with SAP Crystal
Server.
7. Decide whether to start the servers as soon as the installation is complete. If you do not start the
servers after the installation process is complete, the servers must be started manually with the
Central Configuration Manager (CCM).
8. Review the default values for the web application server connection port number, the shutdown port
number, and the redirect port number. The web application server must be able to receive incoming
connections on these ports, so ensure that your firewall is configured appropriately.
TheConnection portis the port on which the web application server listens for incoming
connections from web clients.
TheShutdown portallows the web application to be shut down remotely.
TheRedirect portenables redirects to secure web connections.
9. Review the port number and provide a password for SAP Crystal Server to use when accessing the
Subversion repository.
10.SAP Crystal Server can integrate with your organization's deployment of SAP Solution Manager
Diagnostics (SMD). If your organization uses SAP SMD, selectConfigure connectivity to SAP
SMD Agent. You are prompted for information. If you chose not to configure SMD at this time,
you can configure SMD Agent in the Central Management Console (CMC) "Placeholders" screen
later.
2012-08-1335
Installation
7/25/2019 Crs2011 Install Linux En
36/62
Note:Touse SAP Solution Manager Diagnostics (SMD), SAP Host Agent and SMD Agent must be installed:
For information on installing the SAP Host Agent before SAP Crystal Server, see "To enable
SAP System Landscape Directory (SLD) support". For information on installing the SAP Host Agent after SAP Crystal Server, see "To configure
System Landscape Directory (SLD) Data Supplier (DS) post installation".
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with SAP Solution Manager Diagnostics (SMD), enter the SMD Agent
hostname and port number.
11. SAP Crystal Server can integrate with your organization's deployment of CA Wily Introscope
Enterprise Manager. If your organization does not use Introscope Enterprise Manager, select Do
not integrate connectivity to Introscope Enterprise Manager.Note:To use CA Wily Introscope Enterprise Manager, SMD Agent must be installed:
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)".
For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with Introscope Enterprise Manager, enter the hostname and port number
for the Introscope Enterprise Manager server.
The "Start Installation" screen appears. Select "Next" to install.
Proceed toWhile the installation program runs.
5.2.1.3 Web Tier installation
The web tier hosts web applications and serves content to users over the web. Use the "Web Tier"
installation option to install Java web applications onto a dedicated Java web application server.
Note:
A web tier installation does not deploy web applications to the web application server. To deployweb applications to a web application server after a web tier installation, use the WDeploy tool. For
more information on using the WDeploy tool, see the SAP BusinessObjects Business Intelligence
Platform Web Application Deployment Guide.
If you do not have a web application server in place for use with SAP Crystal Server, the installation
program can install and configure a Tomcat web application server for you. It is recommended that you
2012-08-1336
Installation
7/25/2019 Crs2011 Install Linux En
37/62
evaluate your requirements against information from your web application server vendor to determine
which supported web application server would best suit your organization's needs.
If you already have a supported web application server installed, you can deselect the option to install
Tomcat, and only install the Java web applications
The following steps are performed forWeb Tierinstallations of SAP Crystal Server.
1. Review the list of features to install. Only features with a selected checkbox are installed.
Web Tier components:
Java Web Applications: Central Management Console (CMC), BI launch pad, and other web
applications
Tomcat 6: the Apache Tomcat web application server.
2. If you chose to install the Tomcat 6 web application server, review the default values for the web
applicationserverconnection port number, the shutdown port number, and the redirectport number.
The web application server must be able to receive incoming connections on these ports, so ensure
that your firewall is configured appropriately. TheConnection portis the port on which the web application server listens for incoming
connections from web clients.
TheShutdown portallows the web application to be shut down remotely.
TheRedirect portenables redirects to secure web connections.
3. SAP Crystal Server can integrate with your organization's deployment of CA Wily Introscope
Enterprise Manager. If your organization uses Introscope Enterprise Manager, select Integrate
connectivity to Introscope Enterprise Manager. You will be prompted for information.
Note:To use CA Wily Introscope Enterprise Manager, SMD Agent must be installed:
For information on installing SMD Agent before SAP Crystal Server, see "SAP Solution Manager
Diagnostics (SMD)". For information on installing SMD Agent after SAP Crystal Server, see "To configure SMD Agent
post installation".
a. If you chose to integrate with Introscope Enterprise Manager, enter the hostname and port number
for the Introscope Enterprise Manager server.
The "Start Installation" screen appears. Click "Next" to install.
Proceed toWhile the installation program runs.
5.2.2 While the installation program runs
The progress bar illustrates the progress of the installation as a whole.
Note:When performing an Expand installation, the existing CMS may be restarted automatically as a part of
the installation process.
2012-08-1337
Installation
7/25/2019 Crs2011 Install Linux En
38/62
The installation program installs SAP activity and resource monitoring tools. These tools enable you to
provide detailed technical information about your installation in the event of a problem.
5.2.3 When installation is complete
When the installation is complete, review the information in the "Post Installation Steps" screen. If you
are not using the bundled Tomcat web application server, you must deploy web applications with the
WDeploy web application deployment tool.
5.3 To run a silent installation
Every option in the installation wizard can be given from the command-line. This type of installation is
known as a silent install.
Installation options can be given directly on the command-line as a parameter, or can be stored in a
response file.
Giving installation options on the command-line
Installation options can be passed directly to the setup program from the command-line as a
parameter. For example, the installation option CMSPort=6401can be given on the command-line
as a parameter when running the installation program to set the CMS port number to 6401, instead
of the default value of 6400.
In the following example of giving the CMSPortparameter on the command-line, ellipses ([...])
are shown to indicate where other installation options would normally be present:
./setup.sh [...] CMSPort=6401 [...]
Giving installation options in a response file
Installation options can be stored in a response file, which is a text file containing installation option
parameters in key-value format. When using a response file to give installationoptions, the installation
program is run from the command-line with the -r parameter, whereis the name of the response file.
The response file contains multiple installation options, with one installation option per line. In thefollowing example, the response file is given as a parameter:
./setup.sh [...] -r $HOME/response.ini [...]
For example, the installation option CMSPort=6401can be given on a line in the response file to
set the CMS port number to 6401, instead of the default value of 6400.
2012-08-1338
Installation
7/25/2019 Crs2011 Install Linux En
39/62
In the following example of giving the CMSPortparameter in a response file, ellipses ([...]) are
shown to indicate where other installation options would normally be present:
[...]CMSPort=6401
[...]
For a complete list of installation options, seeInstallation option parameters. For an example of a
response file, seeResponse file example.
5.3.1 Command-line switch parameters
The following table lists the switch parameters that can be given to the installation program on the
command-line to perform a silent installation.
Table 5-1: Installation program command-line switch parameters
ExampleDescriptionSwitch parameter
./setup.sh -w "$HOME/re
sponse.ini"
Writes a response file to , containing theoptions select-
ed from the installation wizard.
-w
./setup.sh -r "$HOME/re
sponse.ini"
Reads installation options from a re-
sponse file named.
-r
./setup.sh -q -r
"$HOME/response.ini"
Whenperforming a silent installation,
this switch causes the installation
program to install with no console
output or prompting. If a problem is
encountered, the installation program
will writea message to the installation
log file and exit. This switch must al-
ways be used in combination with the
-r switch parameter.
-q
5.3.1.1 To use a response file
To use a response file, run the installation program with the-r parameter. The
installation program reads all installation options from the response file, and no further input is required.
2012-08-1339
Installation
7/25/2019 Crs2011 Install Linux En
40/62
For example, the following command reads installation options from the response file $HOME/re
sponse.ini:
./setup.sh -r $HOME/response.ini
To override an installation option in a response file, give that option on the command-line. Installation
options given on the command-line take precedence over the options in the response file. For a complete
list of installation options, seeInstallation option parametersbelow.
If an unexpected condition is encountered, an error message is written to the installation log file and
the installation program exits. Installation activity, warnings, and errors are written to the installation log
file in the folder:
/InstallData/logs//InstallDU.log
If thefolder has not been created by the time the installation program exits,
look forinstall.login the temporary folder specified by the system TEMPenvironment variable.
5.3.1.1.1 To write a response file
To create a response file, run the installation program with the -w parameter and
select the desired installation options with the installation wizard. When the wizard completes, the
installation program exits and the response file is created. The response file can then be used for future
installations.
For example, the following command creates the response file $HOME/response.ini:
./setup.sh -w $HOME/response.ini
Once created, the response file can be updated with a text editor.
Note:When creating a response file with the GUI installation program, passwords entered via the GUI will
be written to the response file in plain text format.
5.3.1.1.2 To read a response file
A response file installation is started on the command-line, but installation options are read from a ASCII
text file with the options stored in key-value format. This is useful when setting up a cluster, or for
creating development or test environments with standardized options.
When an option is given both on the command-line and in a response file, the command-line options
take precedence over the response file options. This allows an administrator to override an option in a
response file when required. This provides three levels precedence for installation options:1. Installation options given on the command-line take highest precedence, and will always override
response file and default values.
2. Installation options given in a response file are used when not given on the command-line, and
override default values.
3. Installation option default values are used when not given on the command-line or in a response
file.
2012-08-1340
Installation
7/25/2019 Crs2011 Install Linux En
41/62
For example, the following command reads installation options from the response file $HOME/re
sponse.ini, but overrides the response file's setting for the installation destination folder:
./setup.sh -r $HOME/response.ini InstallDir=/opt/sap/sap_bobj/
5.3.1.2 Quiet mode installations
A quiet mode installation is a command-line installation that does not prompt for installation options.
Installationoptions must be provided on the command-line or in a response file. Any installationoptions
not provided on the command-line or in a response file are left at their default values.
The-qswitch bypasses the installation program's installation wizard, and allows an installation to be
performed with no human input and no console output.
For example, the following command uses the default values for all installation options, except for the
installation destination folder (set to /opt/sap/sap_bobjinstead of the current working folder).
setup.exe -q InstallDir=/opt/sap/sap_bobj/
If an unexpected condition is encountered, an error message is written to the installation log file and
the installation program exits. Installation activity, warnings, and errors are written to the installation log
file in the folder:
/InstallData/logs//InstallDU.log
If thefolder has not been created by the time the installation program exits,
look for a file named setupengine.login a timestamp folder in the temporary folder specified by thesystemTEMPenvironment variable.
5.3.2 Installation option parameters
The following table lists the parameters that can be used to select installation options on both the
command-line and in resp