Inst Content Server Ux sp20
Inst Content Server Ux sp20
Inst Content Server Ux sp20
1 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1 Installation Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
General Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Technical Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.2 Basic Installation Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
4 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.1 Creating Operating System Users and Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.2 SAP Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.3 Using Virtual Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.4 Preparing the Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Downloading and Extracting the Software Provisioning Manager 1.0 Archive. . . . . . . . . . . . . . . . 37
Downloading Complete Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4.5 Install the SAP MaxDB and/or the File System Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Installing the SAP MAX DB (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Set Up the File System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
5.1 Prerequisites for Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
5.2 Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.3 Additional Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Useful Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Restarting Interrupted Processing of Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . 53
Troubleshooting with Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Using the Step State Editor (SAP Support Experts Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
7 Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1 SAP Notes Relevant for SAP Content Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.2 Using Virtual Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
7.3 Uninstalling the SAP Content Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
The following table provides an overview on the most important document changes.
Note
Before you start reading, make sure you have the latest version of this installation guide, which
is available at https://support.sap.com/sltoolset System Provisioning Install a System using
Software Provisioning Manager Installation Option of Software Provisioning Manager 1.0 .
2.4 2024-10-07 Updated version for software provisioning manager 1.0 SP42 (SL Toolset 1.0 SP42)
2.3 2024-05-27 Updated version for software provisioning manager 1.0 SP41 (SL Toolset 1.0 SP41)
2.2 2024-02-12 Updated version for software provisioning manager 1.0 SP40 (SL Toolset 1.0 SP40)
2.1 2023-10-09 Updated version for software provisioning manager 1.0 SP39 (SL Toolset 1.0 SP39)
Windows operating systems no longer supported for software provisioning manager 1.0 SP39
and higher, according to SAP Note 2998013 , have been removed.
2.0.1 2023-10-09 Updated version for software provisioning manager 1.0 SP38 (SL Toolset 1.0 SP38): Last version
containing information about no longer supported Windows operating systems according to SAP
Note 3346502 .
2.0 2023-05-26 Updated version for software provisioning manager 1.0 SP38 (SL Toolset 1.0 SP38)
1.9 2023-02-13 Updated version for software provisioning manager 1.0 SP37 (SL Toolset 1.0 SP37)
Operating systems and CPU architectures no longer supported according to SAP Note
2998013 have been removed.
1.8.1 2022-10-10 Updated version for software provisioning manager 1.0 SP35 (SL Toolset 1.0 SP35): Last version
containing information about no longer supported operating systems and CPU architectures
according to SAP Note 2998013 .
1.8 2022-05-24 Updated version for software provisioning manager 1.0 SP35 (SL Toolset 1.0 SP35)
1.7 2022-02-14 Updated version for software provisioning manager 1.0 SP34 (SL Toolset 1.0 SP34)
1.6 2021-10-11 Updated version for software provisioning manager 1.0 SP33 (SL Toolset 1.0 SP33)
1.5 2021-06-21 Updated version for software provisioning manager 1.0 SP32 (SL Toolset 1.0 SP32)
1.4 2021-02-15 Updated version for software provisioning manager 1.0 SP31 (SL Toolset 1.0 SP31)
1.3 2020-10-05 Updated version for software provisioning manager 1.0 SP30 (SL Toolset 1.0 SP30)
1.2 2020-06-08 Updated version for software provisioning manager 1.0 SP29 (SL Toolset 1.0 SP29)
1.1 2020-01-20 Updated version for software provisioning manager 1.0 SP28 (SL Toolset 1.0 SP28)
This documentation describes how to install an SAP Content Server or SAP Cache Server 7.5 or higher on
UNIX , using the software provisioning manager 1.0 SP42 [page 6], which is part of SL Toolset 1.0 SP42.
Note
If you want to install an SAP Content Server or SAP Cache Server release lower than 7.5, use the
documentation Installation of SAP Content Server (lower than) 7.5 on UNIX , which is available at https://
support.sap.com/sltoolset System Provisioning System Provisioning Scenarios Install a System
using software provisioning manager Installation Option of software provisioning manager 1.0 <Current
SP> Installation Guides - Standalone Engines and Clients SAP Content Server
You can find a complete list of the SAP system products that are supported by software provisioning manager
1.0 attached to SAP Note 1680045 .
Starting with release 7.5, Content Server is integrated into the SAP Web Dispatcher instead of the Apache
(Unix) or Microsoft IIS (Windows) web servers.
SAP Content Server will be installed typically under its own system ID (SAPSID) and with an instance number
that is unique within the system. As a result, SAP Content Server instances will now be better integrated in your
SAP system landscape (for example, regarding its integration with SAP MC, SAP Solution Manager). For more
information, see SAP Note 2786364 .
If SAP Cache Server is not explicitly mentioned, “SAP Content Server” always refers to both SAP Content
Server and SAP Cache Server.
Note
If you want to install an SAP Content Server or Cache Server lower than 7.5 , use the documentation
Installation of SAP Content Server on UNIX 7.4 and Lower at: https://support.sap.com/sltoolset
System Provisioning Install a System using software provisioning manager Installation Option of software
provisioning manager 1.0 SP<Current Number> Installation Guides - Standalone Engines and Clients
SAP Content Server
The software provisioning manager 1.0 is the successor of the product- and release-specific delivery of
provisioning tools, such as “SAPinst”. We strongly recommend that you always download the latest version of
the software provisioning manager 1.0. The software provisioning manager 1.0 is part of the Software Logistics
Toolset 1.0 (“SL Toolset” for short). This way, you automatically get the latest fixes and supported processes.
For more information about the software provisioning manager as well as products and releases supported by
it, see SAP Note 1680045 and http://scn.sap.com/docs/DOC-30236 .
• The name of the technical framework of the software provisioning manager. For more information about
the SAPinst Framework, see SAP Note 2393060 .
• Texts and screen elements in the the software provisioning manager GUI (SL Common GUI)
• Names of executables, for example sapinst
• Names of command line parameters, for example SAPINST_HTTPS_PORT
• Names of operating system user groups, such as the additional group sapinst
In the following, we generally refer to the software provisioning manager 1.0 as the “software provisioning
manager”. We only use the term “software provisioning manager 1.0” if this is required for technical reasons.
Related Information
This section contains sub-sections giving a general description of the SAP Content Server, and a specific
description of SAP Content Server for UNIX.
The SAP Content Server is the server at the core of SAP’s document storage and management concept. It
provides the technical infrastructure for all document-centric applications and business scenarios that do not
require a long-term document archiving solution. Because the SAP Content Server is included in every SAP
solution, a self-contained content server is always available to SAP customers.
The content server infrastructure also includes the cache server. Like the content server, the cache server
stores documents and allows them to be accessed via HTTP. The difference is that the cache server is an
interim storage facility located close to the client whose main task is to make access to document content
quicker and more efficient. It does this by temporarily storing (‘caching’) requested document content, so that
the next time that content is requested by a nearby client; the content can be retrieved from the nearest cache
server rather than the content server.
This is most advantageous on very large, dispersed networks, where the client and the content server may be
located on different continents. It is also particularly useful if the content is required for fast display, such as in
a Web browser. Cache servers also reduce the network load and thus enhance network performance.
Client Applications
SAP applications that use the technical infrastructure of the SAP Content Server include the SAP Business
Workplace, ArchiveLink, the Document Management System (DMS), and the SAP Knowledge Warehouse.
More Information
For further information on Knowledge Provider, the SAP Content Server, and the SAP Cache Server,
see the SAP Library at https://help.sap.com/nw <Choose the SAP NetWeaver Release your
SAP product is based on> SAP NetWeaver Library: Function-Oriented View Application Server
Application Server ABAP Other Services Services for Business Users Knowledge Provider (BC-SRV-KPR)
Content Management Service (BC-SRV-KPR) SAP Content Server
Architecture
The graphic below shows the architecture of SAP Content Server for UNIX:
The basis of the SAP Content Server is the content server engine. The engine receives all URLs, checks their
validity, and triggers the processing of requests.
The SAP Content Server saves data to the SAP database (SAP DB) or to the file system. However, the Content
Server engine does not communicate directly with the storage medium. Instead, it uses an adapter known as
the content storage layer, which is implemented either as the SAP DB storage layer or the file system storage
layer, depending on the storage medium. The storage layer “hides” the specific access mechanisms of the
storage medium behind a consistent, byte stream-oriented interface. This means that one server engine can
support several storage media.
The new Content Server for UNIX has a number of advantages. The most important of these are:
Constraints
The SAP Content Server (both platform versions) is not intended to replace optical storage systems and other
storage media for long-term document archiving.
File System
The file system storage layer uses the POSIX (portable operating system interface on UNIX) file system API
of the underlying UNIX operating system. The file system repositories take the form of a directory hierarchy
in which the documents are stored. The system is designed in such a way that the number of documents in
the file system is limited only by the number of available inodes (note that some inodes are needed for the
directory structure).
Non-standard file systems (that is, file systems other than the UNIX file system (UFS)), such as SAMBA or a
virtual FS, can be used, but they must support the UNIX access rights and be accessible via a valid access
path beginning with the root file system. You should also expect substantial performance losses if you use a
non-standard file system.
The directory structure of the file system repositories has been designed in such a way as to make efficient,
fast, and flexible use of your disks. The main features of file system storage are as follows:
• Flat hierarchy
The aim of a flat hierarchy is to keep the number of disk accesses required during document retrieval low
and consistent (the flatter the hierarchy, the fewer accesses required). A flat hierarchy also increases the
potential number of documents that can be stored.
• Efficient usage ratio of the inodes used for structural objects and content objects
The ratio between inodes used for structural objects and content object does not substantially limit the
overall capacity of the repository.
• Portable layout
File system repositories are accessible from different server hosts and can be transported as backed-
up archives. No file system-specific features are utilized, in order to keep the repositories platform-
2.3 Purpose
SAP Content Server for UNIX allows users to run SAP’s proven content server technology with the
added advantages inherent in UNIX systems: enhanced flexibility, improved resource utilization, platform-
independence, and high stability.
The SAP Content Server for UNIX has the following sub-components:
2.4 Constraints
This section lists the constraints valid for SAP Content Server.
SAP Content Server is not an alternative to optical storage systems and other storage media for long-term
document archiving.
• Effective immediately, the software provisioning manager no longer supports the deprecated CPU
architectures and/or operating system versions listed in SAP Note 2998013 .
Note
• If your current operating system is listed as deprecated in SAP Note 2998013 , we strongly
recommend that you migrate to a supported platform.
• If you continue to run Software Provisioning Manager on the deprecated CPU architectures and/or
operating system versions listed in SAP Note 2998013 , you do so at your own risk and without
support from SAP. The software provisioning manager 1.0 SP36 and higher will still run on the
deprecated CPU architectures and/or operating system versions listed in SAP Note 2998013
but it may run into an error. When you start the software provisioning manager, you will see a
warning like the following: “Platform Support : Support for SAP JVM on PPC64 big endian for Linux
ends June 30 th, 2022. See SAP note 2998013.” If you run into an issue, you must use the “frozen”
software provisioning manager 1.0 SP35 software and the related installation guide. For more
information, see SAP Note 3220901 .
This section describes the prerequisites required for using this guide.
This installation guide assumes that you have a thorough knowledge of the following:
You must read the following SAP Notes before you start the installation. These SAP Notes contain the most
recent information on the installation, as well as corrections to the installation documentation.
Make sure that you have the up-to-date version of each SAP Note which you can find at https://
support.sap.com/notes .
1680045 Release Note for Software Provisioning Remarks, annotations, and corrections
Manager 1.0 discovered after publication of the docu-
mentation Software Provisioning Manager
2378874 Install SAP Solutions on Linux on IBM Information about how to install SAP solu-
Power Systems (little endian) tions on Linux on IBM Power Systems (lit-
tle endian)
Note
From a technical point of view, the SAP Content Server 7.5 or higher is set up like an SAP system with its
own SAP system ID (SAPSID), its own operating system users, and its own directory structure.
Before you start installing SAP Content Server, note the following prerequisites.
SAP Content Server can store documents in SAP MaxDB (separate installation required, see Installing the SAP
MAX DB (Optional) [page 41]) or directly on a file system.
You should save the following SAP Content Server sub-components to different hard disks, to ensure maximum
performance and data security in the productive system:
• Data (data files of MaxDB or root folder of file system based repositories)
• Log file (MaxDB only)
• Mirrored log file (MaxDB only)
A RAID 5 system with at least 2.5 GB of free hard disk capacity is recommended for storing the data. The hard
disks must be set up in NTFS format.
All users, in particular application servers and workstation PCs, must be able to access the Content Server
or Cache Server system via HTTP. A workstation PC without direct HTTP access will not be able to execute
individual scenarios, or will only have very limited access to individual scenarios.
Caution
If your hosts do not fully meet the requirements, you might experience problems when working with the
SAP system.
Procedure
Note
The information here is not intended to replace the operating system documentation. For more
information, see your operating system documentation.
AIX Before you start the installation, make sure that you have read SAP Note 1972803 .
In addition, we also recommend that you check the information available in the SAP on AIX space on
the SAP Community Network at https://www.sap.com/community/topic/aix.html .
HP-UX Before you start the installation, make sure that you have read SAP Note 1075118 .
In addition, we also recommend that you check the information available in the SAP on HP-UX Best
Practices space on the SAP Community Network at https://www.sap.com/community/topic/hp-
ux.html .
Linux Before you start the installation, make sure that you have read the SAP Notes for your Linux distribu-
tion listed in the central SAP Note 171356 .
In addition, we also recommend that you check the information available in the SAP on Linux space
on the SAP Community Network at https://www.sap.com/community/topic/linux.html .
Solaris Before you start the installation, make sure that you have read SAP Note 1669684 .
In addition, we also recommend that you check the information available in the SAP on Oracle
Solaris space on the SAP Community Network at https://www.sap.com/community/topic/oracle-so-
laris.html
Hardware Requirements
Processing units For application server instances and database instances: The number of physical or virtual
processing units usable by the operating system image must be equal to or greater than 2.
Note
AIX: Keep in mind that the operating system itself requires about 10% of the available
RAM.
HP-UX: Refer to SAP Note 1112627 for the commands to display the RAM size on HP-UX.
End of 'Platform': HP-UX
Linux: For more information about how to evaluate main memory consumption on Linux, see
SAP Note 1382721 .
End of 'Platform': Linux
AIX: Paging space You need hard disk drives with sufficient paging space. You can calculate the required paging
space as follows:
• Optimistic strategy:
• Defensive strategy:
3 * RAM, at least 20 GB
For the latest information about recommended paging space, see SAP Note 1121904 .
HP-UX: Swap space You need hard disk drives with sufficient space for swap. You can calculate the required swap
space as follows:
For more information about HP-UX swap space recommendations and about how to set up
swap space, see SAP Note 1112627 .
Linux: Swap space You need hard disk drives with sufficient space for swap. We recommend that you use the
amount of swap space as described in SAP Note 1597355 . You might decide to use more
or less swap space based on your individual system configuration and your own experience
during daily usage of the SAP system.
Oracle Solaris: Swap space You need hard disk drives with sufficient space for swap.
At least 20 GB are required. For more information, see SAP Note 570375 .
Software Requirements
Database software Check the Product Availability Matrix (PAM) at http://support.sap.com/pam for
supported database platforms.
AIX: Operating system version Your operating system platform must be 64-bit.
Minimal OS requirements for the specific SAP Kernel releases are listed in SAP Note
1780629 .
You require at least AIX 7.1 TL1 SP1 to be able to run the software provisioning
manager.
HP-UX: Operating system version Your operating system platform must be 64-bit.
To check the operating system version on your installation hosts, use the following
command:
uname -r
See SAP Note 939891 for information about support time frames of HP-UX.
Linux: Operating system version Your operating system platform must be 64-bit.
To check the operating system version on your installation hosts, use the following
command:
cat /etc/*-release
Only valid for 'Platform': Linux
If you are installing on SUSE Linux Enterprise Server (SLES), see SAP Note
1275776 to prepare SLES for SAP environments.
End of 'Platform': Linux
Linux Secure Enabled Linux (SELi- Set Linux Secure Enabled Linux (SELinux) | SELinux mode to Permissive or Disabled
nux) Mode on all SAP System hosts for the installation procedure. For more information, see
SAP Note 3247790 .
Oracle Solaris: Operating system Your operating system platform must be 64-bit.
version
Check the Product Availability Matrix (PAM) at http://support.sap.com/pam for
supported operating system versions.
To check the operating system version on your installation hosts, use the following
command:
/bin/uname -r
AIX: Kernel parameters To adjust AIX kernel parameters, see SAP Note 628131 .
HP-UX: Kernel parameters To run an SAP system, make sure that you check and, if necessary, modify the
HP-UX kernel.
Caution
We recommend that a UNIX system administrator performs all kernel modifica-
tions.
Proceed as follows:
1. Check SAP Note 172747 for recommendations on current HP-UX kernel pa-
rameters.
Caution
If a kernel value is already larger than the one suggested in the SAP Note,
do not automatically reduce it to match the SAP requirement.
You have to analyze the exact meaning of such a parameter and, if required,
to reduce the parameter value. In some cases this might improve the per-
formance of your SAP applications.
Linux: Kernel parameters Check SAP Note 2369910 for Linux kernel versions certified by SAP.
To check the Linux kernel parameters for your Linux distribution, see one of the
following SAP Notes:
Oracle Solaris: Kernel parameters To run an SAP system, you must check and, if necessary, modify the Oracle Solaris
kernel parameters or resource controls.
HP-UX: OS patches To check the minimum required OS patches, see SAP Note 837670 .
Oracle Solaris: OS patches Check the relevant SAP Note for required Oracle Solaris patches:
AIX: National Language Support Make sure that National Language Support (NLS) and corresponding locales are
(NLS) installed.
HP-UX: National Language Support Make sure that National Language Support (NLS) and corresponding locales are
(NLS) installed.
Linux: National Language Support Make sure that National Language Support (NLS) and corresponding locales are
(NLS) installed.
• Ensure that the required locales such as the following are available:
de_DE, en_US
• Check SAP Note 187864 for information about corrected operating system
locales and SAP blended Code Pages.
Oracle Solaris: National Language Make sure that National Language Support (NLS) and corresponding locales are
Support (NLS) installed.
locale -a
System language For the installation, you must choose English as the operating system language on
all hosts that run SAP software.
Minimum Web Browser Make sure that you have at least one of the following web browsers installed on the host
where you run the software provisioning manager's SL-UI:
You need a web browser to be able to run the SL-UI, and to display the Evaluation Form
and send it to SAP.
AIX: Additional software Make sure that the following additional file sets are installed:
Host name To find out physical host names, open a command prompt and enter hostname.
For more information about the allowed host name length and characters allowed for
SAP system instance hosts, see SAP Note 611361 .
Only valid for 'Platform': HP-UX
If you want to use virtual host names, see SAP Note 962955 .
Login shell The software provisioning manager only prompts you for this parameter if you use a login
shell other than C shell (csh).
HP-UX: Mount and file system For recommendations about block size and mount option configuration, see SAP Note
configuration 1077887 .
Shared file systems for decen- If application servers are installed decentralized, a “shared” file system must be installed,
tralized systems for example Network File System (NFS).
AIX: C++ Runtime environment Minimal C++ runtime requirements for the specific SAP Kernel releases are listed in SAP
Note 1780629 .
The table below lists the basic input parameters that are prompted by the software provisioning manager. For
all remaining input parameters, use the tool help or the descriptions on the software provisioning manager
screens.
Parameters Description
SAP System ID <SAPSID> The SAP System ID <SAPSID> is the technical identifier for your SAP Content Server
and SAP Cache Server. You can install SAP Content Server and SAP Cache Server with
the same <SAPSID>, but with different instance numbers.
Caution
Choose your SAP system ID carefully. You cannot change the SAP system ID after
the installation.
Caution
Do not use 75 for the instance number of the SAP Content Server because this
number is already used by the operating system. For more information, see SAP
Note 29972 .
Virtual Host Name Virtual host name (network name) of the SAP<SAPSID> cluster group
You can assign a virtual host name for the instance to be installed, by specifying it in
the Host Name field of the screen. Then this instance is installed with this virtual host
name.
After the installation has completed, all application servers can use this virtual host
name to connect to the instance. The virtual host name is also a global host name. If
you do not provide the virtual host name, the instance is installed automatically using
its physical host name.
You must have already reserved the virtual host name (network name) and its IP
address on a DNS server before you run the software provisioning manager. For more
information, see Using Virtual Host Names [page 35].
Note
Fully qualified host names, IPv4, IPv6 are not accepted as virtual host names.
Alternatively you can assign virtual host names also by starting the software provision-
ing manager with the SAPINST_USE_HOSTNAME command line parameter. For more
information, see Running Software Provisioning Manager [page 46].
Master Password Common password for all users that are created during the installation:
Caution
If you did not create the operating system users manually before the instal-
lation, the software provisioning manager creates them with the common
master password (see Operating System Users). In this case, make sure that
the master password meets the requirements of your operating system.
Recommendation
The Master Password feature can be used as a simple method to obtain customer-
specific passwords for all newly created users. A basic security rule is not to have
identical passwords for different users. Following this rule, we strongly recommend
individualizing the values of these passwords after the installation is complete.
Operating System Users and The software provisioning manager processes the operating system users as follows:
Groups
• If the operating system users do not exist, the software provisioning manager
creates the following users:
• The SAP system administrator user <sapsid>adm
• Database administrator users
The software provisioning manager sets the master password for these users by
default. You can overwrite and change the passwords either by using the parame-
ter mode Custom or by changing them on the parameter summary screen.
• If the operating system users already exist, the software provisioning manager
prompts you for the existing password, except if the password of these users is the
same as the master password.
• Make sure that the user ID and group ID of these operating system users are
unique and the same on each relevant application server instance host.
During the Define Parameters phase of the software provisioning manager you can
specify that the sapinst group is to be removed from the group set of the operating
system users after the execution of the software provisioning manager has completed.
For more information about the sapinst group, see Creating Operating System Users
and Groups [page 29].
For more information about the sapinst_instdir directory, see Useful Informa-
tion about Software Provisioning Manager [page 50].
Recommendation
For the SAP Content Server, we recommend using HTTP port 1090 and
HTTPS port 1091.
For the SAP Cache server, we recommend using HTTP port 1095 and HTTPS
port 1096.
• Enable AdminSecurity
If you want to enable AdminSecurity, provide the AdminSecurity Group.
SAP Host Agent Upgrade (Op- If there already exists an SAP Host Agent on the installation host, the software provi-
tional) sioning manager asks you if you want to upgrade it to a newer patch level version. If
you want the existing version to be upgraded, you must provide the new target version
of the SAPHOSTAGENT<Version>.SAR archive.
This section describes in detail the steps you need to take before installing your SAP Content Server.
Install the SAP MaxDB and/or the File System Storage [page 40]
The sapinst_instdir directory belongs to a group named sapinst. If this group is not available, it is
created automatically as a local group.
If you do not want the software provisioning manager to create operating system users, groups, and services
automatically, you can optionally create them before the installation is started. This might be the case if you
use central user management such as Network Information System (NIS).
For distributed installations, unless you are using global accounts or NIS, you must create the target users
automatically using the software provisioning manager or manually on the operating system, before starting
the installation :
Caution
The user ID (UID) and group ID (GID) of SAP users and groups must be identical for all servers belonging to
an SAP system.
This does not mean that all users and groups have to be installed on all SAP servers.
The software provisioning manager checks if the required services are available on the host and creates
them if necessary. See the log messages about the service entries and adapt the network-wide (NIS) entries
accordingly.
Recommendation
For a distributed or a high-availability system, we recommend that you distribute account information
(operating system users and groups) over the network, for example by using Network Information Service
(NIS)..
If you want to use global accounts that are configured on a separate host, you can do this in one of the following
ways:
• You start the software provisioning manager and choose Generic Installation Options <Database>
Preparation Operating System Users and Groups .
For more information, see Running Software Provisioning Manager [page 46].
• You create operating system users and groups manually. Check the settings for these operating system
users.
User Settings
Caution
Caution: the limit mechanism supports hard and soft limits. The soft limit cannot be bigger than
the hard limit. The hard limit can be set/increased by the root user like: limit -h <limit>
<new_value>, for example limit -h datasize unlimited .
Example
The following table lists example output taken from SUSE Linux Enterprise Server 11 (x86_64).
Output Properties
cputime unlimited
filesize unlimited
datasize unlimited
stacksize 8192 KB
coredumpsize unlimited
descriptors 8192
memoryuse unlimited
• Using sh or ksh shell, the output of command ulimit -a needs to be at least as follows:
Example
The following table lists example output taken from SUSE Linux Enterprise Server 11 (x86_64).
• All users must have identical environment settings. Any change to the environment – such as variables, or
paths – is at your own responsibility.
• If you have multiple operating system users with user ID (UID) 0, you must assign the sapinst group to all
of them.
If you have multiple operating system users with user ID (UID) 0, you must assign the sapinst group to all of
them.
Recommendation
For security reasons, we recommend that you remove the operating system users from the group sapinst
after the software provisioning manager has completed.
We recommend that you specify this “cleanup” already during the Define Parameters phase on the Cleanup
Operating System Users screen. Then, the removal of the operating system users from the group sapinst
is done automatically.
Groups Members
sapsys <sapsid>adm
The directory of the SAP Content Server instance is C<Instance_Number>, for example C00.
Note
Depending on your operating system, you might also have to add space for administrative purposes.
/<sapmnt>/<SAPSID> The default name for the SAP system mount directory is 500 MB
sapmnt.
• exe
Contains executable kernel programs
• global
Contains log files
• profile
Contains the start and operations profiles of the SAP Con-
tent Server instance
• SYS
Note
The subdirectories of /usr/sap/<SAPSID>/SYS have
symbolic links to the corresponding subdirectories of /
<sapmnt>/<SAPSID>, as shown in the figure above.
• <INSTANCE>
The instance name (instance ID) of the SAP Content Server
instance is C<Instance_Number>, for example C00.
/usr/sap/trans This directory contains SAP software for the transport of objects This value heavily depends
between SAP systems . on the use of your SAP sys-
tem.
You can use one or more virtual TCP/IP host names for SAP servers within an SAP server landscape to hide
their physical network identities from each other. This can be useful when quickly moving SAP servers or
complete server landscapes to alternative hardware since you do not need to reinstall or reconfigure.
Prerequisites
Make sure that the virtual host name can be correctly resolved in your Domain Name System (DNS) setup.
Context
Procedure
You must extract this archive to be able to run the software pro-
visioning manager. For more information, see Downloading and
Extracting the Software Provisioning Manager 1.0 Archive [page
37].
SAPCS<Release>.SAR Contains the installation packages for the SAP Content Server
and the Cache Server
Caution
As of SAP MaxDB version 7.9.11.07, SAP MaxDB liveCache
version 7.9.11.08, a new structure for the software packages
is used. For more information, see SAP Note 3524673 .
SAPHOSTAGENT<Release>_<Version>.SAR Contains the installation packages for the SAP Host Agent
SAP MaxDB <Release> - SP<Version> Build Contains the SAP MaxDB database software, only required if you
<Version> <OS> install a database instance for the Content Server and / or the
Cache Server
Caution
As of SAP MaxDB version 7.9.11.07, SAP MaxDB liveCache
version 7.9.11.08, a new structure for the software packages
is used. For more information, see SAP Note 3524673 .
MaxDB
Note
The digital signature of installation media is checked automatically by the software provisioning manager
during the Define Parameters phase while the Media Browser screens are processed (see also Running
Software Provisioning Manager [page 46] ). The software provisioning manager only accepts media
whose digital signature has been checked.
Prerequisites
• Make sure that you are logged on as a user with root authorizations, and that the download directory has
at least the permissions 755.
• Make sure that you use the latest version of the SAPCAR tool when manually extracting the software
provisioning manager archive. You need the SAPCAR tool to be able to unpack and verify software
component archives (*.SAR files). *.SAR is the format of software lifecycle media and tools that you can
download from the SAP Software Download Center.
Note
An older SAPCAR version might extract archive files in a wrong way and this could prevent the software
provisioning manager from working consistently.
Procedure
1. Download the latest version of the Software Provisioning Manager 1.0 archive
SWPM10SP<Support_Package_Number>_<Version_Number>.SAR from:
Note
Check SAP Notes 2178665 and 1680045 whether additional information is available.
Note
Make sure that all users have at least read permissions for the directory to which you unpack the
Software Provisioning Manager archive.
Caution
Make sure that you unpack the Software Provisioning Manager archive to a dedicated folder. Do not
unpack it to the same folder as other installation media.
This section describes how you can download media from the SAP Software Download Center.
Procedure
1. Download and unpack the latest version of Software Provisioning Manager as described in Downloading
and Extracting the Software Provisioning Manager 1.0 Archive [page 37].
Note
Installation media might be split into several files. In this case, you have to reassemble the required files
after the download.
Example
SAPEXE_1110-80002623.SAR
Kernel Part I (753) (*)
SAPEXE_1118-80002612.SAR
Example
SAPEXEDB_1110-80002623.SAR
Kernel Part II (753) (*)
• To download the remaining media required for your SAP product, you can use one of the following
navigation paths:
• https://me.sap.com/softwarecenter INSTALLATIONS & UPGRADES By Category SAP
NETWEAVER AND COMPLEMENTARY PRODUCTS <Product> <Product Release>
• https://me.sap.com/softwarecenter INSTALLATIONS & UPGRADES By Alphabetical
Index (A-Z) <First Letter of Product> <Product> <Product Release>
• Material number
All download objects that are part of an installation medium have the same material number and an
individual sequence number:
<Kernelpart>_<Sequence Number>-<Material Number>
Example
SAPEXE_1110-80002623.SAR
Kernel Part I (753) (*)
SAPEXE_1111-80002623.SAR
Kernel Part I (753) (*)
SAPEXE_1112-80002623.SAR
Kernel Part I (753) (*)
SAPEXEDB_1110-80002623.SAR
Kernel Part II (753) (*)
SAPEXEDB_1111-80002623.SAR
Kernel Part II (753) (*)
SAPEXEDB_1112-80002623.SAR
Kernel Part II (753) (*)
• Title
All objects that are part of an installation medium have the same title, such as
<Solution><Media_Name><OS> or <Database>RDBMS<OS> for database media.
5. Download the objects to the download directory.
6. To correctly re-combine the media that are split into small parts, unpack all parts into the same directory.
In the unpacking directory, the system creates a subdirectory with a short text describing the medium and
copies the data into it. The data is now all in the correct directory, the same as on the medium that was
physically produced. For more information, see SAP Note 1258173 .
Caution
Make sure that you unpack each installation media to a separate folder. Do not unpack installation
media to the same folder where you unpack the Software Provisioning Manager archive.
Do not unpack installation media to the same folder where you unpack the SAP kernel archives for
archive-based installation.
4.5 Install the SAP MaxDB and/or the File System Storage
The content server supports both storage types simultaneously. That is, you can put one or more repositories
into the file system and other repositories into one or more database instances.
Reserve at least 700 MB for the initial software installation and the first database instance. Add 200 MB for
each subsequent database instance. Database root directory
Create an SAP MaxDB root directory /sapdb. This can be a real directory on your root partition, a mount point,
or a soft link.
Make sure that all users that are members of the group sapsys have full permissions for this directory.
Set up the data volumes and the log volumes. SAP MaxDB provides two options for doing this: you can either
create them as files inside the file system, or in raw devices.
You can create data and log volumes as large files in the file system. This option is generally regarded as more
flexible then the raw device option, but you have to expect a loss of I/O performance. This is because every disk
access has to pass the kernel’s file system layer.
Raw devices
Directing disk I/O into raw disk devices – that is, addressing partitions directly and not via the kernels file
system layer – yields the best performance. If you decide on this option, make sure that you set up enough
raw devices (partitions plus the corresponding entries in /dev). Whichever method you choose, do not simply
create one large file or raw device. Instead, spread your total volume across several files or raw devices. This
will increase the overall I/O throughput of your MAX DB installation. A good divider value is 5. So, if you intend
to create a database with a total size of 10 GB, create 5 partitions of 2 GB each.
For information on dimensioning the database instance, see the section Planning and Sizing above, and
read the SAP Content Server sizing guide at https://sap.com/sizing Sizing Guidelines Database &
Technology SAP NetWeaver .
SAP Content Server can store documents in SAP MaxDB (separate installation required) or directly on a file
system. If you want to use SAP MaxDB, you have to install it separately. Proceed as follows:
When installing the SAP MaxDB, you should also consult your operating system manual as necessary.
Set up your file system, taking into account the following points:
• A file system repository may be located on any mounted partition. However, SAP recommends that you set
up a separate partition that is exclusively reserved for that purpose.
• To maintain a consistent setup across all content servers, we also recommend that you reserve a common
mount point for these partitions within your enterprise (for example, /net/contreps).
Note
The initial path depth adds to performance. Therefore, you should keep the mount point depth low.
• Make sure that the content server and cache server users have full execution, creation, and read rights for
this mount point.
• As mentioned above, the file system repositories are designed to yield a good usage ratio of inodes used
for structural elements to those used for the documents. You can estimate the number of required inodes
using the following formula:
8193 + n Documents * ( 1 + m components per document)
Therefore, if you want to store 3 million documents with 1 component each, you should reserve at least
6,008,183 inodes for this repository.
• For the SL-UI, make sure that the following web browser requirements are met:
• You have one of the following supported browsers on the device where you want to run the SL-UI:
• Google Chrome (recommended)
• Mozilla Firefox
• Microsoft Edge
• Microsoft Internet Explorer 11 or higher.
Always use the latest version of these web browsers.
• If you copy the SL-UI URL manually in the browser window, make sure that you open a new Web
browser window in private browsing mode (Internet Explorer), incognito mode (Chrome) or private
browsing mode (Firefox). This is to prevent Web browser plugins and settings from interfering with the
SL-UI.
Caution
The software provisioning manager uses a self-signed certificate, which is used temporarily only
while the software provisioning manager is running. This certificate is not trusted by the browser
unless it is imported manually by the user running the software provisioning manager. This behavior
is intentionally designed in this way because - unlike ordinary public web servers - the software
provisioning manager has different usage patterns. You must configure your browser do trust the
self-issued certificate of the software provisioning manager after carefully performing the “thumbprint”
verification described in Running Software Provisioning Manager [page 46] . For more information
about adding trusted certificates, see the documentation of your browser.
For more information about the SL-UI, see Useful Information about Software Provisioning Manager [page
50].
• If you want to enable Internet Protocol Version 6 (IPv6), make sure that you set SAP_IPv6_ACTIVE=1 in
the environment of the user with root authorization which you use to start the software provisioning
Note
By applying this setting the SAP system administrator is responsible for configuring the IP version on
each host of the system landscape, before installing any additional instance to it.
• The software provisioning manager uses shell scripts to obtain the environment for user adm.
• If user adm does not yet exist, a working /bin/csh must be available on the host where you run the
software provisioning manager. For more information about recommended login shells, see SAP Note
202227 .
• If user adm already exists and uses csh, before you start the software provisioning manager, execute
the following command as user adm to make sure that the csh scripts are up-to-date, depending on
your UNIX OS platform:
/bin/csh -c "source /home/adm/.cshrc;env" or /bin/csh -c "source /
home/adm/.login;env"
• Make sure that your operating system does not delete the contents of the temporary directory /tmp or
the contents of the directories to which the variables TEMP, TMP, or TMPDIR point, for example by using a
crontab entry.
Make sure that the temporary directory has the permissions 755.
• Make sure that you have at least 700 MB of free space in the installation directory for each installation
option. In addition, you need 700 MB free space for the software provisioning manager executables. If you
cannot provide 700 MB free space in the temporary directory, you can set one of the environment variables
TEMP, TMP, or TMPDIR to another directory with 700 MB free space for the software provisioning manager
executables.
You can set values for the TEMP, TMP, or TMPDIR environment variable to an alternative installation
directory as described in section Useful Information about Software Provisioning Manager [page 50].
• Make sure that umask is set to 022 for the user with root permissions that you want to use for running the
software provisioning manager.
As the user with root permissions that you want to use for running the software provisioning manager,
enter the following command: umask 022
• Only valid for 'Platform': AIX
AIX: Make sure that you have set the limits for operating system users as described in SAP Note
323816 .
End of 'Platform': AIX
Caution
Caution: the limit mechanism supports hard- and soft-limits. The soft-limit cannot be bigger than
the hard-limit. The hard-limit can be set/increased by the root user like: limit -h <limit>
<new_value>, for example limit -h datasize unlimited .
Example
The following table lists example output taken from SUSE Linux Enterprise Server 15 (x86_64).
Output Properties
cputime unlimited
filesize unlimited
datasize unlimited
stacksize 8192 KB
coredumpsize unlimited
descriptors 8192
memoryuse unlimited
• Using sh or ksh shell, the output of command ulimit -a needs to be at least as follows:
Example
The following table lists example output taken from SUSE Linux Enterprise Server 15 (x86_64).
• Make sure that you have defined the most important SAP system parameters as described in Basic
Installation Parameters [page 23] before you start the installation.
• Make sure that the following ports are not used by other processes:
• Port 4237 is used by default as HTTPS port for communication between the software provisioning
manager and the SL-UI.
Prerequisites
For more information, see Prerequisites for Running Software Provisioning Manager [page 43].
Context
The software provisioning manager has a web browser-based GUI named “SL-UI of the software provisioning
manager” - “SL-UI” for short.
This procedure describes an installation where you run the software provisioning manager and use the SL-UI,
that is you can control the processing of the software provisioning manager from a browser running on any
device.
For more information about the SL-UI, see Useful Information about Software Provisioning Manager [page
50].
Procedure
Caution
Make sure that the user with root permissions that you want to use for running the software
provisioning manager has not set any environment variables for a different SAP system or database.
If your security policy requires that the person running the software provisioning manager is not
allowed to know the credentials of a user with root permissions on the installation host, you
For more information, see Preparing the Installation Media [page 35] .
Recommendation
Make the installation media available locallyFor example: The software provisioning manager might
require a certain PL . For example, if you use Network File System (NFS), reading from media mounted
with NFS might fail.
Note
Oracle Solaris: If you mount installation media, make sure that you do this with option nomaplcase.
3. Start the software provisioning manager from the directory to which you unpacked the Software
Provisioning Manager archive by entering the following command:
<Path_To_Unpack_Directory>/sapinst
Note
If you need to assign a virtual host name to the instance to be installed and you do not want to assign
it by entering it as a parameter using the software provisioning manager screens (see Basic Installation
Parameters [page 23]), you can alternatively assign it as follows:
<Path_To_Unpack_Directory>/sapinst SAPINST_USE_HOSTNAME=<Virtual_Host_Name>
4. The software provisioning manager now starts and waits for the connection with the SL-UI.
You can find the URL you require to access the SL-UI at the bottom of the shell from which you are running
the software provisioning manager.
...
************************************************************************
Open your browser and paste the following URL address to access the GUI
https://[<hostname>]:4237/sapinst/docs/index.html
Logon users: [<users>]
************************************************************************
...
Note
If the host specified by <hostname> cannot be reached due to a special network configuration,
proceed as follows:
1. Terminate the software provisioning manager as described in Useful Information about Software
Provisioning Manager [page 50].
2. Restart the software provisioning manager from the command line with the
SAPINST_GUI_HOSTNAME=<hostname> property.
You can use a fully-qualified host name.
Caution
After opening the browser URL, make sure that the URL in the browser starts with “https://” to avoid
security risks such as SSL stripping .
Before you reach the Welcome screen, your browser warns you that the certificate of the sapinst
process on this computer could not be verified.
1. Click on the certificate area on the left hand side in the address bar of your browser, and view the
certificate.
2. Open the certificate fingerprint or thumbprint, and compare all hexadecimal numbers to the ones
displayed in the console output of the software provisioning manager.
Proceed as follows to get the certificate fingerprint or thumbprint from the server certificate
printed in the software provisioning manager console:
1. Go to the sapinst_exe.xxxxxx.xxxx directory in the temporary directory to which the
software provisioning manager has extracted itself:
<User_Home>/.sapinst/
2. In the sapinst_exe.xxxxxx.xxxx directory, execute the sapgenpse tool with the
command line option get_my_name -p.
As a result, you get the server fingerprint or thumbprint from the server certificate.
3. Accept the warning to inform your browser that it can trust this site, even if the certificate could not
be verified.
Note
If there are errors during the self-extraction process of the software provisioning manager, you can find
the log file dev_selfex.out in the temporary directory.
7. Follow the instructions on the software provisioning manager screens and enter the required parameters.
Note
To find more information on each parameter during the Define Parameters phase, position the cursor
on the required parameter input field , and choose either F1 or the HELP tab. Then the available help
text is displayed in the HELP tab.
The digital signature of installation media and installation archives is checked automatically during the
Define Parameters phase while processing the Media Browser and - if you perform an archive-based
installation - the Software Package Browser screens.
Note that this automatic check is only committed once and not repeated if you modify artifacts such
as SAR archives or files on the media after the initial check has been done. This means that - if you
modify artefacts later on either during the remaining Define Parameters phase or later on during the
Execute Service phase - the digital signature is not checked again.
After you have entered all requested input parameters, the software provisioning manager displays the
Parameter Summary screen. This screen shows both the parameters that you entered and those that the
software provisioning manager set by default. If required, you can revise the parameters before starting the
installation.
8. To start the installation, choose Next.
The software provisioning manager starts the installation and displays the progress of the installation.
When the installation has finished, the software provisioning manager shows the message: Execution of
<Option_Name> has completed.
Only valid for 'Platform': HP-UX
Caution
HP-UX only: If you decided to use 02 as the instance number, the instance fails to start during the
installation process. For more information about the cause, see Basic Installation Parameters [page
23]. You must manually change the port number for report RSLGCOLL to continue with the installation.
Proceed as follows:
1. Go to directory /<sapmnt>/<SAPSID>/profile.
2. Edit DEFAULT.PFL.
3. Set the parameter rslg/collect_daemon/listen_port to a free port number.
9. If required, delete directories with the name sapinst_exe.xxxxxx.xxxx after the software provisioning
manager has finished. Sometimes these directories remain in the temporary directory.
10. If you want to store documents in SAP MaxDB, you can now install a SAP MaxDB Database Instance.
a. Restart the software provisioning manager as described above.
b. On the Welcome screen, choose Generic Options SAP Content Server SAP MaxDB Database
Instances .
c. Follow the instructions on the software provisioning manager screens and enter the required
parameters.
11. If you copied the software provisioning manager software to your hard disk, you can delete these files when
the installation has successfully completed.
12. For security reasons, we recommend that you remove the operating system users from the group sapinst
after you have completed the installation.
This step is only required, if you did not specify during the Define Parameters phase that the operating
system users are to be removed from the group sapinst after the execution of the software
provisioning manager has completed.
13. For security reasons, we recommend that you delete the .sapinst directory within the home directory of
the user with which you ran the software provisioning manager:
<User_Home>/.sapinst/
14. The software provisioning manager log files contain IP addresses and User IDs such as the ID of your
S-User. For security, data protection, and privacy-related reasons we strongly recommend that you delete
these log files once you do not need them any longer.
You find the software provisioning manager log files in the sapinst_instdir directory. For more
information, see Useful Information about Software Provisioning Manager [page 50].
The following sections provide additional information about the software provisioning manager.
Using the Step State Editor (SAP Support Experts Only) [page 57]
This section describes how to use the Step State Editor available in the software provisioning
manager.
This section contains some useful technical background information about the software provisioning manager
and the software provisioning manager's SL-UI.
• The software provisioning manager has a framework named “SAPinst”. For more information about the
current SAPinst Framework version and its features, see SAP Note 3207613 (SAPinst Framework 753
Central Note).
• As soon as you have started the sapinst executable, the software provisioning manager creates
a .sapinst directory underneath the /home/<User> directory where it keeps its log files. <User> is
the user with which you have started the software provisioning manager.
After you have reached the Welcome screen and selected the relevant software provisioning manager
option for the SAP system or instance to be installed , the software provisioning manager creates a
directory sapinst_instdir where it keeps its log files, and which is located directly below the temporary
directory. The software provisioning manager finds the temporary directory by checking the value of the
TEMP, TMP, or TMPDIR environment variable. If no value is set for these variables, the software provisioning
manager uses /tmp by default.
All log files which have been stored so far in the .sapinst folder are moved to the sapinst_instdir
directory as soon as the latter has been created.
If you want the sapinst_instdir directory to be created in another directory than /tmp, set the
environment variable TEMP, TMP, or TMPDIR to this directory before you start the software provisioning
manager.
export TEMP
Make sure that the installation directory is not mounted with NFS, or there might be problems when
the Java Virtual Machine is started.
The software provisioning manager records its progress in the keydb.xml file located in the
sapinst_instdir directory. Therefore, if required, you can continue with the software provisioning
manager from any point of failure, without having to repeat the already completed steps and without
having to reenter the already processed input parameters. For security reasons, a variable encryption key
is generated as soon as the sapinst_instdir directory is created by the software provisioning manager.
This key is used to encrypt the values written to the keydb.xml file.
Recommendation
We recommend that you keep all installation directories until the system is completely and correctly
installed.
• The software provisioning manager extracts itself to the temporary directory. These executables are
deleted again after the software provisioning manager has stopped running.
Directories called sapinst_exe.xxxxxx.xxxx sometimes remain in the temporary directory after the
software provisioning manager has finished. You can safely delete them.
The temporary directory also contains the log file dev_selfex.out from the self-extraction process of
the software provisioning manager, which might be useful if an error occurs.
Caution
If the software provisioning manager cannot find a temporary directory, the installation terminates with
the error FCO-00058.
• To see a list of all available software provisioning manager properties (command line options) and related
documentation, start the software provisioning manager as described above with command line parameter
-p:
./sapinst -p
• If required, stop the software provisioning manager by choosing the Cancel button.
Note
Here you find information about how to restart the software provisioning manager if its processing has been
interrupted.
Context
The processing of the software provisioning manager might be interrupted for one of the following reasons:
• You interrupted the processing of the software provisioning manager by choosing Cancel in the SL-UI.
Caution
If you stop an option in the Execute phase, any system or component installed by this option is
incomplete and not ready to be used. Any system or component uninstalled by this option is not
completely uninstalled.
Option Definition
Retry The software provisioning manager retries the installation from the point of failure
without repeating any of the previous steps.
This is possible because the software provisioning manager records its progress in
the keydb.xml file.
We recommend that you view the entries in the log files, try to solve the problem, and
then choose Retry.
If the same or a different error occurs, the software provisioning manager displays
the same dialog box again.
Stop The software provisioning manager stops the installation, closing the dialog box and
the software provisioning manager's SL-UI.
The software provisioning manager records its progress in the keydb.xml file.
Therefore, you can continue with the software provisioning manager from the point of
failure without repeating any of the previous steps. See the procedure below.
Continue The software provisioning manager continues the installation from the current point.
You can also terminate the software provisioning manager by choosing Ctrl + C but we do not
recommend this because it kills the process immediately.
The following procedure describes the steps to restart an installation, which you stopped by choosing Stop, or
to continue an interrupted installation after an error situation.
Procedure
1. Log on to the installation host as a user with the required permissions as described in Running Software
Provisioning Manager [page 46] .
2. Make sure that the installation media are still available.
For more information, see Preparing the Installation Media [page 35] .
Recommendation
Make the installation media available locally. For example, if you use remote file shares on other
Windows hosts, CIFS shares on third-party SMB-servers, or Network File System (NFS), reading from
media mounted with NFS might fail.
Note
Oracle Solaris: If you mount installation media, make sure that you do this with option nomaplcase.
3. Restart the software provisioning manager from the directory to which you unpacked the Software
Provisioning Manager archive by executing the following command:
<Path_To_Unpack_Directory>/sapinst
4. The software provisioning manager is restarting.
You can find the URL you require to access the SL-UI at the bottom of the shell from which you are running
the software provisioning manager.
...
************************************************************************
Open your browser and paste the following URL address to access the GUI
https://[<hostname>]:4237/sapinst/docs/index.html
Logon users: [<users>]
************************************************************************
...
Note
If the host specified by <hostname> cannot be reached due to a special network configuration,
proceed as follows:
1. Terminate the software provisioning manager as described in Useful Information about Software
Provisioning Manager [page 50].
If you have a supported web browser (see Prerequisites for Running Software Provisioning Manager [page
43]) installed on the host where you run the software provisioning manager, you can open this URL directly
in the shell. Otherwise, open the URL in a supported web browser that runs on another device.
Caution
After opening the browser URL, make sure that the URL in the browser starts with “https://” to avoid
security risks such as SSL stripping .
Before you reach the Welcome screen, your browser warns you that the certificate of the sapinst
process on this computer could not be verified.
Perform a new run The software provisioning manager does not continue the interrupted installa-
tion option. Instead, it moves the content of the old software provisioning man-
ager directory and all software provisioning manager-specific files to a backup
directory. Afterwards, you can no longer continue the old option.
log_<Day>_<Month>_<Year>_<Hours>_<Minutes>_<Seconds>
Example
log_01_Oct_2016_13_47_56
Note
All actions taken by the installation before you stopped it (such as creating
directories or users) are not revoked.
Caution
The software provisioning manager moves all the files and folders to a new
log directory, even if these files and folders are owned by other users. If
there are any processes currently running on these files and folders, they
might no longer function properly.
Continue with the existing one The software provisioning manager continues the interrupted installation from
the point of failure.
This section tells you how to proceed when errors occur while the software provisioning manager is running.
Context
• Stops processing
• Displays a dialog informing you about the error
1. Check SAP Note SAP Note 3207613 (SAPinst Framework 753 Central Note) for known software
provisioning manager issues.
2. If an error occurs during the Define Parameters or the Execute Service phase, do one of the following:
Note
The LOG FILES tab is only available if you have selected on the Welcome screen the relevant
software provisioning manager option for the SAP product to be installed .
If you need to access the log files before you have done this selection, you can find them in
the .sapinst directory underneath the /home/<User> directory, where <User> is the user
that you used to start the software provisioning manager.
For more information, see Useful Information about Software Provisioning Manager [page 50].
• To check the log and trace files of the software provisioning manager's SL-UI for errors, go to the
directory <User_Home>/.sapinst/
• Then continue by choosing Retry.
• If required, abort the software provisioning manager by choosing Cancel in the tool menu and restart
the software provisioning manager. For more information, see Restarting Interrupted Processing of
Software Provisioning Manager [page 53].
3. If you cannot resolve the problem, report an incident using the appropriate subcomponent of BC-INS*.
For more information about using subcomponents of BC-INS*, see SAP Note 1669327 .
This section describes how to use the Step State Editor available in the software provisioning manager.
Note
Only use the Step State Editor if the SAP Support requests you to do so, for example to resolve a
customer incident.
Prerequisites
1. Start the software provisioning manager from the command line as described in Running
Software Provisioning Manager [page 46] with the additional command line parameter
SAPINST_SET_STEPSTATE=true
2. Follow the instructions on the software provisioning manager screens and fill in the parameters prompted
during the Define Parameters phase until you reach the Parameter Summary screen.
3. Choose Next.
The Step State Editor opens as an additional dialog. Within this dialog you see a list of all steps to be
executed by the software provisioning manager during the Execute Service phase. By default all steps are
in an initial state. Underneath each step, you see the assigned software provisioning manager component.
For each step you have a Skip and a Break option.
• Mark the checkbox in front of the Break option of the steps where you want the software provisioning
manager to pause.
• Mark the checkbox in front of the Skip option of the steps which you want the software provisioning
manager to skip.
4. After you have marked all required steps with either the Break or the Skip option, choose OK on the Step
State Editor dialog.
The software provisioning manager starts processing the Execute Service phase and pauses one after
another when reaching each step whose Break option you have marked. You can now choose one of the
following:
After the software provisioning manager has completed successfully, there are a few more things you have to
do before you can use your newly-installed SAP Content Server.
Procedure
1. Set up repositories.
2. Make the repositories known to your SAP system.
3. Issue certificates, if necessary.
4. Change the password for the database users.
You do steps 1 – 3 in transaction CSADMIN in your SAP system. For detailed information on CSADMIN
and the tasks listed above, go to https://help.sap.com/nw <Choose the SAP NetWeaver Release
your SAP product is based on> SAP NetWeaver Library: Function-Oriented View Application
Server Application Server ABAP Other Services Services for Business Users Knowledge Provider
(BC-SRV-KPR) Content Management Service (BC-SRV-KPR) SAP Content Server and see the
following documentation:
Context
After you have created your repositories (see Post-Installation [page 59] ), you might want to run report
RSCMST to check that your repositories can be accessed from the SAP system.
You need to ensure the security of the users that the software provisioning manager created during the
installation.
Recommendation
The Master Password feature can be used as a simple method to obtain customer-specific passwords for
all newly created users. A basic security rule is not to have identical passwords for different users. Following
this rule, we strongly recommend individualizing the values of these passwords after the installation is
complete.
Recommendation
In all cases, the user ID and password are encoded only when transported across the network. Therefore,
we recommend using encryption at the network layer, either by using the Secure Sockets Layer (SSL)
protocol for HTTP connections, or Secure Network Communications (SNC) for the SAP protocols dialog
and RFC.
Caution
Make sure that you perform this procedure before the newly installed SAP system goes into production.
Recommendation
For security reasons, we recommend that you remove the operating system users from the group sapinst
after you have completed the installation of your SAP system.
You do not have to do this if you specified this “cleanup” already during the Define Parameters phase on the
Cleanup Operating System Users screen. Then the removal had already been done automatically when the
processing of the software provisioning manager had completed.
Operating system user <sapsid>adm Administrator for the SAP Content Server.
Operating system user sapadm SAP Host Agent administrator is the user for central
monitoring services.
Before you store data on SAP Content Server and start using the system productively, you have to make the
system settings described in this section. You can make these settings directly in the SAP System.
Prerequisites
You have to fulfill the technical prerequisites described in Installation Prerequisites [page 14].
You make the Customizing settings in the SAP System in the Implementation Guide (IMG). The individual
Customizing activities are described in the SAP reference IMG under Application Server Basis Services
Knowledge Provider . In the IMG, simply choose Execute to go to the transaction in question. For online
help, choose Documentation. Also, for detailed documentation on SAP Content Server, see the SAP Library at
https://help.sap.com/nw <Choose the SAP NetWeaver Release your SAP product is based
on> Application Server Basis Services Knowledge Provider Content Management Service and its
sub-sections. As the settings are described in detail in the SAP Library, they are only mentioned briefly here.
Procedure
http://<hostname>:<port>/sapcs?serverInfo
Note
The information on the Content Server that is the result of the test is then displayed. In this
information, the status should be running.
• Creating Content Repositories
a. In transaction CSADMIN, create at least one content repository for your Content Server.
Make sure that you change the pre-set ContentStorageName from SDB to the name of the database
instance you set during the installation procedure.
b. Send a certificate to your repository and activate the certificate.
c. From the tab page Detail, call up transaction OAC0, so that you can make the repository known in the
SAP System.
You can use the Customizing icon (a blue arrow) in change mode to jump from transaction CSADMIN
to transaction OAC0. In OAC0, you can simply accept the pre-set entries and save them.
This means that only members of specified groups (and local administrators) can execute administrative
commands. To do this, they have to enter their user name and password.
Context
Procedure
http://<hostname>:<port>/sapcsc?serverInfo
Note
The information on the Cache Server that is the result of the test is then displayed. In this information,
the status should be running (serverStatus="running").
• Making the Cache Known to the SAP System
a. In transaction SCMSCA, maintain the entries for your Cache Server.
b. If you are using distributed cache servers, you need to make additional entries.
For information on this, see both the installation guide (IMG) at Application Server Basis Services
Knowledge Provider Distribution and the SAP Library at https://help.sap.com/nw <Choose the
SAP NetWeaver Release your SAP product is based on> SAP NetWeaver Library: Function-
Oriented View Application Server Application Server ABAP Other Services Services for Business
Number Content
2786364 SAP Content Server and Cache Server 7.5 (and higher)
0181696 Caching
You can use one or more virtual TCP/IP host names for SAP servers within an SAP server landscape to hide
their physical network identities from each other. This can be useful when quickly moving SAP servers or
complete server landscapes to alternative hardware since you do not need to reinstall or reconfigure.
Prerequisites
Make sure that the virtual host name can be correctly resolved in your Domain Name System (DNS) setup.
Context
Procedure
Procedure
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using
such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.