Reference - Ansible4IOM Processes

Product Version


Product To Version



1 Introduction

This document lists all predefined operational processes and their scope that can be used within Ansible4IOM to manage tasks such as setup, reconfiguration or cleanup of system components of an IOM installtion. For every process, a description, included tasks as well as background information and examples are provided.

The target group of this document are developers of a project as well as system administrators.

1.1 Glossary

Ansible4IOMAnsible4IOM is a tool of IOM for server configuration management. Additionally operation tasks are predifined and can be customized.
AzureA cloud computing service created by Microsoft for building, testing, deploying, and managing applications and services through a global network of Microsoft-managed data centers.
CIContinous integration
Configuration RepositoryIn the scope of Ansible4IOM a configuration repository is a set of configurations that describes the used machines, values of variables hooks and more. It's a descripton of how to install a custom IOM.
EPELExtra Packages for Enterprise Linux is a repository of the Fedora-Project (
FSFile system
Gluster-FSA scale-out network-attached storage file system
HookHooks are part of Ansible4IOM. Hooks are a sophisticated way to customize processes. Additionally the behavior of processes can be simply customized by various variables.
IOMThe abbreviation for Intershop Order Management
IOM WatchdogA tool of IOM to monitor and manage the availablity of IOM application servers
JMSJava Message Service
OMSThe abbreviation for Order Management System, the technical name of the IOM

Red Hat Enterprise Linux

SQLStructured Query Language

1.2 References


2 Ansible4IOM Processes

TitleDescriptionValid FromValid To
Process - Cleanup Database AccountThe process cleanup_omsdb removes an existing database account. The process is intended to be used by CI processes or on preproduction systems, in order to reset a database back into initial state.2.2
Process - Cleanup Load BalancerThe process cleanup_load_balancer removes an installed load balancer. The process is used by CI processes, in order to reset a machine back into initial state.2.2
Process - Cleanup OMS NodeThe process cleanup_oms_node removes an IOM installation.2.2
Process - Cleanup Postgres ServerThe process cleanup_pgserver removes a simple PostgreSQL-server (installed before using Process - Setup Postgres Server) and according data. The process is intended to be used by CI processes, in order to reset a machine back into initial state.2.2
Process - Reconfigure Load BalancerThe process reconfigure_load_balancer applies configuration changes to an installed load balancer, based on an Apache httpd-server. For installation see Process - Setup Load Balancer.2.2
Process - Reconfigure OMS NodeThe process reconfigure_oms_node is the right choice to update the project code and configuration. The process executes all hooks, which should be used by projects and it redeploys all artifacts. If you are using the process reconfigure_oms_node to update project code and configuration, you should execute the process on all servers in parallel (forcing a downtime) to avoid inconsistency between project code and project specific data-structures in the database.2.2
Process - Reconfigure Postgres ServerThe process reconfigure_pgserver updates selected PostgreSQL settings of a database installed before using Process - Setup Postgres Server. Since reconfiguration of the database server requires restart of the database server, the process forces a downtime of the whole IOM system.2.2
Process - Setup Load BalancerThe process setup_load_balancer installs a new load balancer for a distributed IOM installation. It works on servers assigned to the group load_balancer. Also see Concept - Ansible4IOM. The load balancer, installed this way, is an Apache HTTP-server, configured to work as load balancer for IOM.2.2
Process - Setup OMS Node
Error: [com.ctc.wstx.exc.WstxLazyException] Unexpected character ' ' (code 32) in content after '<' (malformed start element?). at [row,col {unknown-source}]: [1,679]
Process - Setup or Reconfigure Database AccountThe process setup_omsdb sets up or reconfigures a DB account suitable for use by IOM on an existing PostgreSQL-server.2.2
Process - Setup Postgres ServerThe process setup_pgserver installs a simple PostgreSQL-server, without any high-availabilty features. It can be used by IOM application-servers.2.2
Process - Update OMS NodeThe process update_oms_node updates an IOM node to a newer IOM version. IOM updates mostly require database migrations, therefore the update process forces a downtime of the whole system. For the same reason, you should execute updates for the whole cluster only. The process update_oms_node is working for all server groups, which might be used for oms-nodes: oms_single_node, oms_ha_node and oms_azure_node.2.2


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources