Serena Deployment Automation: Quick Start for Windows

Contents

Interactive Server Installation

The Deployment Automation interactive server installer uses a wizard that guides you through the installation process.

Run one of the following installer executables as a Windows local system user:
  • Windows 32-bit: SerenaDA-Server.exe
  • Windows 64-bit: SerenaDA-Server64.exe

The properties set during the server installation are recorded in the installed.properties file located in the server_install/conf/server/ directory.

Specify the installation information as follows.

Server Quick Installation

For a quick default server installation, enter the installer wizard panel information as follows:

  1. Destination Folder: accept the default and click Next
  2. General Program Settings: accept the defaults and click Next
  3. Database Selection: accept the default (Derby) and click Next
  4. Database Details: specify the details for the built-in Derby database as follows and click Next
    • Port: 11377
    • User: <any user ID>
    • Password: <anypassword>
    • Confirm Password: <anypassword>
    Note: The Derby database will be created by the installer.
  5. Administrator Details: enter the product administrator user name and password and click Next
  6. Configuration Details: accept the default (8080) and click Next
  7. Ready to Install: review the settings and click Install
  8. InstallShield Wizard Completed: review the installation details and click Finish

    Your server installation is now complete.

For full installation and configuration details, see the Serena Deployment Automation User's Guide on the Documentation Center.

Starting and Stopping the Server

The installer installs Deployment Automation under the application server and starts the service automatically.

To start or stop the server service:

Use Administrative Tools > Services to start or stop Serena Common Tomcat.

Interactive Agent Installation

The interactive agent installer uses a wizard that guides you through the installation process.

Run the following installer executable as a Windows local system user:

SerenaDA-agent.exe

Agent Installation

The user performing the agent installation needs full access rights to the installation location used.

Multiple Agents on Multiple Machines

If you plan to run deployments on several machines, a separate agent with a unique name should be installed on each machine. If, for example, your testing environment consists of three machines, install an agent on each one. Follow the same procedure for each environment the application uses.

Multiple Agents on One Machine

If you plan to install multiple agents on a single machine, make sure that all names are unique: installation directory name, agent name, and service name, if running the agent as a service.

Important: Except for evaluation purposes, do not install an agent on the same machine as the server.

Starting and Stopping an Agent

The agent installer installs the agent service, but does not start the service. It is set to manual start by default.

Note: If you are using an agent relay, you must start it before starting any agents that will communicate through it.

To stop or start an agent service:

Use Administrative Tools > Services to start or stop serenaRA Agent (SRA-Agent).

Once the agent has started, navigate to the Deployment Automation web application and display the Resources page. If the installation went well, the agent should be listed with a status of Connected.

Accessing Deployment Automation

After you have completed at minimum a server installation, you can login to the web application to begin configuring Deployment Automation.

To access the Deployment Automation web application:

  1. Open a web browser and enter the following URL:

    http://serverName:port/serena_ra/

    Use the host name and port for the application server where you installed Deployment Automation. The default port is 8080 for Serena Common Tomcat.
  2. Log on to the server using the credentials (Username and Password) you set up during the server installation.

    Once you are logged in, you can change these in System Settings.

Automation Plug-ins

Deployment Automation includes several standard plug-ins that are available when you install. Many additional plug-ins are available for you to download and use for your specific needs. Plug-ins can be installed, or loaded, at any time, directly from the Deployment Automation web application.

Note: If you download a bundled zip file that contains multiple plug-ins, you will need to extract the individual plug-in zip files from the bundle. You should not decompress the individual plug-in zip files.

Loading Plug-ins

After you have downloaded a plug-in, you can load it so that it becomes available to use in the Process Editor.

To load the downloaded plug-ins:

  1. Navigate to Automation > Automation Plugins > Load Plugin [button].
  2. Enter the path to the compressed plug-in (.zip) file and click Submit.

After the plug-in load process completes successfully, when you are designing processes for components, the plug-in is listed in the Process Editor on the Automation Plug-ins pane. Once loaded, plug-in functionality is available immediately.

Copyright © 2011-2015 Serena Software, Inc. All rights reserved.