+ All Categories
Home > Documents > Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2...

Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2...

Date post: 28-Jun-2018
Category:
Upload: vuongminh
View: 225 times
Download: 0 times
Share this document with a friend
74
PBS Works is a brand of Results Visualization Service Administrator’s Guide
Transcript
Page 1: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

PBS Works is a brand of

Results Visualization Service

Administrator’s Guide

Page 2: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Intellectual Property Rights Notice: Copyrights, Trademarks, and Third Party Licenses

Updated: July 21, 2017.

Altair® PBS Works™ 13.2Enabling On-Demand Computing™Copyright© 1994-2017 Altair Engineering Inc. All Rights Reserved.

Altair PBS Works™: Compute Manager™ ©2012-2017; Display Manager™ ©2013-2017; PBS Pro™ ©1994-2017; PBSProfessional® ©1994-2017; PBS Application Services™ ©2008-2017; PBS Analytics™ ©2008-2016;PBS Desktop™ ©2008-2012; and e-Compute™ ©2000-2010.

HyperWorks® Products: HyperMesh® ©1990-2017; HyperCrash® ©2001-2017; OptiStruct® ©1996-2017; RADIOSS® ©1986-2017; HyperView® ©1999-2017; HyperView Player® ©2001-2017; HyperMath® ©2007-2017; HyperStudy® ©1999-2017; HyperGraph® ©1995-2017; MotionView® ©1993-2017; MotionSolve® ©2002-2017; HyperForm® ©1998-2017; HyperXtrude® ©1999- 2017; Process Manager™ ©2003-2016; Templex™ ©1990-2017; TextView™ ©1996-2017; MediaView™ ©1999-2017; TableView™ ©2013-2017; BatchMesher™ ©2003-2017; HyperWeld® ©2009-2017; HyperMold® ©2009-2017; Manufacturing Solutions™ ©2005-2017; solidThinking Inspire® 2017 ©2009-2017; solidThinking Evolve®2017 ©1993-2017; Durability Director™ ©2009-2017; Suspension Director™ ©2009-2017; AcuSolve® ©1997-2017; AcuConsole® ©2006-2017; SimLab® ©2004-2017; Virtual Wind Tunnel™ ©2012-2017; FEKO® (©1999-2014 Altair Development S.A. (Pty) Ltd.; ©2014-2017 Altair Engineering, Inc.); ConnectMe™ ©2014-2017; Click2Extrude™ Polymer 2017 ©1996-2017; Click2Extrude™ Metal 2017 ©1996-2017; Click2Form™ 2017 ©1998-2017.

Additional Altair Products: Multiscale Designer™ ©2011-2017; Flux v.12.2 ©1983-2017; InCa3D v.3.1©1996-2016; CDE v.2  ©2012-2016; Got-It v.3  ©2002-2016; WinProp v.14.5 ©2000-2017

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

ii

Page 3: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Altair Packaged Solution Offerings (PSOs): Automated Reporting Director™ ©2008-2017; GeoMechanics Director ©2011-2017; Impact Simulation Director™ ©2010-2017; Model Mesher Director™ ©2010-2017; Model Verification Director™ ©2013-2017; NVH Director™ ©2010-2017; Squeak and Rattle Director™ ©2012-2017; Virtual Gauge Director™ ©2012-2017; Weight Analytics™ ©2013-2017; Weld Certification Director™ ©2014-2017; Multi-Disciplinary Optimization™ ©2012-2017.

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

Software products of solidThinking, Inc., a wholly owned subsidiary of Altair Engineering:solidThinking Inspire® 2017 ©2009-2017; solidThinking Evolve®2017 ©1993-2017; solidThinking Compose® 2017 ©2007-2017, solidThinking Activate® 2017 ©1989-2017, solidThinking Embed® 2017 ©1989-2017, solidThinking Embed® SE 2017 ©1989-2017; Click2Extrude™ Metal 2017 ©1996-2017; Click2Extrude™ Polymer 2017 ©1996-2017; Click2Cast® 4.0 ©2011-2017; Click2Form™ 2017 ©1998-2017; Envision® 4.0 ©2013-2017.

Altair intellectual property rights are protected under U.S. and international laws and treaties. Additionally, Altair software is protected under patent #6,859,792 and other patents pending. All other marks are the property of their respective owners.

ALTAIR ENGINEERING INC. Proprietary and Confidential. Contains Trade Secret Information.

Not for use or disclosure outside of Altair and its licensed clients. Information contained in Altair software shall not be decompiled, disassembled, “unlocked”, reverse translated, reverse engineered, or publicly displayed or publicly performed in any manner. Usage of the software is only as explicitly permitted in the end user software license agreement. Copyright notice does not imply publication.

Third party software licenses

AcuConsole contains material licensed from Intelligent Light (www.ilight.com) andused by permission.

iii

Page 4: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Software Security Measures:

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

Technical Support

This document is proprietary information of Altair Engineering, Inc.

Location Telephone e-mail

China +86 (0)21 6117 1666 [email protected] +33 (0)1 4133 0992 [email protected] +49 (0)7031 6208 22 [email protected] +91 80 66 29 4500 [email protected] +39 800 905595 [email protected] +81 3 5396 2881 [email protected] +82 70 4050 9200 [email protected] America +1 248 614 2425 [email protected] +46 (0) 46 460 2828 [email protected] +44 (0)1926 468 600 [email protected]

iv

Page 5: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Contents

About this Guide vii

Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiRelated Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiDocument Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiAcronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Introduction to Results Visualization Service 1

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Overview of the Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Software Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Selecting a RVS Deployment Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Deployment Option One . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Deployment Option Two . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Deployment Option Three . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Deployment Option Four . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Performance and Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Installation and Configuration of RVS 11

Installing Results Visualization Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Minimum Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Recommended Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Installation Media Download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Installing Results Visualization Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Console Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Configuring RVS for HyperWorks 14.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Configuring Results Visualization Server with Compute Manager . . . . . . . . . . . . . . . . . . . . 25Configurations on PAS Server (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Configuring RVS for SSL Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Configuring RVS Result File Formats to View and Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Technical Advisory Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Setting Permissions for Users to Access RVS on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Setting up Mapped Drives on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Impersonation Checklist on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

v

Page 6: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Starting, Stopping and Restarting RVS 31

Server Tuning Recommendations 33

Configurations on Results Visualization Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Configurations on Compute Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Making Job Directories Available to RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Configuring Solver Log File Readers 39

RVS Data Cleanup Criteria Settings 41

Supported Result File Types 43

Uninstalling Results Visualization Service 47

Starting the Uninstaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Troubleshooting RVS 53

Locating RVS log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53RVS Troubleshooting Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Preparing Web Browsers for RVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Common Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Unable to start RVS or perform RVS operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56View Option is Unavailable in the Context Menu for Plot or Animation . . . . . . . . . . . . . . . . . . . 57Plot generation fails with Number format error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Unable extract TOC Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58HyperMath Execution Error: HW_APP_FAILED Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Known Issues 61

Licensing 63

vi Contents

Page 7: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

About this Guide

This document describes how to install, configure and administer PBS Works.

This chapter contains the following topics:• Audience• Related Documentation• Document Conventions• Acronyms

AudienceThis document is intended for administrators who perform the following tasks:

• Install and administer PBS Works products• Monitor the operation of PBS Works products• Troubleshoot PBS Works products

Related DocumentationThe other PBS Works related documents are as follows:

• PBS Works Installation Guide• PBS Works Administrator’s Guide• PBS Works Release Notes• Compute Manager Administrator’s Guide• Display Manager Administrator’s Guide• Results Visualization Service Administrator’s Guide

Documentation can be found at the following URL:

http://www.pbsworks.com/SupportGT.aspx?d=PBS-Professional,-Documentation

vii

Page 8: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Document ConventionsThe following typographical conventions are used in this document:

PBS Works Home Directory

CONFIG_HOME is where the PBS Works configuration and log files are stored. The location of this directory is platform dependent. For more information see Software Organization on page 4.

For example:

config.properties is stored in CONFIG_HOME\services\cm\config

PBS Works Execution Directory

SERVER_HOME is where the PBS Works binaries are stored. The location of this directory is platform dependent. For more information see Software Organization on page 4.

For example:

PBSWorksService.bat is stored in SERVER_HOME\scripts\

RVS Installation Location

RVS SERVER_HOME is the location in a file system where RVS is installed. It is used when referencing a file that may need to be accessed or viewed by a systems administrator. For more information see Software Organization on page 4. For example:

RVS SERVER_HOME/rvs/log/HWE_RM_Log.txt

File Pathname

Names of a file or a directory are displayed as follows:

/home/user1/submission_dir/PBSJobApp/174.hwesuse113.oe

Keyboard Inputs

Keyboard inputs, for example commands that are entered are displayed as follows:

./etc/init.d/pbsworks-pbsa start

Code Example and File Contents

viii

Page 9: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Examples of programming code or the contents of a file are displayed as follows:

Parameters, Environment Variables, XML tags

Environment variables, XML tags, parameters, and references to a snippet of a file are displayed as follows:

Set the value of the MaxBackupIndex parameter to the maximum number of log files to keep.

UI Controls

User Interface controls such as command buttons, tab names, menu options, application fields, or items in a list are displayed as follows:

Click the Settings button.

Document References

References to an external document are displayed as follows:

For more information see the PBS Works 13.1 Administrator’s Guide.

Messages

Log file messages or messages returned from a command are displayed as follows:Please make sure PBSA engine and Monetdb Server are not running.

Notes

Information or notes that supplement or emphasize important points are displayed as follows:

Tips

Tips that makes your work easier are displayed as follows:

if userInputs['ACCOUNT']:

job.attr_accounting_label =userInputs['ACCOUNT']

The default TOC type for a result file is set in the plugin_def.xml file

If you get an error during registration of the HyperView Player, right click on the shortcut and choose the Run as Administrator option from the context menu.

ix

Page 10: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Cautions

Cautions draw special attention to any action that could cause damage to the product or cause the loss of data. For example:

AcronymsThe following acronyms are used in this guide.

Do not turn the monitor off by unplugging it from the computer or wall socket. Severe damage to the monitor may result. Turn the monitor off before unplugging it.

Table 1. Acronyms

Terms DefinitionsCAD Computational Fluid DynamicsCAE Computer Aided EngineeringCM Compute ManagerDM Display ManagerESR Extended Support ReleaseFEA Finite Element AnalysisHMath HyperMathHVP HyperView PlayerHW Hyper WorksHWU HyperWorks UnitMBD Multi Body DynamicsMOM Machine Oriented MiniserverPAS PBS Application ServicePBS Portable Batch SystemRVS Results Visualization ServiceSSL Secure Sockets LayerTOC Table Of Contents

x

Page 11: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

1. Introduction to Results Visualization Service

IntroductionResults Visualization Service (RVS) provides features to access, process and visualize CAE results from anywhere, without installing any post-processing desktop applications through the user friendly web interface of Compute Manager and Simulation Manager. CAE analysts can monitor simulations in real-time by tracking and visualizing relevant parameters from solver log files. Meaningful plots and animations can also be created remotely without downloading huge raw results files from compute clusters or remote networks locations. A variety of FEA and MBD solv-ers are supported. Refer to the Supported Result File Types for further information.

1

Page 12: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

The Altair HyperView Player plugin used by RVS is available at the download area of Compute Manager and PBS Works.

Overview of the GuideThis guide provides relevant information for the administrator in installing and configuring Results Visualization Service (RVS).The following topics are covered in the guide.

• Installation and Configuration of RVS• Starting, Stopping and Restarting RVS• Server Tuning Recommendations• RVS Data Cleanup Criteria Settings• Supported Result File Types• Troubleshooting RVS• Known Issues• Licensing

This section describes the following:• System Requirements• The advantages and disadvantages of the four deployment options available for RVS• Performance and scaling • Installing RVS

System RequirementsSupported Server Platforms

• Architecture: Only the 64-bit (x86_64) platforms are supported

Supported Operating Systems• Windows Server 2012 R2• Red Hat Enterprise Linux version 6.X• SUSE Linux Enterprise Server version 11.0 and later• CentOS version 6.X and later

2 Introduction to Results Visualization Service

Page 13: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Supported Browsers• Internet Explorer version 11 • Mozilla Firefox ESR (Extended Support Release) version 45.0 • Google Chrome: version 43.0

Minimum System Requirements• RAM: 16 GB • CPU: A Quad Core Processor @ 2.5 GHz• Disk Space: 10 GB temporary space for the installer

Recommended System Requirements• RAM: 24 GB • CPU: A Quad Core Processor @ 3.1 GHz• Disk Space: 12 GB temporary space for Enterprise Foundation and Applications

HyperWorks version 14.0 should be installed and available for many features of PBS Works appli-cations and services. For Linux Virtual Machines, HyperWorks version 14.0 is required to parse supported CAD/CAE file types. For more details, refer to Configuring RVS for HyperWorks 14.0.

NPAPI plugins (HyperView Player Plugin for RVS) are not supported from Chrome version 44.0 and Mozilla Firefox ESR 45.

RVS requires good network connectivity to all the connected file servers such as PAS server and job execution hosts. A minimum speed of 100mbps is required while a speed of 1gbps is recommended.

Introduction to Results Visualization Service 3

Page 14: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Software OrganizationAfter a successful installation of PBS Works, two main directory structures are created. The loca-tion of these directories is platform dependent.

PBS Works home directory (CONFIG_HOME)

This is where the PBS Works configuration and log files are stored.

The default location for CONFIG_HOME is:

on Windows: C:\altair\pbsworks\13.2

on Linux: /var/spool\pbsworks/13.2

PBS Works execution directory (SERVER_HOME)

This is where the PBS Works binaries are stored.

The default location for SERVER_HOME is:

on Windows: C:\altair\pbsworks\13.2\exec

on Linux: /opt/altair/pbsworks/13.2/exec

RVS execution directory (RVS SERVER_HOME)

This is where the RVS binaries, configuration, and log files are stored.

The default location for RVS SERVER_HOME is:

on Windows: C:\altair\rvs\13.2\exec

on Linux: /opt/altair/rvs/13.2\exec

4 Introduction to Results Visualization Service

Page 15: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Selecting a RVS Deployment OptionThe diagrams below depict deployment options for RVS with Compute Manager (CM) and PBS Professional Application Services (PAS).

Refer to Minimum System Requirements and Recommended System Requirements for more information to plan your deployment.

Deployment Option OneAdvantages

• This deployment option provides better performance since there is no file copy required from PAS staging directory to RV Server.

Disadvantages• High availability of computing resources on the PBS head node is required. High depen-

dency since RVS performance affects PBS server.

Server - A: CM

Server - B: PAS, Altair HyperWorks and RVS

Introduction to Results Visualization Service 5

Page 16: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Deployment Option TwoAdvantages

• In this deployment option, there is no file transfer from PAS staging directory to RV Server, therefore the performance is better.

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

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

Server A: - Everything is installed in one machine.

To configure RVS and CM on the same machine, follow the steps below:1. Install CM and start the service.2. Install RVS.

The installer will detect if CM is installed in the same machine and assign a different port for RVS.

6 Introduction to Results Visualization Service

Page 17: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Deployment Option ThreeAdvantages

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

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

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

Server - A: CM and PAS are installed.

Server - B: Altair HyperWorks and RVS are installed.

Introduction to Results Visualization Service 7

Page 18: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Deployment Option FourAdvantages

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

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

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

• High investment and maintenance costs

Server- A: PAS is installed.

Server- B: CM is installed.

Server- C: RVS and Altair HyperWorks are installed.

8 Introduction to Results Visualization Service

Page 19: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Performance and ScalingPerformance of RVS depends on many factors such as server hardware resources, typical file size, data composition and accessibility of result files from the server. Other key factors such as network bandwidth and speed, file server I/O performance and number of concurrent users also influence the overall performance of the system. Generally, performance of such systems are measured in terms of average response time offered by the system under typical loading condition, i.e. fre-quently used plot and animation requests for a certain number of concurrent users.

For reference purposes, the table below shows the average response time (sec) of a test system. The tests were performed using a typical data set distribution, for 10, 20 and 30 concurrent users and for different level of file accessibility ranging from locally accessible to network copy over 100 MB shared network connection

CategoryResult Types

Sub Cases

Time Steps

Full TOC Size (MB)

File Size (GB)

Load Distribution

(%)Small 2 1 101 0.4 0.5 20Medium 4 1 651 0.5 1.3 30Large 2808 72 182 0.8 0.9 40Very large 8505 81 3601 3.6 21 10

Introduction to Results Visualization Service 9

Page 20: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Please note that the values shown here are indicative and for reference purposes only. They do not guarantee a complete agreement and are not binding.

RVS scales linearly with the server hardware resources (CPU and RAM) up to a certain number of users but to serve more than fifty concurrent users, it is advisable to switch to a load balancing configuration. Load balancing configuration additionally provides some fail safe functionality, thereby minimizing the risk of service failure or request denial. For more information on this con-figuration and set up, please contact your Altair representative.

10 Introduction to Results Visualization Service

Page 21: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

2. Installation and Configuration of RVS

Installing Results Visualization ServiceThis section describes the following:

• Minimum Requirements• Recommended Requirements• Installation Media Download• Installing Results Visualization Service

Minimum Requirements1. Altair HyperWorks 14.0 must be installed

a. The HyperWorks installation should not be in /root or any user's-home directory.b. It should be installed in a location where all users have read and write permissions.c. Refer to the HyperWorks installation guide for more details on how to install it.d. Installation of RVS must be performed as root or Administrator user

2. Compute Manager must be installed,a. It is recommended to install CM and RVS in different locations.b. After the RVS installation, you must configure RVS with CM to communicate and

share the files with CM. For more information, refer to Configuring Results Visualiza-tion Server with Compute Manager.

c. RVS url (http://<RVSHost>:Port) must be directly accessible from the connecting web clients. To make job directories available to RVS, refer to Configuring Results Visual-ization Server with Compute Manager.

Recommended Requirements1. To avoid copying result files from job execution host to RVS, all execution hosts job scratch

directories should be directly accessible from RVS. For more information, refer to the sec-tion Making Job Directories Available to RVS.

11

Page 22: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

2. To avoid file copy, the file location should be directly accessible to RVS. PAS staging direc-tory and job output directories (such as users home or project directories) should be mounted on RVS.

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

4. Compute Manager should be installed and configured after the RVS installation

Refer to the Technical Advisory Notes section for:1. Setting permissions for users to access RVS in Windows. 2. Setting up mapped drive locations on Windows when HyperWorks or Workspace is on a

different location than RVS3. Setting up impersonation on Windows based installations.

Installation Media DownloadRVS is available as an option in the PBS Works 13.2 installer.

Download the installer from the client center section of the Altair website.

Installing Results Visualization ServiceLocate the PBS Works 13.2 Installer file.

On Windows: Right click on the file and select the Run as administrator option.

On Linux: Invoke the installer from the Administrator console.

The method of installation is identical in the Windows and Linux plat-forms.

12 Installation and Configuration of RVS

Page 23: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

The Installer will extract the files to prepare the installation and the welcome screen is displayed.

Installation and Configuration of RVS 13

Page 24: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

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

14 Installation and Configuration of RVS

Page 25: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Scroll down and accept the License Agreement to proceed with the installation.

Installation and Configuration of RVS 15

Page 26: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Choose the Custom Install option.

16 Installation and Configuration of RVS

Page 27: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

In the next screen, select the Results Visualization Service option.

Installation and Configuration of RVS 17

Page 28: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Provide the Hostname or IP Address and Port of the Database used by PBS Works. RVS uses this database information for data persistence.

18 Installation and Configuration of RVS

Page 29: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Choose the folder where you want RVS to be installed. We recommend you to install RVS in a sep-arate machine. In Windows, the binaries install location path is C:\altair\pbsworks\13.2\rvs and config install location is C:\altair\pbsworks\13.2\rvsIn Linux, the binaries install location path is /opt/altair/pbsworks/13.2 and config install location is /var/spool/pbsworks/13.2

Installation and Configuration of RVS 19

Page 30: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Provide the HyperWorks license server IP address. RVS will use HyperWorks tools to generate plots and animations.

You can enter multiple license server IP addresses (if required) by using a semi colon (;) to separate each location. In Linux, use colon (:) as the separator to specify multiple license server IP addresses.

20 Installation and Configuration of RVS

Page 31: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

For installing RVS, provide the location of the HyperWorks Installation folder.

Installation and Configuration of RVS 21

Page 32: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Provide the Hostname or IP Address of the PAS (PBS Application Services) Server.

22 Installation and Configuration of RVS

Page 33: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

The installer will display a summary of your choices. You can go back to make any changes if required. Check the details of the choices you have made and click Install.

Installation and Configuration of RVS 23

Page 34: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

On completion, the installer will display the Installation Directory, Host and Port.

Console InstallationThe same steps described above can be executed from the console/command prompt for a console installation. To perform a console installation:

1. Open the console (command prompt) and type <Installer_Name> -i console

2. Follow the steps prompted in the console

24 Installation and Configuration of RVS

Page 35: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Configuring RVS for HyperWorks 14.0To use RVS with HyperWorks 14.0, perform the following steps after installation.

1. Navigate to the following location<HyperWorks Install Folder>/altair/scripts/

2. Verify on the availability of a soft link (symbolic link) for hmathserv 3. Navigate to the following location in the RV Server

RVS SERVER_HOME/rvs/config and open the site-config.xml file in a text editor.

4. In the site-config.xml file, the location for HyperWorks 14.0 should be specified properly.

Configuring Results Visualization Server with Compute ManagerAfter installing Results Visualization Service and Compute Manager, RVS must be configured to communicate and share files with CM.

To perform this configuration, you must know, the PAS Server Name registered with CM and the RVS Service URL.

1. Open file, rm_servers.xml from the RVS Server location (CONFIG_HOME \services\rm\con-fig\rm_servers.xml) and then make the following changes.

2. Specify the RVS Server url (for example: http://<RVSHost>:Port). and enable the PAS Server as 'True' in the following code:.<RVSServerURL>http://<RVSHost>:Port</RVSServerURL>

<PASServers isConfigured="true">

Installation and Configuration of RVS 25

Page 36: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

3. Specify the values for the following in the code given below:• PAS Server Name registered with CM• RVS Service location• Is the stage directory of the PAS is mapped to the RVS server • Is the scratch directories of all the PBS MOMs (execution hosts) are mapped to the RVS

server.<Server name="PAS110" rmServiceBaseURL="http://RVS service location:port" isPASStageMappedToRM="true" isPASScratchMappedToRM="true" />

4. Open file_servers.xml.5. Specify the PAS Server Host Name, port number, and PAS server value in the following

code. <FileServer hostName="blrvm6-cenos63-epm" port="17084" isSameNetwork="false" />

6. Restart the RVS service.INSTALL_FOLDER /home/services/rm/config#/etc/init.d/pbsworks restart

The value of isPASStageMappedToRM and isPASScratchMappedToRM should be "true" when PAS and RVS are installed on the same node or RVS data directory is mounted on to the system where PAS is installed.In all other situations, the value is “false”.

If PAS and RVS are on same server, then the command, isSameNet-work is ‘True’.

26 Installation and Configuration of RVS

Page 37: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Configurations on PAS Server (Optional)The example below describes how to configure PAS application definition to copy pre-defined plot and animation templates to job execution directory when a job starts.

Let us assume that a predefined result template, Template1.rvst need to be copied to the job exe-cution directory whenever an Optistruct job starts. The screenshot below shows the SolverOptis-truct application definition directory structure.

Follow these steps to configure PAS application definition.1. Stop PAS and copy the template files to "runtime" directory of application definition.2. Edit the start.py file to include the copy statements as shown below:

import shutil

shutil.copyfile("runtime/Template1.rvst", " Template1.rvst");

3. Start PAS. For information on how to start and stop PAS, please refer to the PAS User Guide or contact the PBS Administrator.Now, whenever a new job is submitted for the Optistruct solver, the template files will be automatically copied over to the job execution directory.

Installation and Configuration of RVS 27

Page 38: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Configuring RVS for SSL ModeA secure connection between core RVS Server to RVS client, can be enabled using the server.xml file.

The location of the file for a typical installation of RVS is:

On Windows and Linux:CONFIG_HOME\services\rm\config\rm_servers.xml

To enable SSL service:1. Add the following code with appropriate key store path and password in server.xml file.

<Connector SSLEnabled="true" clientAuth="false" keystoreFile<serverlocal-path>\rvskeystore" keystorePass=**** maxThreads="150" port="8443" proto-col="HTTP/1.1" scheme="https" secure="true" sslProtocol="TLS"/>

2. Restart the service in the core RVS Server to enable the secure communication between core RVS Server and RVS client.

Configuring RVS Result File Formats to View and Edit By default, the double click action for RVS supported files are configured to open the Table of Contents of the file. With following the steps, you can configure the double click action to open the result file to view and edit.

For more information, refer to the section Supported Result File Types.

You can include the file formats in “cmPatterns” plugin to view and edit the RVS result file data.

To include file formats in "cmPatterns" of the plugin.js:1. Navigate to the following location:

SERVER_HOME/applications/cm/plugins/rm/binaries/ui/plugin.js

2. Add file extensions in CM variable.For example, cmPatterns = ["txt", "dat", "out","log"];

28 Installation and Configuration of RVS

Page 39: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Technical Advisory NotesThis section provides information on configuring RVS on Windows.

Setting Permissions for Users to Access RVS on WindowsIf users do not have administrative privileges on the RVS server, then they have to be given full control permissions to the location where RVS data is available.

Follow these steps for this configuration:1. Check if the user who is requesting for results through RVS is existing on the RVS server. If

the user does not exist, create an account for the user.2. Check if the data directory exists in the RVS installation folder. Create this directory if it

does not exist in the following location: RVS SERVER_HOME\rvs\data3. Provide Full Access Control to the data directory for the users requesting for results

through RVS.

Setting up Mapped Drives on WindowsOn Windows, when HyperWorks or the workspace is on a different location than the RVS server, the drives need to be mapped and linked to RVS. Perform the following configurations to create the links for mapped locations.

1. Create the link for the mapped drive. e.g. mklink /D C:\myLink \\127.0.0.1\c$2. RVS users should be present on the shared system and the mapped system.3. Provide the mapped or linked location in RVS4. Restart RVS

Impersonation Checklist on WindowsThe user who is running the RVS service should have these privileges for impersonation:

1. SeCreateTokenPrivilege2. SeAssignPrimaryTokenPrivilege3. SeServiceLogOnRight4. SeTcbPrivilege

Installation and Configuration of RVS 29

Page 40: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

30 Installation and Configuration of RVS

Page 41: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

3. Starting, Stopping and Restarting RVS

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

Starting RVS• At the Windows command line enter:

RVS SERVER_HOME/scripts/RVservice.bat start

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

Checking the Status of RVS• At the Windows command line enter

RVS SERVER_HOME/scripts/RVservice.bat status

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

Stopping RVS• At the Windows command line enter

RVS SERVER_HOME/scripts/RVservice.bat stop

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

Restarting RVS• At the Windows command line enter

RVS SERVER_HOME/scripts/RVservice.bat restart

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

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

31

Page 42: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

32 Starting, Stopping and Restarting RVS

Page 43: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

4. Server Tuning Recommendations

This section describes the main parameters that can be modified in the RVS server and CM server for optimum performance.

Configurations on Results Visualization ServerThe main configurations for improving RVS performance are provided in the table below. The important parameters, their default values and the location of the configuration file which con-tains the parameters is displayed below.

Parameters Default Values File PathCATALINA_OPTS (JVM Max)This parameter is used to start the server with a maximum memory heap size

512 MB (upto 30 concur-rent users load)e.g. (-Xms512m -Xmx-512m -XX:+UseCon-cMarkSweepGC -XX:+PrintGCDetails)

On Windows:RVS SERVER_HOME\script\rvser-vices.batOn Linux:RVS SERVER_HOME/scripts/server-start.sh

33

Page 44: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

TOC sizeSpecify the TOC max size limit in bytes. Helps to send the par-tial TOC (bytes)

2097152 (In bytes) RVS SERVER_HOME\rvs\con-fig\site_config.xml

Cache enabledEnable or disable data caching for RVS on the server

true

Session defaultTimeout - is the maximum amount of time the server should wait for a response from another appli-cation before disconnecting.

6000 milliseconds

Operation defaultTimeout - is the maximum amount of time the server should wait before closing an old connec-tion and creating a new con-nection.

6000 milliseconds

Socket timeout for HMath 6000 milliseconds RVS SERVER_HOME\rvs\plugins\hypermath_application \plugin_def.xml

Connection timeout for HMath

6000 milliseconds

Request timeout for PBS datasource

6000 milliseconds RVS SERVER_HOME\rvs\plugins\ pbs_datasource_han-dler\plugin_def.xmlConnection timeout for PBS

datasource6000 milliseconds

Idle timeout for PBS data-source

21600 milliseconds

Parameters Default Values File Path

34 Server Tuning Recommendations

Page 45: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Configurations on Compute ManagerThe table below provides the main parameters related to RVS in the CM server. The default value of the parameters and the location of the files in which these settings are stored are listed in the table.

Making Job Directories Available to RVSFor better performance and to avoid copying huge result files from job execution hosts to RVS, it is recommended that PBS Professional job sandboxes (i.e. see $jobdir attribute in the PBS Profes-sional Administrator's Guide) from all execution hosts are made directly accessible to RVS. If the file system hosting these job directories is not already mounted on RVS, it can be configured using NFS and automounter following the example given below.

As the proposed configuration has potential security implications with regards to file accessibility by unwanted parties, it is recommended that resulting file accessibility is tested against whatever security policy is applied for jobs submitted through CM and PBS Professional.

Let's consider a scenario of two execution hosts node03 and node04.

On each execution host (MOM in PBS terminology), please do following steps.1. Create a local (physical) directory /scratch on the host2. Create a directory /scr3. Edit the file /etc/auto.pbs to include all execution hosts as below.

node04 -fstype=nfs node04:/scratch

Parameter Description Default Value File path and Parameter Examples

Maximum H3D file size supported in browser

26214400 (bytes) CONFIG_HOME/services/rm/config/ con-fig.properties(maxH3DFileSize=26214400)

Setting default log levels

INFO CONFIG_HOME/services/rm/config/log4j.propertieslog4j.rootCategory=INFO,ActivityLogger log4j.logger.ActivityLog-ger=INFO, activityLogAppender

These instructions are valid only for Linux/Unix set up.

Server Tuning Recommendations 35

Page 46: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

node03 -fstype=nfs node03:/scratch

Above lines define mount names and destinations. This information will be used by auto-mounter to create specific mount points.

4. Edit the file /etc/auto.master to include following line/scr/etc/auto.pbs --ghost

This line specifies that automounter should create mount points for each directory speci-fied in the /etc/auto.pbs file and add a prefix /scr to it. So in this case, two mount points will be created /scr/node03 pointing to node03 /scratch directory and

/scr/node04 pointing to the node04 /scratch directory.

5. Edit the file /etc/exports to add below line for allowing other machines to be able to mount /scratch directory from this host. /scratch Subnet_IP/24 (rw,async,no_root_squash)

6. To apply the above changes to the system, please run the command exportfs -arv

7. Edit the MOM configuration file (\var\spool\PBS\mom_priv\config) to modify the $job-dir_root variable to point to the above created directory. e.g. $jobdir_root /scr/node03

8. Reload the automounter to apply the changes/etc/init.d/autofs reload

9. Repeat above process for every execution host.

This can also be automated using a script.

On RVS, please do following steps.1. Create a directory /scr2. Edit the file /etc/auto.pbs to include all execution hosts as below

node04 -fstype=nfs node04:/scratch

node03 -fstype=nfs node03:/scratch

Above lines define mount names and destinations.This information will be used by automounter to create specific mount points.

3. Edit the file /etc/auto.master to include following line/scr/etc/auto.pbs --ghost

This line specifies that automounter should create mount points for each directory speci-fied in the /etc/auto.pbs file and add a prefix /scr to it. So in this case, there will be two mount points created

36 Server Tuning Recommendations

Page 47: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

/scr/node03 pointing to node03 /scratch directory and

/scr/node04 pointing to the node04 /scratch directory.

4. Reload the automounter to apply the changes/etc/init.d/autofs reload

If needed, these steps can be automated using a script.

These changes are required for efficient data handling while the job is still running, once the job is finished, all data is normally directly accessible either from PAS staging directory or the job output directory.

Most of these steps are already performed as part of PBS recommended set up. The only change specific for RVS is to edit the MOM configura-tion file for changing the $jobdir_root and configurations on RVS.

Server Tuning Recommendations 37

Page 48: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

38 Server Tuning Recommendations

Page 49: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

5. Configuring Solver Log File Readers

You can activate the solver log file readers, Abaqus, Fluent, CFX, and STAR-CMM+ to plot.

These readers are already present in the standard installation of HyperWorks 14.0 but they are not activated by default. This section explains how to enable them.

To enable the solver log file reader, perform the following steps:1. Open preferences_common_plot.mvw preference file from

<HyperWorks Install Folder>/hw/prefinc folder.2. Locate the following solver log file reader code:

* RegisterExternalColumnReader({external_readers_dir + "/hgtextcolumn.exe"})

3. To configure a new solver log file reader, add the following code with the new solver log file reader just before the solver log file reader code.For example, to register Fluent solver log file reader,*RegisterExternalReader({external_readers_dir + "/hgfluent.exe"}, "", "", ascii)

*RegisterExternalColumnReader({external_readers_dir + "/hgtextcolumn.exe"})

4. If you wish to add Abaqus, CFX, and STAR-CMM+ solver log file readers.For example, adding Abaqus, CFX, and STAR-CCM+ file readers.*RegisterExternalReader({external_readers_dir + "/hgabaqus.exe"}, "", "", ascii)

*RegisterExternalReader({external_readers_dir + "/hgCFX.exe"}, "", "", ascii)

*RegisterExternalReader({external_readers_dir + "/hgStarCCM.exe"}, "", "", ascii)

*RegisterExternalReader({external_readers_dir + "/hgfluent.exe"}, "", "", ascii)

*RegisterExternalColumnReader({external_readers_dir + "/hgtextcolumn.exe"})

To configure STAR-CCM+ log reader for HW14.0 copy hgstarccm exe-cutable from download area to <Altair_Home>\io\abf_read-ers\bin\<platform>

39

Page 50: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

40 Configuring Solver Log File Readers

Page 51: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

6. RVS Data Cleanup Criteria Settings

This section describes the cleanup criteria settings for RVS data and it is configured using the site_config.xml file.

To configure site_config.xml file:1. Edit cleanup criteria settings in the RVS SERVER_HOME\rvs\config\site_config.xml file

i. Enter the cleanup time in 24 hours format.ii. Edit the criteria to clean up result data with noOfDays from last accessed.iii. Edit cache clean up criteria with noOfDays from last modified.

For example, use the following format to clean up the result data and cache.

<CleanupTime>DAILY 01:00</CleanupTime>

<CleanupCriteria>

<Criterion id="LAST_ACCESSED_TIME_BASED" noOfDays="30" class="com.altair.hwe.publish.resultsmanager.defaultimpl.LastAccessedTime-BasedCriterion"/>

<Criterion id="FRAMEWORK_CACHE_CLEANUP_CRITERIA" noOfDays="100" class="com.altair.hwe.publish.resultsmanager.defaultimpl.LastModifiedTime-BasedCriterion"/>

</CleanupCriteria>

2. Save the file & restart the RVS service.

41

Page 52: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

42 RVS Data Cleanup Criteria Settings

Page 53: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

7. Supported Result File Types

This section provides a table that describes the supported result file types in RVS.

Results Files Format Plot Data Animation Data Default TOC TypeRadioss Bulk*.op2 Yes Yes Animation*.h3d Yes Yes Animation*.res Yes NA Plot*.pch Yes NA Plot*.gz Yes Yes AnimationRadioss Block*A00# Yes Yes Animation*.T## Yes NA Plot*.gz Yes Yes AnimationOptistruct*.op2 Yes Yes Animation*.h3d Yes Yes Animation*.res Yes NA Plot*.pch Yes NA Plot*.hgdata Yes NA PlotMotionSolve*.mrf Yes NA Plot*.plt Yes NA Plot*.h3d Yes Yes Animation*.maf Yes NA PlotAbaqus*.odb Yes Yes Animation*.dat Yes NA Plot*.out Yes NA Plot

43

Page 54: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

ADAMS*.req Yes NA Plot*.res Yes NA Plot*.nam Yes NA Plot*.rsp Yes NA Plot*.shl Yes NA Plot*.sta Yes NA PlotAnsys*.rst Yes Yes Animation*.rth Yes Yes Animation*.rmg Yes Yes AnimationCFX *.out Yes NA PlotFluent*.out Yes NA Plotoutput.* Yes NA Plot*.trn Yes NA Plot*.txt* Yes NA PlotLs-Dynad3plot Yes Yes Animation*dynain Yes Yes Animation*.fz Yes Yes AnimationIntfor Yes Yes AnimationPtf Yes Yes AnimationABSTAT Yes NA PlotBINOUT Yes Yes AnimationBNDOUT Yes Yes AnimationDBFSI Yes NA PlotDEFORC Yes NA Plot*.dyn Yes NA PlotELOUT Yes NA Plot

Results Files Format Plot Data Animation Data Default TOC Type

44 Supported Result File Types

Page 55: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

GLSTAT Yes NA PlotGECOUT Yes NA PlotJNTFORC Yes NA PlotMATSUM Yes NA PlotNCFORC Yes NA PlotNODFOR Yes NA PlotNODOUT Yes NA PlotRBDOUT Yes NA PlotRCFORC Yes NA PlotRWFOC Yes NA PlotSBTOUT Yes NA PlotSECFORC Yes NA PlotSLEOUT Yes NA PlotSPHOUT Yes NA PlotSWFORC Yes NA PlotNanoFluidXnFX Yes No NAUltraFluidXuFX Yes No NAHyperXtrude*.h3d Yes Yes Animation*.out Yes NA PlotFEMZIP *.fz Yes Yes Animation*d3plot* Yes Yes AnimationHW ASCII*.hwascii Yes Yes AnimationMADYMO*.fai Yes NA Plot*.kn3 Yes Yes AnimationMarc

Results Files Format Plot Data Animation Data Default TOC Type

Supported Result File Types 45

Page 56: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

*.t16 Yes Yes AnimationNastran*.op2 Yes Yes Animation*.pch Yes NA PlotNIKE3D*n3plot Yes Yes AnimationPamcrash*.DSY Yes Yes Animation*.erfh5 Yes Yes Animation*.THP Yes NA Plot*.fz Yes Yes Animation*.h3d Yes Yes AnimationPermas*A## Yes Yes AnimationOther Ascii formats*.xgr Yes NA Plot*.dat Yes NA Plot*.col Yes NA Plot*.csv Yes NA Plot

The default TOC type (plot or animation) will be identified depending on the file type registration with RVS and the parameter isDefault in the plugin_def.xml file.

To set the Default TOC Type, change the value of isDefault to true in the RVS server configuration (plugin_def.xml). Any new file formats other than the ones mentioned in the table which are supported by Hyper-Works can be configured in plugin_def.xml.

Results Files Format Plot Data Animation Data Default TOC Type

46 Supported Result File Types

Page 57: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

8. Uninstalling Results Visualization Service

Prior to uninstalling, stop the PBS Works service (see Starting, Stopping and Restarting RVS).

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

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

/opt/altair/rvs/13.2

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

cd _RVS_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\ RVS\ Installation -i swing

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

47

Page 58: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

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

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

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

48 Uninstalling Results Visualization Service

Page 59: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

In the next screen, click on the Uninstall button.

Confirm your choice in the alert box.

Uninstalling Results Visualization Service 49

Page 60: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

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

50 Uninstalling Results Visualization Service

Page 61: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

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

Uninstalling Results Visualization Service 51

Page 62: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

52 Uninstalling Results Visualization Service

Page 63: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

9. Troubleshooting RVS

Locating RVS log files1. Locating RVS log files locations:

i. RVS core logs: RVS SERVER_HOME/rvs/log/HWE_RM_Log.txtii. RVS web server logs: RVS SERVER_HOME/thirdparty/apache/tomcat/log/catalina.outiii. RVS framework log: RVS CONFIG_HOME/logs/framework/server/awpflog.log

2. Locating Compute Manager logs locations:i. Portal framework log location: SERVER_HOME/logs/framework/server/awpflog.logi. RVS services log location: <CM Install Folder>/services/rm/logs/RMService.log

RVS Troubleshooting ChecklistHere is a quick checklist of pre-requisites.

1. The RVS server should be installed on a supported Operating System. e.g. Windows 2012 R2, RHEL6.X, SLES 11.0 and later or CentOS 6.X and later.

2. A supported web browser should be used.e.g. Internet Explorer 11, Firefox ESR 45.0, or Google Chrome 43.0.

3. On the RVS server HyperWorks 14.0 should be installed4. On the client HyperView Player 14.0 should be installed and registered5. The license server should be configured in the service startup file located at RVS

SERVER_HOME/scripts/server-start.sh

6. The user should have read access to results files7. The user should have execute permissions in the RVS server

NPAPI plugins (HyperView Player Plugin for RVS) are not supported from Chrome version 44.0 and Mozilla Firefox ESR 45.

53

Page 64: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

8. RVS is tested on the following combinations of component versions.

9. The client, PAS, CM and RVS server should be accessible to each other. 10. The PAS, CM & RVS server's host name & IP address should be registered to each other. 11. The PAS, CM & RVS server's host name & IP address should be mapped to client machine.

If you use hostname on one machine, use host name on all the others. If you use IP address on one machine, use IP address on all the others as well. Ping the machines to make sure they are all accessible to each other.

12. The server port should be unique for each of the servers and port clashes should not occur

Preparing Web Browsers for RVSTo prepare web browsers for Results Visualization follow the steps below.

For all Web Browsers (Internet Explorer, Firefox and Chrome)1. Turn off pop-up blocker at least for the first instance2. Disable any additional Java Script blocker plugins

For Internet Explorer 11 and later.

Set the following ActiveX control settings. In Internet Options choose Custom Level in Security settings. Choose the following:

1. Allow ActiveX filtering > Disable2. Display video or animation on webpage that does not use external media player > Enable3. Initialize and script active controls not marked as safe for scripting > Enable4. Only allow approved domains to use ActiveX controls without prompt > Disable5. Run active controls and plug-in > Enable

CM PAS PBS12.0.0 12.0.0 12.1.012.0.0 11.3.0 12.0.013.0.0 12.1.0 12.2.013.0.0 12.1.0 13.0.013.00 13.0.0 13.0.013.1.0 13.0.0 13.0.013.1.0 13.1.0 13.1.0

54 Troubleshooting RVS

Page 65: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Configuring HyperView Player (HVP)

To install HVP (without other HyperWorks modules), you can download the installer http://www.altairhyperworks.in/ResourceLibrary.aspx?keywords=&industry=All&product_ser-vice=All&category=Free%20Software%20Downloads&order_by=title

The supported HVP version needs to be installed. Register the HVP controls from program files as shown below.

On successful registration, a message displayed as shown below.

If any other message is displayed, H3D files will not play in the browser.

If you get an error during registration, Right click the shortcut and choose Run as Administrator the context menu.

To check the player installation, restart the browser. try animating a result file from the RVS UI or open an animation file from the Altair Demo directory (shown below) in the browser.

Troubleshooting RVS 55

Page 66: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

You should see the H3D files loading directly into html page without any errors (on IE, enable ActiveX control and other pop-ups) If all these methods fail, seek help from HyperWorks Support and inform the RVS team. To install HVP (without other HyperWorks modules), you download the installer from the Altair website.

Common Issues

Unable to start RVS or perform RVS operations.Causes

1. Port Clash issue during server startup2. HyperWorks license configuration issue.3. Incorrect location of HyperWorks in configuration file

Resolution1. Make sure that RVS server is restarted after installation configuration.2. Check for any errors in the logs. Refer to the Locating RVS log files topic. 3. If it is a port clash issue, change the port numbers for SHUTDOWN and Connector in:

RVS SERVER_HOME/thirdparty/apache/tomcat/conf/server.xml

4. Start the services. Refer to the section Starting, Stopping and Restarting RVS.5. Check the following URLs in browser for the service list

http://<RVS-IP>:<RVS-Port>/ResultService/rest/doc

56 Troubleshooting RVS

Page 67: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

http://<RVS-IP>:<RVS-Port>/ResultService/rest/resultservice/apps

6. Restart the RVS Server after installation or configuration changes.7. For resolving license related issues, check the license location for HyperWorks in the file

server-start.sh at the location RVS SERVER_HOME/scripts/server-start.sh

8. The Altair HyperWorks installation folder location is stored in the file site_config.xml located at RVS SERVER_HOME/rvs/config/ site_config.xml. Edit this file to point to the HyperWorks directory.

View Option is Unavailable in the Context Menu for Plot or AnimationCauses

1. Generic errors2. RVS Server is not registered in CM3. Result file format is unsupported4. Web Browser is not configured properly

Resolution1. Check if RVS is running.Check for any errors in the logs. Refer to the Locating RVS log

files files topic. Perform the checks in the RVS Troubleshooting Checklist provided.2. Verify that the RVS port number is not blocked through firewall settings.3. Check for the RVS server entry in the CM server in the file

CONFIG_HOME/services/rm/config/rm_servers.xml

4. Restart the CM server after making any changes to the rm_servers.xml. Check for the name of the PAS server, it should be same as the name given during registering PAS and is case sensitive.

5. Check if the result file format is support by RVS. The default configuration is available at RVS SERVER_HOME/rvs/plugin/plot_toc_data_provider/plugin_def.xml

6. Follow the steps in the section Preparing Web Browsers for RVS to make sure that the required components are installed and configured.

Troubleshooting RVS 57

Page 68: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

Plot generation fails with Number format errorCause

In some locales, in the numbering format for decimals and thousands, comma (,) is used as instead of dot (.).

Resolution1. Check the system locale setting of the Compute Manager server

[pbsadmin@<hostname>]$ echo $LANG

2. If the value of LANG is set to a different locale than English, set the locale in the CM server startup script located at: <CM Install Folder>/scripts/server-start.sh

#####Setting locale####

set LANG

export LANG en_US.UTF-8

Or in JAVA_OPTS JAVA_OPTS="$JAVA_OPTS -Duser.country=US -Duser.language=en"

After "#set server environment" in the file.

Unable extract TOC ErrorCause

The permissions to access the result file is restricted or not set properly.

Resolution1. Check if the registered CM user has read permission on the result file.2. If the registered user does not have read permission on the result file update the permis-

sions of the registered user to read the result files.

58 Troubleshooting RVS

Page 69: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

HyperMath Execution Error: HW_APP_FAILED Message Causes

1. HyperWorks is not updated with HW-130 patch for HMath.2. HyperMath service is not running or does not have execute permissions

Resolution1. Perform the checks listed in the RVS Troubleshooting Checklist.2. Check for HMath patches available in the extras directory and apply them as instructed.3. After applying patches check for the execute permissions of HMathserver4. Check if the HMath service is started successfully5. Check the wsdl location of the HMath URL hmath_wsdl_xxxx.wsdl6. If it is a Fluent/CFX/Abaqus log file please check the logger is configured properly

Troubleshooting RVS 59

Page 70: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

60 Troubleshooting RVS

Page 71: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

10. Known Issues

This section provides a table that describes the known issues:

No. Description Cause Resolution1 RVS-264: On Windows

Server the result files in series cannot be viewed if the job directories are not directly accessible.

This is a known product issue.

The job directories have to be mapped to server.

2 RVS-323 & RVS-325: The *.H3D output from MBD & Flex and *.MAF are not supported for extracting animation.

This is a known product issue.

Not all file formats sup-ported in HyperWorks desktop products are sup-ported in Results Visualiza-tion Service.

3 RVS-330: HVP plug-in does not work on browser version for x86_64 architecture on Linux.

This is a known product issue.

Use a browser version of x86 architecture.

61

Page 72: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

62 Known Issues

Page 73: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

11. Licensing

Result Visualization Services use Altair patented licensing system of HyperWorks Units (HWU). Animation request will checkout 6 HWU and Plot request will checkout 10 HWU on the server. Units are leveled for the same user but stacked for different users. They are checked out only during the results extraction on the server. As soon as the results are extracted, units are immedi-ately returned to the licensing pool. The client side rendering of plot and animation results are covered by Compute Manager licensing and does not require any extra units.

63

Page 74: Results Visualization Service Administrator’s Guide fileResults Visualization Service 13.2 Administrator’s Guide iv Software Security Measures: Altair Engineering Inc. and its

Results Visualization Service 13.2 Administrator’s Guide

64 Licensing


Recommended