PBS Works 1 ,QVWDOODWLRQ Guide - Altairresources.altair.com/pbs/documentation/support/PBS Works 13.0... · PBS Works 13.0 Installation Guide iv Technical Support This document is

PBS Works is a division of

PBS Works 1 .

Guide

PBS Works 13.0 Installation Guide

Copyrights, Trademarks, and Third Party Licenses


Updated: September 29, 2015.

Intellectual Property Rights Notice:

Copyrights, Trademarks, Trade Secrets, Patents & Third Party Software Licenses

Altair® PBS Works™

Enabling On-Demand Computing™

Copyright© 1994-2015 Altair Engineering Inc. All Rights Reserved.

Special Notice: Pre-release versions of Altair software are provided ‘as is’, without warranty of any kind. Usage is strictly limited to non-production purposes.

Compute Manager™ 2007-2015; Display Manager™ 2007-2015; PBS™ 1994-2015; PBS Professional® 1994-2015; PBS Application Services™ 2008-2015; PBS Analytics™ 2007-2015; and PBS Desktop™ 2007-2012; PBS Portal™ 2007-2011; e-BioChem ™ 2007-2013; e-Compute™ 2000-2007; e-Render™ 2006-2010; OpenPBS® 1994-2003 and Personal PBS® 2007-2012.

Other Altair software applications include:

Altair Simulation Cloud Suite: Simulation Manager™ 2003-2015; Compute Manager™ 2003-2015; Display Manager™ 2003–2015; and Process Manager™ 2003-2015.

Altair HyperWorks®: HyperMesh® 1990-2015; HyperCrash® 2001-2015; OptiStruct® 1996-2015; RADIOSS®1986-2015; HyperView® 1999-2015; HyperView Player® 2001-2015; HyperStudy® 1999-2015; HyperGraph® 1995-2015; MotionView® 1993-2015; MotionSolve® 2002-2015; HyperForm® 1998-2015; HyperXtrude® 1999- 2015; Process Manager™ 2003-2015; Templex™ 1990-2015; TextView™ 1996-2015; MediaView™ 1999-2015; TableView™ 2013-2015; BatchMesher™ 2003-2015; HyperMath® 2007-2015; HyperWeld® 2009-2015; HyperMold® 2009-2015; Manufacturing Solutions™ 2005-2015; solidThinking® 1993-2015; solidThinking Inspire® 2009-2015; solidThinking Evolve® 1993-2015; Durability Director™ 2009-2015; Suspension Director™ 2009-2015; AcuSolve® 1997-2015; AcuConsole® 2006-2015; SimLab® 2004-2015; Virtual Wind Tunnel™ 2012-2015; FEKO™ 1999-2015 and VisSim™ 1989-2015.

Altair Packaged Solution Offerings (PSOs) Copyright© 2008-2015 Automated Reporting Director™ 2008-2015; Impact Simulation Director™ 2010-2015; Model Mesher Director™ 2010-2015; Model Verification Director™ 2013-2015; and Squeak and Rattle Director™ 2012-2015.

Altair intellectual property rights are protected under U.S. and international laws and treaties. Additionally, Altair software is protected under patent #6,859,792 and other patents pending. All other marks are the property of their respective owners.ALTAIR ENGINEERING INC. Proprietary and Confidential. Contains Trade Secret Information. Not for use or disclosure outside of Altair and its licensed clients. Information contained in Altair software shall not be decompiled, disassembled, “unlocked”, reverse translated, reverse

ii


engineered, or publicly displayed or publicly performed in any manner. Usage of the software is only as explicitly permitted in the end user software license agreement.

Copyright notice does not imply publication.

Third Party Licenses

Software Security Measures:

Altair Engineering Inc. and its subsidiaries and affiliates reserve the right to embed software security mechanisms in the Software for the purpose of detecting the installation and/or use of illegal copies of the Software. The Software may collect and transmit non-proprietary data about those illegal copies. Data collected will not include any customer data created by or used in connection with the Software and will not be provided to any third party, except as may be required by law or legal process or to enforce our rights with respect to the use of any illegal copies of the Software. By using the Software, each user consents to such detection and collection of data, as well as its transmission and use if an illegal copy of the Software is detected. No steps may be taken to avoid or detect the purpose of any such security mechanisms.

iii

http://www.altairhyperworks.com/ClientCenter3rdPartyLicense.aspx

http://www.altairhyperworks.com/ClientCenter3rdPartyLicense.aspx


Technical Support

This document is proprietary information of Altair Engineering, Inc.

Location Telephone EmailAustralia +1 800 174 396 [email protected] +86 21 6117 1666 [email protected] +33 1 4133 0992 [email protected] +49 7031 6208 22 [email protected] +91 80 66 29 4500

+1 800 425 0234 (Toll Free)[email protected]

Italy +39 800 905595 [email protected] +81 3 5396 2881 [email protected] +82 70 4050 9200 [email protected] +91 80 66 29 4500


North America +1 248 614 2425 [email protected] +49 7031 6208 22 [email protected] +46 46 460 2828 [email protected] +91 80 66 29 4500


South America +55 11 3884 0414 [email protected] +44 1926 468 600 [email protected]

iv

Contents

Chapter 1: About PBS Works 1

Applications and Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Supported Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Hardware Requirements for CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Hardware Requirements for RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Minimum System Requirements for DM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Execution Host Requirements for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Execution Host Requirements for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Sample Configurations for Execution Hosts for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Sample Configurations for Execution Hosts for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Web Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Web Client Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Java Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 2: Pre-installation 9

Applications and Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Deployment options for CM and DM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Option 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10


Option 3 - Recommended Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Network Implementation of Display Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Deployment Options for RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14



Option 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

v

Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Option 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Express Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Installing RVS on the same machine as CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Authentication and Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

AMS Migration from Previous Versions of CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20PBS Works Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Chapter 3: Prerequisites 23

Prerequisites for Installing CM and DM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Prerequisites for Using CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Google Chrome Frame plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Prerequisites for Installing Display Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Prerequisites for Installing Display Manager Agent for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Prerequisites for Installing Display Manager Agent for Windows . . . . . . . . . . . . . . . . . . . . . . . . . 26

Prerequisites for Installing RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Prerequisites for using RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Recommended Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Chapter 4: Installing CM and DM in GUI Mode 29

Express Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Splash Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33License Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34PBS Works Super User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35PBS Works Service User - Windows only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Installation Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

vi Contents

Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Splash Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Choose Applications to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Continue with Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Database Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Access Management Service Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Installation Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52License Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Access Management Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Authentication Module for AMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Authorization Module for AMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

PBS Works Super User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58PBS Works Service User - Windows only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61GPU Configuration for the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62GPU Configuration for the Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Installation Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 5: Installing CM and DM in Console Mode 69

Express Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Install Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72PBS Works Superuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Pre-installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Installation complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Contents vii

Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Install Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Choose Applications to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Continue with Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Access Management Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Installation Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87GPU Configuration for the PBS Server - DM only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87GPU Configuration for the PBS MOM - DM only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88PBS Works Superuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Pre-installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Chapter 6: Installing RVS in GUI Mode 91

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Installing RVS on same machine as CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Splash Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Choose Applications to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Database Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Installation Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99License Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Hyperworks Installation Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101PBS Application Service Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Installation Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

viii Contents

Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Chapter 7: Installing RVS in Console Mode 107

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Starting the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Installing RVS on same machine as CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Install Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Choose Applications to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Installation Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Hyperworks Installation Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114PBS Application Services Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Pre-installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Start Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Chapter 8: Post-Installation 117

AMS Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Access Management Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Migrating AMS from previous versions of CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Display Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Compute Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Results Visualization Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Chapter 9: Starting, Stopping and Restarting 121

PBS Works Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Determine the PBS Works Portal Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Starting the PBS Works Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Stopping the PBS Works Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Restarting the PBS Works Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

RVS Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Starting RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Determine the Status of RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Contents ix

Stopping RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Restarting RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Chapter 10: Uninstall in GUI Mode 125

Starting the Uninstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Chapter 11: Uninstall in Console Mode 131

Starting the Uninstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Starting the Uninstallation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Proceed with Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Completing the Uninstallation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

x Contents

1. About PBS Works

PBS Works™, Altair's suite of on-demand cloud computing technologies, allows enterprises to maximize ROI on existing infrastructure assets. PBS Works is the most widely implemented soft-ware environment for managing grid, cloud, and cluster computing resources worldwide. The suite’s flagship product, PBS Professional®, allows enterprises to easily share distributed computing resources across geographic boundaries. With additional tools for portal-based submission, ana-lytics, and data management, the PBS Works suite is a comprehensive solution for optimizing HPC environments. Leveraging a revolutionary “pay-for-use” unit-based business model, PBS Works delivers increased value and flexibility over conventional software-licensing models.

Applications and ServicesThe following applications and services can be installed as part of PBS Works:

Compute Manager™

Compute Manager (CM) is a web-based job submission and management portal, that is applica-tion aware. It enables users to submit, manage and review workloads on distributed resources.

Display Manager™

Display Manager (DM) enables users to run graphics-intensive applications on their cluster while visualizing those applications on their desktop.

Access Management Service

Access Management Service (AMS) provides a centralized configuration system for authentication and authorization.

Results Visualization Service

Results Visualization (RVS) is a service, available through a plug-in, which provides necessary fea-tures to access, process and visualize CAE results through an easy and intuitive graphical user interface, embedded directly into the web browser. In the current release, these features are acces-sible through the Compute Manager web interface.

1


System Requirements

Supported PlatformsCompute Manager is supported on the following platforms:

Windows 64bit• Windows Server 2008 R2 • Windows Server 2012

Linux 64bit • Red Hat Enterprise Linux 5, 6, and 7• Cent OS 5, 6 and 7• Suse Linux Enterprise Server 10, 11, and 12

Supported BrowsersWindows

• Firefox 17, 24, 31, and 38 ESR (Only Extended Support Release is supported. Please refer to https://www.mozilla.org/en-US/firefox/organizations/)

• Google Chrome 40 and 41• Internet Explorer 8, 9, 10, and 11

Linux • Firefox 17, 24, 31, and 38 ESR (Only Extended Support Release is supported. Please refer to

https://www.mozilla.org/en-US/firefox/organizations/)• Google Chrome 40 and 41

OSX • Safari 6, 7 and 8

2 About PBS Works

https://www.mozilla.org/en-US/firefox/organizations/

https://www.mozilla.org/en-US/firefox/organizations/


Hardware Requirements for CM Please review the following hardware requirements for Compute Manager.

Hardware Requirements for RVS Please review the following hardware requirements for Results Visualization Service.

Table 1. Hardware requirements for CM and DM

Hardware Minimum Requirement RecommendedCPU 2 CPU cores with a minimum

speed of 2.5 GHz4 CPU cores with a minimum speed of 2.5 GHz

Memory (Physical) 2 GB 8 GBDisk Space 2 GB 4 GB

Table 2. Hardware requirements for RVS

Hardware Minimum Requirement RecommendedCPU Dual Core Processor @ 2 GHz Quad Core Processor @ 2.5 GHzMemory (Physical) 4 GB 16 GB

About PBS Works 3


Minimum System Requirements for DM

Execution Host Requirements for Linux

Execution Host Requirements for Windows

Operating System Any Linux distribution in the Red Hat Enterprise or SUSE Enterprise fam-ilies which contains GLIBC 2.3.2 or later

Graphics • Only NVIDIA and [AMD] ATI cards are supported.• For Linux, install the 3D adapter drivers provided by the manufacturer.• Full 3D acceleration or Pixel Buffer support should be enabled by the

Linux drivers.GPU cores and GPU memory

Specific to the applications used.

CPU cores and Physical memory


Others • For running Display Manager sessions, X Server and application on local display must be configured and working. X Server must be config-ured to export True Color (24 bit or 32 bit) visuals.

• Use Virtual Private Networking or secured channels for communication between clients and Display Manager server if encryption is required.

• The execution host must be able to access and run the applications avail-able through Display Manager.

Operating System Windows Server 2007, 2008 R2 and 2012Graphics Only NVIDIA and [AMD] ATI cards are supported.CPU cores and Physical memory


Others • Use Virtual Private Networking or secured channels for communication between clients and Display Manager server if encryption is required.

• The execution host must be able to access and run the applications avail-able through Display Manager.

4 About PBS Works


Sample Configurations for Execution Hosts for Linux

Here are some sample execution host configurations on which Display Manager has been tested for Linux.

If Remote Desktop Protocol (RDP) is in use, then ensure that the latest updates and patches are installed. Refer Remote Desktop Protocol (RDP) 8.0 update for Windows 7 and Windows Server 2008 R2 for more infor-mation.

Graphics Card Model Processor OS RAM

System 1 NVIDIA Quadro FX 5500

2 x AMD® Opetron® CPU 2220 (4 cores total)

RHEL WS R4 (Nahant Update 6)

4 GB

System 2 NVIDIA Quadro 600

2 x Intel® Xeon® CPU E31280 @ 3.50GHz (8 cores total)

RHEL Client R 5.1 (Tikanga)

32GB


2 x Intel® Xeon® CPU X5675 @3.07GHz(12 cores total)

Cent OS 5.5 48GB


2 x Intel® Xeon® CPU X5675 @3.07GHz (12 cores total)

Cent OS 5.5 48GB

System 5 NVIDIA (2) Quadro 4000

2 x Intel® Xeon® CPU E5620 @ 2.40GHz(8 cores total)

Cent OS 5.5 32GB


2 x Intel® Xeon® CPU E5620 @ 2.40GHz (8 cores total)

RHEL Server R 6.3 (Santiago)

24GB


Intel® Xeon® CPU E5620 @ 2.40GHz (4 cores)

RHEL 5 4GB

System 8 [AMD] ATI Device 6809

Intel(R) Xeon(R) CPU E3-1220 v3 @ 3.10GHz (4 core)

Cent OS 6.4 32GB

About PBS Works 5

https://support.microsoft.com/en-us/kb/2592687

https://support.microsoft.com/en-us/kb/2592687


Sample Configurations for Execution Hosts for Windows

Here are some sample execution host configurations on which Display Manager has been tested for Windows.

Web Server Requirements

System 9 NVIDIA Quadro K4000, NVIDIA Quadro 2000


SLES 11 SP3 32GB

System 10 NVIDIA Quadro K5000


SLES 11 SP3 32GB



Intel(R) Pentuim(R) CPU 3.00GHz (2 core)

Windows 2008 R2 4GB


Intel(R) i7 CPU 2.20GHz (4 core)

Windows 2012 R2 8GB


Intel(R) i7 CPU 2.20GHz (4 core)

Windows 2012 R2 8GB

Operating System • Windows Server 2007, 2008 R2 and 2012• Red Hat Enterprise Linux version 5 and later• SUSE Linux Enterprise Server version 10 and later

CPU Intel(R) Xeon(R) CPU X5675 @ 3.07GHz or fasterPhysical Memory 8GB or higher


6 About PBS Works


Web Client Requirements

Java RequirementJava Extensions are required on the browsers. Java Runtime Environment (JRE) should be avail-able on the Web Client.

Download the latest JRE version from https://java.com/en/download/.

For information about installing Java, refer to http://www.java.com/en/download/help/down-load_options.xml.

To enable Java, refer to http://www.java.com/en/download/help/enable_browser.xml.

To enable NPAPI in Chrome, refer to https://java.com/en/download/faq/chrome.xml#npapi-chrome.

For troubleshooting the Java installation, refer to http://www.java.com/en/download/help/trouble-shoot_java.xml.

LicensingFor users to log into any of the PBS Works products, PBS Works must have access to an activated and running Altair License Management System (ALM) that allows a PBS Works product to draw license units. During the installation of PBS Works, you will be prompted to supply information about the license server (port and hostname/IP address). You may supply the information at this time, or PBS Works can be configured with this information post-installation.

CPU Pentium 4/Xeon, 2.0 GHz or fasterRAM 2 GB or higherSupported Browsers On Windows:

• Mozilla Firefox ESR (Extended Support Release) 24, 31, and 40• Google Chrome 40 and 41• Microsoft Internet Explorer 8, 9, 10, and 11On Linux:• Mozilla Firefox ESR 31Note: Java Extensions are required on the browsers.

About PBS Works 7

https://java.com/en/download/

http://www.java.com/en/download/help/download_options.xml


https://java.com/en/download/



http://www.java.com/en/download/help/enable_browser.xml



http://www.java.com/en/download/help/troubleshoot_java.xml







The following HyperWorks Units (HWUs) are drawn for Computer Manager:• 2 HWUs are checked out at CM/DM server startup and stay locked all the time.• 1 additional HWU per concurrently logged in user is required.

The following HyperWorks Units (HWUs) are drawn for Results Visualization Service. These units are checked out only during the server-side operation for extracting the information from job result files. There is no license draw while displaying this information in the browser.

• 10 HWUs for a RVS plot• 6 HWUs for a RVS animation

8 About PBS Works

2. Pre-installation

Applications and ServicesThe following applications and services can be installed as part of PBS Works:

Compute Manager is a web-based job submission and management portal.

Display Manager enables users to run graphics-intensive applications on their cluster while visual-izing those applications on their desktop. DM requires three components to be installed:

• web application - must be installed on the same machine as CM• router - must be installed on the same machine as CM• agent - must be installed on all PBS Professional MOMs

Access Management Service provides a centralized configuration system for authentication and authorization.

Results Visualization Service is a service, available through a plug-in, which provides necessary features to access, process and visualize CAE results through a graphical user interface, embedded directly into the web browser. These features are accessible through the Compute Manager web interface.

• Results Visualization Service must be installed after installation of CM to use the plug-in with Compute Manager.

Deployment options for CM and DMDepending on which installation option is chosen, Express Installation or Custom Installation, you can choose to install some or all PBS Works applications or services.

When you install CM or DM, an instance of AMS will also be installed, as well as a database instance.

If DM is being installed, the PBS Works installer always installs the DM web application and router. If the installer detects a PBS Professional MOM (execution host) on the machine where DM is being installed, then the DM agent will also be installed.

9


If a MOM is not detected, then the DM agent will have to be installed separately on the MOM(s). The installation of the DM agent will require the use of a separate installer and instructions for it’s installation on the MOM(s) can be found in the Display Manager Administrator’s Guide.

If you are installing DM onto a machine where PBS Professional and PBS Application Services are already installed, then the installer will perform some configuration of both in support of DM. Otherwise, if DM is being installed onto a machine that does not host PBS Professional and PBS Application Services, then a separate DM installer must be used to configure the PBS Professional and PAS Servers. Instructions for these activities can be found in the Display Manager Administra-tor’s Guide.

Option 1This option installs all applications and services onto a single machine that hosts all PBS Works applications and services, as well as the PBS Professional Server and MOM, PBS Application Ser-vices, and the DM agent.

Advantages• Costs are reduced since a single hardware is sufficient• Maintenance cost is reduced since a single hardware is used.

Disadvantages• Performance can be slow as all the services are running on a single machine.

10 Pre-installation


• Adequate computing hardware resources are required.• Not suitable for heavy usage load. • High dependency on the single server's performance

Option 2This option deploys all applications and services, except the DM agent component, on a single machine that hosts the PBS Professional Server. The execution host(s) are installed on separate machines from the PBS Professional Server, therefore the DM agent will have to be installed sepa-rately on the MOMs. The installation of the DM agent will require the use of a separate installer and instructions for it’s installation on the MOMs can be found in the Display Manager Adminis-trator’s Guide.

Advantages

Similar to Option 1 although execution resources are off loaded to separate machine(s).

Disadvantages• Similar to Option 1.• Installation of the DM agent will have to be done as a separate step.

Pre-installation 11


Option 3 - Recommended ConfigurationThis option deploys all applications, except the DM agent component, on a single machine with the PBS Professional and PAS Servers hosted on a separate machine. Since DM is being installed on a machine that is not hosting the PBS Professional and PAS servers, then a separate DM installer must be used to configure the PBS Professional and PAS Servers, as well as installing the DM agents on the MOMs. Instructions for these activities can be found in the Display Manager Administrator’s Guide.

Advantages• Improved performance as the services are running on different machines.• Distributed environment reduces computing hardware resources per machine.

Disadvantages• Installation of the DM agent will have to be done as a separate step.• Configuration of PBS Professional and PAS will have to done as a separate step.• Increased investment and maintenance costs.

12 Pre-installation


Network Implementation of Display ManagerThe network connections for Display Manager components are shown below.

When a user double-clicks an application icon in Display Manager (DM), the remote application is started and the following sequence of events are initiated.

1. The DM Application sends the request to the DM Web Service.2. The DM Web Service interfaces with PAS to submit an interactive job.

Pre-installation 13


3. The interactive job script updates DM Web Service with the Remote Display Server (RDS) information.

4. DM Web Service responds to DM Web Application with the RDS information. The DM Web Application transfers the information to Client Viewer.

5. Client Viewer connects to the Display Server directly. If the Display Server is not reachable, then it tries to connect to Display Server through configured Display Router.

Virtual Private Networking or secured channels for communication between clients and Display Manager Server can be used if encryption is required. Only the users currently logged in into DM that have a valid session ID are allowed to connect to the DM router.

The ports for the Display Manager portal (application server, port 8086 by default) and the Display Manager Router (port 9500 by default) should be open through the firewall or gateway for clients to connect. The port information for these two components is displayed in the installation sum-mary.

Deployment Options for RVS

Option 1This option deploys all applications and services on a single machine.

Advantages• In this deployment option, there is no file copy from the PAS staging directory to the

machine hosting RVS, therefore the performance is better. • Costs are reduced since a single hardware is sufficient• Maintenance cost is reduced since a single hardware is used.

14 Pre-installation


Disadvantages• Performance can be slow as all the services are running on a single machine.• Adequate computing hardware resources are required.• Not suitable for heavy usage load. • High dependency on the single server's performance

Option 2 This option deploys RVS on the same machine as PBS Professional and PBS Application Services, while Compute Manager is hosted on a separate machine.

Advantages• This deployment option provides better performance since there is no file copy required

from the PAS staging directory to the machine hosting RVS.

Disadvantages• High availability of computing resources on the PBS head node is required. • High dependency since RVS performance affects PBS server.

Pre-installation 15


Option 3This option deploys RVS on the same machine as HyperWorks. PBS Professional and PBS Appli-cation Services, and Compute Manager are hosted on a separate machine.

Advantages• This option provides better performance as the services are running on different machines.• There is low dependency between RVS and other applications.

Disadvantages• If the result files are not directly accessible, they are moved over the network resulting in

slower response time. This can be improved by mounting the PAS staging directory.• High investment and maintenance costs.

16 Pre-installation


Option 4This option deploys RVS on the same machine as HyperWorks. PBS Professional and PBS Appli-cation Services are hosted on a single machine, while Compute Manager is hosted on a separate machine.

Advantages• Distributed environment reduces dependency.• Better performance as the services are running on three different machines.

Disadvantages• If the result files are not directly accessible, they are moved over the network resulting in

slower response time. This can be improved by making the PAS staging directory directly accessible to Server-C.

• High investment and maintenance costs.

Installation OptionsTwo installation options are available through the PBS Works installer: Express Installation and Custom Installation.

Express InstallationThe Express option is recommended for installations where both Compute Manager and Display Manager are being installed on the same machine as PBS Professional and PBS Application Ser-vices.

Pre-installation 17


Applications and services installed via the Express installation option are: • Compute Manager• Display Manager• Access Management Service• A database instance (port 6767)• Display Manager router • Display Manager web application• DM agent will be installed if a MOM is detected

SSH protocol is used for authentication on Linux/Unix platforms, and Windows protocol on Win-dows platforms.

Authorization services are performed through AMS.

The installation directory will be:

on Windows: C:\altair\pbsworks\13.0

on Unix/Linux: /opt/altair/pbsworks/13.0

The Express option assumes that PBS Professional Server and PBS Application Services is installed on the same machine as the PBS Works applications (CM, DM, AMS).

For DM, the number of GPUS available in the cluster defaults to one (1). This information will be used to configure the PBS Professional Server. The number of GPUS on the execution hosts defaults to one (1). This information will be used to configure the PBS MOM.

The database administrator defaults to “pbsworksuser”.

The AMS administrator defaults to “amadmin” with a password of “adminadmin”.

Custom InstallationThe Custom option provides more flexibility during installation. You can choose what applica-tions to install, where to install, type of authentication and authorization to use, and you can install the PBS Works application on a separate machine from PAS and PBS.

Applications and services that can be installed via the Custom installation option are: • Compute Manager• Display Manager• Access Management Service

18 Pre-installation


• Results Visualization Service• A database instance (port 6767)• Display Manager router • Display Manager web application• DM agent will be installed if a MOM is detected

If credentials are not provided for the database administrator during installation, then the data-base administrator defaults to “pbsworksuser”.

The AMS administrator defaults to “amadmin” with a password of “adminadmin”.

Installing RVS on the same machine as CMCurrently, the Custom option of the PBS Works installer does not support installing RVS at the same time as CM (typically RVS is installed on a separate machine). If you are installing RVS on the same machine as CM, then you need to install RVS in a separate location from CM. Addition-ally, RVS should be installed with its own database. Do not connect to an existing PBS Works database (see Installing RVS in GUI Mode and Installing RVS in Console Mode).

Authentication and AuthorizationDuring installation, PBS Works can be configured to use either Windows based or SSH based authentication, or it can be configured to authenticate against the AMS datastore.

If you have chosen to authenticate against the AMS datastore, then the datastore must be popu-lated prior to users logging into the CM and DM web applications.

Authorization is done against the AMS datastore. Currently, only Computer Manager supports specific authorization policies. The AMS console can be used to add CM authorization policies. See the "Post-Installation" chapter in the Computer Manager Administrator's Guide for more infor-mation.

There are two options available for populating AMS with users and groups:• During installation of PBS Works, there is an option to connect AMS to a Windows Active

Directory (AD), or a Lightweight Directory Access Protocol (LDAP) compatible server. However, adding and deleting users via the AMS console is restricted when an LDAP/AD is being used.

• Populate AMS with users and groups using the AMS console. For more information about using AMS to manage users and groups see “Authentication and Authorization” in the PBS

Pre-installation 19


Works Administrator’s Guide, which can be downloaded from PBS Works documentation user area.

AMS Migration from Previous Versions of CMIf you are currently running a previous version of Compute Manager, and would like to migrate the AMS datastore to avoid having to re-enter users, groups, and authorization policies into AMS, then prior to uninstalling CM, copy and save the following files:

<INSTALL_DIR>/config/AAServiceHome/applications/cm/cmPolicy.xml

<INSTALL_DIR>/config/AAServiceHome/resources/AA_Users.xml

<INSTALL_DIR>/config/AAServiceHome/resources/AA_Groups.xml

where <INSTALL_DIR> is the directory where the previous version of Compute Manager is installed.

InstallationInstallation is similar to the installation of other PBS Works products. A binary or executable needs to be downloaded from the PBS Works user area and executed. The installer will walk you through the installation process.

Typically, the PBS Works service is installed and configured to use port 8086. If this port is not available during installation, then the PBS Works installer will increment the port number and try again. This will continue until a free port is found, or until 100 consecutive ports are refused at which point the installer will ask for a port.

PBS Works DatabasePostgres will be installed by the PBS Works installer. The installer will create a default user, if one is not supplied during installation, as the database administrator - “pbsworksuser”.

The PBS Works database is installed and configured to use port 6767. If this port is not available during installation, then the PBS Works installer will increment the port number and try again. This will continue until a free port is found, or until 100 consecutive ports are refused at which point the installer will ask for a port.

If PBS Works is installed on a Windows platform, then a separate service is registered specifically for the PBS Works database. This service will automatically be started when the PBS Works ser-vice is started.

20 Pre-installation


ConfigurationSome level of configuration of CM, DM and RVS may need to be performed after installation is complete. Please see their respective administration guides for more information.

Pre-installation 21


22 Pre-installation

3. Prerequisites

Prerequisites for Installing CM and DM• system administrator privileges • existence of the following users before beginning the installation

- The PBS Work superuser (CM only) - This user must be a pre-existing user on the machine where PBS Work is being installed. This user will be responsible for adminis-tering the CM web applications, for example adding PAS servers to CM.

- The PBS Works service user (Windows platforms only) - This user will be used to reg-ister the PBS Works service. This user must exist on the authentication server.

• removal of any old instances of PBS Works applications and services - CM, DM, AMS, and RVS

• adherence to the minimum system requirements (see System Requirements).

Prerequisites for Using CMIn order to register a user session of Compute Manager 13.0 to an Enterprise PBS Professional complex, the complex head node must be running PBS Application Services 12.0.2 or later. Please contact your site administrator for further information.

Google Chrome Frame plug-inInternet Explorer versions 8, 9, 10, and 11 do not natively support the multi-file upload mecha-nisms for local files nor the file upload progress meter in Compute Manager. It has been observed that many times installing the Chromium projects Google Chrome Frame plug-in on Windows XP, Vista and Windows 7 has provided indirect support for this. However, this configuration has not formally been tested, so it is not fully supported by Altair. Please use the Chromium projects at your own discretion.

Prerequisites for Installing Display ManagerThe following prerequisites have to be met to allow the Display Manager Agent (DM Agent) to configure ngpus on PBS MOMs (Machine Oriented Miniservers). The term ngpus refers to a sin-

23


gle custom consumable resource to represent all GPU devices on an execution host. Refer to the PBS Professional Administrator's Guide for more information.

Prerequisites for Installing Display Manager Agent for LinuxThe following prerequisites have to be met to allow the Display Manager Agent (DM Agent) to configure ngpus on PBS MOMs (Machine Oriented Miniservers).

Configuring GPU Resources

A custom resource called ngpus has to be configured for Display Manager sessions. This can be adjusted any time.

The ngpus setting limits the number of concurrent display sessions that can utilize the GPU on the host. When more concurrent sessions are using the same GPU, the display session performance will be affected.

Apart from configuring GPUs, performance can be improved by increasing host memory, network performance and CPU cores.

Configuration of PBS Server

PBS Server should have been configured using either the PBS Works 13.0 installer or the PBS Works 13.0 Display Manager add-on installer to make sure that ngpus are configured as a custom resource.

The PBS Works 13.0 installer will perform the following:• Install the DM components• Define a new custom resource called ngpus• Set the custom resource at each execution host

PBS Privileges

For the Display Manager Add-on installer to set the custom resource at each execution host, the root user of all execution hosts must be granted operator access. Prior to starting the DM Add-on installer, issue the following command to grant this access:

qmgr: s s operators+=root@*

If this access is not granted, then you will manually have to set the custom resource by issuing a qmgr set command for each execution host after installation of DM. For example:e.g. set node <node> resources_available.ngpus = 4

24 Prerequisites


After applying such a setting, every user named root from any host on any network will be able to operate on jobs from other users. To prevent misuse, restrict the above setting to the sub domain containing the execution hosts or list them one by one.

After installing Display Manager components, you can remove the root user of the PBS MOMs from the operators list on the PBS server using the command: qmgr: s s operators-=root@*

Prerequisite Resource Libraries for DM Agent

If the following libraries must be installed before attempting to install DM. If they are not, they can be installed using the appropriate system tools (e.g. RPM, YUM, YAST etc.).

libc.so.6()(64bit)

libc.so.6(GLIBC_2.2.5)(64bit)

libc.so.6(GLIBC_2.3)(64bit)

libcrypt.so.1()(64bit)

libdl.so.2()(64bit)

libdl.so.2(GLIBC_2.2.5)(64bit)

libGL.so.1()(64bit)

libGLU.so.1()(64bit)

libICE.so.6()(64bit)

libm.so.6()(64bit)

libm.so.6(GLIBC_2.2.5)(64bit)

libpam.so.0()(64bit)

libpthread.so.0()(64bit)

libpthread.so.0(GLIBC_2.2.5)(64bit)

libpthread.so.0(GLIBC_2.3.2)(64bit)

libSM.so.6()(64bit)

libX11.so.6()(64bit)

libXaw.so.7()(64bit)

libXcursor.so.1()(64bit)

libXext.so.6()(64bit)

libXmu.so.6()(64bit)

libXt.so.6()(64bit)

libXv.so.1()(64bit)

libz.so.1()(64bit)

Prerequisites 25


Prerequisites for Installing Display Manager Agent for WindowsConfiguration of PBS Server

PBS Server should have been configured using either the PBS Works 13.0 installer or the PBS Works 13.0 Display Manager add-on installer.

The PBS Works 13.0 installer will Install the DM components.

The PBS Works 13.0 Display Manager add-on installer will perform the following:• Configure PBS and PAS Server• Installing the Display Manager Router• Install Display Manager Agent• Unconfigure PBS and PAS Servers

Prerequisites for Installing RVS • Altair HyperWorks 12.0 - 110 must be installed.

- The HyperWorks installation should not be in /root or any user’s home directory.- HyperWorks should be installed in a location where all users have read and execute

permissions.- Refer to the HyperWorks installation guide for more details on how to install it.- Installation of RVS must be performed as root or an Administrative user.

• Compute Manager must be installed and the service should be up and running.• adherence to the minimum system requirements (see System Requirements).

Prerequisites for using RVS • Configuration of Compute Manager is necessary after installation of RVS to register RVS

with CM. Please see the “Configurations on Compute Manager” section of the Results Visualization Service Administrator’s Guide.

• The RVS URL (http://<RVSHost>:Port ) must be directly accessible from the connecting web clients, unless RVS is configured to route traffic through Compute Manager. See “Enabling RVS traffic through CM” in the PBS Works Administrator’s Guide for more infor-mation.

26 Prerequisites


Recommended RequirementsTo avoid copying result files from job execution host to RVS, all execution hosts job scratch direc-tories should be directly accessible from RVS. For more information, refer to the section “Making Job Directories Available to RVS” in the Results Visualization Service Administrator’s Guide.

To avoid file copies, the file location should be directly accessible to RVS. The PAS staging direc-tory and job output directories (such as user’s home or project directories) should be mounted on RVS.

In some situations the above setup is not possible. Therefore, to use an efficient file copying sys-tem, password-less authentication must be configured among all hosts.

Prerequisites 27


28 Prerequisites

4. Installing CM and DM in GUI Mode

If you are installing DM onto a machine where PBS Professional and PBS Application Services are already installed, then the installer will perform some configuration of both in support of DM. Details about this configuration can be found in the Display Manager Administrator’s Guide.

Otherwise, if DM is being installed onto a machine that does not host PBS Professional and PBS Application Services, then a separate DM installer must be used to configure the PBS Professional and PAS Servers. Instructions for these activities can be found in the Display Manager Administra-tor’s Guide.

If a PBS MOM is detected, the installer will also install the Display Manager Agent. This configu-ration will require both PBS Professional and PBS Application Services to be restarted. Therefore, it is recommended to delay the installation until such a time when critical jobs are not running.

Express Installation The Express option is recommended for installations where both CM and DM are being installed on the same machine as PBS Professional and PBS Application Services.

Applications and services installed via the Express installation option are: CM, DM, and AMS, as well as a database instance (port 6767). The DM router and web application will be installed, and the DM agent will be installed if a MOM is detected.

For installation prerequisites see Prerequisites.

To install PBS Works download the installer appropriate for your platform from the user area.

Starting the InstallerInvoke the installer by executing the following command on Linux/Unix platforms:

./PBS_Works_13.0_Linux_x86_64__YYYYMMDD_MMSS.bin -i swing

Or by double-clicking the executable on Windows platforms:

PBS_Works_13.0_Windows_x86_64_YYYYMMDD_MMSS.exe

29


Splash ScreenAfter extracting the files, the installation will proceed by displaying the splash screen.

30 Installing CM and DM in GUI Mode


IntroductionThe Introduction screen provides information on navigating the installer using the Next and Pre-vious buttons and specifies the Prerequisites for Installation.

Installing CM and DM in GUI Mode 31


License AgreementTo continue with the installation, please scroll down to read the license agreement and accept it.



Installation TypeTo install Compute Manager and Display Manager using windows authentication on Windows, SSH on Linux, using local authorization with a new database, choose Express Install.



License Server ConfigurationProvide the license server location information. More than one location can be provided by sepa-rating them with a colon (:) in Linux and with a semicolon (;) in Windows.



PBS Works Super UserEnter a user id that will be the PBS Works portal administrator. This user will have privileges for administering the PBS Works applications, for example adding PAS servers to CM.

On Linux, this user must be a pre-existing user on the machine where PBS Works is being installed.

On Windows:

If the machine where PBS Works is being installed is a part of a domain, then specify a domain user that exists on the machine.



If the machine where PBS Works is being installed is not part of a domain, then specify a local user that exists on the machine.

Portal Administrator User does not exist

If the user specified for the portal administrator does not exist, you may click OK to configure the portal administrator after the installation of PBS Works. See “Configuring Administrative Users” in the PBS Works Administrator’s Guide for information about manually configuring a PBS Works portal administrator.

Otherwise, you can click BACK and enter another user.



PBS Works Service User - Windows onlyFor Windows platforms, enter a user id and password that will be used to register the PBS Works service. This user must exist on the authentication server. Click Next.



Pre-Installation SummaryThis screen summarizes all your choices before beginning the installation.



Installation ProgressDuring installation, the billboards are displayed based on the installation options you selected.

On completion, the installer will provide the details of the Installation Directory, Host, Port and the link to login to the portal.

Start ServicesOnce the installation is complete, the PBS Works service will be started. The following message will be displayed.



If the DM agent was installed, then the DM Agent service will be started. The following message will be displayed.

Installation CompleteOnce the installation is complete the installation details will be displayed. Click Done to complete the installation.



RestartRestarting the system is advised if the DM Agent is installed. Click Yes.

Custom Installation The Custom installation option can be used when more flexibility is required than is supported by the Express installation option. For instance, you can choose what applications to install, where to install, type of authentication and authorization to use, and you can install the PBS Works applica-tion on a separate machine from PAS and PBS.

As of PBS Works 13.0, installing Display Manager requires that Compute Manager be installed as well.


RVS can also be installed using the Custom installation option. For more information see Install-ing RVS in GUI Mode or Installing RVS in Console Mode.

To install CM and/or DM download the installer appropriate for your platform from the user area.
















Installation TypeTo perform a custom installation which gives more flexibility when installing PBS Works applica-tions, select the Custom Install option. Click Next.



Choose Applications to InstallChoose an application to install. You can install:

1. Compute Manager only2. Compute Manager and Display Manager

Click Next.

Continue with InstallationIf you are installing DM onto a machine where PBS Professional and PBS Application Services are already installed, then the installer will perform some configuration of both in support of Display Manager.

This configuration will require both PBS Professional and PBS Application Services to be restarted. Therefore, it is recommended to delay the installation until such a time when critical jobs are not running.

If a PBS MOM is also detected, the installer will also install the Display Manager Agent.



If you would like to continue the installation, click Yes. Otherwise to cancel the installation click No.

Database ConfigurationA database instance is installed with CM and DM.

If you have already installed a PBS Works product and want to connect to its database, then choose the Existing Database option and provide the hostname, port, and database administrator and password to connect to the existing database.



Otherwise, choose the New Database option. A non-administrative user is required to own the database as a administrator. You can provide this user’s credentials, or you can let the installer cre-ate a database administrator. Click Next.



You can also provide the credentials of an existing OS user who will become the database Super User.

If the application is pointed to an existing database from a previous installation using the PBS Works installer, provide the credentials of the database super user.



Access Management Service ConfigurationAMS provides a centralized configuration system for authentication and authorization.

If you have previously installed a PBS Works product and want to use the previously installed instance of AMS, then choose the Use an Existing Instance option, and enter the hostname and port where AMS is installed.



An existing instance of AMS can be used by providing the Hostname or IP Address and the port at which the AMS instance is running.



Installation FolderSpecify a location where the selected applications will be installed. These components can be installed to the default location, or another location locally. To select a custom directory click Choose. To restore the default directory, click Restore Default Folder. Once an installation location is entered, click Next. The default location for Linux is: /opt/altair/pbsworks/13.0 and for Win-dows is: C:\altair\pbsworks\13.0



License Server ConfigurationIt is not mandatory to provide the license server at installation time. You will however be required to configure the license server information prior to starting Compute Manager or Display Man-ager (see “Configuring the License Server” in the PBS Works Administrator’s Guide).



Access Management ServiceDuring installation, PBS Works can be configured to use either Windows based or SSH based authentication, or it can be configured to authenticate against the AMS datastore.

Authentication Module for AMS

The portal (PBS Works) and services can be configured to use the following authentication mech-anisms:

SSH (Secure Shell): All the users will be authenticated against a SSH server provided by the administrator during installation.



Access Management Service: All the users will be authenticated against a datastore and managed using the AMS console.



Authorization Module for AMS

Authorization is performed against the AMS datastore. The AMS datastore can be populated with users and groups via a connection to a Windows AD, or any LDAP compatible server. Or it can be populated by using the AMS console to add users, groups, and authorization policies

Active Directory

If you choose to use Active Directory, provide the details of the LDAP compatible server.



Access Management Service

If you choose Access Management Service, no further inputs are required by the installer. Use the AMS console for authorizing users through the local datastore.



PBS Works Super UserEnter a user id that will be the PBS Works portal administrator. This user will have privileges for administering the PBS Works applications, for example adding PAS servers to CM.

On Linux, this user must be a pre-existing user on the machine where PBS Works is being installed.



On Windows:

If the machine where PBS Works is being installed is a part of a domain, then specify a domain user that exists on the machine.

If the machine where PBS Works is being installed is not part of a domain, then specify a local user that exists on the machine.



Portal Administrator user does not exist

If the user specified for the portal administrator does not exist, you may click OK to configure the portal administrator after the installation of PBS Works. See “Configuring Administrative Users” in the PBS Works Administrator’s Guide for information about manually configuring a PBS Works portal administrator.

Otherwise, you can click BACK and enter another user.



PBS Works Service User - Windows onlyFor Windows platforms, enter a user id and password that will be used to register the PBS Works service. This user must exist on the authentication server. Click Next.



GPU Configuration for the ServerIf DM is being installed, and a PBS Professional Server is detected by the installer on the machine where DM is being installed, it will ask the user for the number of GPUs available in the cluster. This information will be used to configure the PBS Professional Server.



GPU Configuration for the NodeIf DM is being installed, and a PBS MOM is detected by the installer on the machine where DM is being installed, it will ask the user for the number of GPUs available on the execution node. This information will be used to configure the PBS MOM



Pre-Installation SummaryA pre-installation summary will be displayed. Review all the installation specifications before ini-tiating the installation. If the specifications are incorrect, click Previous to go back and make any necessary changes. If the installation specifications are correct, click Install to initiate installation.





Start ServicesOnce the installation is complete, the PBS Works service will be started. The following message will be displayed.







RestartRestarting the system is advised if the DM Agent is installed. Click Yes.




5. Installing CM and DM in Console Mode

If you are installing DM onto a machine where PBS Professional and PBS Application Services are already installed, then the installer will perform some configuration of both in support of DM. Details about this configuration can be found in the Display Manager Administrator’s Guide.

Otherwise, if DM is being installed onto a machine that does not host PBS Professional and PBS Application Services, then a separate DM installer must be used to configure the PBS Professional and PAS Servers. Instructions for these activities can be found in the Display Manager Administra-tor’s Guide.

If a PBS MOM is detected, the installer will also install the Display Manager Agent. This configu-ration will require both PBS Professional and PBS Application Services to be restarted. Therefore, it is recommended to delay the installation until such a time when critical jobs are not running.

Express Installation The Express option is recommended for installations where both CM and DM are being installed on the same machine as PBS Professional and PBS Application Services.

Applications and services installed via the Express installation option are: CM, DM, and AMS, as well as a database instance (port 6767). The DM router and web application will be installed, and the DM agent will be installed if a MOM is detected.


To install PBS Works download the installer appropriate for your platform from the user area.


./PBS_Works_13.0.0_Linux_x86_64_YYYYMMDD_MMSS.bin -i console

IntroductionPlease read through the instructions before proceeding with the installation. To ensure a success-ful installation, please note the prerequisites for the installation. At anytime during the installation

69


process, you may enter back to go back to a previous installation step. To cancel the installation process, enter quit. To continue the installation process, press <ENTER>.

=========================================================================

Introduction

-------------

PBS Works Suite 13.0 installer will guide you through the installation.

It is strongly recommended that you quit all programs before continuing with

this installation.

Use the "Next" and "Previous" buttins to navigate between the installation steps.

You may cance this installation at any time by clicking the "Cancel" button.

Pre-requisites for Installation:

1. Minimum hard disk space of 4 GB

2. Minimum RAM of 4 GB

3. A non-admin User name and password to act as owner of PBS Works Database

4. A User name and password of the user who would be acting as Portal Administrator. This user should be existing on the authentication server.

5. An existing active directory user and password in case you choose Enterprise data-store to query user details for authorization.

PRESS <ENTER> TO CONTINUE:

70 Installing CM and DM in Console Mode


License Agreement License agreement information will be displayed. Please read through the License Agreement before proceeding with the installation. To accept the terms of the license agreement, enter “Y” and press <ENTER>.

accomplish the intent of the parties within the limits of applicable law, and all remaining provisions shall continue to be valid and enforceable. Heading. The section headings contained in this Agreement are for convenience only and shall not be of any effect in constructing the meanings of the Sections. Modification. no change or mod-ification of this Agreement will be valid unless it is in writing and is signed by a duly authorized representative of each party. Conflict. In the event of any conflict between the terms of this Agreement and any terms and conditions on a Licensee Pur-chase Order or comparable document, the terms of this Agreement shall prevail. More-over, each party agrees any additional terms on any Purchase Order or comparable document other than the transaction items of (a) item(s) ordered; (b) pricing; (c) quantity; (d) delivery instructions and (e) invoicing directions, are not binding on the parties. IN the event of a conflict between the terms of this Agreement, and the Additional Terms, the Agreement shall take precedence. Entire Agreement. This Agree-ment, the Additional Terms, and the Order Form(s) attached hereto constitute the entire understanding between the parties related to the subject matter hereto, and superseded all proposals or prior agreements, whether written or oral, and all other communications between the parties with respect to subject matter. This Agreement may be executed in one or more


counterparts, all of which together shall constitute one and the same instrument. Execution. Copies of this Agreement executed via original signatures, facsimile or email shall be deemed binding on the parties.

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):

Installing CM and DM in Console Mode 71


Install OptionsTo install both CM and DM on the same machine as PBS Professional and PBS Application Ser-vices, select the Express Install option by entering “1” and pressing <ENTER>.

License ServerIt is not mandatory to provide the license server at installation time. You will however be required to configure the license server information prior to starting Compute Manager or Display Man-ager (see “Configuring the License Server” in the PBS Works Administrator’s Guide).

Press <ENTER>.

=========================================================================Installation Type-------------------

Please choose the type of installation thaout you would like to go ahead with. A small description for the installation types is as below:

Express Install - Installs Compute Manager and Display Manager applications, Resulsts Visualization Service is not installed, uses Windows authentication on Win-dows and SSH on Linux, uses locatl authorization, installs a new DB and creates a default DB user.

Custom Install - Provides option to the users to configure the installation.

->1- Express Install 2- Custom Install

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

=========================================================================License Server Configuration-----------------------------

"Applications" require access to the Altair License Server to function. Please pro-vide the license server location.

You can provide multiple license server locations separated by a colon.

License Server (e.g: [email protected]:6200@lmxserver): (Default: ):



PBS Works Superuser Enter a user id that will be the PBS Works portal administrator. This user must be a pre-existing user on the machine where PBS Works is being installed. This user will have privileges for admin-istering the PBS Works applications, for example adding PAS servers to CM. Press <ENTER>.

=========================================================================PBS Works Suite: Super User Configuration------------------------------------------Please provide the username for the PBS Works Suite Super User. This user will be the PBS WOrks portal Administrator and must exist on the authentication server.

You have chosen SSH based authentication.

Portal Administrator User Name: (Default: ):



Pre-installation SummaryA pre-installation summary will be displayed. Review all the installation specifications before ini-tiating the installation. If the specifications are incorrect, enter “back” to go back and make any necessary changes. If the installation specifications are correct, press <ENTER> to initiate instal-lation.

=========================================================================Pre- Installation Summary--------------------------Please Review the Following Before Continuing:

Install Folder:/opt/altair/pbsworks/13.0_Linux_x86_64_YYYYMMDD_MSS

Product Name:PBS Works Suite 13.0

Installation Host:hwesuse113-01

Applications/Service selected for installation:Applications

Database Host:localhost

Database Port:6767

DM Router Port:9500

Database Super User:pbsworksuser

Portal Admin User:root

Disk Space Information (for Installation Target):Required: 916.69 MegaBytesAvailable: 4,474.72 MegaBytes




Start ServicesOnce the installation is complete, the PBS Works service will be started.

If the DM agent was installed, then the DM Agent service will be started.

Installation completeOnce the installation is complete the installation details will be displayed. Press <ENTER> to complete the installation.

Restart Restarting the system is advised if the DM Agent is installed. Enter “1” and press <ENTER>.

=========================================================================PBS Works Suite Installation Complete--------------------------------------

Congratulations! PBS WOrks Suite has been successfully installed to:

Install Directory: /opt/altair/pbsworks/13.0Host: hwesuse113-01Port: 8086

To login, proceeed to

http://hwesuse113-01:8086/pbsworks/13

Press "Done" to quite the installer.

PRESS <ENTER> TO EXIT THE INSTALLER:

=========================================================================Restart Required!------------------

System needs to be restared for changes to take effect.Would you like to restart now?

->1- Yes 2- No

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:



Custom InstallationThe Custom installation option can be used when more flexibility is required than is supported by the Express installation option. For instance, you can choose what applications to install, where to install, type of authentication and authorization to use, and you can install the PBS Works applica-tion on a separate machine from PAS and PBS.

As of PBS Works 13.0, installing Display Manager requires that Compute Manager be installed as well.


RVS can also be installed using the Custom installation option. For more information see Install-ing RVS in GUI Mode or Installing RVS in Console Mode.

To install CM and/or DM download the installer appropriate for your platform from the user area.



IntroductionPlease read through the instructions before proceeding with the installation. To ensure a success-ful installation, please note the prerequisites for the installation. At anytime during the installation



process, you may enter back to go back to a previous installation step. To cancel the installation process, enter quit. To continue the installation process, press <ENTER>.

=========================================================================Introduction-------------

PBS Works Suite 13.0 installer will guide you through the installation.It is strongly recommended that you quit all programs before continuing with this installation.

Use the "Next" and "Previous" buttins to navigate between the installation steps.You may cance this installation at any time by clicking the "Cancel" button.

Pre-requisites for Installation:1. Minimum hard disk space of 4 GB2. Minimum RAM of 4 GB3. A non-admin User name and password to act as owner of PBS Works Database4. A User name and password of the user who would be acting as Portal Administrator. This user should be existing on the authentication server.5. An existing active directory user and password in case you choose Enterprise data-store to query user details for authorization.











Install OptionsTwo perform a custom installation which gives more flexibility when installing PBS Works appli-cations, select the Custom Install option by entering “2” and pressing <ENTER>.









Choose Applications to InstallChoose to install Applications by entering “1” and pressing <ENTER>.

Choose an application to install.

Enter “1” to install Compute Manager only.

Enter “2” to install both Compute Manager and Display Manager.

Press <ENTER>.

=========================================================================Altair Applications and Services---------------------------------

Please specify your installation options.->1- Applications 2- Service: Results Visualization Service

=========================================================================Applications-------------

Please select the applications you would like to install.

->1- Compute Manager 2- Display Manager (Computer Manager will be installed as a pre-requisite) ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:



Continue with InstallationIf you are installing DM onto a machine where PBS Professional and PBS Application Services are already installed, then the installer will perform some configuration of both in support of Display Manager. The configuration will require both PBS Professional and PBS Application Services to be restarted. Therefore, it is recommended to delay the installation until such a time when critical jobs are not running.

If a PBS MOM is detected, the installer will also install the Display Manager Agent.

If you would like to continue the installation, enter “1” and press <ENTER>. Otherwise to cancel the installation enter “2” and press <ENTER>.

=========================================================================Applications-------------

Please select the applications you would like to install.

->1- Compute Manager 2- Display Manager (Computer Manager will be installed as a pre-requisite) ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2

=========================================================================Action Required----------------

PBS and PAS server will be restarted during the isntallation. So it is advised that you run the installer when you are not running critical jobs. Would you like to proceed?

->1- Yes 2- No

ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS <ENTER> TO ACCEPT THE DEFAULT:



DatabaseA database instance is installed with PBS Works.

If you have already installed a PBS Works product and want to connect to its database, then choose the Existing Database option by entering “2” and pressing <ENTER>. Provide the hostname, port, and database administrator, and password to connect to the existing database. Press <ENTER>.

Otherwise, choose the New Database option by entering “1” and pressing <ENTER>. A non-administrative user is required to own the database as a administrator. You can provide this user’s credentials by entering “2” and entering the username and password, or you can let the installer create a database administrator by entering “1” and pressing <ENTER>.

Install New Database

=========================================================================Install New DB---------------

The Databse will be installed on the localhost (hwesuse113-01). To install a new database, the installer needs a non-admin OS user to own the database as a super user. Do you want the installer to create an OS user?

->1- Yes 2- No, I will provide the credentials of an existing user ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2

=========================================================================Existing OS user----------------

Please provide the user name of an exisitng non-admin OS user

User Name (Default: ): user1

=========================================================================Existing OS user----------------

Please provide the password of the exisitng non-admin OS user

Password:



Connect to Existing Database

=========================================================================Database Configuration----------------------The selcted options need access to the PBS Works Database.

Please choose to installa a new database or use an existing database.->1- New Database 2- Existing Database ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2 =========================================================================Existing DB information------------------------

Please provide the details to connect to the PBS Works Database

Provide Hostname/IP Address where PBS Works Database is installed (Default: ) : hwe-suse113-01

Provide the port at which the PBS Works Database is running (Default: ) : 6767

PBS Works Database Super User: (Default: ): user1

=========================================================================Existing DB information------------------------

Please provide the password of the existing PBS Works Database Super User

Password:



Access Management ServiceAMS provides a centralized configuration system for authentication and authorization.

If you have previously installed a PBS Works product and want to use the previously installed instance of AMS, choose the Use an Existing Instance option by entering “2”, and then enter the hostname and port where AMS is installed.

Otherwise, choose the Install Access Management Service option by entering “1” to install a new instance of AMS. Press <ENTER>.

=========================================================================Access Management Service Configuration----------------------------------------

Please choose to install Access Management Service or use an existing instance of the service.

->1- Install Access Management Service 2- Use and Existing Instance ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2-

=========================================================================Applications: Access Management Service Configuration------------------------------------------------------

Please privde the details to connect to Access Management Service

Hostname or IP Address (Default: ):

Access Management Service Port (Default: ):



Installation LocationSpecify a location where the selected applications will be installed. These components can be installed to the default location, or another location locally. Once an installation location is entered, press <ENTER>.

License ServerIt is not mandatory to provide the license server at installation time. You will however be required to configure the license server information prior to starting Compute Manager or Display Man-ager (see “Configuring the License Server” in the PBS Works Administrator’s Guide).

Press <ENTER>.

===========================================================================Installation Folder:--------------------

Please choose a destination folder for this installation.

Where youw you like to install?

Default Install Folder: /opt/altair/pbsworks/13.0

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE Default

===========================================================================License Server Configuration-----------------------------

"Applications" require access to the Altair License Server to function. Please provide the license server location.





AuthenticationDuring installation, PBS Works can be configured to use either Windows based or SSH based authentication, or it can be configured to authenticate against the AMS datastore.

If SSH is chosen, then a SSH server hostname/IP address is required. The default is localhost, however you may connect to any Linux server for authentication.

If you have chosen to authenticate against the AMS datastore, then the datastore must be popu-lated prior to users logging into the CM and DM web applications.

Choose the appropriate authentication protocol and press <ENTER>.

=========================================================================Access Management Service: Authentication Module--------------------------------------------------

Access Management Service provides Authenitation and Authorization services for all Altair Products. It also helps create policies that define access permissions to all the product features and services.The next set of screens will guide you through the installation of Access Management Service.Please specify the module to be used for authentication.

->1- SSH 2- Access Management Service ENTER THE NUMBER OF YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 1

=========================================================================Access Manager: SSH Server Hostname/IP Address----------------------------------------------- Access Manager is a service to create policies that define access permissions to product features and servers. It also provide Authentication and Authorization ser-vices for all Altair products.

The next set of screens will guide you through the installation of Access Manager. On Linux, SSH based authentication is supported. Please provide SSH Server.

Hostname or IP Address (Default: localhost) :



AuthorizationAuthorization is performed against the AMS datastore. The AMS datastore can be populated with users and groups via a connection to a Windows Active Directory, or any LDAP compatible server. Or it can be populated by using the AMS console to add users, groups, and authorization policies

If you choose to use an LDAP/AD for authorization, then you will be prompted to enter the infor-mation necessary to connect to the LDAP/AD. Choose the appropriate authorization mechanism, enter any necessary information, and press <ENTER>.

GPU Configuration for the PBS Server - DM onlyIf DM is being installed, and a PBS Professional Server is detected by the installer on the machine where DM is being installed, it will ask the user for the number of GPUs available in the cluster. This information will be used to configure the PBS Professional Server Enter the number of avail-able GPUs and press <ENTER>.

=========================================================================Access Manager: Authorization Module-----------------------------------------------

You can manage your users and groups using either of the following:

1. Windows Active Directory Server or any LDAP compatible server.

2. Altair's Access Management Service

1- Active Director (LDAP)->2- Access manager Service


=========================================================================Display Manger: GPU Configuration for Server-----------------------------------------------

Provide the maximum number of GPUs available for the server

Available GPUs on the Cluster: (Default: 1):



GPU Configuration for the PBS MOM - DM onlyIf DM is being installed, and a PBS MOM is detected by the installer on the machine where DM is being installed, it will ask the user for the number of GPUs available on the execution node. This information will be used to configure the PBS MOM. Enter the available GPUs and press <ENTER>.

PBS Works SuperuserEnter a user id that will be the PBS Works portal administrator. This user must be a pre-existing user on the machine where PBS Work is being installed. This user will have privileges for admin-istering the PBS Works applications, for example adding PAS servers to CM. Press <ENTER>.

=========================================================================Display Manger: GPU Configuration for Node-----------------------------------------------

Provide the maximum number of GPUs available on this node

Available GPUs on the node: (Default: 1):

=========================================================================PBS Works Suite: Super User Configuration------------------------------------------

Please provide the username for the PBS Works Suite Super User. This user will be the PBS Works portal Adminsitrator and must exist on the authentication server

You have chosen SSH based authentication.

Portal Administrator User Name: (Default: ):



Pre-installation SummaryA pre-installation summary will be displayed. Review all the installation specifications before ini-tiating the installation. If the specifications are incorrect, enter “back” to go back and make any necessary changes. If the installation specifications are correct, press <ENTER> to initiate instal-lation.

=========================================================================Pre-Installation Summary-------------------------Please Review the Following Before Continuing:

Install Folder:/opt/altair/pbsworks/13.0



Applications/Service selected for installation:Applications

Application Server Port:8086

Database Host:Localhost

Database Port:9500


Portal Admin User:root

Disk Space Information (for Installation Target):Required: 916.69 MegaBytesAvailable: 4,474.72 MegaBytes




Start ServicesOnce the installation is complete, the PBS Works service will be started.

If the DM agent was installed, then the DM Agent service will be started.

Installation CompleteOnce the installation is complete the installation details will be displayed. Press <ENTER> to complete the installation.

Restart Restarting the system is advised if the DM Agent is installed. Enter “1” and press <ENTER>.




To login, proceeed to

http://hwesuse113-01:8086/pbsworks/13

Press "Done" to quite the installer.


=========================================================================Restart Required!------------------

System needs to be restared for changes to take effect.Would you like to restart now?

->1- Yes 2- No



6. Installing RVS in GUI Mode

IntroductionResults Visualization (RVS) is a service, available through a plug-in, which provides necessary fea-tures to access, process and visualize CAE results through an easy and intuitive graphical user interface, embedded directly into the web browser. In the current release, these features are acces-sible through the Compute Manager web interface. The Results Visualization Service must be installed to use the plug-in with Compute Manager.


Compute Manager should be installed and its service should be up and running prior to installing RVS.

To install RVS download the installer appropriate for your platform from the user area.





RVS should be installed with its own database. Do not connect to an existing PBS Works database.

91


Installing RVS on same machine as CMIf RVS is being installed on the same machine as CM, and CM has already been installed, then the following screen will be displayed:

Choose the Install a New Instance option. When prompted for an installation location for RVS do not select the default location. Installing into the default location will overwrite the instance of CM that has already been installed. Instead, install RVS into a separate location than CM.

Click OK.

92 Installing RVS in GUI Mode



Installing RVS in GUI Mode 93








Installation TypeTo perform a custom installation which gives more flexibility when installing PBS Works applica-tions, select the Custom Install option. Click Next.



Choose Applications to InstallChoose to install the Results Visualization Service. Click Next.



Database ConfigurationChoose the New Database option to create a new instance of a database for RVS. A non-adminis-trative user is required to own the database as a administrator. You can provide this user’s creden-tials, or you can let the installer create a database administrator. Do not connect to an existing database.



Installation FolderSpecify a location where RVS will be installed. If you are installing RVS on a separate machine from CM, then you may use the default location. Otherwise, if you are installing RVS on the same machine as CM, do not install RVS to the same location as CM. Installing RVS to the same loca-tion as CM overwrites the previous installation. The default location in Windows is: C:\altair\pbsworks\13.0 and in Linux is: /opt/altair/pbsworks/13.0



License Server ConfigurationIt is not mandatory to provide the license server at installation time. You will however be required to configure the license server information prior to starting Compute Manager or Display Man-ager (see “Configuring the License Server” in the PBS Works Administrator’s Guide).



Hyperworks Installation LocationSpecify the installation location of HyperWorks. To select a directory click Choose. To restore the default directory, click Restore Default Folder.



PBS Application Service ServerEnter the hostname/IP address and port of the PAS server.



Pre-Installation SummaryA pre-installation summary will be displayed. Review all the installation specifications before ini-tiating the installation. If the specifications are incorrect, click Previous to go back and make any necessary changes. If the installation specifications are correct, click Install to initiate installation.





Start ServicesOnce the installation is complete, the PBS Works Results Visualization Service will be started. The following message will be displayed.








7. Installing RVS in Console Mode

IntroductionResults Visualization (RVS) is a service, available through a plug-in, which provides necessary fea-tures to access, process and visualize CAE results through an easy and intuitive graphical user interface, embedded directly into the web browser. In the current release, these features are acces-sible through the Compute Manager web interface. The Results Visualization Service must be installed to use the plug-in with Compute Manager.

Please note - RVS should be installed with its own database. Do not connect to an existing PBS Works database.


Compute Manager should be installed and it’s service should be up and running prior to installing RVS.

To install RVS download the installer appropriate for your platform from the user area.



107


Installing RVS on same machine as CMIf RVS is being installed on the same machine as CM, and CM has already been installed, then the following screen will be displayed:

Choose the Install a New Instance option by entering “1” and pressing <ENTER>. When prompted for an installation location for RVS do not select the default location. Installing into the default location will overwrite the instance of CM that has already been installed. Instead, install RVS into a separate location than CM.

Launching installer...

==================================================================================Manage Instances-----------------

->1- Installa a new instance 2- Modify an existing instance Choose Instance Management Option:

108 Installing RVS in Console Mode


IntroductionPlease read through the instructions before proceeding with the installation. To ensure a success-ful installation, please note the prerequisites for the installation. At anytime during the installation process, you may enter back to go back to a previous installation step. To cancel the installation process, enter quit. To continue the installation process, press <ENTER>.

=========================================================================Introduction-------------

PBS Works Suite 13.0 installer will guide you through the installation.It is strongly recommended that you quit all programs before continuing with this installation.

Use the "Next" and "Previous" buttins to navigate between the installation steps.You may cance this installation at any time by clicking the "Cancel" button.

Pre-requisites for Installation:1. Minimum hard disk space of 4 GB2. Minimum RAM of 4 GB3. A non-admin User name and password to act as owner of PBS Works Database4. A User name and password of the user who would be acting as Portal Administrator. This user should be existing on the authentication server.5. An existing active directory user and password in case you choose Enterprise data-store to query user details for authorization.


Installing RVS in Console Mode 109









Install OptionsTo install RVS select the Custom Install option by entering “2” and pressing <ENTER>.

Choose Applications to InstallTo install RVS select the Results Visualization Service option by entering “2” and pressing <ENTER>.







=========================================================================Altair Applications and Services---------------------------------

Please specify your installation options.->1- Applications 2- Service: Results Visualization Service ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2



DatabaseChoose the New Database option to create a new instance of a database for RVS. A non-adminis-trative user is required to own the database as a administrator. You can provide this user’s creden-tials, or you can let the installer create a database administrator. Do not connect to an existing database. Press <ENTER>.

=========================================================================Install New DB---------------

The Databse will be installed on the localhost (hwesuse113-01). To install a new database, the installer needs a non-admin OS user to own the database as a super user. Do you want the installer to create an OS user?

->1- Yes 2- No, I will provide the credentials of an existing user ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2

=========================================================================Existing OS user----------------

Please provide the user name of an exisitng non-admin OS user

User Name (Default: ): user1

=========================================================================Existing OS user----------------

Please provide the password of the exisitng non-admin OS user

Password:



Installation Location Specify a location where RVS will be installed. If you are installing RVS on a separate machine from CM, then you may use the default location. Otherwise, if you are installing RVS on the same machine as CM, do not install RVS to the same location as CM. Installing RVS to the same loca-tion as CM overwrites the previous installation. Once an installation location is entered, press <ENTER>.

License ServerIt is not mandatory to provide the license server at installation time. You will however be required to configure the license server information prior to starting RVS (see “Configuring the License Server” in the PBS Works Administrator’s Guide).

Press <ENTER>.

=========================================================================Installation Folder--------------------

Please choose a destination folder for this installation.

Where would you like to install?

Default Install Folder: /opt/altair/pbswors/13.0

ENTER AND ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE Default

===========================================================================License Server Configuration-----------------------------

"Applications" require access to the Altair License Server to function. Please pro-vide the license server location.





Hyperworks Installation LocationSpecify the installation location of HyperWorks. Once an installation location is entered, press <ENTER>.

PBS Application Services ServerEnter the hostname/IP address and port of the PAS server. Press <ENTER>.

===========================================================================HyperWorks Installation Folder------------------------------

Please provide the location of the HyperWorks Installation.

HyperWorks Installation Folder: (Default: ):

===========================================================================Results Visualization Service: PAS Server Information------------------------------------------------------

Please privide the Hostname or IP Address of PBS Application Server (PAS).

Hostname or IP Address: (Default: localhost) :

Port Number: (Default: 17084) :



Pre-installation SummaryA pre-installation summary will be displayed. Review all the installation specifications before ini-tiating the installation. If the specifications are incorrect, click back to go back and make any nec-essary changes. If the installation specifications are correct, press <ENTER> to initiate installation.

===========================================================================Pre-Installation Summary-------------------------

Please Review the Following Before Continuing:

Install Folder:/opt/altair/pbsworks/13.0



Applications/Service selected for installation:Results Visualization Service

Application Server Port:8086

Database Port:6767


Portal Admin User

Disk Space Information (for Installation Target) :Required: 620.16 MegaBytesAvailable: 3,168.26 MegaBytes




Start ServicesOnce the installation is complete, the PBS Works Results Visualization service will be started.

Installation CompleteOnce the installation is complete the installation details will be displayed. Press <ENTER> to complete the installation.






8. Post-Installation

Once installation is complete and a valid license server (see the PBS Works Administrator’s Guide “Configuring the License Server” if a license server was not supplied during installation) is known to CM, DM, and RVS, the web applications are available for use. Use any of the supported brows-ers (see Supported Browsers) to login through the URL http://<hostname>:<port>/pbsworks.

AMS PasswordOnce PBS Works is installed, it is recommended to change the AMS administrator to a secure site-specific one. The AMS administrator defaults to “amadmin” with a password of “adminadmin”. See “Changing the AMS Administrator Password” in the PBS Works Administrator’s Guide for information about changing the AMS administrator password.

Access Management ServiceIf you have chosen to use the AMS datastore for authentication, and a connection to an LDAP/AD was not specified during installation, then the AMS console must be used to add users to the data-store prior to users logging into the CM and DM web applications.

For more information about using AMS to manage users and groups see “Authentication and Authorization” in the PBS Works Administrator’s Guide, which can be downloaded from PBS Works documentation user area.

Migrating AMS from previous versions of CMTo migrate the AMS datastore from your previous version of CM to 13.0 you will need to merge the previous version of the AMS datastore files with the 13.0 versions. The previous version of the AMS datastore files should have been saved prior to installing PBS Works 13.0.

The files that will need to be merged are those that were saved prior to installing PBS Works 13.0 and the following files:

<INSTALL_DIR>/config/AAServiceHome/applications/cm/cmPolicy.xml

<INSTALL_DIR>/config/AAServiceHome/resources/AA_Users.xml

<INSTALL_DIR>/config/AAServiceHome/resources/AA_Groups.xml

117


where <INSTALL_DIR> is the directory where PBS Works 13.0 was installed. For a typical instal-lation of PBS Works 13.0 the installation directory defaults to :

on Windows: C:\altair\pbsworks\13.0.0

on Unix/Linux: /opt/altair/pbsworks/13.0.0

The xmllint command line XML tool may have to be used to reformat the XML files in a more readable format. Use the command:

xmllint --format <file_name> > temp_file

After installing PBS Works 13.0, follow these instructions for merging the files:

13.0 version of AA_Users.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<users>

<user userName="amadmin">

<password>Z7MtGmUa09iT4+nM1feC0qcbPJhZCfNv6KXiuSa790M=</password>

</user>

<user userName="<portal_admin>"

<password>9z1WNgdMqjh42kPr7gGhbbKKlzVOWfeeVvQX00fRVc0=</password>

</user>

</users>

Copy all <user></user> xml tags from the previous version of AA_Users.xml to the 13.0 version of AA_Users.xml(except amadmin), and do not overwrite the amadmin and <portal_admin> refer-ences in the 13.0 version (see above). The <portal_admin> will be the userid chosen as the PBS Works portal administrator during installation.

13.0 version of AA_Groups.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<groups>

<group name="altairadmin" privilegeType="TRUE">

<user>root</user>

</group>

</groups>

118 Post-Installation


Copy all <group></group> xml tags from the previous version of AA_Groups.xml to the 13.0 ver-sion of AA_Groups.xml, but do not overwrite the altairadmin reference in the 13.0 version (see above).

As the PBS Works portal administrator, log into Compute Manager and add all previous PBS Pro-fessional servers. It is VERY important to add a server with the same CM server name that was used for the previous CM release. You can determine those names by viewing the previous version of the cmPolicy.xml file, and searching for the string ‘Resource name="CM/Server'. You will see something similar to:

<Resource name="CM/Server">

<Resource name="CM/Server/hwe1">

<Resource name="CM/Server">

<Resource name="CM/Server/hwe2">

where “hwe1” and “hwe2” are the CM server names.

Once all servers have been added, copy the previous version of the cmPolicy.xml file to the loca-tion of the 13.0 version.

Restart the PBS Works service.

Display ManagerIf you are installing DM on a separate machine from PAS, then you will need to use the DM installer to configure PAS and the PBS Professional Server, as well as install the DM agent. Instructions for this installation can be found in the Display Manager Administrator’s Guide.

In addition, further DM configuration must be performed on the execution hosts to configure the custom resource “ngpus”. For information on the post installation steps related to Display Man-ager, refer to the “Post Installation Administration” section of the Display Manager Administrator’s Guide.

For DM clients, the Java plug-in must be installed and enabled to view interactive content.

Compute ManagerFor information about mandatory post installation steps related to Compute Manager, refer to the Compute Manager Administrator’s Guide.

Post-Installation 119


Results Visualization ServiceFor information on the post installation steps related to Results Visualization Service, refer to the Results Visualization Service Administrator’s Guide.

120 Post-Installation

9. Starting, Stopping and Restarting

PBS Works Portal

Determine the PBS Works Portal Status---------------------------------------------------------------------------------------

zeethon:/etc/init.d # /etc/init.d/pbsworks status

PBS Works 13.0 (pid 18908) is running

You can access the portal using link http://zeethon.pbsworks.com:8086/pbsworks

---------------------------------------------------------------------------------------

Starting the PBS Works PortalOn Windows:

1. Click Start, choose Run and type services.msc to open the Services Management Con-sole.

2. Select the PBSWorks Service in the list of services. Click the Start link to start the service.

121


On Linux:zeethon:/etc/init.d # /etc/init.d/pbsworks start

Stopping the PBS Works PortalOn Windows:

From the services console select the PBSWorks Service and click the Stop link.

On Linux:zeethon:/etc/init.d # /etc/init.d/pbsworks stop

Restarting the PBS Works PortalOn Windows:

From the services console select the PBSWorks Service and click the Restart link.

On Linux:

From the terminal window with root privilege, type the following command to restart the service:

zeethon: /etc/init.d # /etc/init.d/pbsworks restart

122 Starting, Stopping and Restarting


RVS ServiceAdministrator privileges are required to start, stop and restart RVS.

Starting RVSAt the Windows command line enter:<Install Folder>/scripts/RVservice.bat start

At the Linux command prompt enter:./etc/init.d/rvs start

Determine the Status of RVSAt the Windows command line enter<Install Folder>/scripts/RVservice.bat status

At the Linux command prompt enter:./etc/init.d/rvs status

Stopping RVSAt the Windows command line enter<Install Folder>/scripts/RVservice.bat stop

At the Linux command prompt enter:./etc/init.d/rvservices stop

Restarting RVSAt the Windows command line enter<Install Folder>/scripts/RVservice.bat restart

At the Linux command prompt enter:/etc/init.d/rvs restart

To start and stop RVS from the service management console in Windows, use Results Visualization Service. On Linux, use the rvs service.

Starting, Stopping and Restarting 123


124 Starting, Stopping and Restarting

10. Uninstall in GUI Mode

Prior to uninstalling, stop the PBS Works service (see Stopping the PBS Works Portal).

Starting the UninstallerPlease note - If you have installed RVS on the same machine as CM, then two separate uninstall processes will have to be performed to remove CM/DM and RVS. Follow the instructions as docu-mented below for uninstalling CM/DM. To uninstall RVS, you will have to navigate to the direc-tory where RVS has been installed to perform the uninstall of RVS (follow the same set of instructions for uninstalling, but just execute the uninstall script that is located in the RVS installa-tion directory).

LinuxNavigate to the PBS Works installation directory. The installation directory for a typical installa-tion of PBS Works is

/opt/altair/pbsworks/13.0

Enter the following at the Linux/Unix command line prompt (command must contain spaces with escape characters):

cd _PBS\ Works\ Suite_installation

Execute the uninstall script by entering the following command at the Linux/Unix command line prompt (command must contain spaces with escape characters)

./Change\ PBS\ Works\ Suite\ Installation -i swing

WindowsIn Windows, navigate to the _PBS Works Suite_ installation folder in the location where PBS Works is installed. Right click on the Change PBS Works Suite Installation executable and select

125


the Run as administrator option from the context menu as shown below.

The steps from this point onwards to uninstall Display Manager is identical on Windows and Linux platform. In this section, the example screenshots are based on the Linux version.

126 Uninstall in GUI Mode


The Installer launches in Maintenance Mode. Select Uninstall Product and click on the Next but-ton.

Uninstall in GUI Mode 127


In the next screen, click on the Uninstall button.

Confirm your choice in the alert box.



The uninstall process will begin and the progress will be shown:

Uninstall in GUI Mode 129


A confirmation message will be displayed. Click on Done to exit the installer.


11. Uninstall in Console Mode

Prior to uninstalling, stop the PBS Works service (see Stopping the PBS Works Portal).

Starting the UninstallerPlease note - If you have installed RVS on the same machine as CM, then two separate uninstall processes will have to be performed to remove CM/DM and RVS. Follow the instructions as doc-umented below for uninstalling CM/DM. To uninstall RVS, you will have to navigate to the direc-tory where RVS has been installed to perform the uninstall of RVS (follow the same set of instructions for uninstalling, but just execute the uninstall script that is located in the RVS installa-tion directory).

Navigate to the PBS Works installation directory. The installation directory for a typical installa-tion of PBS Works is

/opt/altair/pbsworks/13.0

Enter the following at the Linux/Unix command line prompt (command must contain spaces with escape characters):

cd _PBS\ Works\ Suite_installation

Execute the uninstall script by entering the following command at the Linux/Unix command line prompt (command must contain spaces with escape characters)

./Change\ PBS\ Works\ Suite\ Installation -i console

131


Starting the Uninstallation ProcessThe console uninstaller will launch. Press <ENTER> to continue with the uninstall.

Proceed with Uninstall If you would like to continue the uninstall, enter “1” and press <ENTER>. Otherwise to cancel the uninstall enter “2” and press <ENTER>.

==============================================================================PBS Works Suite (created with InstallAnywhere)------------------------------------------------------------------------------

Preparing CONSOLE Mode Uninstallation...

==============================================================================Uninstall PBS Works Suite--------------------------

About to uninstall...

PBS Works Suite

This will remove features installed by PBS Works Suite Installer. It will notremove files and folders created after the installation.


==============================================================================Uninstall PBS Works Suite--------------------------

Do you really want to proceed with the uninstallation of PBS Works Suite?

Select "OK" to ProceedSelect "Cancel" to Exit

->1- OK 2- Cancel


132 Uninstall in Console Mode


Completing the Uninstallation ProcessOnce the uninstall is complete, a message is displayed. Any items that could not be removed will be listed. Please take a moment to manually remove them.

==============================================================================Uninstalling...---------------

...*****************************************************************************************************

============================================================================ Uninstall Complete ------------------

Some items could not be removed.

Uninstall in Console Mode 133


134 Uninstall in Console Mode

Documents

PBS Works 1 ,QVWDOODWLRQ Guide - Altairresources.altair.com/pbs/documentation/support/PBS Works 13.0... · PBS Works 13.0 Installation Guide iv Technical Support This document is