ARA Features Unique to Release Engineer

Out of the Box Reusable Actions, Procedures or Functions for Automating Continuous Delivery

Pre-Defined Procedures

  • extractzip - Extracts the contents of zip file
  • servicectl - Allows Windows Services to be started and stopped
  • TomcatPostDeploy - Cleans Work Directory and Starts Tomcat
  • TomcatPreDeploy - Shuts down Tomcat before a deployment
  • RunSQLScript - Executes a SQL script

Pre-Defined Functions

  • dir -Runs a directory listing on a remote machine and returns the results into a DMScript Array. To use this you must use DMScript
  • listservices - Lists the services available on a remote machine and returns the results into a DMScript Array. To use this you must use DMScript
  • md5sum - Generates a number that is calculated using a file’s contents. This can be used to determine if the file has been changed since a previous deployment
  • Run SQL Script (Postgres) - Runs one or more SQL scripts against a Postgres Database

Built-in Procedures and Functions for the Deploy Category

  • Deploy Component- Deploys the specified Component to the appropriate Server(s) within the target Environment
  • Deploy - Extracts items from the specified Repository and deploys them to the Server(s) in the target Environment. Use IF conditions to filter the Server list to those matching the specified criteria
  • Checkout - Extracts items from the specified Repository and places them in the Dropzone
  • Transfer - Takes files from the specified Dropzone and deploys them to the Server(s) in the target Environment. Use IF conditions to filter the Server list to those matching the specified criteria
  • Execute - Runs a script on the appropriate Server(s) within the target Environment. Use IF conditions to filter the Server list to those matching the specified criteria

Built-in Procedures and Functions for processing in the Dropzone

  • Using Dropzone - Use a named Dropzone. There normally is just one Dropzone, but you can create more and use them “on demand”. You name a Dropzone by dragging this built-in Procedure/Function to the Workflow. You can then set the name. Once created, you can drill-down to create new Workflows, all of which operate under the new Dropzone. For example, you can check-out a specific Component, manipulate it and deploy it somewhere, all without affecting the “main” Dropzone area
  • Iterate through Dropzone - Loops through each file in the Dropzone
  • Delete file - Deletes a file in the Dropzone
  • Rename File - Renames a file in the Dropzone
  • XML – Sets an XML attribute name in a file in the Dropzone, Sets the text in an XML element in a file in the Dropzone. Removes an XML element from a file in the Dropzone. Adds a new XML element to a file in the Dropzone
  • Amend file Content - Modifies a specific flat file in the Dropzone. “Old String” is replaced by “New String”, and checking the "Server Specific" checkbox makes a unique copy for each Server within the target Environment, as it allows for the use of variables that are available for every target Server. For example, if the file for each Server contained a line such as: server = SERVER_NAME then setting up an Amend File Content (as part of an Action) with the values: filename: myFile Old String: SERVER_NAME New String: ${server.hostname} and the hostname of the target Server was OraSrvr10, then the line in the file would be changed to: server = OraSrvr10 This would be changed in the Dropzone for each Server being deployed to in the target Environment

Built-in Procedures and Functions for the File Logic Category

  • Abort - Terminates deployment on error condition
  • Calculate MD5 - Calculates the MD5 value of a file

Built-in Procedures and Functions for the Flow Logic Category

  • Set Variable - Creates and sets a variable
  • Increment Variable - Increments a variable
  • Add Value to Variable - Adds a value to the variable
  • Add two Values -Adds to values and stores the results in a variable
  • Echo -Echoes a message
  • Using Stream -Uses a named stream. Named streams are used to capture echo output and can then be used in email notifications etc.
  • Parallel - Executes blocks of logic in parallel
  • Sleep - Pauses for n seconds
  • If - If is a general expression evaluator. An “if” block has two exit points – one if the test succeeds and one if it fails. It is not necessary to populate both exit points. If can also be used to filter the current Server list. For example, an environment may contain 10 servers. The Server list is this complete list of Servers defined to the Component. You can use the IF expression to reduce this list to Servers matching the specified criteria. For example if you use IF with an expression of ATVAL=’Y’ then any actions attached to the “true” output of the IF block will operate only on Servers with an attribute of ATVAL that is equal to Y. Similarly any actions attached to the “false” output of the IF block will operate only on Servers without an attribute of ATVAL or with an ATVAL attribute that is not equal to Y.
  • Abort - Terminates deployment on error condition
  • Run Task -Runs a specific Task from within an Action, without having to run it manually. Tasks are otherwise run by clicking on them within the Domain where they were created and reside
  • Wait for Task - Waits for a specified Task to be run before completing the next step of an Action. This is typically used from within an Action to halt its execution until a specific Approve Task has been executed in response to a Request Task, although any Task can be used. The Task that is being waited for can be run from within another Action or from a User who runs the Task ‘manually’, by right clicking and selecting the Task from within the Release Engineer user interface.

Built-in Procedures and Functions for the Loops Category

  • Server Loop- Iterates through the current set of Servers
  • Loop through array keys- Loops through each element of an array setting a variable for each key
  • Version Loop - Loops through each Component Version - between version on target Server and version being deployed
  • Component Loop - Loops through each Component Item that makes up the Application
  • .

Built-in Procedures and Functions for the Tomcat and WebSphere

  • TomcatPreDeploy - Shuts down Tomcat
  • TomcatPostDeploy - Cleans the Work directory and starts Tomcat
  • Deploy App - Deploys an application to Websphere. Also allows the stopping and starting of a Websphere Server and/or a WebSphere Application.

Built-in Procedures and Functions for the Windows

  • Stop Services - Stops the Windows Service on the appropriate Server(s) within the target Environment. Use IF conditions to filter the Server list to those matching the specified criteria.
  • Start Services - Starts the Windows Service on the appropriate Server(s) within the target Environment. Use IF conditions to filter the Server list to those matching the specified criteria.
  • List Services - Returns a list of installed Windows services into an array.
  • Extract Zip - Extracts the contents of a zipfile

Enterprise Platform support

Release Engineer runs on a Linux or Windows server, includes a web based UI and supports software deployments to multiple platforms and can support a deployments that include cross platforms. It also supports WebSphere Deployments, database deployments and integrates with external repositories for retrieving binaries.

Platform Support Includes:

Windows 2008, Windows 2012
Solaris, HP-UX, AIX, Linux
Ubantu, Redhat, SuSe, Debian
Tandem, Stratus, IBM iSeries, OpenVMS, Unisys, IBM 4690
z/OS
IBM WebSphere
Jetty, Tomcat, Cloud Foundry
Microsoft IIS
Microsoft SQL Server
Oracle
Sybase