Oracle® Communications Service Broker System Administrator's Guide Release 6.0 Part Number E23523-02 |
|
|
View PDF |
This appendix contains reference information on directory structures and directory contents, along with details about the start-scripts, JDKs and installer files.
This section specifies the directory structure, directory contents and start-scripts for administration clients.
All administration clients are installed under the directory:
Linux and Solaris: Oracle_home/ocsb60/admin_console
Oracle_home is the Oracle Home directory you defined when you installed the product.
Table A-1 describes the directory structure and the contents of the directory structure.
Table A-1 Directory Contents and Structure for Administration Clients Relative to Oracle_home/ocsb60
Directory | Description |
---|---|
admin_console |
Top-level directory for all administration clients. Contains start-scripts for:
Also contains files related to log4j:
|
admin_console/applications |
Created during start-up. Empty directory. |
admin_console/extensions |
Extensions to the Administration console specific to the features installed. |
admin_console/extensions_cef |
Extensions to the Administration console specific to the features installed. |
admin_console/domain_configuration |
Contains these directories:
|
admin_console/modules |
Contains all OSGi bundles for the administration clients, the Processing Server and the Signaling Server. |
admin_console/osgi |
Contains OSGi-specific configuration for the Administration Console processes. |
admin_console/properties |
It contains property files used by the start-scripts for:
|
admin_console/scripts |
Contains these scripts used for domain creation:
Contains the /database directory containing scripts for configuring databases for the Service Broker features that require it. |
admin_console/utils |
Contains utilities used by the SVC and VPN features. |
admin_console/workspace |
Contains metadata for administration clients. |
Table A-2 give information about start-scripts for Service Broker.
Table A-2 Start-scripts for the Administration Clients
Script | Description |
---|---|
script.sh |
Starts the Scripting Engine. script.sh calls common.sh. See "Using Scripts for Configuration and Management" for details. |
start.sh |
Starts the Standalone Administration Console. start.sh calls common.sh. |
web.sh |
Starts the Web Administration Console server. web.sh calls common.sh. |
host.sh |
Starts the Domain Web server. host.sh calls common.sh. See "Starting and Stopping Processing Servers and Signaling Servers" for information on how to use the script. |
common.sh |
Starts the Standalone Administration Console, Web Administration Console server, Scripting Engine, and the Domain Web server based on the environment variables set by the script that calls it. Defines the environment variables that send additional arguments to the JVM:
|
Table A-3 lists property files in
Oracle_home/admin_console/properties and their settings.
Table A-3 Property files used by the Administration Clients
Property File | Description |
---|---|
common.properties |
Defines properties common to the:
The properties specified are:
See the common.properties file and Table A-9 for details on the property settings. See Table A-10 for information on the security entries. |
create_db_table.properties |
Defines properties for the SVC and VPN applications. The properties specified are:
|
hosting.properties |
Defines properties for the Domain Web server. The properties specified are:
See hosting.properties and Table A-9 for details on the property settings. See Table A-10 for information on the security entries. |
script.properties |
Defines properties for the Domain Web server. The properties specified are:
See script.properties file and Table A-9 for details on the property settings. See Table A-10 for information on the security entries. |
standalone.properties |
Defines properties for the Standalone Administration Console. The properties specified are:
See the standalone.properties file and Table A-9 for details on the property settings. See Table A-10 for information on the security entries. |
web.properties |
Defines properties for the Web Administration Console server. The properties specified are:
See the web.properties file and Table A-9 for details on the property settings. See Table A-10 for information on the security entries. |
This section specifies the directory structure, directory contents and start-scripts for Processing Servers and Signaling Servers.
Processing Servers and a Signaling Servers are installed under the directory:
Oracle_home/ocsb60/managed_server
Oracle_home is the Oracle Home directory you defined when you installed the product.
Table A-4 describes the directory structure and the contents of the directory structure.
Table A-4 Directory Contents and Structure for Processing Servers and Signaling Servers relative to Oracle_home/ocsb60
Directory | Description |
---|---|
managed_server |
Top-level directory for a Processing Server and a Signaling Server. Contains start-scripts for the Processing Server and the Signaling Server. Contains the property file server.properties. Also contains files related to log4j:
These files are relevant up the point in the platform life cycle when the bundle for the log4j service is started. After this point, this configuration is overridden by the configuration in the log4j service itself. |
managed_server/config |
Contains configuration data. |
managed_server/modules |
Contains all necessary bundles to start the OSGi framework and bundles for:
The bundles in this directory are the minimal set necessary to initiate the server and load the contents of the domain configuration directory. |
managed_server/osgi |
A working directory for the Managed Server process. |
managed_server/ss7 |
Contains binaries for the SS7 stacks for TDM and Sigtran. |
Table A-5 gives information about start-scripts for Processing Servers and Signaling Servers.
Table A-6 gives information property files in:
Oracle_home/managed_server/properties
Table A-6 Property Files Used by Processing Servers and Signaling Servers
Property File | Description |
---|---|
server.properties |
Defines properties common for Processing Servers and Signaling Servers. The properties specified are:
See the server.properties file and Table A-9 for details on the property settings. |
This section specifies the directory structure and directory contents for domains.
Domain directories are created, one for each domain, under the domains home directory, by the domain creation script.
Domains_home/Domain_dir
Domains_home is the directory where you store all domain directories, also know as domain configuration directories. For example: /home/oracle/domains/
Domain_dir is where the domain configuration is stored
Domain directories are defined in the domain_path parameter when you run the domain creation script. Normally, all domain directories are created under the same Domains Home directory.
Table A-7 describes the directory structure and contents of the directory structure.
Table A-7 Directory Contents and Structure for Domains relative to Domains_home
Directory | Description |
---|---|
Domain_dir |
Top-lever directory for a domain. Contains the domain configuration file initial.zip. Contains the properties file domain.properties (for Oracle internal use only). This directory is passed to the server start script and this is where a server takes its configuration from. |
Domain_dir/modules |
Contains all necessary bundles to start the domain functions: processing tier modules, signaling tier modules, or both. |
Domain_dir/protected |
Contains the domain credential file and the master passwords file protecting the credential file. Both files are encrypted. |
Domain_dir/workspace |
Contains domain configuration while it is being edited either through the Administration Console or configuration mbeans. |
Table A-8 gives information about the environment variables used.
Table A-9 describes the general system properties defined for Oracle Communications Service Broker. The security-related property entries are listed in Table A-10.
Table A-9 Description of System Properties
System Property | Description |
---|---|
axia.console.log4j.server.port |
The port to use for static log4j XML logging service traffic. Set in common.properties |
axia.platform |
Defines the start mode. These default settings must not be changed:
|
diameter.watchdog.for.dynamic.peers |
Boolean. Defines whether the Diameter SSU should send Device-Watchdog-Request (DWR) commands to dynamic Diameter peers. true - Directs Diameter SSU to send DWR commands to dynamic peers. false - Stops Diameter SSU from sending DWR commands. This is the default setting. Use AXIA_OPTS to change this setting before starting the Signaling Servers server. This example sets this setting to true: export AXIA_OPTS="-Ddiameter.watchdog.for.dynamic.peers=true" The Diameter SSU applies this property only when dynamic peers are allowed. |
diameter.tcp.keepalive.for.client.peers |
Boolean. Defines whether the TCP socket option SO_KEEPALIVE for Diameter dynamic peers is enabled. true - Enables SO_KEEPALIVE. false - Disables SO_KEEPALIVE. This is the default setting. Use AXIA_OPTS to change this setting before starting the Signaling Servers server. This example sets this setting to true: export AXIA_OPTS="-Ddiameter.tcp.keepalive.for.client.peers=true" The Diameter SSU applies this property only when dynamic peers are allowed. |
log4j.configuration |
The name of the static log4j XML configuration file. Set in common.properties for the administration tools. Set in server.properties for the Processing Server and the Signaling Server. |
org.eclipse.equinox.http.jetty.http.port |
Specifies the HTTP port number the Jetty listens for HTTP traffic on if org.eclipse.equinox.http.jetty.http.enabled is set to true. Default value is 9000. Set in:
The setting in web.properties defines the port for the Web Administration Console server. The setting in hosting.properties defines the port for the Domain Web server. This setting must correspond to the port defined when the domain configuration was created. |
org.eclipse.equinox.http.jetty.http.enabled |
Boolean. Specifies whether HTTP is used by the Jetty server. Set this property to:
Set in:
Must always be set to false in script.properties, standalone.properties, and web.properties. |
org.eclipse.equinox.http.jetty.https.enabled |
Boolean. Specifies if HTTPS is used by the Jetty server. Set this property to:
Set in:
Must always be set to false in script.properties, standalone.properties, and web.properties. |
org.eclipse.equinox.http.jetty.https.port |
Specifies the HTTP port number to use for HTTP communication if org.eclipse.equinox.http.jetty.https.enabled is set to true. The default value is 9000. Set in web.properties and hosting.properties. |
org.eclipse.equinox.http.jetty.other.info |
Specifies which help-system to use for the Administration Console. Ignored, for future use. Set in web.properties. |
profile.db.dbname |
Specifies the name of the profile database server used by the SVC and VPN features. The default value is orcl. Set in the create_db_table.properties file. |
profile.db.port |
Specifies the port of the profile database server used by the SVC and VPN features. The default value is 1521. Set in the create_db_table.properties file. |
profile.db.server |
Specifies the IP address of the profile database server used by the SVC and VPN features. There is no default value. Set in the create_db_table.properties file. |
profile.db.user |
Specifies the database user used by the profile database server. Used by the SVC and VPN features. The default value is ocsb. Set in the create_db_table.properties file. |
Table A-10 lists the security-related property file entries. See Table A-9 for the other system property file entries.
Table A-10 System Security Properties
System Security Property | Description |
---|---|
axia.admin.verify.hostname |
Boolean. Determines whether hostname verification is required for each administrator certificate connection. Default value is true. Set in common.properties. |
axia.basic.auth |
Boolean. Specifies if HTTP basic authentication is used when the Web Administration Console connects to the Web Administration Console server. Set this property to:
Set in web.properties. |
axia.console.password.validation.enabled |
Boolean. Enables/disables password strength validation. If true, the restrictions in axia.console.password.validation.min_length, axia.console.password.validation.min_length, axia.console.password.validation.require_lower, axia.console.password.validation.require_upper, and axia.console.password.validation.require_digit are enforced. Default value is true. Set in common.properties. |
axia.console.password.validation.min_length |
Defines the minimum password length. Enforced if axia.console.password.validation.enabled is set to true. Default value is 6 characters. Set in common.properties. |
axia.console.password.validation.require_lower |
Boolean. Enables/disables requirement that passwords include at least one lower-case character. Enforced if axia.console.password.validation.enabled is set to true. Default is true. Set in common.properties. |
axia.console.password.validation.require_upper |
Boolean. Enables/disables requirement that passwords include at least one upper-case character. Enforced if axia.console.password.validation.enabled is set to true. Default value is true. Set in common.properties. |
axia.console.password.validation.require_digit |
Boolean. Enables/disables requirement that passwords include at least one digit. Enforced if axia.console.password.validation.enabled is set to true. Default value is true Set in common.properties. |
axia.ssl |
Boolean. There are two of these settings and the default value for both is true. One is in the common.properties file that controls whether the Administration Console is requried to use SSL security in all traffic. The other is the master SSL switch for the managed server. If false, no traffic with the managed server is required to use SSL security. If true, SSL security is required. |
axia.ssl.cipher_suites |
Specifies the combinations of ciphers that Service Broker supports for SSL communication between the Administration Console and its clients. The choices are:
|
https.cipherSuites |
Specifies the combinations of ciphers that Service Broker supports for HTTPS communication between the Administration Console and its clients. The choices are:
|
javax.net.ssl.keyStore |
The file name of the keystore to use for Processing Servers, Signaling Servers and administration tools. The keystore is a file that contains public and private keys used to establish SSL connections. Set in common.properties for the administration tools. Set in server.properties for the Processing Server and the Signaling Server. |
javax.net.ssl.trustStore |
The file name of the truststore to use for Processing Servers, Signaling Servers and administration tools. The truststore is a file that contains public certificates used to establish SSL connections. Set in common.properties for the administration tools. Set in server.properties for the Processing Server and the Signaling Server. |
org.eclipse.equinox.http.jetty.ssl.keystore |
Specifies the keystore to use for the Jetty HTTPS connection between the Web Administration Console and the Web Administration Console server. This entry is commented-out by default. If not specified, the same keystore as defined in the property javax.net.ssl.keyStore is used. Set in web.properties. and hosting.properties. |
Table A-11 gives information about the directory structure and contents of a domain configuration.
Table A-11 Directory Structure for a Domain Configuration
Directory | Description |
---|---|
Domain_home |
Top-level directory for a domain configuration. This directory contains:
|
Domain_home/modules |
Contains binaries and configuration data for Processing Servers and Signaling Servers in the domain. |
A bundled JDK can be installed when an administration client, a Processing Server, and a Signaling Server are installed.
These files are located in under the directory:
Linux and Solaris: Oracle_home/ocsb60
Oracle_home is the Oracle Home directory you defined when you installed the product.
Table A-12 describes the directory structure and the contents of the directory structure.
Table A-12 Directory Structure for JDKs Relative to Oracle_home/ocsb60
Directory | Description |
---|---|
jdkversion |
Contains Sun HotSpot JDK. version correlates to the version of the JDK, for example 1.6.0_14 This directory is created only if you specified to install Sun HotSpot JDK during the installation. |
jrrt-version |
Contains Oracle JRockit JDK. version correlates to the version of the JDK, for example 3.1.0-1.6.0 This directory is created only if you specified to install Oracle JRockit JDK during the installation. |
A set of files and directories are created by Oracle Universal Installer.
These files are located under the directory:
Oracle_home/ocsb60
Oracle_home is the Oracle Home directory you defined when you installed the product.
Table A-13 describes the directory structure and the contents of the directory structure.
Safe services is a set of services that are installed and running when the platform is in state SAFE MODE. They are the bare minimum of services that needs to be running in order to fetch server services, applications, and protocol adapters for the domain configuration and start them. Table A-14 lists these services.
See "Life Cycle of Processing Servers and Signaling Servers" for details on SAFE MODE.
Service | OSGi Bundles |
---|---|
Provisioning service |
oracle.axia.platform.provisioningservice |
Logging-related |
com.bea.core.apache.log4j oracle.axia.platform.loggingservice |
Services related to Equinox OSGi Framework |
org.eclipse.osgi.services org.eclipse.osgi.services org.eclipse.equinox.ds org.eclipse.equinox.util |