Process Designer Installation Guide

Transcription

1 Process Designer Installation Guide

2 Contents System Requirements... 1 Process Design Studio...1 Process Server...1 Securing files...2 Windows Installation... 2 Unattended Windows Installation...3 UNIX Process Server Installation... 3 UNIX Unattended Installation...5 Uninstalling the Process Server on UNIX...5 Upgrading from Previous Versions... 6 Copyright 2014 Attachmate Corporation. All Rights Reserved. 2

3 Installing 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 requirement 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. For the Process Designer (including both the Design Studio and Process Server) you should allow approximately 1 GB of disk space. Additional space for data (such as models, projects, and logging) or if the Windows platform does not have.net Framework or Microsoft Installer already installed may be required. Process Design Studio For Windows 7 and Windows Server 2008, when User Account Control (UAC) is enabled, you must run setup as Administrator. The Process Design Studio runs on the Windows platform. Requirements Supported (64-bit) Operating system Windows 2008 Server Windows 2008 R2 Server Windows Server 2012 Windows 7 Windows 8 Other Requirements Tutorials The Design Studio contains tutorials that walk you through important workflows in the product. These tutorials are in Portable Document Format (PDF) and require Adobe Reader. You can download the reader at 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 Service Explorer Process Server Web Services Explorer is a browser-based tool for testing SOAP-based Web services that are generated by your project. It is installed with the Design Studio and requires Internet Explorer version 9 or higher, Chrome, or Firefox 12.0 or higher. Although the Design Studio is a Windows-based component, the Process Server runs on multiple operating systems. 3

4 Requirements Supported (64-bit) Microsoft Windows Windows 2008 Server Windows 2008 R2 Server Windows Server 2012 Sun Solaris Solaris 11 (SPARC) Solaris 10 (SPARC) Red Hat Enterprise Linux RHEL 6.x SUSE Enterprise Linux Server SLES 11 SP2 z/linux SLES 11 SP2 Red Hat 6 AIX AIX 7.1 Securing files AIX 6.1 on the IBM AIX 6.1 platform, Technology Level Service Pack 3 (TL SP3) is recommended. Preventing tampering, information leakage, and other security vulnerabilities is 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: 1. Log into Windows with Administrator privileges and close all running applications. 2. Run Setup.exe. and then click Continue. 3. Read and accept the license agreement and click Continue. The following screen displays: 4. Click Install Now to install with the default settings or set the preferences found on each tab. 4 User Information - Attachmate support uses this information to provide better service.

5 File location - Specify the install location for the product. Feature Selection - Choose the features you want to install on the local machine. 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 <install_directory>\processserver\bin\pscli.cmd. 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: 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. 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 want to review it before proceeding with this setup. UNIX Process Server Installation Prerequisite: For AIX and 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 before you can continue with the installation. To install the Process Server: 1. Log on as root. Change the directory (cd) to the VPD installer directory. 2. Depending on your operating system, enter:./vpd-r6.x-prod-linux or sh vpd-r6-prod-linux for Linux systems./vpd-r6.x-prod-zlinux or sh vpd-r6-prod-zlinux for zlinux systems./vpd-r6.x-prod-solaris or sh vpd-r6-prod-solaris for Solaris systems./vpd-r6.x-prod-aix or sh vpd-r6-prod-aix for AIX systems 3. To read the license agreement, use the following command: y+enter - the Attachmate license agreement displays. Enter y to accept the license. If you want to stop the installation enter n+enter. A message displays informing you that the software cannot be installed without first reading and agreeing with the terms. 4. After accepting the license, the following menu screen displays: 5

6 Attachmate Verastream Process Designer R6 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: To navigate the menu, use the following commands: Menu category Packages: 1) *Process Server Description The Process Server is the only package being installed and therefore is required. Options: Actions: +Selected, - Not Selected *Required p) Installation path: /opt/attachmate/ verastream o) Installation owner: (current owner:current group) i) Install q) Quit h) Help Use p) to choose another base installation path. Use o) to 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. Use i) to install the product Use q) to quit the installation Use h) to display the help text. After you configure the options, enter i and press Enter to finish installing. 6

7 UNIX Unattended Installation 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 want to review it before proceeding with this setup. You may install the Process Server silently by specifying all necessary installation and configuration files in a separate file. Assuming this file is called install-input and you are installing on a Linux system, type this command on the command line: vpd-r6.x-prod-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 installation to your input file.: # Path to the Java SDK (version jdk1.7.0 or higher) javapath=<full path name of the java installation> Sample install-input file: # Package selection processserver=true # Installation location # basepath=/opt/attachmate/verastream/ # Owner of installation and startup id servers # owner=vpduser:vpdgroup Uninstalling the Process Server on UNIX 1. Log on as root. 2. Enter <VPD installation directory>/vpd_uninstall.sh 3. When prompted to remove the Process Designer, enter yes. You can specify option -yes to answer all uninstall questons, thus setting up an unattended uninstall process. 7

8 Upgrading from Previous Versions The most recent versions (R5, R5 SP1 and R6) of Verastream Process Designer are 64-bit products. Previous versions were 32-bit products. If you are upgrading from a 32-bit product, read Technical Note before proceeding. The Process Server supports SHA-256 security certificates with 2048 bits keys. All certificates coming from the server, such as 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. This version of Verastream Process Designer supports RESTful services. RESTful services require complex input and output types. If you want to expose your existing projects as RESTful services and you are using simple types for inputs and outputs, you must modify them to be complex. New projects use complex inputs and outputs by default. You can refer to those as an example. Upgrading on UNIX and Windows To upgrade from R6 to R6 SP1: Install VPD R6 SP1. A message confirms that a previous installation has been detected. On UNIX systems, Enter y to continue with the upgrade On Windows systems, choose Yes to continue. The installation completes with a message indicating 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. Upgrading from an Evaluation Version to a Production Version To upgrade from an evaluation version to a production version of Process Designer: Windows - Run evalupgrade.msp UNIX and other environments - Run the standard executable file and follow the instructions. 8

9