This section covers the deployment process of the CoreMedia services
using the rpm
and yum
utilities directly. It will not cover how to
install and configure third-party RPM files such as MongoDB
or MySQL.
Prerequisites
In order to proceed you need to make sure that you successfully meet the following prerequisites:
A running MongoDB instance or cluster, either on the same machine or somewhere else.
A running MySQL instance, either on the same machine or somewhere else.
A configured YUM environment, the
yum
client must be on the PATH.Either the package
createrepo
must be installed, that iscreaterepo
must be on the path or the RPM files must be accessible on a remote YUM repository. To installcreaterepo
, callsudo yum install createrepo
.
Creating a YUM repository
If you want to install the RPM files from a local RPM repository, make sure that you copied all
RPM files to a directory and call createrepo
on that path. If you are using a
remote repository, you can skip this step.
Now you need to register a repository configuration in your /etc/yum.repos.d/
. To
do so create a file below that directory, for example
/etc/yum.repos.d/cm8-repo
, and add the following content.
[cm8] name=CoreMedia 8 Repo baseurl=file://PATH_TO_YOUR_REPO gpgcheck=0 enable=1
Example 4.19. YUM repository
If you are using a remote repository you need to specify the baseurl
property
accordingly.
Installing the RPMs
To install the RPMs, use the yum
utility to install all selected packages at once,
for example:
sudo yum install cm8-*
for all matching packages or specify a list of packages by calling
sudo yum install [PACKAGE_1] ... [PACKAGE_N]
Similar to the roles in Chef that group recipes such as packages to apply to your node, you can
create groups within your YUM repository. This way, if there was a group
bluepring-delivery
, you could simply use
sudo yum groupinstall "blueprint-delivery"
to install a set of RPM files at once, without knowing the concrete packages included. To create
groups use the yum-groups-manager
utility.
After you have installed all RPM files and in case you are using the post-configuration
approach, you need to adapt the default configuration defined in the property files below
/etc/coremedia
and reconfigure all services and tools. To skip this step
you may provide the correct configuration files in advance. As a start you can use the default
configuration files generated by the build and adapt them to your needs. You find these files
below the boxes/target/shared/configuration-templates
folder in your
workspace.
To reconfigure the services and tools, you need to call sudo service [SERVICE NAME]
reconfigure
for each service and
/opt/coremedia/[TOOL_NAME]/reconfigure-tool.sh
for each tool.
Starting the Services
To start the services simply refer to the standard service
utility. By default, all
Tomcat based services created with the Blueprint workspace offer the following methods:
start
- to start the servicestop
- to stop the servicerestart
- to restart the servicestatus
- to check the status of the servicereconfigure
- to reconfigure the servicereload
- to reconfigure and restart the service
Note | |
---|---|
The status method does not reflect the status of any of the contained web applications, it merely checks the presence of a process with a matching process id. |
The order in which the services need to be started depends on many factors including customizations done in a project. Most CoreMedia applications can be started independently of each other but a safe order would look like the following:
service cm7-mls-tomcat start
(Master Live Server)service cm7-cms-tomcat start
(Content Management Server)service cm7-wfs-tomcat start
(Workflow Server)service cm7-solr-master-tomcat start
(Solr Search Engine)service cm7-caefeeder-preview-tomcat start
(Preview CAE Feeder)service cm7-caefeeder-live-tomcat start
(Live CAE Feeder)service cm7-studio-tomcat start
(Studio + Preview, WebDAV and Site Manager)service cm7-delivery-tomcat start
(Delivery CAE)
To reload Apache, call service httpd restart