Upload
others
View
4
Download
0
Embed Size (px)
Citation preview
PBS Works is a division of
PBS Application Services 12.1
Administrator’s Guide
PBS Application Services 12.1 Administrator’s Guide
Updated: August 21, 2014.
Copyright notice does not imply publication.
Altair® PBS Works™ Version 12.1
Enabling On-Demand Computing™
Copyright© 1994-2014 Altair Engineering Inc. All Rights Reserved.
Listed below are PBS Works™ applications.
Copyright© Altair Engineering Inc. All Rights Reserved for:
Compute Manager™ 2007-2014; Display Manager™ 2007-2014; PBS™ 1994-2014; PBS Professional® 1994-2014; PBS Application Services™ 2008-2014; PBS Analytics™ 2007-2014; and PBS Desktop™ 2007-2012
In addition to the PBS Works™ trademarks noted above, Simulation Manager™ 2007-2014, PBS Portal™ 2007-2011, e-BioChem ™ 2007-2013, e-Compute™ 2000-2007, e-Render™ 2006-2010, OpenPBS® 1994-2003, Personal PBS® 2007-2012, HyperMesh® 1990-2014, HyperCrash® 2001-2014, OptiStruct® 1996-2014, RADIOSS®1986-2014, HyperView® 1999-2014, HyperView Player® 2001-2014, HyperStudy® 1999-2014, HyperGraph® 1995-2014, MotionView® 1993-2014, MotionSolve® 2002-2014, HyperForm® 1998-2014, HyperXtrude® 1999- 2014, Process Manager™ 2003-2014, Templex™ 1990-2014, Text-View™ 1996-2014, MediaView™ 1999-2014, TableView™ 2013-2014, BatchMesher™ 2003-2014, HyperMath® 2007-2014, HyperWeld® 2009-2014, HyperMold® 2009-2014, Manufacturing Solutions™ 2005-2014, solidThinking® 1993-2014, solidThinking Inspire® 2009-2014, solidThinking Evolve® 1993-2014, Durability Director™ 2009-2014, Suspen-sion Director™ 2009-2014, AcuSolve® 1997-2014, AcuConsole® 2006-2014, SimLab® 2004-2014, and Virtual Wind Tunnel™ 2012-2014 ™ are trademarks of Altair Engineering, Inc.
Altair trademarks are protected under U.S. and international laws and treaties. Copyright© 1994-2014. Additionally, Altair software is protected under patent #6,859,792 and other pat-ents pending. All other marks are the property of their respective owners. ALTAIR ENGI-NEERING INC. Proprietary and Confidential. Contains Trade Secret Information. Not for use or disclosure outside of ALTAIR and its licensed clients. Information contained in Hyper-Works® shall not be decompiled, disassembled, or “unlocked”, reverse translated, reverse 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.
Third Party Agreements
Chapter 1
Technical Support
This document is proprietary information of Altair Engineering, Inc.
Location Telephone e-mail
North America +1 248 614 2425 [email protected]
China +86 (0)21 6117 1666 [email protected]
France +33 (0)1 4133 0992 [email protected]
Germany +49 (0)7031 6208 22 [email protected]
India +91 80 66 29 4500 [email protected]
Italy +39 800 905595 [email protected]
Japan +81 3 5396 2881 [email protected]
Korea +82 70 4050 9200 [email protected]
Scandinavia +46 (0) 46 460 2828 [email protected]
UK +44 (0)1926 468 600 [email protected]
PBS Application Services Administrator’s Guide iii
Chapter 1
iv PBS Application Services Administrator’s Guide
Table of Contents
1 PBS Application Services 11.1 Integration Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.2 Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.1 Supported Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.3 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.1 Minimum Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.3.2 Minimum Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3.3 Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3.4 Assumptions, Constraints, and Dependencies . . . . . . . . . . . . . . . . . . . . . . . 5
1.4 Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.5 Software Organization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.5.1 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.5.2 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2 Pre-installation Planning 152.1 Upgrading from a previous release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.2 PBS Application Services default port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.3 PBS Application Services staging directory . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.4 Access Management Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.5 SSL Communication with a Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3 Installing PAS GUI mode 193.1 Installing PBS Application Services and PAS Commands . . . . . . . . . . . . . . . . 19
3.1.1 Starting the installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.2 PBS Application Services installation instructions . . . . . . . . . . . . . . . . . . 213.1.3 License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223.1.4 Install options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.1.5 PAS service user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.1.6 PAS service user password - Windows only . . . . . . . . . . . . . . . . . . . . . . . 253.1.7 Staging directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
PBS Application Services Administrator’s Guide v
Table of Contents
3.1.8 License server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.9 Installation location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.1.10 Pre-installation summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303.1.11 Installation progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.1.12 Start PAS services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.1.13 PAS client validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.1.14 Installation complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.1.15 Post-installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.2 Installing PAS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.2.1 Starting the installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.2.2 PAS Commands installation instructions . . . . . . . . . . . . . . . . . . . . . . . . . . 363.2.3 License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373.2.4 Install options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383.2.5 PAS server hostname/IP address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.2.6 Installation location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.2.7 Pre-installation summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.2.8 Installation progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423.2.9 Installation complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433.2.10 Post-installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
4 Installing PAS console mode 454.1 Installing console mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.1.1 Installing PBS Application Services and PAS Commands . . . . . . . . . . . . 454.1.2 Installing PAS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
5 Post-installation 595.1 Features and configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
5.1.1 Application definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595.1.2 Site configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605.1.3 Server configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605.1.4 PAS configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.2 Installing PAS for the first time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.2.1 Configure PAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.2.2 Restart PAS service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
5.3 Upgrading from a previous release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.3.1 Migrate application definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.3.2 Migrate site configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.3.3 Migrate server configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
vi PBS Application Services Administrator’s Guide
Table of Contents
5.3.4 Restart the PAS server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635.4 Updating search path for PAS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635.5 Enabling job history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635.6 Setting environment variable PAS_CONF_FILE . . . . . . . . . . . . . . . . . . . . . . . 635.7 Configuring SSL for communication with PAS Commands . . . . . . . . . . . . . . 645.8 Verifying installation of PAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6 Configuring PBS Application Services 676.1 Configurable parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
6.1.1 Standard configuration parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686.1.2 Advanced Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
6.2 Configuring PAS logging behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746.2.1 Remote file operations, job submission, and job status . . . . . . . . . . . . . . . 756.2.2 File upload/download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766.2.3 File operations (local and remote) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766.2.4 Job submission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766.2.5 Job submission and status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776.2.6 License checkout by PAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776.2.7 Applications (application definitions) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776.2.8 Dynamic Application Refresh Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776.2.9 Metascheduling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
6.3 Changing the Linux SSH Server or Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796.4 Configuring JVM Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7 Log files 817.1 PAS log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817.2 Other log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
8 PAS service commands 838.1 Starting the PAS service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
8.1.1 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838.1.2 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
8.2 Stopping the PAS service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848.2.1 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848.2.2 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
8.3 Restarting the PAS service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858.3.1 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858.3.2 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
8.4 Determining the status of the PAS service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868.4.1 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868.4.2 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
PBS Application Services Administrator’s Guide vii
Table of Contents
9 Application Definitions 879.1 Overview of Application Definition Components . . . . . . . . . . . . . . . . . . . . . . 87
9.1.1 Application input file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.1.2 Application converter file (HPCBP converter) . . . . . . . . . . . . . . . . . . . . . 889.1.3 Application runtime scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.1.4 Site configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
9.2 Sample application definition PBSJobApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899.3 Administration of Application Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.3.1 Adding a new application definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909.3.2 Application definition validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909.3.3 Maintenance of existing application definitions. . . . . . . . . . . . . . . . . . . . . 90
9.4 Sitewide Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 919.4.1 Site configuration file content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929.4.2 Using site configuration information in an application definition . . . . . . . 959.4.3 Site configuration file backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959.4.4 Site configuration file validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
10 Reserved words 97
11 Uninstalling PAS GUI mode 9911.1 Starting the uninstaller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
11.1.1 Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9911.1.2 Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
11.2 Initiate the PAS uninstall process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10011.3 Uninstall PBS Application Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10111.4 Complete uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
12 Uninstalling PAS console mode 10312.1 Starting the uninstaller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10312.2 Initiate the PAS uninstall process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10412.3 Complete uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
viii PBS Application Services Administrator’s Guide
Chapter 1
13 Troubleshooting 10513.1 The package doesn’t match the OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10513.2 PBS Professional Server is not installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10513.3 Incompatible version of PBS Professional detected . . . . . . . . . . . . . . . . . . . . 10613.4 Staging Directory is blank. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10713.5 Could not detect “userid” (Linux/Unix) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10713.6 Could not connect Windows AD/DNS Server (Windows) . . . . . . . . . . . . . . . 10713.7 Specified service user name does not exist (Windows) . . . . . . . . . . . . . . . . . 10813.8 Password is required to continue (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . 10813.9 PBS Professional installation appears to be incomplete . . . . . . . . . . . . . . . . . 10813.10 EIFL server ports in the default range is not available . . . . . . . . . . . . . . . . . . 10813.11 PAS server port is not free for installing PAS service . . . . . . . . . . . . . . . . . . 10913.12 Specified port # is not a valid value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10913.13 The PAS server IP/port number is blank. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10913.14 PAS Service was unable to start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10913.15 PAS Service was unable to install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11013.16 Installer not running as root/admin user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11013.17 Existing instance of Python found (Windows) . . . . . . . . . . . . . . . . . . . . . . . . 11013.18 License server information not provided . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11013.19 Manage Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11113.20 Out of Memory Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11313.21 IOException: No such file or directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Index 115
PBS Application Services Administrator’s Guide ix
Chapter 1
x PBS Application Services Administrator’s Guide
Chapter 1
PBS Application ServicesToday, doing more with less is simply business as usual. Enterprises and institutions are plac-ing higher demands upon their high performance computing infrastructure – larger and more complex applications and dynamic end-user work loads. Optimizing end-user productivity and getting the most from limited resources and complex application work loads can seem to be an impossible challenge.
PBS Application Services (PAS) is a middleware component that communicates with the PBS Professional complex and the operating system, and provides services for the front end client applications such as graphical user interfaces. This middleware component is used as the pre-ferred method of communication between the integration of client applications and the PBS Professional complex. PBS Application Services allows users to quickly create application portals that boost productivity and accelerate innovation. Application administrators can use PBS Application Services to create custom, solver specific application definitions. Leverag-ing key industry standards like the Open Grid Forum High Performance Computing Basic Profile, PBS Application Services makes it easy to respond to dynamic changes to your users and applications.
Benefits of PBS Application Services:
• Stable WS-based application programming interface (API) for integration into bigger systems
• Streamlined APIs for integration of applications into PBS Professional for the indepen-dent software vendors
• Front end graphical user interface application building is made easier
• Independent software vendors and the community can define new application definitions and exchange them within the PBS Professional complex in a turn-key fashion
• Platform neutrality allowing PBS Application Services to run on Windows and Linux
PBS Application Services Administrator’s Guide 1
Chapter 1 PBS Application Services
platforms
• Customized application definition files can be shared across all supported platforms
• Transactional manner of operations (e.g. eliminates out of sync issues with resources not included in scheduling, etc.)
• Grid-friendly as it uses the same extensible markup language/web services (XML/WS) as large-scale grid solutions
• Easier integration into Enterprise SOA and business process management
• Standards-based implementation using Web Services, WS-Security, high performance computing basic profile (HPCBP)
PBS Application Services provides the following major groups of functionality:
• Installation and management of application definitions by administrators
• Site configuration such as billing accounts and MPROC by administrators
• User submission and management of PBS Professional jobs
• File operations services
1.1 Integration Architecture
Web Services (WS) are used as the underlying technology for communication between PBS Application Services and the front end client applications. The PBS Application Services component exposes all functionality supported by PBS Professional and is a neutral interface for the client applications to easily integrate with the PBS Professional complex.
PBS Application Services provides an integration layer built upon the service oriented archi-tecture (SOA) for easy integration of end user applications with the PBS Professional com-plex.
Client applications have access to PBS Application Services through the following ports:
Administration WS Port
• Administration of applications scheduled by PBS Professional
• Site configuration
• Application licensing management
2 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
Application Job WS Port
• Application job submission, monitoring, and management
• Authentication and identity management
• Data management and staging
• Custom actions
HPCBP Job WS Port
• HPCBP job submission, monitoring, and management
• Ability to check attributes of BES container
File Operations WS Port
• Basic file operations
• File operations for running jobs, and expand options for staging user files
Figure 1-1:High Level Overview of PBS Application Services
PBS Application Services Administrator’s Guide 3
Chapter 1 PBS Application Services
1.2 Supported Platforms
The PBS Application Services Server is supported on the following platforms:
• Novell SUSE Linux Enterprise Server (SLES) 10.X, and 11.X on x86_64
• Red Hat Enterprise Linux (RHEL) 5 and 6 (server and desktop) on x86_64
• Windows XP Professional on x86_64
• Windows Vista on x86_64
• Windows Server 2003 on x86_64
• Windows Server 2008 on x86_64
• Windows Server 2008 R2 on x86_64
• CentOS 5.4, 5.5, 5.6, and 6 on x86_64
1.2.1 Supported Configuration
The PBS Application Services server and the PBS Professional server are required to be installed on the same host for job submission and monitoring.
1.3 System Requirements
1.3.1 Minimum Hardware Requirements
Table 1-1: Minimum hardware rqmts
Hardware Requirement
CPU 1
Memory (Physical) 1 GB
Disk Space 2.8 GB
4 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
1.3.2 Minimum Software Requirements
To take advantage of the new scalable qstat feature of PBS that accommodates a request for multiple job identifiers, the Enterprise PBS Professional cluster must be upgraded to PBS Pro-fessional 12.1.1 or newer, though all versions of PBS Professional 11.1 or later are supported. For further information about the installation of PBS Professional, please refer to the PBS Professional Installation and Administrator’s Guide.
On Linux systems, the Open SSH daemon using the SSH2 protocol is required.
PBS Application Services also includes three third party software packages. PBS Application Services will install and configure these three packages during installation:
• JRE 1.7 (Java Runtime Environment)
• Apache Tomcat 7.0x
• Python 2.5.x
Please note - Python 2.5.x must be installed on every execution node, and so is included with the PBS Professional execution node installation option. See section section 6.1.2, “Advanced Configuration Parameters”, on page 72.
1.3.3 Security
• Supported authentication using NIS and UNIX/Linux password security infrastructure
• Supported Windows NT LAN Manager (NTLM) authentication
• Supported High Performance Computing Basic Profile/Basic Execution Services (HPCBP/BES)-compatible Web Services Interoperability (WS-I), Web Services Archi-tecture (WS-A), and WS-security message format
1.3.4 Assumptions, Constraints, and Dependencies
• The PBS Application Services server and the PBS Professional server are required to be installed on the same host for job submission and monitoring.
• PBS Professional infrastructure for file staging: cp or passwordless rcp or scp
• Windows users username and password exactly match those in the UNIX/Linux security setup
PBS Application Services Administrator’s Guide 5
Chapter 1 PBS Application Services
1.4 Workflow
PBS Application Services Workflow:
1. The administrator/user creates a new application definition using HPCBP and PBS Application Services guidelines, or modifies an existing application definition.
2. The administrator uses PBS Application Services WSi for installation of the applica-tion definition.
3. The end user, via a front-end graphical user interface, obtains a list of available appli-cations.
4. The end user selects the application and provides the required and optional parame-ters.
5. Input data from the user is transformed into a JSDL-HPCBP format job description using the application definition documents for the specified application.
6. The JSDL-HPCBP job is converted to PBS Professional submission syntax in the PBS specific port and submitted to PBS Professional.
7. PBS Professional executes and terminates the job in an application specific way.
6 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
1.5 Software Organization
After a successful installation of PBS Application Services, two main directory structures are created: the PBS Application Services home directory (PAS_HOME) and the execution directory (PAS_EXEC). The location of these directories is platform dependent.
1.5.1 Windows
For a typical Windows x86_64 installation, PBS Application Services is installed in the fol-lowing location:
C:\Program Files\altair\pas\12.1
Files and directories installed at this location are:
Table 1-2: Directories
DirectoryTypes of files and
directories located here
_PBS Application Services_installation PAS installer directory
bin PAS framework directory
jre PAS framework directory
PAS PAS home and execution directories
(denoted by PAS_HOME & PAS_EXEC)
thirdparty PAS framework directory
PBS Application Services Administrator’s Guide 7
Chapter 1 PBS Application Services
The PBS Application Services home directory (PAS_HOME) and the execution directory (PAS_EXEC) can be determined by viewing the PBS Application Services configuration file located in:
C:\Program Files\altair\pas\12.1\PAS\pas.conf
The contents of the configuration file for a typical installation are:
1.5.1.1 PBS Application Services Home Directory
The typical location of the PBS Application Services Home directory is:
C:\Program Files\altair\pas\12.1\PAS\home
Directories located in the PBS Application Services Home directory are:
PAS_HOME=C:\Program Files\altair\pas\12.1\PAS\home
PAS_EXEC=C:\Program Files\altair\pas\12.1\PAS\exec
PAS_SERVER=localhost
PAS_PORT=17084
PAS_SSL_ENABLED=true
PAS_SSL_PORT=17443
Table 1-3: Directories
Directory Description
conf PAS configuration files
config-private PAS configuration files used internally which are not avail-able for user modification
logs PAS log files
repository PAS specific files
applications Application definitions
includes Dynamic includes for the site configuration file.
invalid_applications PAS moves application definitions having invalid syntax to this location
pas-appmaker PAS Application Maker.
scripts Scripts for dynamic includes for site configuration file.
8 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
1.5.1.2 PBS Application Services Execution Directory
The typical location of the PBS Application Services Execution directory is:
C:\Program Files\altair\pas\12.1\PAS\exec
Directories located in the PBS Application Services Execution directory are:
schemas Schemas and WSDLs used by all PAS portals
temp Temporary files created by PAS during execution of web server operations
Table 1-4: Directories
Directory Description
bin PAS binaries
AA Authentication and authorization
pas-server War file and PAS deployment directories of Tomcat server
eifl Infrastructure libraries
Windows Windows specific binaries - eifl server, Pro-cessRunner, unzip, zip
init PAS init script
lib Python scripts for application licensing
python Python scripts
pas-commands PAS Commands
bin PAS Commands python scripts
profiles PBSJobApp profile
src Python script files
pbs_spawn PAS python scripts
python Python library
scripts PAS python scripts
Table 1-3: Directories
Directory Description
PBS Application Services Administrator’s Guide 9
Chapter 1 PBS Application Services
1.5.2 Linux
For a typical Linux/Unix installation, PBS Application Services is installed in the following location:
PBS Application Services home directory: /var/spool/pas
PBS Application Services execution directory: /opt/altair/pbsworks/12.1/pas
PBS Application Services configuration and services directory: /etc
The PBS Application Services home directory (PAS_HOME) and the execution directory (PAS_EXEC) can be determined by viewing the PBS Application Services configuration file located in:
/etc/pas.conf
The contents of the configuration file for a typical installation are:
shared Platform specific shared libraries
Windows Windows shared libraries
unsupported Unsupported
actions-unix PBS hooks
aif2pas Python script for aif to pas conversion
pbs-hooks Unix actions
samples PBSJobSampleClient
PAS_HOME=/var/spool/pas
PAS_EXEC=/opt/altair/pas/12.1/pas
PAS_SERVER=localhost
PAS_PORT=17084
PAS_SSL_ENABLED=true
PAS_SSL_PORT=17443
Table 1-4: Directories
Directory Description
10 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
1.5.2.1 PBS Application Services Home Directory
The typical location of the PBS Application Services Home directory is:
/var/spool/pas
Directories located in the PBS Application Services Home directory
Table 1-5: Directories
Directory Description
conf PAS configuration files
config-private PAS configuration files used internally which are not available for user modification
logs PAS log files
repository PAS specific files
applications Application definitions
includes Dynamic includes for the site configuration file.
invalid_applications PAS moves application definitions having invalid syntax to this location
pas-appmaker PAS Application Maker.
scripts Scripts for dynamic includes for site configu-ration file.
schemas Schemas and WSDLs used by all PAS portals
temp Temporary files created by PAS during execu-tion of web server operations
PBS Application Services Administrator’s Guide 11
Chapter 1 PBS Application Services
1.5.2.2 PBS Application Services Execution Directory
The typical location of the PBS Application Services Execution directory is:
/opt/altair/pbsworks/12.1/pas
Directories located in the PBS Application Services Execution directory
Table 1-6: Directories
Directory Description
_PBS Application Services_installation PAS installer directory
init_temp temporary files
jre Java Runtime Environment
pas PAS execution directory
bin PAS binaries
AA Authentication and authorization
pas-server War file and PAS deployment directories of Tomcat server
eifl Infrastructure libraries
Linux-i386 Platform specific binaries - eifl server, Pro-cessRunner, unzip, zip
Linux-x86_64 Platform specific binaries - eifl server, Pro-cessRunner, unzip, zip
Windows Platform specific binaries - eifl server, Pro-cessRunner, unzip, zip
init PAS init script
lib Python scripts for application licensing
python Python scripts
pas-commands PAS Commands
bin PAS Commands python scripts
profiles PBSJobApp profile
src Python script files
pbs_spawn PAS python scripts
12 PBS Application Services Administrator’s Guide
PBS Application Services Chapter 1
1.5.2.3 PBS Application Services Configuration and Services Directory:
Files and directories located in the PBS Application Services Configuration and Services Directory are:
python Python library files
scripts PAS python scripts
shared Platform specific shared libraries
Windows Platform specific shared libraries
Linux-i386 Platform specific shared libraries
Linux-x86_64 Platform specific shared libraries
unsupported Unsupported
actions-unix PBS hooks
aif2pas Python script for aif to pas conversion
pbs-hooks Unix actions
samples PBSJobSampleClient
thirdparty PAS framework directory
Table 1-7:
Directory/File Name Types of files located here
/etc/init.d/pas PAS server script - start, stop, restart PAS
/etc/pas.conf PAS configuration file
Table 1-6: Directories
Directory Description
PBS Application Services Administrator’s Guide 13
Chapter 1 PBS Application Services
14 PBS Application Services Administrator’s Guide
Chapter 2
Pre-installation Planning
2.1 Upgrading from a previous release
If you are upgrading from a previous release of PBS Application Services, you must first migrate your existing application definitions, site configuration file, and server configuration file:
1. Stop the PBS Application Services service (see Chapter 8, "PAS service commands", on page 83).
2. Make a backup of the following files:
Prior to PBS Application Services 12.0
• application definitions stored in the <PAS_HOME>/applications directory
• site-config.xml stored in the <PAS_HOME>/conf directory
• server.conf file stored in the <PAS_HOME>/conf directory
PBS Application Services 12.0 and later
• application definitions stored in the <PAS_HOME>/repository/applica-tions directory
• site-config.xml stored in the <PAS_HOME>/repository directory
• server.conf file stored in the <PAS_HOME>/conf directory
3. Remove any old instances of PBS Application Services (see Chapter 11, "Uninstall-ing PAS GUI mode", on page 99 or Chapter 12, "Uninstalling PAS console mode", on page 103).
PBS Application Services Administrator’s Guide 15
Chapter 2 Pre-installation Planning
2.2 PBS Application Services default port
As of release 11.1, the default port used to communicate with PBS Application Services is 17084.
As of the 12.0 release, the port will be selected dynamically during installation. If port 17084 is not available, then the installation process will increment the port number by one until an available port is found. If an available port is not found after 100 attempts, the installation process will request the administrator to enter a port.
2.3 PBS Application Services staging directory
During the installation of the PBS Applications Service server, you will be prompted to enter a value for the PBS Application Service staging directory. The staging directory is where the necessary files are transferred after job submission (via a client for example, PBS Portals or Compute Manager), but prior to the portal submitting the job to PBS Application Services for transfer to PBS Professional for execution. This staging directory must exist for the installa-tion to complete successfully.
The default location of the staging directory for a typical installation of PBS Application Ser-vices is:
on Linux: /stage
on Window: C:\stage
However, you have the option to choose a custom stage directory during installation.
Following are considerations for selecting and creating the staging directory:
• As of PBS Application Services 11.1, the staging directory can be set to point to the user's home directory by using the variable $USER_HOME (for example: $USER_HOME/stage). However, this functionality is NOT supported by any release of Compute Man-ager prior to CM release 12.0.
• The stage area can grow quite large, depending on the size of the average job. Give care-ful consideration to the disk usage and disk capacity.
• The pathname for the staging directory should not contain spaces.
• PBS Application Services implements an automatic staging directory cleanup such that any data in the staging directory that is not generated by PBS Application Services is at risk of being purged without notice. It is recommended to select a staging directory where only PBS Application Services data files will be stored. Use of a directory that contains important data is not recommended.
16 PBS Application Services Administrator’s Guide
Pre-installation Planning Chapter 2
2.4 Access Management Service
This release of PAS incorporates Access Management Service (AMS), a centralized configu-ration system for authentication and authorization. Other PBS Works products such as Com-pute Manager and Display Manager are using AMS for authentication and authorization. For this release of PAS, AMS has been implemented to standardize security mechanisms across PBS Works products, and to improve security. AMS will continue to use the security mechanisms described in section 1.3.3, “Security”, on page 5.
2.5 SSL Communication with a Client
A secure connection between PBS Application Services and a client, such as Compute Man-ager, is configured by default. This configuration is done through the server.xml file. The location of the file for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\exec\bin\pas-server\conf
on Linux: /opt/altair/pbsworks/12.1/pas/bin/pas-server/conf
<Connector executor="tomcatThreadPool" port="17443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
connectionTimeout="20000"
clientAuth="false" sslProtocol="TLS"
keystoreFile="conf/keystore"
keyAlias="aif-key" keystorePass="changeit"
/>
PBS Application Services Administrator’s Guide 17
Chapter 2 Pre-installation Planning
18 PBS Application Services Administrator’s Guide
Chapter 3
Installing PAS GUI modeAs of the PBS Application Services 11.1 release, two installation options are available. The first option will install both the PBS Application Service server and the PAS Commands. The second option will install the PAS Commands only. PAS Commands are command-line scripts that allow users to access the power of PBS Professional without the use of a graphical user interface, while leveraging the capabilities of PBS Application Services and application definitions. For more information on how to use the PAS Commands see the PBS Application Services Commands User Guide.
See Chapter 13, "Troubleshooting", on page 105 for information pertaining to problems, warnings, or error conditions experienced while installing PAS.
3.1 Installing PBS Application Services and PAS Commands
Installation of this product requires:
• System administrator privileges (root or Windows Administrator)
• Existing installation of PBS Professional 11.1 or newer
• Existing user account to register as the PBS Application Services Administrator account (default is pbsadmin)
• Removal of any old instances of PBS Application Services
• Removal of any instances of Python and Tomcat installed with previous versions of PBS Application Services
• PBS Application Services staging directory must exist prior to installation of this product
PBS Application Services Administrator’s Guide 19
Chapter 3 Installing PAS GUI mode
Please note - The first step in the installation process is the extraction of the installer to the %tmp% directory. There should be enough space in this directory to extract the installer (approximately 3 times the installation size). Also, while the installer is being extracted, noth-ing should be deleted from this directory.
To install PBS Application Services and PAS Commands, download the installer executable appropriate for your platform from the user area.
3.1.1 Starting the installer
Invoke the installer by running the installation binary on Linux/Unix platforms. For example:
./PBSAppSvcs_12.1_SLES-11_x86_64_20130521_1437.bin -i swing
Or by double-clicking the executable on Windows platforms:
PBSAppSvcs_12.1_Windows_x86_64_20130521_1437.exe
20 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.1.2 PBS Application Services installation instructions
Once the extraction process is complete, installation instructions will be displayed. Please read through the instructions before proceeding with the installation. At anytime during the installation process, you may click Previous to go back to a previous installation step. You may cancel the install at any time during the installation process by clicking Cancel. To con-tinue the installation process, click Next.
PBS Application Services Administrator’s Guide 21
Chapter 3 Installing PAS GUI mode
3.1.3 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, click I accept the terms of the License Agreement, and click Next.
22 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.1.4 Install options
Choose to install the PBS Application Services server and the PAS Commands by selecting PAS Server and Commands (clear the PAS Commands Only check box if necessary), and then click Next.
PBS Application Services Administrator’s Guide 23
Chapter 3 Installing PAS GUI mode
3.1.5 PAS service user
Enter the user with whom the PBS Application Services service will be registered. The default is "pbsadmin".
On Windows platforms, this should be the PBS Administrative account as specified during the installation of PBS Professional.
On Linux/Unix platforms, this must be an existing account and can be a non-privileged user account that has been granted manager status for PBS Professional.
Once you have entered the user, click Next..
24 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.1.6 PAS service user password - Windows only
If you are installing PAS on a Windows platform, enter the PAS service user password. Click Next.
PBS Application Services Administrator’s Guide 25
Chapter 3 Installing PAS GUI mode
3.1.7 Staging directory
Enter a staging directory where user's job files will be staged prior to execution. This direc-tory must exist prior to the installation of PBS Application Services. You may select a custom stage directory by clicking Choose (please see the staging directory considerations below before choosing the location of the staging directory). Click Restore Default Folder to reset the directory to the default location. Select a staging directory for PBS Application Services and click Next.
Staging directory considerations:
• As of PBS Application Services 11.1, the staging directory can be set to point to the user's home directory by using the variable $USER_HOME (for example: $USER_HOME/stage). However, this functionality is NOT supported by any release of Compute Man-ager prior to CM release 12.0.
• The stage area can grow quite large, depending on the size of the average job. Give care-ful consideration to the disk usage and disk capacity.
• The pathname for the staging directory should not contain spaces.
• PBS Application Services implements an automatic staging directory cleanup such that any data in the staging directory that is not generated by PBS Application Services is at risk of being purged without notice. It is recommended to select a staging directory where only PBS Application Services data files will be stored. Use of a directory that contains important data is not recommended.
26 PBS Application Services Administrator’s Guide
P 27
Chapter 3
ows platforms
BS Application Services Administrator’s Guide
Installing PAS GUI mode
Linux/Unix platforms Wind
Chapter 3 Installing PAS GUI mode
3.1.8 License server
It is not mandatory to provide the license server at installation time. You may configure the license server information after installation of PAS (see the configurable parameter ALTAIR_LICENSE_PATH in section 6.1.2, “Advanced Configuration Parameters”, on page 72). Click Next.
28 PBS Application Services Administrator’s Guide
P 29
Chapter 3
3
S tion Services in the default directory, or y re Default Folder. Once an installation l
ows platforms
BS Application Services Administrator’s Guide
Installing PAS GUI mode
.1.9 Installation location
pecify a location where PBS Application Services will be installed. You may install PBS Applicaou may select a custom directory by clicking Choose. To restore the default directory, click Restoocation is entered, click Next.
Linux/Unix platforms Wind
C
3 plication Services Administrator’s Guide
3
A lation. You may click Previous to go b
ows platforms
hapter 3 Installing PAS GUI mode
0 PBS Ap
.1.10 Pre-installation summary
pre-installation summary will be displayed. Review all your locations before initiating the instalack and make any changes. Install PBS Application Services by clicking Install.
Linux/Unix platforms Wind
Installing PAS GUI mode Chapter 3
3.1.11 Installation progress
The installation of PBS Application Services will be initiated. You can monitor the progres-sion of your installation via the installation progress toolbar.
PBS Application Services Administrator’s Guide 31
Chapter 3 Installing PAS GUI mode
3.1.12 Start PAS services
Once the installation is complete a message will be displayed asking if the PAS services should be started. Click Yes to start PBS Application Services. Click No to complete the installation without starting PBS Application Services. To manually start PBS Application Services see section 8.1, “Starting the PAS service”, on page 83.
32 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.1.13 PAS client validation
If the PAS service was started, then the PBS Application Services server will be contacted and the following message should be displayed. Click Next to continue the installation.
PBS Application Services Administrator’s Guide 33
C
3 plication Services Administrator’s Guide
3
O yed. Click Done to complete the instal-l
3
P o configure PAS and to perform post-i
ows platforms
hapter 3 Installing PAS GUI mode
4 PBS Ap
.1.14 Installation complete
nce the installation of PBS Application Services is complete the installation details will be displaation
.1.15 Post-installation
lease proceed to the post-installation instructions (see Chapter 5, "Post-installation", on page 59) tnstallation tasks that must be completed before the PAS is ready for use.
Linux/Unix platforms Wind
Installing PAS GUI mode Chapter 3
3.2 Installing PAS Commands
Installation of this product requires:
• System administrator privileges (root or Windows Administrator)
Please note - The first step in the installation process is the extraction of the installer to the %tmp% directory. There should be enough space in this directory to extract the installer (approximately 3 times the installation size). Also, while the installer is being extracted, noth-ing should be deleted from this directory.
To install PAS Commands, download the installer executable appropriate for your platform from the user area.
3.2.1 Starting the installer
Invoke the installer by running the installation binary on Linux/Unix platforms. For example:
./PBSAppSvcs_12.1_SLES-11_x86_64_20130521_1437.bin -i swing
Or by double-clicking the executable on Windows platforms:
PBSAppSvcs_12.1_Windows_x86_64_20130521_1437.exe
PBS Application Services Administrator’s Guide 35
Chapter 3 Installing PAS GUI mode
3.2.2 PAS Commands installation instructions
Once the extraction process is complete, installation instructions will be displayed. Please read through the instructions before proceeding with the installation. At anytime during the installation process, you may click Previous to go back to a previous installation step. You may cancel the install at any time during the installation process by clicking Cancel. To con-tinue the installation process, click Next.
36 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.2.3 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, click I accept the terms of the License Agreement, and click Next.
PBS Application Services Administrator’s Guide 37
Chapter 3 Installing PAS GUI mode
3.2.4 Install options
Choose to install the PAS Commands by selecting PAS Commands Only (clear the PAS Server and Commands check box if necessary), and then click Next.
38 PBS Application Services Administrator’s Guide
Installing PAS GUI mode Chapter 3
3.2.5 PAS server hostname/IP address
Enter the PBS Application Services server hostname or IP address, and the server port num-ber, and click Next. You may choose to accept the defaults by just clicking Next.
PBS Application Services Administrator’s Guide 39
C
4 plication Services Administrator’s Guide
3
S or you may select a custom directory by c on location is entered, click Next.
ows platforms
hapter 3 Installing PAS GUI mode
0 PBS Ap
.2.6 Installation location
pecify a location where PAS Commands will be installed. You may install in the default directory,licking Choose. To restore the default directory, click Restore Default Folder. Once an installati
Linux/Unix platforms Wind
P 41
Chapter 3
3
A lation. You may click Previous to go b
ows platforms
BS Application Services Administrator’s Guide
Installing PAS GUI mode
.2.7 Pre-installation summary
pre-installation summary will be displayed. Review all your locations before initiating the instalack and make any changes. Install PAS Commands by clicking Install.
Linux/Unix platforms Wind
Chapter 3 Installing PAS GUI mode
3.2.8 Installation progress
The installation of PAS Commands will be initiated. You can monitor the progression of your installation via the installation progress toolbar.
42 PBS Application Services Administrator’s Guide
P 43
Chapter 3
3
O yed. Click Done to complete the instal-l
ows platforms
BS Application Services Administrator’s Guide
Installing PAS GUI mode
.2.9 Installation complete
nce the installation of PBS Application Services is complete the installation details will be displaation.
Linux/Unix platforms Wind
Chapter 3 Installing PAS GUI mode
3.2.10 Post-installation
Please proceed to the post-installation instructions (see Chapter 5, "Post-installation", on page 59) to configure PAS and to perform post-installation tasks that must be completed before the PAS is ready for use.
44 PBS Application Services Administrator’s Guide
Chapter 4
Installing PAS console modeAs of the PBS Application Services 11.1 release, two installation options are available. The first option will install both the PBS Application Service server and the PAS Commands. The second option will install the PAS Commands only. PAS Commands are command-line scripts that allow users to access the power of PBS Professional without the use of a graphical user interface, while leveraging the capabilities of PBS Application Services and application definitions. For more information on how to use the PAS Commands see the PBS Application Services Commands User Guide.
See Chapter 13, "Troubleshooting", on page 105 for information pertaining to problems, warning, or error conditions experienced while installing PAS.
4.1 Installing console mode
4.1.1 Installing PBS Application Services and PAS Commands
Installation of this product requires:
• System administrator privileges (root privileges)
• Existing installation of PBS Professional 11.1 or newer
• Existing user account to register as the PBS Application Services Administrator account (default is pbsadmin)
• Removal of any old instances of PBS Application Services
• Removal of any instances of Python and Tomcat installed with previous versions of PBS
PBS Application Services Administrator’s Guide 45
Chapter 4 Installing PAS console mode
Application Services
• PBS Application Services staging directory must exist prior to installation of this product
• Port 17084 must be opened for incoming TCP traffic
Please note - The first step in the installation process is the extraction of the installer to the %tmp% directory. There should be enough space in this directory to extract the installer (approximately 3 times the installation size). Also, while the installer is being extracted, noth-ing should be deleted from this directory.
To install PBS Application Services and PAS Commands, download the installer executable appropriate for your platform from the user area.
4.1.1.1 Starting the installer
Invoke the installer by running the installation binary. The installer will be extracted. This may take a few moments. For example:
/PBSAppSvcs_12.1_SLES-11_x86_64_20130521_1437.bin
4.1.1.2 PBS Application Services installation instructions
The command line installer will launch and you will be prompted to either cancel or continue the installation. You may cancel the install at any time during the installation process by entering "quit" and pressing <Enter>. At anytime during the installation process, you may enter “back” and press <Enter> to go back to a previous installation step. To begin the installation process, press <Enter>.
46 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.1.3 License Agreement
Several pages of license agreement information will be displayed. Page through the license agreement by continuing to press <Enter> until you are prompted to accept the terms of the license agreement. To accept the terms of the license agreement enter "y" and press <Enter>.
4.1.1.4 Install options
Choose to install the PBS Application Services server and the PAS Commands by entering "1" and then pressing <Enter>.
PBS Application Services Administrator’s Guide 47
Chapter 4 Installing PAS console mode
4.1.1.5 PAS service user
Enter the user with whom the PBS Application Services service will be registered. The default is "pbsadmin". This must be an existing account and can be a non-privileged user account that has been granted manager status for PBS Professional. Once you have entered the user, press <Enter>.
48 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.1.6 Staging directory
Enter a staging directory where user's job files will be staged prior to execution. This direc-tory must exist prior to the installation of PBS Application Services. Once a staging directory has been entered, press <Enter>, or to accept the default staging directory, /stage, just press <Enter> (please see the note below before choosing the location of the staging directory).
Staging directory considerations:
• As of PBS Application Services 11.1, the staging directory can be set to point to the user's home directory by using the variable $USER_HOME (for example: $USER_HOME/stage). However, this functionality is NOT supported by any release of Compute Man-ager prior to CM release 12.0.
• The stage area can grow quite large, depending on the size of the average job. Give care-ful consideration to the disk usage and disk capacity.
• The pathname for the staging directory should not contain spaces.
• PBS Application Services implements an automatic staging directory cleanup such that any data in the staging directory that is not generated by PBS Application Services is at risk of being purged without notice. It is recommended to select a staging directory where only PBS Application Services data files will be stored. Use of a directory tha contains important data is not recommended.
PBS Application Services Administrator’s Guide 49
Chapter 4 Installing PAS console mode
4.1.1.7 License server
It is not mandatory to provide the license server at installation time. You may configure the license server information after installation of PAS (see the configurable parameter ALTAIR_LICENSE_PATH in section 6.1.2, “Advanced Configuration Parameters”, on page 72)
Click Next.
4.1.1.8 Installation location
Enter a directory where PBS Application Services will be installed and press <Enter>, or to accept the default directory, /opt/altair/pbsworks/12.1, just press <Enter>.
50 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.1.9 Pre-installation summary
A pre-installation summary will be displayed. Review all your locations before initiating the installation. You may enter “back” and press <Enter> to go back and make any changes. Install PBS Application Services by pressing <Enter>.
4.1.1.10 Start PAS services
A message will be displayed indicating the installation has begun. Once the installation is complete a message will be displayed asking if the PAS services should be started. Enter "1" and press <Enter> to start PBS Application Services. Enter "2" and press <Enter> to com-plete the installation without starting PBS Application Services. To manually start PBS Application Services see section 8.1, “Starting the PAS service”, on page 83.
PBS Application Services Administrator’s Guide 51
Chapter 4 Installing PAS console mode
4.1.1.11 PAS client validation
If the PAS service was started, then the PBS Application Services server will be contacted and the message "PAS client was installed successfully (Server servername on port number portNum is up and running)" should be displayed. Press <Enter> to continue the installa-tion.
4.1.1.12 Installation complete
An installation complete message will be displayed indicating your installation is complete. Press <Enter> to complete the installation. Please logout and login again to complete the configuration for the PAS Commands prior to using PBS Application Services.
4.1.1.13 Post-installation
Please proceed to the post-installation instructions (see Chapter 5, "Post-installation", on page 59) to configure PAS and to perform post-installation tasks that must be completed before the PAS is ready for use.
52 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.2 Installing PAS Commands
Installation of this product requires:
• System administrator privileges (root privileges)
Please note - The first step in the installation process is the extraction of the installer to the %tmp% directory. There should be enough space in this directory to extract the installer (approximately 3 times the installation size). Also, while the installer is being extracted, noth-ing should be deleted from this directory.
To install PAS Commands, download the installer executable appropriate for your platform from the user area.
4.1.2.1 Starting the installer
Invoke the installer by running the installation binary. The installer will be extracted. This may take a few moments. For example:
/PBSAppSvcs_12.1_SLES-11_x86_64_20130521_1437.bin
4.1.2.2 PBS Application Services installation instructions
The command line installer will launch and you will be prompted to either cancel or continue the installation. You may cancel the install at any time during the installation process by entering "quit" and pressing <Enter>. At anytime during the installation process, you may enter “back” and press <Enter> to go back to a previous installation step. To begin the installation process, press <Enter>.
PBS Application Services Administrator’s Guide 53
Chapter 4 Installing PAS console mode
4.1.2.3 License Agreement
Several pages of license agreement information will be displayed. Page through the license agreement by continuing to press <Enter> until you are prompted to accept the terms of the license agreement. To accept the terms of the license agreement enter "y" and press <Enter>.
4.1.2.4 Install options
Choose to install the PAS Commands by entering "2" and then pressing <Enter>.
54 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.2.5 PAS server hostname/IP address
Enter the PBS Application Services server hostname or IP address and press <Enter>. You may choose to accept the defaults by just pressing <Enter>.
4.1.2.6 PAS server port
Enter the PBS Application Services server port number and press <Enter>. You may choose to accept the defaults by just pressing <Enter>.
4.1.2.7 Installation location
Enter a directory where PAS Commands will be installed and press <Enter>, or to accept the default directory, just press <Enter>.
PBS Application Services Administrator’s Guide 55
Chapter 4 Installing PAS console mode
4.1.2.8 Pre-installation summary
A pre-installation summary will be displayed. Review all your locations before initiating the installation. You may enter “back” and press <Enter> to go back and make any changes. Install PBS Application Services by pressing <Enter>.
4.1.2.9 Installation complete
An installation complete message will be displayed indicating your installation is complete. Press <Enter> to complete the installation. Please logout and login again to complete the configuration for the PAS Commands prior to using PBS Application Services.
56 PBS Application Services Administrator’s Guide
Installing PAS console mode Chapter 4
4.1.2.10 Post-installation
Please proceed to the post-installation instructions (see Chapter 5, "Post-installation", on page 59) to configure PAS and to perform post-installation tasks that must be completed before the PAS is ready for use.
PBS Application Services Administrator’s Guide 57
Chapter 4 Installing PAS console mode
58 PBS Application Services Administrator’s Guide
Chapter 5
Post-installation
5.1 Features and configuration files
There are several configuration files and features that are installed with PAS.
5.1.1 Application definitions
Application definitions are a feature of PAS and are used to submit jobs using the power and flexibility of PAS. Application definitions are stored in the PAS application directory. The location of this directory for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\reposi-tory\applications
on Unix/Linux: /var/spool/pas/repository/applications
For an overview of application definitions see Chapter 9, "Application Definitions", on page 87.
Diving Into Application Definitions 12.1 explains what an application definition is and how to use an application definition. If you are installing PAS for the first time and are not familiar with application definitions, then Diving Into Application Definitions 12.1 is a good place to start. A set of tutorials is provided starting with how to create the simplest of application definitions and progressing to more advanced topics. Recipes are also available demonstrat-ing advanced techniques.
In addition, a sample application definition called PBSJobApp is provided out-of-the-box with PAS and is located in the PAS application directory.
PBS Application Services Administrator’s Guide 59
Chapter 5 Post-installation
5.1.2 Site configuration file
A default site configuration file, site-config.xml, is installed in the PAS configuration directory. The location of this file for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\reposi-tory
on Unix/Linux: /var/spool/pas/repository
This file is a central repository for site specific information that can be used across all applica-tion definitions. The default site configuration file installed with PAS is basically a template. Initially, you may use the default site configuration file as is, but as you become accustomed to working with application definitions, you may choose to modify the site configuration file per your site’s needs. A tutorial and several recipes are available within Diving Into Applica-tion Definitions 12.1 showing several ways that the site configuration file can be used within an application definition. For an overview of the site configuration file see section 9.4, “Site-wide Settings”, on page 91.
5.1.3 Server configuration file
A server configuration file, server.conf, is also installed in the PAS configuration direc-tory. This file contains all configurable parameters available with PAS. Please review section 6.1, “Configurable parameters”, on page 68 for an explanation of each parameter.
60 PBS Application Services Administrator’s Guide
Post-installation Chapter 5
5.1.4 PAS configuration file
A PAS configuration file, pas.conf,is installed by default in the following location:
on Linux: /etc/pas.conf
on Windows: C:\Program Files\altair\pas\12.1\PAS\pas.conf
This file contains:
• the location of the PAS home directory where application definitions, the site configura-tion file, PAS log files, and the server configuration file are stored.
• the execution directory where all binaries, scripts, and third party software are stored.
• the IP address and port number of the PAS server.
• a parameter for enabling or disabling HTTPS communication between the PAS server and PAS Commands.
• the default port for HTTPS communication between the PAS server and PAS Commands.
Linux
Windows
PAS_HOME=/var/spool/pas
PAS_EXEC=/opt/altair/pas/12.1/pas
PAS_SERVER=localhost
PAS_PORT=17084
PAS_SSL_ENABLED=true
PAS_SSL_PORT=17443
PAS_HOME=C:\Program Files\altair\pas\12.1\PAS\home
PAS_EXEC=C:\Program Files\altair\pas\12.1\PAS\exec
PAS_SERVER=localhost
PAS_PORT=17084
PAS_SSL_ENABLED=true
PAS_SSL_PORT=17443
PBS Application Services Administrator’s Guide 61
Chapter 5 Post-installation
5.2 Installing PAS for the first time
5.2.1 Configure PAS
If you are installing PAS for the first time, the only configuration that is necessary before using PAS is to make changes to the configurable parameters stored in the server.conf file. Make any modifications that are necessary for your site's installation. For more infor-mation about configurable parameters available for PAS see section 6.1, “Configurable parameters”, on page 68.
5.2.2 Restart PAS service
Any configuration changes will require a restart of the PBS Application Services server (see Chapter 8, "PAS service commands", on page 83).
5.3 Upgrading from a previous release
If you are upgrading from a previous release of PBS Application Services to a new release, you must now migrate your existing application definitions, site configuration file, and server configuration file that were backed up during the pre-installation process (see section 2.1, “Upgrading from a previous release”, on page 15).
5.3.1 Migrate application definitions
Copy the backups of the application definitions to the new <PAS_HOME>/repository/applications directory.
5.3.2 Migrate site configuration file
Copy the backup of the site configuration file to the new <PAS_HOME>/repository directory.
62 PBS Application Services Administrator’s Guide
Post-installation Chapter 5
5.3.3 Migrate server configuration file
Review and compare the new version of the server configuration file to the backup. Addi-tional parameters may have been added to the new server configuration file, or default values for configuration parameters may have changed. Make any modifications that are necessary for your site's installation. For more information about configurable parameters available for PAS see section 6.1, “Configurable parameters”, on page 68.
5.3.4 Restart the PAS server
Any migration activities will require a restart of the PBS Application Services server (see Chapter 8, "PAS service commands", on page 83).
5.4 Updating search path for PAS Commands
On Linux platforms that are installing PBS Application Services version 11.1 or later, any user's of the PAS Commands will need to add <PAS_EXEC>/pas-commands/bin to their search path.
5.5 Enabling job history
As of PBS Application Services release 11.1, PBS Application Services does not automati-cally set the PBS Professional job_history_enable attribute to true. Therefore, to enable job history use the PBS Professional command:
qmgr -c 'set server job_history_enable=True'
5.6 Setting environment variable PAS_CONF_FILE
The environment variable, PAS_CONF_FILE, needs to be set for any nodes where PAS Com-mands are installed. This environment variable must be set to the absolute path of the PBS Application Services configuration file. The location of the configuration file for a typical installation of PBS Application Services is:
on Linux: /etc/pas.conf
on Windows: C:\Program Files\altair\pas\12.1\PAS\pas.conf
PBS Application Services Administrator’s Guide 63
Chapter 5 Post-installation
5.7 Configuring SSL for communication with PAS Commands
As of version 12.0.2, HTTPS communication between PAS Commands and the PAS server will be enabled by default. The default port number for HTTPS communication is 17433. Communication over HTTPS can be disabled by modifying the configuration parameter PAS_SSL_ENABLED to "false" in the pas.conf file on all machines where PAS Com-mands is installed. Communication will then occur using the HTTP protocol.
It is also possible to configure a non-default SSL port for PAS Commands by changing the value of PAS_SSL_PORT on all machines where PAS Commands is installed.
64 PBS Application Services Administrator’s Guide
Post-installation Chapter 5
5.8 Verifying installation of PAS
To verify that the installation was successful, the server is up and running, and PBS Applica-tion Services is properly integrated with PBS Professional, complete the following steps:
1. Determine if the PBS Application Services server is up and running by issuing the following command at the command prompt:
pas-ping
This command will return a message indicating the status of the PAS server
PAS server at <machine name> is up/down.
If the server is up and running then proceed to step 2. Otherwise, review the PBS Application Services log file for error messages.
2. Determine that PBS Application Services has successfully integrated with PBS Pro-fessional by issuing the following command at the command prompt.
pas-stat
This command displays the status of all jobs on the PBS Application Services server.
If this command returns a list of jobs and their corresponding status then proceed to step 3. Otherwise, review the PBS Application Services log file for error messages.
3. Submit a job.
Create a shell script called hello_world.sh and place the following code in that script:
Issue the following command at the command prompt:
If the job completes successfully, this command will create an output file containing the text 'Hello World'. Otherwise, review the PBS Application Services log file for error messages.
#!/bin/sh
echo 'Hello World'
pas-submit ApplicationId=PBSJobApp ApplicationName=PBSJobApp JOB_NAME=PBSJobApp_test MEMORY=10 NCPUS=1 JOB_SCRIPT=pbscp://hostname/job_script_pathname/hello_world.sh SUBMISSION_DIRECTORY=pbscp://hostname/submisson_dir_pathname
PBS Application Services Administrator’s Guide 65
Chapter 5 Post-installation
66 PBS Application Services Administrator’s Guide
Chapter 6
Configuring PBS Application ServicesThe PBS Application Services server has a few configurable parameters available to you. PBS Application Services stores its configuration data in a file called server.conf. The location of the server configuration file for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\conf
on Linux: /var/spool/pas/conf
All parameters are stored in key=value pairs. Spaces and tabs are preserved (as spaces) and providing quotes around values is optional. As spaces are preserved, do not use key = value (notice the space surrounding the =) unless spaces are intentional. Empty lines beginning with a comment symbol (ie. #) are ignored.
PBS Application Services Administrator’s Guide 67
C ices
6 plication Services Administrator’s Guide
6
6
Default Value
the tracing the
server-log.xml
bled ults to e
false
r BS any
speci-ot be
eged S Pro-
pbsadmin
hapter 6 Configuring PBS Application Serv
8 PBS Ap
.1 Configurable parameters
.1.1 Standard configuration parameters
Table 6-1: Standard Configuration Parameters
Parameter Description
LOGGING_CONFIG_FILE_RELATIVE The PBS Application Services logging configuration file(Log4J) which is used to configure logging levels. SincePBS Application Services uses Log4J as its logging and API, you can access additional information on Log4J viaApache Log4J website at http://logging.apache.org/log4j
DEBUG The PBS Application Services debugging property. If enatrue, PBS Application Services will send intermittent resfiles stored in PAS_HOME/temp. This can be an effectivdebugging mechanism.
ADMIN_USER The PBS Application Services administration account (foexample, pbsadmin) that has complete control over the PApplication Services server. This account is required for remote PBS Application Services administration tasks.
On Windows, this will be the same pbsadmin account as fied during the installation of PBS Professional and cannchanged.
On Linux, the administration account can be a non-priviluser account that has been granted manager status for PBfessional, and can be changed after installation.
P 69
ices Chapter 6
S uthori-yer.
Linux: UnixLogin
Windows: WindowsLogin
direc-n Ser-are , PBS mitting rofes-
job for m the wants g direc-ady to e, but
E_- using E/
any
Linux: /stage
Windows: C:/stage
http
Default Value
BS Application Services Administrator’s Guide
Configuring PBS Application Serv
LOGIN_MODULE_NAME The PBS Application Services authentication module. PBApplication Services uses the Java Authentication and Azation Service (JAAS) as its authentication abstraction la
STAGE_ROOT The PBS Application Services file staging location. Thistory must exist prior to the installation of PBS Applicatiovices. The staging directory is where the necessary files transferred after job submission (via a client for examplePortals or Compute Manager), but prior to the portal subthe job to PBS Application Services for transfer to PBS Psional for execution. When PBS Professional selects theexecution, the files are staged-in to the execution host frostaging directory. Upon job completion, any files the job to retain are staged-out by PBS Professional to the stagintory, and the client retrieves them from there when it is redo so. Customer written portals may choose to do the samare not required to do so.
As of PBS Application Services 11.1, the value of STAGROOT can be set to point to the user's home directory bythe variable $USER_HOME (for example: $USER_HOMstage). However, this functionality is NOT supported byrelease of Compute Manager prior to CM release 12.0.
FILE_TRANSFER_PROTOCOL The PBS Application Services file transfer mechanism.
Table 6-1: Standard Configuration Parameters
Parameter Description
C ices
7 plication Services Administrator’s Guide
ime. the y the e e never
14
This is BS
hed_-ral val-
server_dyn_res: '$FEATURE !"$PYTHON_PATH" "$LICSTATUS_PATH" --get-licenses -F $FEATURE'
oolean ar in
urces
ources line.
e added
false
Default Value
hapter 6 Configuring PBS Application Serv
0 PBS Ap
FILE_EXPIRATION_TIME The PBS Application Services stage area file expiration tThat is, the age in days after which data is removed fromPBS Application Services staging directory (as defined bSTAGE_ROOT parameter) and its subdirectories with thexception of the profiles directory. Files in the profiles arremoved by PBS Application Services.
DYN_RES_PATTERN The PBS Application Services dynamic resource string. the pattern for creation of server_dyn_res records in the PScheduler configuration file (PBS_HOME/sched_priv/scconfig). The following elements are substituted with liteues defined by the PBS Application Services server $FEATURE, $PYTHON_PATH.
PAS_SCHEDULING The PBS Application Services scheduling policy. This Battribute determines if PAS scheduler resources will appesched_config on PAS startup.
if PAS_SCHEDULING is set to true, PAS scheduler resowill be set in PBS sched_config in "resources:" line.
if PAS_SCHEDULING is set to false, PAS scheduler reswill be removed from PBS sched_config in "resources:"
The exception is PAS Dynamic licensing resources. Thosresources are now controlled by PAS_LICENSING (not or removed when we change PAS_SCHEDULING).
Table 6-1: Standard Configuration Parameters
Parameter Description
P 71
ices Chapter 6
uring LING
nked on of ING.
g line UL-
ng
less if
false
Default Value
BS Application Services Administrator’s Guide
Configuring PBS Application Serv
PAS_LICENSING In previous versions of PBS Application Services, configPAS scheduling (see the description of the PAS_SCHEDUconfiguration parameter as defined above) was directly liwith the configuration of licensing. Now the configuratilicensing is done through a new parameter, PAS_LICENS
if PAS_LICENSING is set to true, PAS Dynamic licensinresources will be set in PBS sched_config in "resources:"and in “server_dyn_res:” line, regardless if PAS_SCHEDING is set to true or false
if PAS_LICENSING is set to false, PAS Dynamic licensiresources will be removed from PBS sched_config in "resources:" line and from “server_dyn_res:” line, regardPAS_SCHEDULING is set to true or false
Table 6-1: Standard Configuration Parameters
Parameter Description
C ices
7 plication Services Administrator’s Guide
6
T ppropriate for advanced configurations...
Default Value
ca-
y or ve re ry
as
$PBS_EXEC/bin/python
es on
on
<PAS_EXEC>/scripts/lic_status.py
hapter 6 Configuring PBS Application Serv
2 PBS Ap
.1.2 Advanced Configuration Parameters
he PBS Application Services server also has a few optional parameters available to you that are a
Table 6-2: Advanced Configuration Parameters
Parameter Description
PYTHON_PATH The PBS Application Services Python binary. The PBS Applition Services require that each PBS execution host provide a standard Python binary. The full path to your systems Pythonbinary can be changed here.
The PBS Professional daemon pbs_mom will look for a binarcalled pbs_python in PBS_EXEC/bin. If using custom actionsany other operations that involve the pbs_mom accessing thispbs_python (aka python binary) there may be problems if thepython libraries are not located in the standard locations relatito PBS_EXEC/bin/pbs_python. If Python is installed elsewhea link to (Linux) or copy of (Windows) the actual python binamust exist as PBS_EXEC/bin/pbs_python.
As of PBS Professional 11.0 a Python distribution is includedpart of the pbs_mom installation.
LICSTATUS_PATH When the PBS Scheduler needs to know the number of licensavailable with which to run jobs submitted via PBS ApplicatiServices, it uses the lic_status.py utility to query the license server. This parameter can be configured to point to the locatiof lic_status.py. See the DYN_RES_PATTERN parameter above.
P 73
ices Chapter 6
Specified during the installa-tion of PBS Application Ser-vices
er. e
none
Default Value
BS Application Services Administrator’s Guide
Configuring PBS Application Serv
ALTAIR_LICENSE_PATH The location of the Altair license server. This is the license server from which PBS Application Services itself attempts topull license(s). Format: port@hostname.
FEATURE The application licensing feature, as known to the license servThe custom resource created for PBS Professional must be thsame as this feature name.
Table 6-2: Advanced Configuration Parameters
Parameter Description
Chapter 6 Configuring PBS Application Services
6.2 Configuring PAS logging behavior
The PAS logging behavior can be defined in the file server-log.xml. The location of the file for a typical installation of PAS is:
on Windows : C:\Program Files\altair\pas\12.1\PAS\home\conf
on Linux : /var/spool/pas/conf
The default logging level is set to “info” providing informational messages that highlight the progress of the application at a coarse-grained level.
To configure the level of logging, edit the server-log.xml file and set the <priority value> attribute of a particular <category> to one of the following values:
• off - has the highest possible rank and is intended to turn off logging.
• fatal- very severe error events that will presumably lead the application to abort.
• error- error events that might still allow the application to continue running.
• warn- potentially harmful situations.
• info - informational messages highlighting the progress of the application at a coarse-grained level.
• debug- fine-grained informational events that are most useful to debug an application.
• trace - finer-grained informational events than the DEBUG.
• all - the lowest possible rank and is intended to turn on all logging..
The existing categories in server-log.xml are useful as a basic configuration, are more course-grained, and provide the default PAS logging.
The <priority value> can be changed from “info” to “debug” for these existing categories to troubleshoot an issue. In addition, the following categories can be added to the server-log.xml file to troubleshoot specific functional aspects of PAS.
In addition, if the configuration parameter, DEBUG is set to “false” (see section 6.1, “Config-urable parameters”, on page 68), then job resource dump files will be created in the location <PAS_HOME>/temp, and a record will be written to the PAS log file referencing the dump file. For example:
<category name="<category>">
<priority value="<logging_level>" />
</category>
“Created job resources dump: <file name>”
74 PBS Application Services Administrator’s Guide
Configuring PBS Application Services Chapter 6
6.2.1 Remote file operations, job submission, and job status
The logging for this category is relevant for the communication to and from the EIFL server
The following are examples of the type of messages that will be logged if debugging is enabled for this class:
Before a web service API call to the EIFL server
After an EIFL web service API call to the EIFL server
For a job status request, before the web service API call to the EIFL server
After an EIFL web service API call to the EIFL server
For the job submission request, after a web service API call to the EIFL server, on successful job submission:
For the job delete request, after a web service API call to the EIFL server:
For each operation, if an error occurs, the error code will be logged as returned by PBS
<category name="com.altair.gw.aif.pbs.ifl.implementations.PbsEiflWs">
<priority value="debug" />
</category>
“Success getting eifl server port <port>”
“Success returning from eifl.waitExit(), port is <port>”
“qstatJobs(): Success getting eifl server port <port>”
“qstatJobs(): Success returning from eifl.waitExit(), port is <port>”
"SubmitJob: returned job ID <jobId>”
“Deleted job ID: <jobId>”
“PbsEiflWs.java getErrorCode(): pbs error code is <pbsErrorCodeStr>”
PBS Application Services Administrator’s Guide 75
Chapter 6 Configuring PBS Application Services
6.2.2 File upload/download
6.2.3 File operations (local and remote)
6.2.4 Job submission
The following are examples of the type of messages that will be logged if debugging is enabled for this class:
Before job submission, PAS will record the job name and the resources requested.
Once the job is submitted, PAS will record the job id.
For job status requests, PAS will log any empty responses.
<category name="com.altair.gw.aif.servlets">
<priority value="debug" />
</category>
<category name="com.altair.gw.aif.fileop.implementation.FileOperations"> <priority value="debug" /></category>
<category name="com.altair.gw.aif.fileop.implementation.FileOperationsHelper"> <priority value="debug" /></category>
<category name="com.altair.gw.aif.wms.jobsubmission">
<priority value="debug" />
</category>
PbsJobFactory.getPbsJob():job name = <job name>, resourceList to String: <job resources>
“JobSubmit success. Job id: <jobId>”
"HpcpPbsAdapter.jobList(): qstat is empty"
76 PBS Application Services Administrator’s Guide
Configuring PBS Application Services Chapter 6
6.2.5 Job submission and status
Enabling a debugging level for the “PbsJobsPortImpl” class also provides the ability to deter-mine the IP address of a client request for PAS job submission services.
For each job submission API call a log record is created having the API name, requesting user name, and remote host,. For example:
6.2.6 License checkout by PAS
6.2.7 Applications (application definitions)
6.2.8 Dynamic Application Refresh Script
<category name="com.altair.schemas.pbs._2007._03.portal.PbsJobsPortImpl">
<priority value="debug" />
</category>
<category name="com.altair.gw.aif.pbs.ifl.responses.JobsStatus_Response">
<priority value="debug" />
</category>
<category name=" com.altair.gw.aif.pbs.ifl.responses.PBSObjectStatus">
<priority value="debug" />
</category>
Entered getJobs(). User: <username>, client host: '<clientHost>'
<category name="com.altair.gw.pbs">
<priority value="debug" />
</category>
<category name="com.altair.gw.aif.converter">
<priority value="debug" />
</category>
<category name="com.altair.gw.aif.applications.utils.DynamicApplicationBuilder">
<priority value="debug" />
</category>
PBS Application Services Administrator’s Guide 77
Chapter 6 Configuring PBS Application Services
6.2.9 Metascheduling
To troubleshoot specific functional aspects of the Metascheduling version of PAS, enable debugging for the following classes/packages:
6.2.9.1 Basic Execution Service (BES) operations
All BES API operation calls will be logged. For example:
6.2.9.2 Vnode monitoring
Every time vnode details are requested, PAS will record the fact. For example: :
6.2.9.3 Job submission and status
In addition, the following debugging levels can be enabled for Metascheduling: section 6.2.1, “Remote file operations, job submission, and job status”, on page 75 and section 6.2.4, “Job submission”, on page 76.
<category name=" com.altair.schemas.aif._2010._07.bes_factory_wms. BESFactoryPortTypeImpl">
<priority value="debug" />
</category>
"CreateActivity: Job Submitted successfully."
<category name="com.altair.gw.aif.pbs.utils.monitoring">
<priority value="debug" />
</category>
“Getting VNode Details"
<category name="com.altair.gw.aif.pbs.ifl.responses.JobsStatus_Response">
<priority value="debug" />
</category>
<category name=" com.altair.gw.aif.pbs.ifl.responses.PBSObjectStatus">
<priority value="debug" />
</category>
78 PBS Application Services Administrator’s Guide
Configuring PBS Application Services Chapter 6
6.3 Changing the Linux SSH Server or Port
This release of PAS incorporates Access Management Service (AMS), a centralized configu-ration system for authentication and authorization. For more information about AMS see sec-tion 2.4, “Access Management Service”, on page 17.
Authentication information is stored in the file AA_jaas.config. The location of the file for a typical installation of PAS is:
on Windows : C:\Program Files\altair\pas\12.1\PAS\home\conf\AAService-Home\config
on Linux : /var/spool/pas/conf/AAServiceHome/config
To change the SSH server or the SSH port, edit the AA_jaas.config file.
1. Replace <SSH_SERVER> with the new SSH server IP address or hostname.
2. Replace <PORT> with the new port number.
3. Restart the PAS service.
LoginModule {
com.altair.jaas.module.SSHUnixLoginModule Required
host="<SSH_SERVER>"
cache_ttl="60";
};
Super_User_Login {
com.altair.jaas.module.DatastoreLoginModule Required;
};
UnixLogin {
com.altair.jaas.module.JschLoginModule required;
};
PBS Application Services Administrator’s Guide 79
Chapter 6 Configuring PBS Application Services
6.4 Configuring JVM Performance
The Java Virtual Machine (JVM) heap size of PAS may need to be adjusted. Currently, the default JVM heap size is 1024 MB. If OutOfMemory errors or warnings are reported in the PAS log file, this value should be increased. It can be increased in multiples of 256 MB.
On Linux, the Java heap size default is stored in a script file called pas-server-start.sh. The location of this file for a typical installation of PAS is:
/opt/altair/pbsworks/12.1/pas/scripts
The variable that needs to be changed is CATALINA_OPTS. Modify the JVM argument -Xmx1024m. Increase the "1024" value.
This is the area of pas-server-start.sh that will need to be modified (this file is too large to show in its entirety):
For Windows platforms, the same JVM argument, -Xmx1024m, in the following registry entry must be modified:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Pro-crun 2.0\PBSAppSvcs\Parameters\Java
The PAS service will need to be restarted for the changes to be reflected.
CATALINA_OPTS="-Dpass -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=128m -Djava.library.path=$PAS_EXEC/shared/$AIF_PLATFORM -Djava.security.auth.login.config=$PAS_HOME/conf/jaas.config -Dpas.exec=$PAS_EXEC -Dpas.eifl.port=18080 -Dpas.eifl.usebroker=true"
80 PBS Application Services Administrator’s Guide
Chapter 7
Log files
7.1 PAS log file
The PBS Application Services log file, pas-server.log, contains a record of server activities and is useful for identifying issues and problems. The location of the log file for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\logs
on Unix/Linux: /var/spool/pas/logs
7.2 Other log files
The PAS installation log file is located in:
<INSTALL_DIR>/_PBS Application Services_installation/Logs
The log files for the Apache Tomcat web server are located in:
<INSTALL_DIR>/pas/bin/pas-server/logs
PBS Application Services Administrator’s Guide 81
Chapter 7 Log files
82 PBS Application Services Administrator’s Guide
Chapter 8
PAS service commands
8.1 Starting the PAS service
8.1.1 Windows
As the Windows Administrator open Windows Services:
1. Click Start
2. Click Control Panel
3. Double-click Administrative Tools
4. Double-click Services
5. Right-click on the service PBS Application Services.
6. Click the Start option.
Once the service is started, the status of the service will be displayed as Started.
8.1.2 Linux
As root, enter the following at the Linux command line prompt:
/etc/init.d/pas start
PBS Application Services Administrator’s Guide 83
Chapter 8 PAS service commands
The following messages will be displayed:
8.2 Stopping the PAS service
8.2.1 Windows
As the Windows Administrator open Windows Services:
1. Click Start
2. Click Control Panel
3. Double-click Administrative Tools
4. Double-click Services
5. Right-click on the service PBS Application Services.
6. Click the Stop option.
8.2.2 Linux
As root, enter the following at the Linux command line prompt:
/etc/init.d/pas stop
The following messages will be displayed:
Starting PAS server
Using CATALINA_BASE: /opt/altair/pas/12.1/pas/bin/pas-server
Using CATALINA_HOME: /opt/altair/pas/12.1/thirdparty/Apache
Using CATALINA_TMPDIR: /opt/altair/pas/12.1/pas/bin/pas-server/temp
Using JRE_HOME: /opt/altair/pas/12.1/thirdparty/Java/jre1.7
Using CLASSPATH: /opt/altair/pas/12.1/thirdparty/Apache/bin/bootstrap.jar:/opt/altair/pas/12.1/thirdparty/Apache/bin/tomcat-juli.jar
PAS server started, pid: 23471
Stopping PAS server
PAS server stopped, was pid: 24604
84 PBS Application Services Administrator’s Guide
PAS service commands Chapter 8
8.3 Restarting the PAS service
8.3.1 Windows
As the Windows Administrator open Windows Services:
1. Click Start
2. Click Control Panel
3. Double-click Administrative Tools
4. Double-click Services
5. Right-click on the service PBS Application Services.
6. Click the Restart option.
Once the service is started, the status of the service will be displayed as Started.
8.3.2 Linux
As root, enter the following at the Linux command line prompt:
/etc/init.d/pas restart
The following messages will be displayed:
Restarting PAS server
Stopping PAS server
PAS server stopped, was pid: 12167
Starting PAS server
Using CATALINA_BASE: /opt/altair/pas/12.1/pas/bin/pas-server
Using CATALINA_HOME: /opt/altair/pas/12.1/thirdparty/Apache
Using CATALINA_TMPDIR: /opt/altair/pas/12.1/pas/bin/pas-server/temp
Using JRE_HOME: /opt/altair/pas/12.1/thirdparty/Java/jre1.7
Using CLASSPATH: /opt/altair/pas/12.1/thirdparty/Apache/bin/bootstrap.jar:/opt/altair/pas/12.1/thirdparty/Apache/bin/tomcat-juli.jar
PAS server started, pid: 27344
PBS Application Services Administrator’s Guide 85
Chapter 8 PAS service commands
8.4 Determining the status of the PAS service
8.4.1 Windows
As the Windows Administrator open Windows Services:
1. Click Start
2. Click Control Panel
3. Double-click Administrative Tools
4. Double-click Services
Scroll down the list of services until you find PBS Application Services.
The status of the service will be displayed as Started if PBS Application Services is running. The status of the service will not be displayed if PBS Application Services is not running..
8.4.2 Linux
As root, enter the following at the Linux command line prompt:
/etc/init.d/pas status
If the service is running, the following messages will be displayed:
f the service is not running, the following messages will be displayed:
PAS server is running with pid: 31825
PAS server is not running.
86 PBS Application Services Administrator’s Guide
Chapter 9
Application DefinitionsPBS Application Services requires a predefined set of instructions, called application defini-tions, to describe your application parameters to users, store their responses, and prepare those responses for job execution via PBS Professional. An application definition provides a flexi-ble set of instructions that can be manipulated to allow for precise control over all aspects of application-specific parameters and job execution. These application definitions are stored in a central repository and will make PBS Professional aware of each of them upon server startup. The location of the application directory for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\reposi-tory\applications
on Unix/Linux: /var/spool/pas/repository/applications
9.1 Overview of Application Definition Components
An application definition is comprised of a set of Python scripts and two XML files which could include references to site wide configuration settings. A separate application definition with application-specific details is required for each application that will be integrated into PBS Application Services. Application definitions are compliant with the Open Grid Forum High Performance Computing Basic Profile (HPCBP), Business Process Execution Language (BPEL), and Job Submission Description Language (JSDL) standards.
For more comprehensive information about application definitions and their associated files see Diving Into Application Definitions 12.1.
PBS Application Services Administrator’s Guide 87
Chapter 9 Application Definitions
9.1.1 Application input file
The application input file is where administrators can define the allowed arguments for a given application. This file is also used by graphical, web-based and even command-line tools to display these arguments to users for job submission.
The mandatory naming convention for the application input file is app-inp-applica-tionname.xml where "applicationname" is whatever name you choose to give your appli-cation.
9.1.2 Application converter file (HPCBP converter)
The application converter file is where administrators take the values received by the user via the input file and communicates this information to PBS Application Services and PBS Pro-fessional. This file allows the PBS Application Services administrator to configure the job submission environment.
The mandatory naming convention for the application converter file is app-conv-appli-cationname.xml where "applicationname" is whatever name you decide to give to your application.
9.1.3 Application runtime scripts
The application runtime scripts are what really get executed on the execution hosts. The run-time script, start.py, is what will be executed as the “job script”. This script file is respon-sible for executing the application associated with your application definition, using the information entered by the user (defined by the application input file), and converted (via the application converter file). Additional scripts can also be included that support and enhance the runtime script. Administrators can directly edit these runtime script(s), taking full advan-tage of Python to add further inspection and complexity to job submission and finally execu-tion of the application itself. This adds tremendous flexibility as nearly infinite possibilities for job control exist at this phase of job description.
For information about how to use runtime scripts see the tutorials “Enhancing your Applica-tion with Runtime Scripts” and “Executing Actions on a Running Job” and the Recipes sec-tion in Diving Into Application Definitions 12.1.
9.1.4 Site configuration file
The site configuration file, site-config.xml, is meant to make application definitions more portable by consolidating data that may change from cluster to cluster in a central loca-tion (see section 9.4, “Sitewide Settings”, on page 91 for more information pertaining to the
88 PBS Application Services Administrator’s Guide
Application Definitions Chapter 9
site configuration file). It is where administrators can define things like policies, version, and path information for all the available applications, billing account information, etc. The data in this file is used by the application input and converter files. For information on how to ref-erence the site configuration file in an application definition see the tutorial “Allowing Multi-ple Versions of an Application”, and recipes “How to Configure and Use Billing Accounts” and “How to Configure and Use Site Policies” in Diving Into Application Definitions 12.1.
9.2 Sample application definition PBSJobApp
PBS Application Services provides a sample application definition, PBSJobApp, which is located in the application definition directory.
PBSJobApp is an example of how an administrator could create an application definition enabling users to use custom job scripts akin to the more common PBS Professional job script. PBSJobApp allows these job scripts to be written in any language by using its runtime script, start.py, to parse the first line (shebang line) to determine the correct interpreter to execute your job script against. PBSJobApp's versatility allows the following:
• extra arguments to be passed to the job script
• specification of advanced multi-node placement options
• the inclusion of additional files
This application definition in conjunction with the Diving Into Application Definitions 12.1 documentation will assist administrators to create and deploy application definitions.
9.3 Administration of Application Definitions
The PBS Application Services has a central location for keeping application definitions and will make PBS Professional aware of each of them upon server startup. The location of the application definition files for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\repos-itory\applications
on Unix/Linux: /var/spool/pas/repository/applications
PBS Application Services Administrator’s Guide 89
Chapter 9 Application Definitions
9.3.1 Adding a new application definitions
Adding an application definition to the applications directory, followed by a restart of PBS Application Services, will expose your application definition to the user, as well as notify PBS Professional. Follow these steps to add an application definition:
• Navigate to the applications directory.
• Create a directory called appname (where appname is the name of the application).
• Place the application definition input file (applapp-inp-appname.xml) and the application definition converter file (app-conv-appname.xml) in the application directory.
• Create a subdirectory called runtime and navigate to that subdirectory.
• Place any runtime scripts into the runtime directory.
• Restart the PBS Application Services server.
9.3.2 Application definition validation
When the PBS Application Services server starts, it performs a validation of the existing application definitions. If application definitions fail to meet key criteria, they will be moved to an invalid application directory. The directory will be created if it does not exist. The loca-tion of this directory for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\repos-itory\invalid_applications
on Unix/Linux: /var/spool/pas/repository/invalid_applications
In addition, PBS Application Services will restore the site configuration file from the last valid backup - site-config.backup.
Error messages will be displayed in the PBS Application Services log file indicating why the application definition was invalid. Invalid application definitions can be retrieved from the invalid_applications directory and modified to meet the criteria necessary to be con-sidered valid. An invalid application definition will not prevent the PBS Application Services server from starting up.
9.3.3 Maintenance of existing application definitions
Existing application definitions can be modified or removed. To make PBS Application Ser-vices aware of the modification or the removal of an application definition, restart the PBS Application Services server.
90 PBS Application Services Administrator’s Guide
Application Definitions Chapter 9
9.3.3.1 Update an Application Definition
You can easily modify an existing application definition using your favorite XML editor. Fol-low these steps to modify an application definition:
• Navigate to the applications directory.
• Edit and make any modifications necessary to the application definition files.
• Restart the PBS Application Services server:
9.3.3.2 Remove an Application Definition
Removing an application definition from PBS Application Services is also very simple. Sim-ply remove the application definition directory and restart PBS Application Services to remove your application definition from both PBS Application Services and PBS Profes-sional. Follow these steps to remove an application definition:
• Navigate to the applications directory.
• Remove the application directory and all of its content including the runtime subdirec-tory and associated files.
• Restart the PBS Application Services server:
9.4 Sitewide Settings
PBS Application Services provides a central repository for site specific information such as executable paths, policies, and billing account information. This information is stored in a site configuration file, site-config.xml. By putting some site specific application infor-mation in the site-config.xml, application definitions can be made more portable and reusable among different PBS Professional complexes: for example, putting binaries locations and version availability information here, makes the rest of the application definition reusable on a different cluster just by modifying that cluster's site-config.xml. The location of this file for a typical installation of PBS Application Services is:
on Windows: C:\Program Files\altair\pas\12.1\PAS\home\reposi-tory
on Unix/Linux: /var/spool/pas/repository
PBS Application Services Administrator’s Guide 91
Chapter 9 Application Definitions
9.4.1 Site configuration file content
This file can hold virtually any sort of information, since the information stored in the file can be referenced by any application definition XML file. Altair has included certain data in the site configuration file for the integration and support of other products from the PBS Profes-sional family. The example below shows a sample of the site configuration file with the sec-tions currently used by the PBS Professional product suite:
• Applications - This section holds application specific information.
• Application versions - For each application, you can insert site supported versions and for each version its binary pathname.
• Job projects (billing accounts) - This section is for integrating PBS Application Services with other products from Altair. Here you can list a set of strings to be used as “account-ing” information to be attached to jobs.
• Policies - Site policies are values that can be used in a site’s application definition XML files and/or as values available in job runtime environment (policies are included as envi-ronment variables for the jobs).
92 PBS Application Services Administrator’s Guide
P 93
Chapter 9
9
A PBSJobApp, an application definition t ll need to be updated according to your s
<
<
s/site-config.xsd">
<
BS Application Services Administrator’s Guide
Application Definitions
.4.1.1 Initial site configuration file after installation of PAS
fter installation of PBS Application Services the site configuration file will contain references to hat is provided out-of-the-box. Placeholders for billing accounts and policies are provided, but wiite specifications.
?xml version="1.0" encoding="UTF-8"?>
SiteConfiguration xmlns="http://schemas.altair.com/pbs/2007/01/site-config"
xmlns:site-config="http://schemas.altair.com/pbs/2007/01/site-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://schemas.altair.com/pbs/2007/01/site-config ../schema
<Applications>
<Application id="PBSJobApp">
<ApplicationVersions/>
</Application>
</Applications>
<JobProjects id="BILLING_ACCOUNT"/>
<Policies/>
/SiteConfiguration>
C
9 plication Services Administrator’s Guide
9
H sions, billing accounts, and policies:
<
< g.xsd">
<
hapter 9 Application Definitions
4 PBS Ap
.4.1.2 Sample of a site configuration file
ere is an example of a site configuration file with modifications for site supported application ver
?xml version="1.0" encoding="UTF-8"?>
SiteConfiguration xmlns="http://schemas.altair.com/pbs/2007/01/site-config" xmlns:site-config="http://schemas.altair.com/pbs/2007/01/site-config" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.altair.com/pbs/2007/01/site-config ../schemas/site-confi <Applications> <Application id="PBSJobApp"> <ApplicationVersions/> </Application> <Application id="Optistruct"> <ApplicationVersions> <ApplicationVersion> <Option>8.0</Option> <Executable>/opt/hyperworks/11.0/altair/scripts/optistruct</Executable> </ApplicationVersion> <ApplicationVersion> <Option>9.0</Option> <Executable>/sw/optistruct9/optistruct</Executable> </ApplicationVersion> </Application> </Applications> <JobProjects id="BILLING_ACCOUNT"> <Option>Company1</Option> <Option>Company2</Option> </JobProjects> <Policies> <Policy> <Option>MAX_CPUS</Option> <Value>4</Value> </Policy> <Policy> <Option>MPIPROCS</Option> <Value>4</Value> </Policy> </Policies>
/SiteConfiguration>
Application Definitions Chapter 9
9.4.2 Using site configuration information in an application definition
For information on how to reference the site configuration file in an application definition see the tutorial “Allowing Multiple Versions of an Application”, and recipes “How to Configure and Use Billing Accounts” and “How to Configure and Use Site Policies” in Diving Into Application Definitions 12.1.
9.4.3 Site configuration file backup
Upon server start-up, PBS Application Services will validate the content of the site configura-tion file (section 9.4.4, “Site configuration file validation”, on page 96), and the content of application definitions (section 9.3.2, “Application definition validation”, on page 90):
If the content of both the site configuration file and application definitions is valid:
• The site configuration file will be backed up to a file called site-config.backup.
If the content of either the site configuration file or any application definition is invalid:
• The site configuration file will be backed up to a file called site-con-fig.YYYYMMDDMMSS where YYYYMMDDMMSS is the file cre-ation timestamp.
• The site configuration file will be restored from the last valid backup, site-con-fig.backup.
Up to five (5) backups will be maintained. All backup files will be maintained in the same directory as the site configuration file.
PBS Application Services Administrator’s Guide 95
Chapter 9 Application Definitions
9.4.4 Site configuration file validation
Upon server startup, PBS Application Services validates the site configuration file. It is vali-dated against its XML schema. An XML schema defines the legal building blocks of a partic-ular XML document. An XML schema:
• defines elements that can appear in a document
• defines attributes that can appear in a document
• defines which elements are child elements
• defines the order of child elements
• defines the number of child elements
• defines whether an element is empty or can include text
• defines data types for elements and attributes
• defines default and fixed values for elements and attributes
The validation process also determines if the content of the site configuration file is well-formed (valid). The content is well-formed if the following criteria is met:
It must have a root element.
• XML elements must have a closing tag.
• XML tags are case sensitive.
• XML elements must be properly nested.
• XML attribute values must be quoted.
96 PBS Application Services Administrator’s Guide
Chapter 10
Reserved wordsThe table below illustrates the reserved words used by PBS Application Services. The reserved words enable unification of application definitions and automatic rendering of GUIs based on these definitions.
The following list of reserved words are identified.
Table 10-1: PBS Application Services Reserved Words
Reserved Word Description
BILLING_ACCOUNT PBS Professional "account" attribute
CHUNK PBS Professional "requested chunks count" attribute
CPUTIME PBS Professional "cput" attribute
EXECUTABLE path to application executable
JOB_NAME PBS Professional "job_name" attribute
MASTER master file
MEMORY PBS Professional "mem" attribute
NCPUS PBS Professional "ncpus" attribute
PYTHON_PATH Python Interpreter
QUEUE PBS Professional "queue" attribute
SOFTWARE PBS Professional "software" attribute
PBS Application Services Administrator’s Guide 97
Chapter 10 Reserved words
SUBMISSION_DIRECTORY job submission directory
VERSION application version
VMEMORY PBS Professional "vmem" attribute
WALLTIME PBS Professional "walltime" attribute
Table 10-1: PBS Application Services Reserved Words
Reserved Word Description
98 PBS Application Services Administrator’s Guide
Chapter 11
Uninstalling PAS GUI modeStop the PAS service (see section 8.2, “Stopping the PAS service”, on page 84).
11.1 Starting the uninstaller
11.1.1 Linux
Navigate to the PBS Application Services execution directory. The execution directory for a typical installation of PAS is
/opt/altair/pas/12.1
Enter the following at the Linux/Unikx command line prompt (command must contain spaces with escape characters):
cd _PBS\ Application\ Services_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\ Application\ Services\ Installation -i swing
11.1.2 Windows
As the Windows Administrator navigate to Start > Control Panel > Programs and Fea-tures. Scroll down until you find the PBS Application Services application. Right-click the PBS Application Services application, and then click Uninstall/Change.
PBS Application Services Administrator’s Guide 99
Chapter 11 Uninstalling PAS GUI mode
11.2 Initiate the PAS uninstall process
Click Next to start the uninstall process.
100 PBS Application Services Administrator’s Guide
Uninstalling PAS GUI mode Chapter 11
11.3 Uninstall PBS Application Services
Click Uninstall to initiate the uninstallation process.
PBS Application Services Administrator’s Guide 101
Chapter 11 Uninstalling PAS GUI mode
11.4 Complete uninstall
A message is displayed once the uninstall process is complete. Any items that could not be removed will be listed. Please take a moment to manually remove them. To complete the uninstall, click Done.
102 PBS Application Services Administrator’s Guide
Chapter 12
Uninstalling PAS console modeStop the PAS service (see section 8.2, “Stopping the PAS service”, on page 84).
12.1 Starting the uninstaller
Navigate to the PBS Application Services execution directory. The execution directory for a typical installation of PAS is
/opt/altair/pas/12.1
Enter the following at the Linux/Unikx command line prompt (command must contain spaces with escape characters):
cd _PBS\ Application\ Services_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\ Application\ Services\ Installation
PBS Application Services Administrator’s Guide 103
Chapter 12 Uninstalling PAS console mode
12.2 Initiate the PAS uninstall process
Press <ENTER> to start the uninstall process.
12.3 Complete uninstall
A message will be displayed indicating the uninstall has begun. Once the uninstall is com-plete a message is displayed indicating any items that could not be removed will be listed. Please take a moment to manually remove them..
104 PBS Application Services Administrator’s Guide
Chapter 13
Troubleshooting
13.1 The package doesn’t match the OS
Question: I get a The package doesn’t match the OS error message, what do I do?
Answer: This error indicates that you are trying to use an installation binary or executable for a platform that does not match the operating system of the machine onto which you are trying to install PBS Application Services. For instance, you might have used the installation binary PBSAppSvcs_12.0_RHEL-6_x86_64_20130606_0725.bin to install PBS Application Ser-vices on a server that is running CentOS 6. Please download the installation binary/execut-able that matches your platform.
13.2 PBS Professional Server is not installed
Question: I get a PBS Professional Server is not installed warning message, what do I do?
Answer: The installation process has determined that PBS Professional is not installed. It is highly recommended to install PBS Professional prior to installing PBS Application Services. PBS Application Services can be installed without an existing installation of PBS Profes-sional, however some file operations functionality will not be available for jobs that are sub-mitted directly to PBS Professional via the command line.
PBS Application Services Administrator’s Guide 105
Chapter 13 Troubleshooting
13.3 Incompatible version of PBS Professional detected
Question: I get an Incompatible version of PBS Professional error message, what do I do?
Answer: The installer has detected that you are installing PBS Application Services with an incompatible version of PBS Professional. Currently, PBS Professional 11.1 and greater is supported. The installation cannot continue and will abort. Make sure you have PBS Profes-sional version 11.1 or greater installed. Execute the following PBS Professional command from a command prompt and look for the pbs_version attribute to determine which version of PBS Professional is installed:
qstat -Bf Server: hwesuse113-01 server_state = Active server_host = hwesuse113-01.prog.altair.com scheduling = True total_jobs = 1 state_count = Transit:0 Queued:1 Held:0 Waiting:-1 Running:1 Exiting:0 Begu n:0 managers = pbsadmin@* default_queue = workq log_events = 511 mail_from = adm query_other_jobs = True resources_default.ncpus = 1 default_chunk.ncpus = 1 resources_assigned.mem = 0mb resources_assigned.ncpus = 1 resources_assigned.nodect = 1 scheduler_iteration = 600 FLicenses = 3333332 resv_enable = True node_fail_requeue = 310 max_array_size = 10000 pbs_license_info = 6200@trlicsrv03 pbs_license_min = 1 pbs_license_max = 2147483647 pbs_license_linger_time = 31536000 license_count = Avail_Global:3333321 Avail_Local:11 Used:1 High_Use:12 Avai l_Sockets:0 Unused_Sockets:0 pbs_version = PBSPro_11.3.0.121703 eligible_time_enable = False job_history_enable = True job_history_duration = 14:00:00 max_concurrent_provision = 5
106 PBS Application Services Administrator’s Guide
Troubleshooting Chapter 13
13.4 Staging Directory is blank
Question: I get a Staging Directory is blank warning message, what do I do?
Answer: The staging directory is where the necessary files are transferred after job submis-sion, but prior to the portal submitting the job to PBS Application Services for transfer to PBS Professional for execution. This staging directory must exist for the installation to complete successfully. Please enter a pathname to an existing directory which will be designated as the PAS staging directory.
13.5 Could not detect “userid” (Linux/Unix)
Question: I get a Could not detect “userid” message, where “userid” is the PAS service user, what do I do?
Answer: This error condition will only occur on Linux/Unix platforms. The userid that was entered as the PAS service user is not an existing user account on the server where PAS is being installed. The PAS service user must be an existing account.
13.6 Could not connect Windows AD/DNS Server (Windows)
Question: I get a Could not connect Windows AD/DNS Server error message, what do I do?
Answer: On Windows platforms, the PAS installation process first checks the existence of the service account at the domain level. If it is unable to contact the Windows AD/DNS server, then this message will be displayed. Please verify that the AD/DNS server is up and running and that there are no network issues.
Secondly, if the service account does not exist at the domain level, then the installation pro-cess checks for its existence at the local level. If it does not exist at the local level, then the following message will be displayed Specified service user name does not exist - see section 13.7, “Specified service user name does not exist (Windows)”, on page 108
PBS Application Services Administrator’s Guide 107
Chapter 13 Troubleshooting
13.7 Specified service user name does not exist (Windows)
Question: I get a Specified service user name does not exist error message, what do I do?
Answer: The service account does not exist at either a domain or a local level for the userid entered. Verify that the service account has been created, or enter a different userid. Please refer to the information contained in section 6.1, “Configurable parameters”, on page 68 per-taining to the ADMIN_USER.
13.8 Password is required to continue (Windows)
Question: I get an Password is required to continue error message, what do I do?
Answer: You must enter the password of the PAS service user to proceed with the installa-tion.
13.9 PBS Professional installation appears to be incomplete
Question: I get a PBS Professional installation appears to be incomplete warning message, what do I do?
Answer: This error condition occurs when the <PBS_HOME>/server_priv/hooks directory is missing. This directory is created during the installation of PBS Professional. Please verify and correct the installation of PBS Professional. Once the issue is resolved, and an existing <PBS_HOME>/server_priv/hooks directory exists, copy the files located in <PAS_EXEC>/pas/unsupported/pbs-hooks to <PBS_HOME>/server_priv/hooks.
13.10 EIFL server ports in the default range is not available
Question: I get an EIFL server ports in the default range is not available error message, what do I do?
108 PBS Application Services Administrator’s Guide
Troubleshooting Chapter 13
Answer: The EIFL server requires at least 50 ports within the range of 18080-18180. If less than 50 ports are available, then this error condition occurs. At least 50 ports must be freed within the default range to install PAS.
13.11 PAS server port is not free for installing PAS service
Question: I get a PAS server port is not free for installing PAS service error message, what do I do?
Answer: The default port used to communicate with PAS is 17084 (PAS release 11.1). As of the 12.0 release, the port will be selected dynamically during installation. If port 17084 is not available, then the installation process will increment the port number by one until an avail-able port is found. If an available port is not found after 100 attempts, the installation process will request the administrator to enter a port.
13.12 Specified port # is not a valid value
Question: I get a Specified port number is not a valid value error message, what do I do?
Answer: The installation process was unable to find an available port for PAS (see section 13.11, “PAS server port is not free for installing PAS service”, on page 109). Please enter a free port number to be used for communication with PAS within the range 1-65535.
13.13 The PAS server IP/port number is blank
Question: I get a PAS server IP/port number is blank error message, what do I do?
Answer: This error condition will only occur during installation of PAS Commands Only. The server name and port number where PAS is installed must be provided.
13.14 PAS Service was unable to start
Question: I get a PAS Service was unable to start error message, what do I do?
Answer: An error occurred while starting PAS. Review the PAS log file for errors (see Chap-ter 7, "Log files", on page 81) and contact system support.
PBS Application Services Administrator’s Guide 109
Chapter 13 Troubleshooting
13.15 PAS Service was unable to install
Question: I get a PAS Service was unable to install error message, what do I do?
Answer: An error occurred while installing PAS. Review the PAS installation log file for errors (see Chapter 7, "Log files", on page 81) and contact system support.
13.16 Installer not running as root/admin user
Question: I get an Installer not running as root/admin user error message, what do I do?
Answer: Ensure that you are installing PBS Application Services as root on Linux/Unix plat-forms or as an administrative user on Windows platforms.
13.17 Existing instance of Python found (Windows)
Question: I get an Existing instance of Python found error message, as shown below, what do I do?
Answer: On Windows platforms, uninstall the existing Python installation and restart the PBS Application Services installation.
13.18 License server information not provided
Question: I get a License server information not provided warning message, as shown below, what do I do?
Answer: You may install PBS Application Services without supplying a license server during installation time. You may later configure the license server. Please refer to the information contained in the section 6.1, “Configurable parameters”, on page 68 pertaining to the ALTAIR_LICENSE_PATH.
110 PBS Application Services Administrator’s Guide
Troubleshooting Chapter 13
13.19 Manage Instances
Question: After launching the installer I get the following message:
What do I do?
Answer: An instance of PAS is still installed. You must uninstall any previously installed versions of PAS, before installing a new version of PAS.
To uninstall the existing instance of PAS, choose Modify an Existing Instance and click OK. The uninstallation process will initiate. Once the uninstall is complete, you will need to launch the installer a second time to install PAS.
If after uninstalling PAS this error persists, view the contents of the hidden file .com.zerog.registry.xml. On Linux/Unix platforms, this file will be located in the following directory:
/var
On Windows platforms, this file will be located in:
C:\Program Files\Zero G Registry
PBS Application Services Administrator’s Guide 111
Chapter 13 Troubleshooting
Whenever an Altair product is installed on a machine, the installation process appends infor-mation to this file. View the contents of this file for any existing installations of PAS. The following example shows an installation of PAS that is located at /opt/altair/pas2/12.0.
Navigate to the installation location and uninstall PAS - see Chapter 11, "Uninstalling PAS GUI mode", on page 99 or Chapter 12, "Uninstalling PAS console mode", on page 103.
If the installation location does not exist, or after launching the uninstall process, it is unable to complete successfully, edit the .com.zerog.registry.xml file. Remove all <prod-ucts> references of “PBS Application Services. For example:
Also remove any <component> references having the same installation location (loca-tion=”<INSTALL_LOC>”). For example:
<product name="PBS Application Services" id="c42daab7-1f0c-11b2-a949-8b152e999552" version="12.0.0.0" copyright="2012" info_url="" support_url="" location="/opt/altair/pas2/12.0" last_modified="2013-06-04 12:27:15">
<products>
<product name="PBS Application Services" ................. location="<INSTALL_LOC>"..................>
......
......
......
</product>
</products>
<components>
<component id=...........location="<INSTALL_LOC>/jre">
<component id=...........location="<INSTALL_LOC>/pas.conf.unix"/>
<component id=...........location="<INSTALL_LOC>/_PBS Application Services_installation/Change PBS Application Services Installation"/>
......
......
......
</component>
</components>
112 PBS Application Services Administrator’s Guide
Troubleshooting Chapter 13
Launch the install process again. The Manage Instances message should not be displayed again.
13.20 Out of Memory Errors
Question: There are OutOfMemoryErrors in the PAS server log what do I do?
Answer: You may need to adjust the Java Virtual Machine (JVM) heap size of PAS. See sec-tion 6.4, “Configuring JVM Performance”, on page 80. Out of memory errors can indicate a underlying problem, therefore it is recommended to report these errors to PAS system support.
13.21 IOException: No such file or directory
Question: Our site has implemented load balancing for PBS Works. The following error is showing up in the PAS server log, what do I do?
ERROR gw.aif.pbs.admin.resources.ApplicationsResources (ApplicationsResources.java:210) - IOException java.io.IOException: No such file or directory
Answer: Edit the PAS server configuration file, server.conf, and add the following entry:
Restart the PAS service.
SERVER_ROLE_SECONDARY=true
PBS Application Services Administrator’s Guide 113
Chapter 13 Troubleshooting
114 PBS Application Services Administrator’s Guide
IndexPPBSA service commands 85
restarting web application 85status of web application 85
pbsworks-pbsa 85
Rrestarting web application 85
Sstatus of web 85
PBS Application Services Administrator’s Guide 115
Index
116 PBS Application Services Administrator’s Guide