Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

6.3. Configuring a Complete Environment

The following is an example configuration for a complete OpenShift Enterprise deployment consisting of:
  • One host with the nameserver role.
  • Two hosts with the broker role.
  • Two hosts with the msgserver role.
  • Three hosts with the datastore role.
  • Multiple hosts with the node role.
This example uses a common set of variables to ensure that parameters between different roles match up properly. This example is also appropriate for deploying on Infrastructure-as-a-Service (IaaS) environments where public and private routing is in use; applications are made available via their public IP addresses by making use of the ec2_public_ipv4 fact.

Recommended Order of Deployment:

  1. Name server host.
  2. Message server hosts.
  3. Datastore hosts, ensuring the primary host is fully deployed before adding additional nodes to your replica set.
  4. Broker hosts.
  5. Node hosts.
Common Variables for This Example

$bind_key = 'oZmVeXEiAi3foJ5GPG/11aaliaw1Wm7hccODfqBDfKRluO8bUfHK08mFMxpBnSW2bNJb+567Mc2sOwWyg7a1AA=='
$broker_virtual_hostname = 'ose-broker.example.com'
$install_method = 'none'
$mongodb_replicasets = true
$mongodb_replicasets_members = ["ose-mongo01.example.com:27017","ose-mongo02.example.com:27017","ose-mongo03.example.com:27017"]
$msgserver_cluster = true
$msgserver_cluster_members = ["ose-amq01.example.com","ose-amq02.example.com"]
$nameserver_ip_addr = '10.3.8.18'
$nameserver_hostname = 'ose-ns01.example.com'
$ose_version = '2.2'
$register_host_with_nameserver = true
Copy to Clipboard Toggle word wrap

Example 6.10. Name Server Configuration

node /^ose-ns/ {
  class { 'openshift_origin':
    roles                         => ['nameserver'],
    bind_key                      => $bind_key,
    install_method                => $install_method,
    nameserver_ip_addr            => $nameserver_ip_addr,
    nameserver_hostname           => $nameserver_hostname,
    ose_version                   => $ose_version,
    register_host_with_nameserver => $register_host_with_nameserver,
  }
}
Copy to Clipboard Toggle word wrap

Example 6.11. Message Server Configuration (ActiveMQ)

node /^ose-amq/ {
  class { 'openshift_origin':
    roles                         => ['msgserver'],
    msgserver_cluster             => $msgserver_cluster,
    msgserver_cluster_members     => $msgserver_cluster_members,
    msgserver_hostname            => $::fqdn,
    msgserver_routing             => $msgserver_routing,
    msgserver_routing_password    => $msgserver_routing_password,
    # all node classes get these params
    bind_key                      => $bind_key,
    install_method                => $install_method,
    nameserver_ip_addr            => $nameserver_ip_addr,
    nameserver_hostname           => $nameserver_hostname,
    ose_version                   => $ose_version,
    register_host_with_nameserver => $register_host_with_nameserver,
  }
}
Copy to Clipboard Toggle word wrap

Example 6.12. Datastore Configuration

This assumes that you are naming your primary datastore node ose-mongo01.example.com. 
node /^ose-mongo/ {
  class { 'openshift_origin':
    roles                           => ['datastore'],
    datastore1_ip_addr              => '10.3.9.214',
    datastore2_ip_addr              => '10.3.9.219',
    datastore3_ip_addr              => '10.3.9.221',
    mongodb_replica_primary_ip_addr => '10.3.9.214',
    mongodb_replicasets             => $mongodb_replicasets,
    mongodb_replicasets_members     => $mongodb_replicasets_members,
    mongodb_replica_primary         => $::fqdn ? {
      'ose-mongo01.example.com'     => true,
      default       => false,
    },
    datastore_hostname              => $::fqdn,
    # all node classes get these params
    bind_key                      => $bind_key,
    install_method                => $install_method,
    nameserver_ip_addr            => $nameserver_ip_addr,
    nameserver_hostname           => $nameserver_hostname,
    ose_version                   => $ose_version,
    register_host_with_nameserver => $register_host_with_nameserver,
  }
}
Copy to Clipboard Toggle word wrap

Example 6.13. Node Configuration

You must have one set of configuration options per district. This registers the node_ip_address using the public IP address so that all applications on these gears are publicly accessible. 
node /^ose-small-node/ {
  class { 'openshift_origin':
    roles                         => ['node'],
    broker_hostname               => $::fqdn,
    node_hostname                 => $::fqdn,
    node_ip_addr                  => $::ec2_public_ipv4,
    node_frontend_plugins         => ["apache-mod-rewrite","nodejs-websocket"],
    install_cartridges            => ["cron","diy","haproxy","mongodb","nodejs","perl","php","postgresql","python","ruby","jenkins","jenkins-client","mysql"],
    msgserver_cluster             => $msgserver_cluster,
    msgserver_cluster_members     => $msgserver_cluster_members,
    # all node classes get these params
    bind_key                      => $bind_key,
    install_method                => $install_method,
    nameserver_ip_addr            => $nameserver_ip_addr,
    nameserver_hostname           => $nameserver_hostname,
    ose_version                   => $ose_version,
    register_host_with_nameserver => $register_host_with_nameserver,
  }
}
Copy to Clipboard Toggle word wrap

Example 6.14. Broker Configuration

node /^ose-broker/ {
  class { 'openshift_origin':
    roles                         => ['broker'],
    broker_cluster_members        => ["ose-broker01.example.com", "ose-broker02.example.com"],
    broker_hostname               => $::fqdn,
    broker_virtual_hostname       => $broker_virtual_hostname,
    msgserver_cluster             => $msgserver_cluster,
    msgserver_cluster_members     => $msgserver_cluster_members,
    conf_broker_session_secret    => 'secret',
    conf_console_session_secret   => 'secret',
    mongodb_replicasets           => $mongodb_replicasets,
    mongodb_replicasets_members   => $mongodb_replicasets_members,
    # all node classes get these params
    bind_key                      => $bind_key,
    install_method                => $install_method,
    nameserver_ip_addr            => $nameserver_ip_addr,
    nameserver_hostname           => $nameserver_hostname,
    ose_version                   => $ose_version,
    register_host_with_nameserver => $register_host_with_nameserver,
  }
}
Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat