23 Satellite Properties in the Satellite Server JSON File

The following topics provide information about the properties categorized under Satellite in the Satellite Server wcs_properties.json file:

23.1 About the Satellite Category in the Satellite Server JSON File

Properties categorized under Satellite in the Satellite Server wcs_properties.json file describe how the Satellite servlets communicate with WebCenter Sites.

Satellite Server is installed by default on the server that hosts your WebCenter Sites application. Properties categorized under Satellite configure the local Satellite servlet.

23.2 Satellite Properties in the Satellite Server JSON File

Table provides a description for each of the properties categorized under Satellite in the Satellite Server wcs_properties.json file.

Table 23-1 Satellite Properties in the Satellite Server JSON File

Property Description

bservice

This value is the servlet path for the Blob Server servlet. It is used to tell Satellite Server where to go to resolve satellite.blob tags.

Typical values include /NASApp/cs/BlobServer for iPlanet and /servlet/BlobServer for servlet runners.

Default value: /<wcsites.app.contextroot>/BlobServer

cache_folder

Applies to only legacy page caching. This property specifies the location of disk based cache data. If this property is left blank, cached data will be stored in the context's temp folder.

Default value: blank

cache_max

Applies only to legacy page caching. This property specifies the maximum number of objects to maintain in the cache. Objects are removed from the cache if the size specified is exceeded; an LRU method is used to manage cache size limits.

Default value: 1000000

contentserver.installation.folder

Applies to installations in which Satellite Server and WebCenter Sites are running in the same web application and must therefore share the user's session. This property specifies the path to the WebCenter Sites installation, enabling Satellite Server to access WebCenter Sites resources.

Possible values:
  • blank, if Satellite Server is running in a web application other than WebCenter Sites.

  • <cs_installation_dir> if Satellite Server is running in the same web application as WebCenter Sites.

Default value: <wcsites.home>

cookieprefix

Satellite Server maintains a session between itself and the remote host on behalf of the client. Satellite Server needs to know the name of the session ID cookie the application server uses so that it can be properly tracked.

Enter the possible session cookie name prefixes here, separated by a semicolon. If left blank, a default set will be used.

Default value: JSESSIONID;WebLogicSession;GX_SESSIONID

cs.satellitehosts

Specifies the host names of the servers that are hosting Satellite servlets that the CacheManager on this server (the one that hosts WebCenter Sites) needs to communicate with.

Enter a comma-separated list of host names. The value for each host must include the path to the WebCenter Sites servlets.

Use the following format: http://<hostname:port>/<servlet>/

You can use https or special ports, if necessary. If required by your configuration, be sure to specify a fully-qualified domain name.

The Satellite servlet that resides on this server is listed by default.

cs.satelliteusers

Specifies the user names for the Satellite Server hosts. Note that the user name for the Satellite servlet on this server is listed by default.

Enter a comma-separated list of user names in the order that matches the list of passwords that you specified in the cs.satellitepassword property.

expiration

Applies to inCache page caching and legacy page caching. This property specifies expiration information (in the form of a COM.FutureTense.Util.TimePattern string) for all cached objects that do not have this information specified elsewhere.

The expiration information for an object can be specified in the cachecontrol attribute on the satellite.page (and related) tags. For pages, expiration information can also be specified in the SiteCatalog's sscacheinfo column. For binary objects, the default value for the cachecontrol attribute is specified in the WebCenter Sites wcs_properties.json file.

Note that the outermost wrapper page of any request cannot specify an override, so this property is the only place where it can be controlled.

Default value: 5:0:0 */*/*

This means that everything in the Satellite Server cache expires every day at 5:00 a.m.

The format is as follows:

<hours>:<minutes>:<seconds> <daysOfWeek>/<daysOfMonth>/<months>

Possible values:
  • <hours>: 0 through 23, where 0 is midnight

  • <minutes>: 0 through 59

  • <seconds>: 0 through 59

  • <daysofweek>: 0 through 6, where 0 is Sunday

  • <daysofmonth>: 1 though 31

  • <months>: 1 through 12

Other possible values:
  • never, which means the page can expire only if the cache is full and it is the least recently used page.

  • immediate, which means to never cache the page.

file_size

Applies to legacy page caching. This property specifies the size (in kilobytes) of objects that can be cached to disk. Smaller objects are retained in memory.

This value should be adjusted for system RAM, disk speed, and so on.

Default value: 250

formaction

The Satellite servlet converts WebCenter Sites URLs that you GET or POST to into Satellite URLs. This property specifies which string to replace in the WebCenter Sites URL to create a Satellite URL.

This value is case sensitive.

Effective in Satellite Server 6, use the new satellite.form tag for all forms.

Default value: action=\”ContentServer\”

globally_replace_contentserver

If this property is set to true, Satellite Server will parse through all processable pages returned from WebCenter Sites and replace all instances of the string described by the formaction property with the string described by the newformaction property. It will also replace any occurrence of ContentServer with the string described by the servlet property.

Default value: false

hidden.encrypted

Default value: false

host

The name of the remote host system running WebCenter Sites that the Satellite engine is caching requests for.

modify.passwords

Enables you to modify passwords in Remote Satellite Server. The value of this property must be set to true to enable password modification.

Default value: false

newformaction

Specifies the replacement string in URLs to be GET'ed or POST'ed to the locally mapped servlet.

This value is case sensitive.

Effective in Satellite Server 6, use the new satellite.form tag for all forms.

Default value: action=\"Satellite\"

oracle.wcsites.satelliteserver.registered

Specifies whether Satellite Server is registered with WebCenter Sites.

Default value: false

port

The port number for communicating with the WebCenter Sites host.

Default value: 80

product.installation.type

Defines the name of the installation.

Possible values: Sites or RSS (Remote Satellite Server)

protocol

The communication protocol between the Satellite Server host and the WebCenter Sites host (generally http:// or https//).

Note that setting the protocol to https:// will not ensure secure communications. You still need to get a certificate.

security.keys.created

Indicates whether security keys are created. When security keys are created, this property is set to true automatically.

Do not modify the value of this property.

Default value: false

service

This value is the servlet path for the WebCenter Sites servlet.

It is used to tell Satellite Server where to go to resolve satellite.page tags.

Typical values include /NASApp/cs/ContentServer for iPlanet and /servlet/ContentServer for servlet runners.

Default value: /<wcsites.app.contextroot>/ContentServer

servlet

Specifies the URL pattern used to identify the Satellite Server servlet. Satellite Server will rewrite links and forms to use this URL pattern if pages are properly designed.

Default value: Satellite

sessionid.cookie.prefix

Users can now specify the prefix that is prepended to the session id cookie.

The session id cookie is the session id cookie for the host (WebCenter Sites). Satellite Server needs to pass the session id cookie to the client in order to maintain a session between WebCenter Sites and the client.

The cookie must be renamed, so it does not conflict with the session cookie that Satellite Server uses. The configurable prefix allows users who know the name of the session id cookie to construct the full cookie name. This can be used in a servlet filter or other mechanism to support custom functionality.

Default value: SS_X_

sharesession

Specifies whether the ContentServer servlet and the Satellite servlet share the user session.

If Satellite Server is running remotely, set this to false; if Satellite server and ContentServer are co-resident, set this property to true.

If this property is not set appropriately, user-specific information may be inconsistent between pages.

Default value: true

ss.username

The username for the Satellite Server user, on the Satellite Server side. This much match the value for the wcsites.satelliteserver.username property.

transparent.content-type.pattern

A regular expression denoting content types that may contain nested components such as pagelets, links to other WebCenter Sites pages, or links to blobs.

Default value: text/.*|.xml.*

username

Sepcifies the name of the attribute in the directory server that serves as the user name attribute.

Possible values:
  • WebCenter Sites and NT: uniquemember

  • LDAP, iPlanet: uid

  • LDAP, Active Directory: sAMAccount