Part of the default configuration

This example is included in the default configuration created by Pineapple, so there is no need to create it by hand.

• Define resources

  A resource defines a entity in a IT environment which is manageable by Pineapple through some protocol. In this example, the entity is a Linux OS and the used protocol is SSH. One resource is defined for each Linux host where the JVM should be installed.

  In this example we will use the linux-vagrant environment defined as part of the default configuration. The environment defines a network with three hosts:

  • Node1 with IP Address: 192.168.34.10
  • Node2 with IP Address: 192.168.34.11
  • Node3 with IP Address: 192.168.34.12

  To enable SSH usage for these hosts, three resources are defined within the linux-vagrant environment in the resources file located at ${user.home}/.pineapple/conf/resources.xml:

  <?xml version="1.0" encoding="UTF-8"?>
  <configuration xmlns="http://pineapple.dev.java.net/ns/environment_1_0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://pineapple.dev.java.net/ns/environment_1_0
      http://pineapple.dev.java.net/ns/environment_1_0.xsd">
       
      <environments>
          <environment description="Vagrant multi-machine Linux environment" id="linux-vagrant">
              <resources>
                  <resource plugin-id="com.alpha.pineapple.plugin.ssh" credential-id-ref="ssh-node1" id="ssh-node1" >
                      <property value="192.168.34.10" key="host"/>
                      <property value="22" key="port"/>
                      <property value="1000" key="timeout"/>
                  </resource>
                  <resource plugin-id="com.alpha.pineapple.plugin.ssh" credential-id-ref="ssh-node2" id="ssh-node2" >
                      <property value="192.168.34.11" key="host"/>
                      <property value="22" key="port"/>
                      <property value="1000" key="timeout"/>
                  </resource>
                  <resource plugin-id="com.alpha.pineapple.plugin.ssh" credential-id-ref="ssh-node3" id="ssh-node3" >
                      <property value="192.168.34.12" key="host"/>
                      <property value="22" key="port"/>
                      <property value="1000" key="timeout"/>
                  </resource>
              </resources>
          </environment>
      </environments>
  </configuration> 
  

  Each resource is defined with a different ID and IP address. All other properties are identical. The role of the attribute plugin-id is to bind the resource definition to the plugin code at runtime which implements the SSH plugin.

The configuration details

Two schema are used in the model file. The http://pineapple.dev.java.net/ns/module_model_1_0 is used to define the namespace mmd which defines the general infrastructure for models. The http://pineapple.dev.java.net/ns/plugin/ssh_1_0 schema is used to define the namespace shp which is used to define the model for the SSH plugin. Since multiple schemas are used to define the model file, the elements are qualified.

The target-resource attribute defines a reference to the resource which is targeted when the model executed. In this case, the value regex:ssh-node.* defines a regular expression for targeting multiple resources, e.g. all the resources starting with ssh-node.

The main part of the model consists of four commands, which performs the installation steps:

• Copy the file from the bin directory within the module to the tmp directory on the accessed host. The usage of the modulepath: variable in the source file attribute defines the source directory relative to module.
• Change execution rights for the JVM.
• Install the JVM into the /usr/java/jdk1.7.0_25 directory.
• Change ownership of the JVM directory to user weblogic of the group oinstall.

The execute commands in the model is executed using sudo. The requirement for sudo depends on the privileges of the user used by the SSH plugin to connect to a given host. The users was defined in credentials file in the previous section.