Create the Common Configuration Layer

The Content Engine package installed in the Unpack Content Engine Components step contains a skeleton configuration layer. This is a folder tree containing configuration files that you can use as a basis for your configurations. All the property settings in these files are commented out. To create a configuration, you copy this tree to the location specified in your bootstrap layer (e.g. /etc/escenic/engine/common) and edit the contents to set the properties you need. You will find the skeleton configuration layer located in /opt/escenic/engine/siteconfig/config-skeleton.

On your assembly-host, while logged in as escenic:

  1. Copy the skeleton configuration layer to /etc/escenic/engine/common:

    $ cp -r /opt/escenic/engine/siteconfig/config-skeleton/* /etc/escenic/engine/common/
  2. Copy the delivered security configuration files to /etc/escenic/engine/common

    $ cp -r /opt/escenic/engine/security/ /etc/escenic/engine/common/
  3. Open /etc/escenic/engine/common/ServerConfig.properties for editing, and make sure the following properties are uncommented and set correctly for your site:

    databaseProductName

    The name of the database you are using. Currently allowed values are:

    • MySQL

    ldapProductName

    The name of the LDAP server you are using. Currently allowed values are:

    • OpenLdap

    ldapProductVersion

    The version number of the LDAP server you are using. In the case of OpenLDAP, you can get the version number by entering:

    # slapd -V
    filePublicationRoot

    The path of the folder in which all binary files served by the Content Engine are stored (multimedia files - video, audio, images, Word documents, PDF files and so on). You should set this to:

    filePublicationRoot=/var/lib/escenic/publications/

    The path you specify must include a trailing slash.

    webPublicationRoot

    The URL root you want to be used for all your publications. For example http://my-company.com/. The URLs of your publications are formed by appending the publication name to this string. This property is in general used only for development purposes. In production, it is often the case that each publication has its own root URL.

  4. Open /etc/escenic/engine/common/Ldap.properties for editing, and make sure the following properties are uncommented and set correctly for your site:

    providerUrl

    Must be set as follows:

    providerUrl=ldap://ldap-host-ip-address:389/dc=your-company,dc=com

    where:

    • ldap-host-ip-address is the host name or IP address of the LDAP server, as specified when you installed it (see Install LDAP Server).

    • your-company is the same company name you used when installing the LDAP server (see Install LDAP Server).

    userid

    The user ID that will be used to log in to the LDAP server (often called the principal). It can be specified either as a distinguished name or as a search specification. The user you specify must have access to everything stored below the root node specified with root below. For development or test systems, you can use the root user. In the case of OpenLDAP, this means that you should enter the name you entered in response to the LDAP account for root prompt during installation (see Install LDAP Server):

    userid=cn=admin,dc=your-company,dc=com
    password

    The password that will be used to log in to the LDAP server. If you are using the root user for this purpose, then in the case of OpenLDAP, you should enter the password you entered in response to the Administrator password: prompt during installation (see Install LDAP Server):

    password=password
    basedn

    The base distinguished name (dn) you specified when defining the LDAP schema:

    basedn=dc=your-company,dc=com
    root

    The name of the Content Engine's root node. You can set this to:

    root=ou=ECE
  5. Open /etc/escenic/engine/common/connector/ReadConnector.properties for editing, and make sure the following property is uncommented and set correctly:

    dataSourceName

    Must be set as follows:

    dataSourceName=java:comp/env/jdbc/ECE_READ_DS

    This is the name of the read database pool that you defined when installing the application server (see Install Application Server).

    Do not modify any of the other settings in this file.

  6. Open /etc/escenic/engine/common/connector/UpdateConnector.properties for editing, and make sure the following property is uncommented and set correctly:

    dataSourceName

    Must be set as follows:

    dataSourceName=java:comp/env/jdbc/ECE_UPDATE_DS

    This is the name of the update database pool that you defined when installing the application server (see Install Application Server).

    Do not modify any of the other settings in this file.

  7. Open /etc/escenic/engine/common/neo/io/managers/ContentManager.properties for editing, and make sure the following properties are uncommented and set correctly:

    readConnector

    Must be set as follows:

    readConnector=/connector/ReadConnector
    updateConnector

    Must be set as follows:

    updateConnector=/connector/UpdateConnector
  8. If you are creating a multi-host installation, then you should skip this step now, and add these settings to your editorial hosts' configuration layer (see Create Host Configuration Layers).

    Open /etc/escenic/engine/common/com/escenic/webstart/StudioConfig.properties for editing, and make sure the property property.com.escenic.client.webservice.url is uncommented and set as shown below:

    property.com.escenic.client.webservice.url=http://host-name:port/webservice/index.xml

    where:

    host-name is the host name or IP address of your editorial host and port is the number of the port on which Tomcat is listening. This property identifies the web service that Content Studio communicates with: if you do not set it correctly, then Content Studio will not work.

    You can also set the property vmargs in this properties file. You can use this property to set arguments to be passed to the JVM when Content Studio is run, should this be necessary.