Installation Guide - Product Documentation - Attachmate

attachmate.com

Installation Guide - Product Documentation - Attachmate

INSTALLATION GUIDE

Process Designer

R5 Service Pack 1


Copyright © 2013 Attachmate Corporation. All Rights Reserved.

1


Table of Contents

Introducing Verastream Process Designer ............................................................................. 3

System Requirements .......................................................................................................... 3

Process Design Studio ...................................................................................................... 3

Process Server ................................................................................................................. 3

Securing files ................................................................................................................... 4

Windows Installation ............................................................................................................ 4

Unattended Windows Installation ...................................................................................... 5

UNIX Process Server Installation ........................................................................................... 5

UNIX Unattended Installation ............................................................................................ 7

Uninstalling the Process Server on UNIX ............................................................................ 7

Upgrading From Previous Versions ........................................................................................ 8

Upgrading on UNIX .......................................................................................................... 8

Upgrading on Windows ..................................................................................................... 8

2


Introducing Verastream Process Designer

Verastream Process Designer (VPD) is an end-to-end Web service composition and orchestration

product based on the BPEL standard, consisting of the Process Design Studio and the Process

Server. After installing, you can use the Process Design Studio to quickly import Web services,

apply logic constructs, test, and execute them as a BPEL process. The process is immediately

ready for deployment as a Web service to the Process Server.

System Requirements

These requirements apply to both the Process Design Studio and the Process Server.

In preparing system requirements guidelines, Attachmate may rely on published claims

(that it cannot independently confirm) regarding the capabilities of the non-Attachmate

products. Attachmate therefore recommends that you contact your suppliers directly with

questions or concerns regarding their products

Process Design Studio

For Windows 7 and Windows Server 2008, when User Account Control (UAC) is enabled, you

must run setup as administrator.

Requirements For

Operating System

Supported (64-bit)

Windows 2008 Server

Windows 2008 R2 Server

Windows Server 2012

Windows 7

Windows 8

Note: The Process Design Studio has tutorials that walk you through important workflows

in the product. These tutorials are in Portable Document Format (PDF) and require the

Adobe Reader. You can download the reader at http://get.adobe.com/reader. To set browser

preferences, open Acrobat Reader, go to Preferences, and click on the Internet

settings. For example, you can choose to have the Reader always open PDFs in an

external window instead of embedded within the browser: just clear the “Display PDF in

browser” option.

Web Services Explorer is a browser-based tool for testing the Web services generated by

your project. It is installed with the Process Design Studio and requires Internet Explorer

version 8.0 or higher, Chrome, or Firefox 12.0 or higher.

Process Server

Although the Design Studio is a Windows-based component, the Process Server runs on multiple

operating systems.

Requirements For

Supported (64-bit)

Microsoft Windows Windows 2008

Windows 2008 R2 Server

Windows 8

Windows Server 2012

3


Sun Solaris

Solaris 11 (SPARC)

Solaris 10 (SPARC)

Red Hat Enterprise Linux RHEL 6

RHEL for IBM System z 6

SUSE Enterprise Linux Server

SLES 11 SP2

SLES for System z 11 SP2

AIX AIX 7.1 and AIX 6.1

On the IBM AIX 6.1 platform, Technology Level

6100-04 Service Pack 3 (TL 6100-04 SP3) is

recommended.

Securing files

Preventing tampering, information leakage, and other security vulnerabilities are important. For a

list of possible vulnerable files see the online help topic, How to Work Securely.

Windows Installation

To install the Process Design Studio:

Log into Windows with administrative privileges and close all running applications.

Run setup.exe, and then click Continue.

Read and accept the license agreement and click Continue. The following screen displays:

Click Install Now to install with the default settings or set the preferences found on each tab.

User Information – Attachmate support uses this information to provide better service.

File Location – Specify the install location for the product.

Feature Selection – Choose the features you want to install on the local machine.

Note: Process Designer is installed using the default password of ‘secret’ and the default

user name of ‘admin’. You should use the Process Server command line interface (pscli)

utility to change this password as soon as possible. The utility is located at

\processserver\bin\pcsli.cmd

4


Unattended Windows Installation

Run the following command to install the Process Server silently:

setup.exe /install /quiet

You can specify the installation location using the INSTALLDIR command. Execute the

following:

Command: setup.exe /install /quiet INSTALLDIR ="C:\Program

Files\Attachmate\Verastream\”

The default install directory is C:\Program Files\Attachmate\Verastream\. The

install process creates two sub-folders: ProcessDesignStudio and

ProcessServer.

Note: An ‘unattended install’ presumes that you have already accepted the software

license agreement applicable to this product (most likely, in the course of a software

download process, or an initial product installation). A copy of the software license

agreement is provided in the root directory of the product, in case you wish to review

it before proceeding with this setup.

UNIX Process Server Installation

Note: Specify path of Java installation. For AIX or zLinux users, you must have Java SE

Version 7 installed before running an installation of Process Designer. During installation

you will be prompted to specify the location of an existing JDK installation. You must

specify the full path name before continuing.

To install the Process Server:

Log on as root. Change directory (cd) to the VPD installer directory.

Depending on your operating system:

Enter ./vpd-r5-linux or sh vpd-r5-linux for Linux systems

Enter ./vpd-r5-zlinux or sh vpd-r5-zlinux for zLinux systems.

Enter ./vpd-r5-solaris or sh vpd-r5-solaris for Solaris systems

Enter ./vpd-r5-aix or sh vpd-r5-aix for AIX systems

To read the license agreement, use the following commands:

Command

y + ENTER

n + ENTER

Result

The Attachmate license agreement is shown.

The installation stops and is followed by this message:

ERROR: This software cannot be installed without reading and

agreeing with these terms

Enter ‘y’ to accept the license. The following screen displays:

5


Attachmate Verastream Process Designer R5 SP1 Installation

Installation

Packages:

1) * Process Server

+ Selected, - Not Selected, * Required

Options:

p) Installation path: /opt/attachmate/verastream

o) Installation owner: root:system

Actions:

i) Install

q) Quit

h) Help

Make a selection:

1. To navigate the menu, use the following commands:

Menu Category

Packages:

1) *Process Server

+ Selected, - Not

Selected,

* Required

Options:

p) Installation path:

/opt/attachmate/verastream

o) Installation owner:

[current owner:current

group]

Actions:

i) Install

q) Quit

h) Help

Commands

The Process Server is the only package being installed

and therefore is a required package.

Configure Options:

p) – Choose another base installation path. The default

is: /opt/attachmate/verastream.

o) – Choose the owner (and optional group) for all files

and directories under the base location where the

product is being installed.

Specify user or user:group

After installation by root is complete, you can directly log

in as the specified user to manage the product.

The default installation owner is: root:system

i) – Installs the product

q) – Quits the installation

h) – Displays the following help text:

The '+' symbol indicates the package selected.

The '-' symbol indicates the package is not selected.

The '*' symbol indicates the package is required (by

another).

Use the displayed number to select/unselect the package.

6


Use ‘p’ to change the default installs location.

Use 'o' to change the owner of the installation.

2. After you configure the options, enter i and press Enter to finish installing.

UNIX Unattended Installation

You may install the Process Server silently, by specifying all necessary installation and

configuration options in a separate file. Assuming this file is called install-input, type this

command on the command line:

vpd-r5-linux --licenseagreed --input install-input

Example

File install-input (below) contains all previously described options and is a sample

delivered with the installation.

If you are installing on AIX or zLinux, you need to add the location of a JDK 1.7.0 installation to

your input file (see below):

# Path to the Java SDK (version jdk1.7.0 or higher) javapath=

# Package selection

processserver=true

# Installation location

# basepath=/opt/attachmate/verastream/

# Owner of installation and startup id

servers

# owner=vpduser:vpdgroup

Note: An ‘unattended install’ presumes that you have already accepted the software

license agreement applicable to this product (most likely, in the course of a software

download process, or an initial product installation). A copy of the software license

agreement is provided in the root directory of the product, in case you wish to review

it before proceeding with this setup.

Uninstalling the Process Server on UNIX

1. Log on as root.

2. Enter /vpd_uninstall.sh

3. When prompted to remove the Process Designer, enter ‘yes’.

You can specify option –yes to answer all uninstall questions, thus setting up an unattended

uninstall.

7


Upgrading From Previous Versions

Versions of Verastream Process Designer prior to version R5 were 32-bit products. Versions R5

and all future versions are 64-bit products. If you are upgrading from a 32-bit product, read

Technical Note 10145 before proceeding.

The Process Server supports SHA-256 security certificates with 2048 bits keys. All certificates

coming from the server, for example the HTTPS Verastream Web services use this protocol. SHA-

256 security certificates are designed by the National Security Agency and meet the United States

information processing standards.

When you upgrade from a previous version, existing certificates (installed with the previous

version) are maintained.

Upgrading on UNIX

To upgrade from R5 to R5 SP1:

• Install VPD R5 SP1.

• A message confirms that a previous installation has been detected. Enter ‘y’ to continue

with the upgrade.

• The installation completes with a message indicating its success.

Upgrading on Windows

To upgrade:

• Install VPD R5 SP1.

• A message confirms that a previous installation has been detected. Choose Yes to

continue.

• The installation completes with a message indicating its success.

If you had processes deployed with persistence enabled, each execution instance was saved in

the database. After you upgrade, these instances will no longer be available.

8

More magazines by this user
Similar magazines