CoreMedia 6 //Version 5.3.27
CoreMedia Operations Basics CoreMedia Operations Basics |
CoreMedia Operations Basics
Copyright CoreMedia AG © 2012 CoreMedia AG Ludwig-Erhard-Straße 18 20459 Hamburg International All rights reserved. No part of this manual or the corresponding program may be reproduced or copied in any form (print, photocopy or other process) without the written permission of CoreMedia AG. Germany Alle Rechte vorbehalten. CoreMedia und weitere im Text erwähnte CoreMedia Produkte sowie die entsprechenden Logos sind Marken oder eingetragene Marken der CoreMedia AG in Deutschland. Alle anderen Namen von Produkten sind Marken der jeweiligen Firmen. Das Handbuch bzw. Teile hiervon sowie die dazugehörigen Programme dürfen in keiner Weise (Druck, Fotokopie oder sonstige Verfahren) ohne schriftliche Genehmigung der CoreMedia AG reproduziert oder vervielfältigt werden. Unberührt hiervon bleiben die gesetzlich erlaubten Nutzungsarten nach dem UrhG. Licenses and Trademarks All trademarks acknowledged. 12.Feb 2013
CoreMedia Operations Basics 2 CoreMedia Operations Basics |
1. Introduction ...... 1 1.1. Audience ...... 2 1.2. Typographic Conventions ...... 3 1.3. Change Chapter ...... 4 2. System Requirements ...... 5 2.1. Hardware Requirements ...... 7 2.2. Java ...... 9 2.3. Databases ...... 10 2.4. Servlet Containers ...... 11 3. Basics of Operation ...... 12 3.1. CoreMedia CMS Directory Structure ...... 13 3.2. Communication between the System Components ...... 14 3.2.1. Communication Through a Firewall ...... 15 3.2.2. Binding Only a Single Network Interface ...... 19 3.2.3. Encrypting CORBA Communication Using SSL ...... 19 3.2.4. Encrypting CORBA with SSL and bind to a Single Network Interface ...... 25 3.2.5. Configuring SSL for the Embedded Content Server Web Server ...... 25 3.2.6. Preparing Tomcat for Https Connection ...... 26 3.2.7. Troubleshooting ...... 28 3.3. Starting the Components ...... 29 3.3.1. Starting CM Programs with cm/cmw ...... 29 3.3.2. Starting the Server Utilities with cm64.exe ...... 31 3.3.3. Configuration of the Start Routine with JPIF Files ...... 31 3.3.4. Which JVM will be used? ...... 34 3.4. Configuration of CoreMedia Components ...... 35 3.5. CoreMedia Components as Windows Services ...... 36 3.5.1. Install CoreMedia Components as Windows Ser- vices ...... 36 3.5.2. Registration of Windows Services ...... 37 3.5.3. Start and Stop Windows Services ...... 39 3.6. CoreMedia Licences ...... 41 3.7. Logging ...... 44 3.8. CM Watchdog/Probedog ...... 45 3.8.1. Starting the Watchdog ...... 46 3.8.2. Watching Databases ...... 47 3.8.3. Configuration in components.properties ...... 48 3.8.4. Configuration in watchdog.properties ...... 48
CoreMedia Operations Basics iii CoreMedia Operations Basics |
3.8.5. Configuration in watchdog.xml ...... 48 3.8.6. Watchdog Result Codes ...... 64 3.9. JMX Management ...... 66 3.9.1. RMI Connector ...... 66 3.9.2. JMXMP Connector ...... 68 3.9.3. MX4J Connector ...... 68 3.9.4. Starting JConsole ...... 72 3.9.5. Logging ...... 72 3.10. Web Application Deployment ...... 74 3.10.1. IBM WebSphere Application Server ...... 74 4. Support ...... 78 Glossary ...... 83 Index ...... 93
CoreMedia Operations Basics iv CoreMedia Operations Basics |
List of Figures
3.1. IOR inquiry and answer between CoreMedia Client and Serv- er ...... 14 3.2. Schema of the SSH tunnel ...... 16
CoreMedia Operations Basics v CoreMedia Operations Basics |
List of Tables
1.1. Typographic conventions ...... 3 1.2. Pictographs ...... 3 1.3. Changes ...... 4 3.1. Example ports ...... 20 3.2. Optimization options ...... 32 3.3. Parameters of the install tool ...... 36 3.4. Elements of a license file ...... 42 3.5. Action to be used to check a certain component ...... 45 3.6. Attributes of the Component element ...... 49 3.7. General attributes of the Action element ...... 50 3.8. Custom Action ...... 50 3.9. Action DB ...... 51 3.10. Action HTTP ...... 52 3.11. JMX Action ...... 53 3.12. ProcessStatus ...... 54 3.13. Action ServerMode ...... 55 3.14. Server Query ...... 56 3.15. Action ServiceStatus ...... 57 3.16. Action Script ...... 58 3.17. WorkflowServerQuery ...... 59 3.18. Attributes of the Edge element ...... 60 3.19. watchdog result codes ...... 64 4.1. Log files check list ...... 79
CoreMedia Operations Basics vi CoreMedia Operations Basics |
List of Examples
3.1. Code to insert into server.xml ...... 27 3.2. Threaddump with nio-classes ...... 28 3.3. Output of executable CoreMedia components ...... 30 3.4. workflowserver.jpif ...... 38 3.5. Configure log action in .properties file ...... 39 3.6. A sample license file ...... 42 3.7. Example for logback.xml configuration in IBM Web- Sphere ...... 75 3.8. Configuring applicationContext.xml for IBM WebSphere ORB ...... 75 3.9. Log Output with replaced ORB ...... 76
CoreMedia Operations Basics vii Introduction |
1. Introduction
CoreMedia CMS is a content management system for easy and convenient creation and administration of up-to-date content, interactive features and personalized web pages. For this purpose, CoreMedia provides an environment for online editorial workflow processes. Users can simultaneously create and edit content and so conveniently maintain a website. Integration of contents from print editorial systems, office applications and news agencies (dpa, SID, Reuters, etc.) is possible via import mechanisms. Internet display of the content or creation of various export formats is made possible by the versatile CoreMedia Content Application Engine (CAE). Configuration and operation of the different CoreMedia components is described in the correspondent manuals. This manual describes some overall tasks and knowledge that is important for all of the components. ➞ An overview of the architecture of the CoreMedia CMS system in ??? ➞ Some basics about the operating environments used by CoreMedia 6 are described in Chapter 2, System Requirements [5]. ➞ the administration essentials of CoreMedia CMS e.g. how to start the compon- ents, in Chapter 3, Basics of Operation [12]
CoreMedia Operations Basics 1 Introduction | Audience
1.1 Audience
This manual is dedicated to administrators and developers of CoreMedia CMS install- ations. They will find descriptions of all tasks necessary for installation, configuration and operation of a CoreMedia system.
CoreMedia Operations Basics 2 Introduction | Typographic Conventions
1.2 Typographic Conventions
We use different fonts and types in order to label different elements. The following table lists typographic conventions for this documentation:
Element Typographic format Example Table 1.1. Typographic conventions Source code Courier new Command line entries Parameter and values Menu names and entries Bold, linked with | Open the menu entry Format|Normal Field names Italic Enter in the field Heading CoreMedia Components The CoreMedia Component Entries In quotation marks Enter "On" (Simultaneously) pressed Bracketed in "<>", linked with Press the keys
In addition, these symbols can mark single paragraphs:
Pictograph Description Table 1.2. Pictographs Tip: This denotes a best practice or a recommendation.
Warning: Please pay special attention to the text.
Danger: The violation of these rules causes severe damage.
Summary: This symbol indicates a summary of the above text.
CoreMedia Operations Basics 3 Introduction | Change Chapter
1.3 Change Chapter
In this chapter you will find a table with all major changes made in this manual.
Section Version Description Table 1.3. Changes Section 3.8, “CM Watch- 5.3.25 Added description of Watch- dog/Probedog” [45] dog web application.
CoreMedia Operations Basics 4 System Requirements |
2. System Requirements
A CoreMedia system has to rely on several different (3rd party) software compon- Use only recommended ents, for proper operation. CoreMedia tests CoreMedia CMS with the most common systems combinations used by our customers and distinguishes between two levels of ap- proved infrastructure components: ➞ Certified level Certified infrastructure components are extensively tested to work with the CoreMedia CMS system. Every infrastructure component approved with the first final CMS Release is certified. It is recommended to use these compon- ents for productive systems. ➞ Supported level Supported infrastructure components will also work with CoreMedia com- ponents but they are tested less exhaustively, because they are released after the first final CMS Release. They also can be used for productive sys- tems. Refer to the notes.html file for announcements of additionally-suppor- ted environments or the appendix of this manual.
Note: the state "deprecated" is also used on occasion. Deprecated infrastructure components are either of certified or supported level in the current version of the CoreMedia CMS but do not carry official approval by CoreMedia beyond this version.
All necessary security updates for approved versions, recommended by vendors of infrastructure components (such as OS, Java, database...), are supported by CoreMedia automatically. This does not apply to feature updates!
You will find the approved components in the Supported Operation Environments Supported operation document in the download area. In the following sections you will find some gen- environments eral hints for the usage of these components: ➞ Java platforms in Section 2.2, “Java” [9], ➞ databases in Section 2.3, “Databases” [10], ➞ servlet containers in Section 2.4, “Servlet Containers” [11].
CoreMedia Operations Basics 5 System Requirements |
Please keep in mind, that the databases and application servers have only been tested in CoreMedia compliant operating environments and therefore are only approved on these platforms.
CoreMedia Operations Basics 6 System Requirements | Hardware Requirements
2.1 Hardware Requirements
Since hardware requirements are as specific as project requirements, such as e.g. Hardware requirements the number of pages of a website, third-party services, high availability etc., they can only be determined individually. Planning of expected system demands, such as the number of computers and internal network topology, should be performed really carefully. CoreMedia systems can operate on a single computer or in a distributed environ- ment. Project-specific demands can have a strong impact on hardware requirements. The listings below are just rough estimates and/or the very basic equipment needs. This chapter does not replace CoreMedia expert consulting by any means. Basic Production System: To run a CoreMedia System in production, the basic hardware equipment should at least consist of: ➞ one cpu for Content Server and Content Application Engine (CAE) ➞ the same cpu requirements for an Apache Solr search engine as for any other CoreMedia web application. ➞ one cpu for n importers ➞ one cpu for Master Live Server ➞ n cpus for n Live CAEs and Replication Live Server ➞ external DB Server(s): equipment according to the recommendations of the database manufacturer
Each cpu at least equivalent to: ➞ Sun: SPARC 1000 MHz allocating 512 MB main memory, 18 GB hard disk space. or ➞ PC: Xeon / Opteron with min. 2 GHZ allocating 512 MB main memory, 18 GB hard disk space.
Editor Installation: Generally, CoreMedia Editors are installed on separate Windows computers with access to the Content Server. A computer for the CM Editor should not fall short of the following recommendation: ➞ PC: Pentium IV/ Athlon min. 2 GHz, 256 MB main memory, 8 GB hard disk space
CMS Development and Test System:
CoreMedia Operations Basics 7 System Requirements | Hardware Requirements
For a development or test system all CoreMedia components can be installed on one computer: ➞ 2 CM Servers: Content + Live, ➞ (optional) 1 CM Importer ➞ 2 CM CAEs: (Preview + Online)
If possible, the database should be installed on a separate computer in the test system as well. Minimum requirements for a development system: ➞ Sun: SPARC 2*1000 MHz, 2 GB main memory, 18 GB hard disk. or ➞ PC: Xeon / Opteron 2 GHz, 2 GB main memory, 18 GB hard disk.
CoreMedia Operations Basics 8 System Requirements | Java
2.2 Java
The functionality of CoreMedia components can only be guaranteed with approved platforms and corresponding Java versions. To operate CoreMedia CMS, run the Java platform with Java Runtime Environment (JRE) or Java Development Kit (JDK).
Do not run a CoreMedia CMS System with different Java versions. All components have to use the same Java version.
The appropriate JREs/JDKs for the different supported platforms can be obtained from the following locations: ➞ for Solaris, Linux and Windows JRE/JDK can be downloaded at Oracle ( ht- tp://www.oracle.com or http://www.oracle.com/technet- work/java/javase/downloads/index.html). ➞ the IBM JRE/JDK can be downloaded at IBM (https://www.ibm.com/developer- works/java/jdk/).
Only use the JRE/JDK binaries listed in the Supported Environments document or further approved versions mentioned in the change notes on the CoreMedia 6 Maven site. Don't use any other than the specified patch level of an JRE/JDK version! A different patch level is not supported and probably causes errors in service.
CoreMedia Operations Basics 9 System Requirements | Databases
2.3 Databases
CoreMedia CMS uses repositories for data storage, therefore it requires one or more external relational databases. A correctly installed and activated database is pre- requisite for the operation of CoreMedia CMS. How to connect the CoreMedia system to databases is described in detail for the different databases in the Content Server Manual.
It is strongly recommended to use a UTF-8 enabled database for your CoreMedia CMS repository.
The databases have only been tested in CoreMedia compliant operating environ- ments and therefore are only approved on these platforms.
CoreMedia Operations Basics 10 System Requirements | Servlet Containers
2.4 Servlet Containers
CoreMedia CMS web applications such as the Content Application Engine use a servlet container for operation. Default servlet container is Tomcat. For the CoreMedia Search Engine with Solr we highly recommend to use Apache Tomcat. Keep in mind, that the servlet containers have only been tested in CoreMedia compliant operating environments and therefore are only approved on these platforms.
CoreMedia Operations Basics 11 Basics of Operation |
3. Basics of Operation
This chapter covers the fundamental principles of CoreMedia system administration and operation - an overview of the directory structure of the CoreMedia system, configuration settings for internal system communication and general aspects of starting and operating CoreMedia components.
CoreMedia Operations Basics 12 Basics of Operation | CoreMedia CMS Directory Structure
3.1 CoreMedia CMS Directory Structure
CoreMedia components come as simple applications or as web applications. Both have a standard directory structure that will be described in the following. Other - component specific - directories, are described in the corresponding component manual. CoreMedia applications
A CoreMedia application, the Content Server for example, has the following direct- ories:
➞ KL : Start scripts (see Section 3.3, “Starting the Components” [29] ) for Unix (cm) and Windows (cm.exe, cmw.exe) as well as the start scripts of the individual CoreMedia components and utility programs. ➞ KL : Runtime resources like Java jar files and DLLs. ➞ KL : Optional local classes. Note: The directory does not exist in the standard installation. It can contain customer-specific extensions. ➞ KL LY [: XML-configuration files of the component. ➞ KL L : CoreMedia CMS configuration files in Java properties format. ➞ KL L : log files of the CoreMedia components (see Section 3.7, “Log- ging” [44]). ➞ KL L : runtime data (e.g. Process ID). ➞ KL L : temporary data.
CoreMedia web application
A CoreMedia web application, the Content Application Engine for example, is de- ployed in a servlet container. The web application has the following sub directories in its tb_Jfkc directory:
KL : Runtime resources like Java jar files and DLLs.
KL : Spring configuration files of the web application.
CoreMedia Operations Basics 13 Basics of Operation | Communication between the System Components
3.2 Communication between the System Components
Figure 3.1. IOR inquiry and answer between CoreMedia Client and Server
CORBA is used for the communication between CoreMedia system components. All CoreMedia components require the IOR of the Content Server which they want to communicate with. The IOR of the Content Server will be delivered by the server via the HTTP protocol. ➞ All components require the IOR of the Content Server with which they want to communicate. The URL where to get the IOR of the Content Server is configured with the parameter K K K K YfloJroi[ in the file K . The value of the parameter is WLLY [WY [L L . Instead of
The Content Management Server/Live Server embed their own hostnames into the IOR which must be resolved by the client machines. If this is not possible by the client, you can configure the server to embed a numeric IP address into the IOR. To do so, use the property K Klo_p e in the K file. In the following example, the ORB is configured to embed its numeric address: