Show TOC

Background documentationDescription of the Content Server Configuration File Locate this document in the navigation structure

 

File Structure and Parameter

As well as parameters that affect the general behavior of the server, the configuration file contains all the communication parameters necessary for each repository. Usually, the content server keeps the file up to date automatically; in other words, manual editing is not required. The transaction CSADMIN is used for maintaining and administrating the content server.

The ContentServer.INI file is vital for the smooth operation of the whole SAP Content Server. In particular, you must ensure that besides the regular Data Backups, the latest version of this file (as appropriate for the repository backup) is also always backed up (in line with the Database Backup). This is because without an up-to-date record of the repository, the content server cannot access a restored database.

Depending on the operating system the configuration file is called ContentServer.INI (Windows operating systems) or cs.conf (Unix).

Depending on the server variant different parameters or different parameter values are used. For this reason the parameters for the two files are described separately.

Location

The ContentServer.INI file must be stored in the Content Server installation directory. The storage location of file cs.conf is specified in the Web server configuration table CSConfigPath in the Web server configuration profile. When the content server is installed this value is set to <ServerRoot>/conf/cs.conf.

Structure

The file is subdivided into a number of sections. Each of these sections contains parameter-value pairs that are valid within that section. The first section is an exception, however. All entries in this section represent default values for subsequent sections. You can change these defaults in each individual section.

The sections are as follows:

[ContentServer]

The [ContentServer] section contains all generally valid parameters that influence the runtime of the server.

[contRep-<RepositoryName>]

The contRep section defines a content repository. This means that it contains all the parameters that describe access to the database repository. If the corresponding section does not exist, any repository defined in the database will be inaccessible. A [contRep-<RepositoryName>] section must be created for every repository that you want to be accessible from the SAP system.

All repository parameters can also be defined as global default settings in section [ContentServer]. They are then valid the same for all repositories, they can however by redefined for each repository if required.

General Information on Parameters

One parameter-value pair is allowed per line. Every parameter-value pair must contain the assignment sign ‘=’. Parameter-value pairs are case-sensitive.

Note Note

If you want a particular parameter to be ignored, insert a semicolon ‘;’ at the beginning of the line.

Parameters are only valid within their own sections.

End of the note.

If a number of parameters with the same name but different values exist, the last one is used.

Parameter Description for File ContentServer.INI (Windows)
Parameters for the [ContentServer]

Syntax Syntax

  1. Name: LogRequests
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: Log of all client requests in file cs_trace.txt.

Syntax Syntax

  1. Name: ResponseTrace
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: Log of all client responses in file cs_trace.txt.

Syntax Syntax

  1. Name: Log404Response
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: Log of all NOT FOUND requests in file cs_trace.txt.

Syntax Syntax

  1. Name: FullTrace
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: Log of all request/response pairs in their full length in file cs_trace.txt.

Caution Caution

This switch should only be used for diagnostic purposes and only in connection with controlled server requests. Do not activate this switch in the productive system.

End of the caution.

Syntax Syntax

  1. Name: KeepConnection
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: KeepConnection=0 ends the client connection after the response has been transferred. KeepConnection=1 keeps the connection open, thus allowing the client to send more requests on this connection. This second option enhances performance, as it saves on the resources required to establish a new connection.

Syntax Syntax

  1. Name: MaxTransferBlockSize
    Typ: Integer
    Voreinstellung: 65535
    Werte: 1..4294967296
    Obligatorisch: nein
End of the code.

Description: MaxTransferBlockSize determines the block length of the IIS responses. Zero-byte responses can occur in very busy systems. This is because no send buffer can be allocated on the server. In such cases, we recommend that you reduce the block size (for example, to a minimum of 4096 bytes). The size is specified in bytes.

maxTransferBlockSize is effective from Server Build 161.

See also:

SAP Note 328209

Parameters for the [contRep-<RepositoryName>]

Syntax Syntax

  1. Name: Storage
    Typ: Character
    Voreinstellung: ContentStorage.DLL
    Obligatorisch: ja
End of the code.

Description: The Storage parameter contains the name of the storage layer required for accessing a repository.

Syntax Syntax

  1. Name: ContentStorageHost
    Typ: Character
    Voreinstellung: localhost
    Werte: qualifizierter Hostname, IP-Adresse, localhost
    Obligatorisch: ja, wenn „Storage“ auf ContentStorage.DLL gesetzt ist.
End of the code.

Description: The ContentStorageHost determines the host on which the database containing the repository is located.

Caution Caution

The database cannot be run on any machine other than the content server machine.

End of the caution.

Syntax Syntax

  1. Name: ContentStorageName
    Typ: Character
    Voreinstellung: SDB
    Obligatorisch: ja, wenn „Storage“ auf ContentStorage.DLL gesetzt ist.
End of the code.

Note Note

You need to change the default value SDB if a different name was used for the Database Instance when the Content Server was installed.

End of the note.

Description: The parameter ContentStorageName contains the name of the database instance.

Syntax Syntax

  1. Name: ContRepRoot
    Typ: Text
    Werte: jeder gültige Systempfad
    Obligatorisch: ja, wenn „Storage“ auf FileSystemStorage.dll gesetzt ist.
End of the code.

Description: ContRepRoot specifies the root directory for this repository. A full, absolute path name to a directory that exists (rsp. is mounted) must be specified. This directory must have sufficient authorizations to create subdirectories for the user ID, who started the content server.

Syntax Syntax

  1. Name: ContRepDescription
    Typ: Character
    Voreinstellung: ""
    Werte: Freitext
    Obligatorisch: ja
End of the code.

Description: ContRepDescription contains a free text line that explains what the repository is used for.

Syntax Syntax

  1. Name: Security
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: ja
    
End of the code.

Description: Signature checking should always be switched on in a productive system.

Note Note

This is because signature checking is the only method of preventing unauthorized access to documents.

However, it may be necessary to temporarily switch off signature checking if you are analyzing problems or carrying out an installation.

End of the note.

If there are inconsistencies between the content server and the SAP system, documents cannot be accessed. In this case, you should remove all certificates from the content server and in Customizing. The transactions involved are CSADMIN and OAC0.

Syntax Syntax

  1. Name: DefaultDocProt
    Typ: Character
    Voreinstellung: ""
    Werte: {r c u d} r - Read, c - Create, u - Update, d - Delete
    Obligatorisch: nein
End of the code.

Description: DefaultDocProt determines document access protection for this repository. The default value for the security level can be overwritten when this document is stored. As the default value is usually used, however, this parameter is relatively unimportant. This parameter mainly influences whether or not a signature is required for creating a document.

Syntax Syntax

  1. Name: sqltrace
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
    
End of the code.

Description: If sqltrace==true, an SQL trace is written to the directory c:\winntsystem32. This trace should be activated for diagnostic purposes only, and is switched off in a productive system.

Syntax Syntax

  1. Name: driver
    Typ: Character
    Voreinstellung: LiveCache
    Werte: ODBC-Driver-Name
    Obligatorisch: nein
End of the code.

Description: driver contains the ODBC driver names required for DB access. The suitable ODBC driver has to be registered under the driver name in the ODBC service layer.

Only the ODBC drivers of the database instance are available for productive operation.

Description for File cs.conf (Unix)
Parameters for the [ContentServer]

Syntax Syntax

  1. Name: AdminSecurity
    Typ: Boolean
    Voreinstellung: 0
    Werte: 0, 1
    Obligatorisch: nein
End of the code.

Description: Switches administrative authentication on and off. If AdminSecurity is activated, the server for security-relevant administration URLs sends return code “401 (authorization required)“ back to the client. Only when a valid user and password for an administration request is sent by the client, does the content server process this command.

Syntax Syntax

  1. Name: AdminSecurityGroup
    Typ: Text
    Voreinstellung: keine
    Obligatorisch: ja, wenn “AdminSecurity” auf 1 gesetzt ist
End of the code.

Description: The content server checks whether the operating system user specified in the request is a member of the user group specified in AdminSecurityGroup. When the content server is installed this group is interrogated and assigned the default value “sapsys”.

Syntax Syntax

  1. Name: AuthService
    Typ: Text
    Voreinstellung: local
    Werte: NIS, Local
    Obligatorisch: nein
End of the code.

Description: AuthService specifies the password or group file against which the transferred user is to be checked. If AuthService is not specified the check is always made against /etc/passwd. If „AuthService=NIS“ is set, the check is made against the “Network Information System (NIS)“. The check against /etc/password can also be set explicitly by using „AuthService=Local“.

Syntax Syntax

  1. Name: TraceLevel
    Typ: Text
    Voreinstellung: error
    Werte: emergency, alert, critical, error, warning, notice, info, debug
    Obligatorisch: nein
End of the code.

Description: TraceLevel specifies, how detailed the actions in content server are to be recorded. The lower the trace level, the quicker the server log file grows. Trace level debug is only relevant for maintenance and diagnosis. Generally the content server cannot issue messages that exceed the trace level set for the Web server. So, if the trace level of the Web server is set to Warning and the trace level of the content server to debug, no messages of type notice, info, or debug will be issued.

If you change the trace level of the Web server, you must restart it.

Syntax Syntax

  1. Name: TraceOverride
    Typ: Boolean
    Werte: 0
    Obligatorisch: nein
End of the code.

Description: You can use this parameter to override the trace level of the Web server for diagnostic purposes. All content server actions are logged with at least the trace level of the Web server. This parameter is intended for diagnostic and support purposes, as it enables the debug trace to be activated without having to restart the server.

Parameters for the [contRep-<RepositoryName>]

Syntax Syntax

  1. Name: StorageDriver
    Typ: Text
    Werte: SAPDBStorage, FSStorage
    Obligatorisch: ja
End of the code.

Description: StorageDriver specifies the storage medium the repository is created on.

Syntax Syntax

  1. Name: Storage
    Typ: Text
    Werte: ContentStorage.dll, FileSystemStorage.dll
    Obligatorisch: ja, aber „deprecated“
End of the code.

Description: Parameter Storage is included for compatability reasons and at present it has the same meaning as the parameter StorageDriver.

Syntax Syntax

  1. Name: ContRepRoot
    Typ: Text
    Werte: jeder gültige Systempfad
    Obligatorisch: ja, wenn „StorageDriver“ auf FSStorage gesetzt ist.
End of the code.

Description: ContRepRoot specifies the root directory for this repository. A full, absolute path name to a directory that exists (rsp. is mounted) must be specified. This directory must have sufficient authorizations to create subdirectories for the user ID, who started the content server.

Syntax Syntax

  1. Name: ContentStorageName
    Typ: Text
    Werte: jeder gültige SAPDB-Instanzname
    Obligatorisch: ja, wenn „StorageDriver“ auf „SAPDBStorage“ gesetzt ist.
End of the code.

Description: ContentStorageName is the name of the SAPDB instance, in which the current repository is stored.

Syntax Syntax

  1. Name: ContentStorageHost
    Typ: Text
    Werte: jeder gültige Hostname, IP-Adresse
    Obligatorisch: ja, wenn „StorageDriver“ auf „SAPDBStorage“ gesetzt ist.
End of the code.

Description: ContentStorageHost is the name of the host, on which the SAPDB instance is running.

Syntax Syntax

  1. Name: SQLTrace
    Typ: Boolean
    Obligatorisch: nein
End of the code.

Description: If SQLTrace is activated, all database operations are recorded. The resulting log is used by SAP for support and diagnosis purposes. In normal operation this trace should always be deactivated, since the resulting traces become very large and affect the performance of the server.

Syntax Syntax

  1. Name: ContRepDescription
    Typ: Text
    Obligatorisch: nein
End of the code.

Description: Free text description of the repository logged in transaction CSADMIN.

Syntax Syntax

  1. Name: UncompressedMimes
    Typ: Text
    Werte: alle
    Obligatorisch: nein
End of the code.

Description: This parameter deactivates the compression for all new objects you want to create.

Syntax Syntax

  1. Name: Security
    Typ: Boolean
    Voreinstellung: 0
    Obligatorisch: nein
End of the code.

Description: Security activates and deactivates the signature check for URLs directed to this repository. To check signatures an appropriate certificate must have already been sent to the content server and activated.

Syntax Syntax

  1. Name: DefaultDocProt
    Typ: Text
    Werte: c, r, u, d
    Obligatorisch: nein
End of the code.

Description: Specifies the security level for checking signatures of documents.