You are on page 1of 80

Altair HyperWorks 2019

Installation Guide

altairhyperworks.com
Contents
Intellectual Property Rights Notice.............................................................................iii
Technical Support............................................................................................................vii

Introduction....................................................................................................................... 9

About Altair HyperWorks.................................................................................................. 10


Altair HyperWorks 2019 Licensing..................................................................................... 11
Altair Software and Hardware 2019 Release Notes.............................................................. 12

Prepare to Install Altair HyperWorks........................................................................ 16

Platform Support............................................................................................................. 17
Installation Media............................................................................................................ 18
Download from Altair Connect...........................................................................................20

Install Altair HyperWorks............................................................................................. 21

Install Altair HyperWorks: Local Installation........................................................................22


Installation Files...................................................................................................... 22
Install Altair HyperWorks via GUI Mode......................................................................24
Install Altair HyperWorks via Console Mode................................................................ 28
Install Altair HyperWorks via Silent Mode................................................................... 31
Install Altair HyperWorks: Client/Server Installation.............................................................36
Install Altair HyperWorks via GUI Mode......................................................................36
Install Altair HyperWorks via Silent Mode................................................................... 44

Connect to the Altair License Management System 14.0..................................... 45

Requirements.................................................................................................................. 46
Node Locked Licenses...................................................................................................... 47

Start Altair HyperWorks Applications........................................................................48

Start on Windows............................................................................................................49
Change the Default Working Directory on Windows......................................................49
Start on Linux.................................................................................................................50
Obtain a List of Arguments for an Application on Linux................................................ 53

Set up Altair HyperWorks Help................................................................................... 55

Start Help from the Application Menu................................................................................ 56

1
Start Help from the altair/scripts Directory on Linux............................................................ 57
Access Help Installed on a Server on Windows................................................................... 58

Set up CAD Translators................................................................................................. 59

UG Environment Variable Settings..................................................................................... 60


CATIA V5 License............................................................................................................ 62

Uninstall.............................................................................................................................63

Uninstall: Windows.......................................................................................................... 64
Windows Silent Uninstalls Using a Response File......................................................... 64
Uninstall: Linux............................................................................................................... 66

Appendix............................................................................................................................ 67

Windows (Local) Installation............................................................................................. 68


Linux Installation............................................................................................................. 74

2
Intellectual Property Rights Notice
Copyrights, Trademarks, Trade Secrets, Patents & Third Party Software Licenses

Altair HyperWorks 2019 Copyright 1986-2019

The Platform for Innovation™

Altair Engineering Inc. Copyright © 1986-2019. All Rights Reserved.

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

Altair HyperWorks™ - The Platform for Innovation™


Altair AcuConsole™ ©2006-2019

Altair AcuSolve™ ©1997-2019


Altair ElectroFlo™ ©1992-2019

Altair ESAComp™ ©1992-2019

Altair Feko™ ©1999-2014 Altair Development S.A. (Pty) Ltd.; ©2014-2019 Altair Engineering Inc.

Altair Flux™ ©1983-2019

Altair FluxMotor™ ©2017-2019

Altair HyperCrash™ ©2001-2019

Altair HyperGraph™ ©1995-2019

Altair HyperLife™ ©1990-2019

Altair HyperMesh™ ©1990-2019

Altair HyperStudy™ ©1999-2019

Altair HyperView™ ©1999-2019

Altair Virtual Wind Tunnel™ ©2012-2019

Altair HyperXtrude™ ©1999-2019

Altair MotionSolve™ ©2002-2019

Altair MotionView™ ©1993-2019

Altair Multiscale Designer™ ©2011-2019

Altair OptiStruct™ ©1996-2019

Altair Radioss™ ©1986-2019

Altair SimLab™ ©2004-2019

Altair SimSolid™ ©2015-2019

Altair nanoFluidX™ ©2013-2018 Fluidyna GmbH, © 2018-2019 Altair Engineering Inc.

Altair ultraFluidX™ ©2010-2018 Fluidyna GmbH, © 2018-2019 Altair Engineering Inc.


Altair HyperWorks 2019 Installation Guide
Intellectual Property Rights Notice p.iv

Altair WinProp™ ©2000-2019;

Altair ConnectMe™ ©2014-2019;

Plus other products from the Altair solidThinking Platform.

Altair Packaged Solution Offerings (PSOs)


Altair Automated Reporting Director™ ©2008-2019

Altair GeoMechanics Director™ ©2011-2019

Altair Impact Simulation Director™ ©2010-2019

Altair Model Mesher Director™ ©2010-2019

Altair NVH Director™ ©2010-2019

Altair Squeak and Rattle Director™ ©2012-2019

Altair Virtual Gauge Director™ ©2012-2019

Altair Weight Analytics™ ©2013-2019

Altair Weld Certification Director™ ©2014-2019

Altair Multi-Disciplinary Optimization Director™ ©2012-2019

Altair solidThinking - Where Innovation Begins™


Altair Inspire™ ©2009-2019 including Altair Inspire Motion and Altair Inspire Structures

Altair Inspire™ Extrude-Metal ©1996-2019 (formerly Click2Extrude®-Metal)

Altair Inspire™ Extrude-Polymer ©1996-2019 (formerly Click2Extrude®-Polymer)

Altair Inspire™ Cast ©2011-2019 (formerly Click2Cast®)

Altair Inspire™ Form ©1998-2019 (formerly Click2Form®)

Altair Inspire™ Mold ©2009-2019 (initial release-Q2 2019)

Altair Inspire™ Studio ©1993-2019 (formerly ‘Evolve’)

Altair Compose™ ©2007-2019 (formerly solidThinking Compose®)

Altair Activate™ ©1989-2019 (formerly solidThinking Activate®)

Altair Embed™ ©1989-2019 (formerly solidThinking Embed®)


• Altair Embed SE™ ©1989-2019 (formerly solidThinking Embed® SE)
• Altair Embed/Digital Power Designer ©2012-2019

Altair SimLab™ ©2004-2019

Altair 365™ ©1994-2019

Altair PBSWorks™ - Accelerating Innovation in the Cloud™


Altair PBS Professional™ ©1994-2019

Altair Control™ ©2008-2019; (formerly PBS Control)

Altair Access™ ©2008-2019; (formerly PBS Access)

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Intellectual Property Rights Notice p.v

Altair Accelerator™ ©1995-2019; (formerly NetworkComputer)

Altair Accelerator Plus™©1995-2019; (formerly WorkloadXelerator)

Altair FlowTracer™ ©1995-2019; (formerly FlowTracer)


Altair Allocator™ ©1995-2019; (formerly LicenseAllocator)

Altair Monitor™ ©1995-2019; (formerly LicenseMonitor)

Altair Hero™ ©1995-2019; (formerly HERO)


Altair Software Asset Optimization™ (SAO) ©2007-2019

Note:
Compute Manager™ ©2012-2017 is now part of Altair Access

Display Manager™ ©2013-2017 is now part of Altair Access

PBS Application Services™ ©2008-2017 is now part of Altair Access

PBS Analytics™ ©2008-2017 is now part of Altair Control

PBS Desktop™ ©2008-2012 is now part of Altair Access, specifically Altair Access
desktop, which also has Altair Access web and Altair Access mobile

e-Compute™ ©2000-2010 was replaced by “Compute Manager” which is now Altair


Access

Altair SmartWorks™ - Innovation Intelligence®


Altair SmartCore™ ©2011-2019

Altair SmartEdge™ ©2010-2019

Altair SmartSight™ ©2014-2019

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) and used by permission.

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

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Intellectual Property Rights Notice p.vi

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.

Proprietary Information of Altair Engineering


Technical Support
Altair provides comprehensive software support via web FAQs, tutorials, training classes, telephone and
e-mail.

Altair Support on the World Wide Web


The Altair web site is a valuable online companion to Altair software. Visit www.altairhyperworks.com
for tips and tricks, training course schedules, training/tutorial videos, and other useful information.

Altair Training Classes


Altair training courses provide a hands-on introduction to our products, focusing on overall functionality.
Courses are conducted at our main and regional offices or at your facility. If you are interested in
training at your facility, please contact your account manager for more details. If you do not know who
your account manager is, please send an e-mail to training@altair.com and your account manager will
contact you.

Telephone and E-mail


When contacting Altair support, please specify the product and version number you are using along with
a detailed description of the problem. Many times, it is very beneficial for the support engineer to know
what type of workstation, operating system, RAM, and graphics board you have, so please have that
information ready. If you send an e-mail, please specify the workstation type, operating system, RAM,
and graphics board information in the e-mail.

To contact an Altair support representative, reference the following table or the information available on
the HyperWorks website: www.altairhyperworks.com/ClientCenterHWSupportProduct.aspx.

Location Telephone E-mail

Australia 64.9.413.7981 anzsupport@altair.com

Brazil 55.11.3884.0414 br_support@altair.com

Canada 416.447.6463 support@altairengineering.ca

China 86.400.619.6186 support@altair.com.cn

France 33.1.4133.0992 francesupport@altair.com

Germany 49.7031.6208.22 hwsupport@altair.de

India 91.80.6629.4500 support@india.altair.com

1.800.425.0234 (toll free)

Israel israelsupport@altair.com

Italy 39.800.905.595 support@altairengineering.it


Altair HyperWorks 2019 Installation Guide
Technical Support p.viii

Location Telephone E-mail

Japan 81.3.6225.5830 support@altairjp.co.jp

Malaysia aseansupport@altair.com

Mexico 55.56.58.68.08 mx-support@altair.com

South Africa 27 21 8311500 support@altair.co.za

South Korea 82.70.4050.9200 support@altair.co.kr

Spain 34 910 810 080 support-spain@altair.com

Sweden 46.46.460.2828 support@altair.se

United Kingdom 01926.468.600 support@uk.altair.com

United States 248.614.2425 hwsupport@altair.com

For questions or comments about this help system, send an email to connect@altair.com.

In addition, the following countries have resellers for Altair Engineering: Colombia, Czech Republic,
Ecuador, Israel, Russia, Netherlands, Turkey, Poland, Singapore, Vietnam, Indonesia

Official offices with resellers: Canada, China, France, Germany, India, Malaysia, Italy, Japan, Korea,
Spain, Taiwan, United Kingdom, USA

See www.altair.com for complete contact information.

Proprietary Information of Altair Engineering


Introduction 1
Introduction

This guide provides instructions for the installation and operation of HyperWorks software on supported
platforms.

This chapter covers the following:

• About Altair HyperWorks (p. 10)


• Altair HyperWorks 2019 Licensing (p. 11)
• Altair Software and Hardware 2019 Release Notes (p. 12)

This includes the procedures for connecting to an Altair HyperWorks licensing management system,
execution of the applications and connecting the application clients to existing HyperWorks help,
including local, networked and web help.
The details of installing RADIOSS HMPP, OptiStruct SPMD, and configuration of Altair AcuSolve products
are documented in the HyperWorks 2019 Advanced Installation Guide.

HyperWorks 2019 uses InstallAnywhere 2017 as its installation tool. The HyperWorks 2019 installers are
InstallAnywhere web installers. InstallAnywhere provides the consistent look and feel of the HyperWorks
installation wizard across all platforms supported by Altair HyperWorks products.

In order to run HyperWorks 2019 applications, you need to connect the applications to the Altair
License Management System 14.0 (or higher, using the latest version is recommended). Details
of the installation and how to start the Altair License Manager can be found in the Altair License
Management System 14.0 Installation Guide. The license packages are available on the Altair web site
(altairhyperworks.com) or Altair Connect (connect.altair.com).
Altair HyperWorks 2019 Installation Guide
Introduction p.10

About Altair HyperWorks


Altair HyperWorks is the most comprehensive open-architecture simulation platform, offering best-in-
class technologies to design and optimize high performance, efficient and innovative products.

HyperWorks includes finite element modeling, analysis and optimization for structures, fluids, multibody
dynamics, electromagnetics and antenna placement, model-based development, and multiphysics.
Users have full access to a wide suite of design, engineering, visualization, and data management
solutions from Altair and its technology partners.

The 2019 version of the HyperWorks suite offers many new functionalities in areas such as efficient
modeling and meshing, multiphysics and multi-disciplinary analysis, structural analysis and
optimization, model-based design, electromagnetism, fatigue life prediction, and composites materials.

A massive development effort has been placed to deliver the most robust, efficient and fast-performing
HyperWorks software release to-date:
• HyperWorks 2019 sets a new benchmark for quick and robust modeling and visualization of large,
complex assemblies. Thousands of development hours have been spent refining and improving the
software algorithms and workflows, implementing hundreds of customer requests.
• In parallel to the legacy GUI, a brand-new user experience is now available to maximize efficiency
for complex FE modeling tasks, such as geometry creation and editing, meshing, and morphing.
• Significant performance improvements have been achieved across the different desktop and solver
applications, including invoking time, results loading, batch-meshing, and more.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Introduction p.11

Altair HyperWorks 2019 Licensing


Altair HyperWorks 2019 licensing is based on HyperWorks Units (HWUs).
HyperWorks Units licenses are server licenses. Customers can launch any application within the
HyperWorks suite as long as there are sufficient HyperWorks Units to grant the license check out.

To invoke HyperWorks 2019 applications, after completing the HyperWorks 2019 installation, you need
to point the applications to an activated Altair License Manager or a valid node stand-alone license by
setting the proper environment variable.

The HyperWorks 2019 package does not include the license package that sets up the Altair License
Manager. Download the Altair license package from the Altair web site and follow the Altair License
Management System 14.0 Installation and Operation Guide to install and activate the Altair License
Manager properly.

In some cases, Altair provides “feature” based licenses, which allow a particular application to run as
long as the feature exists in the license file. A feature license is a standalone license that does not
consume HyperWorks Units.
Questions regarding the software and license installation may be directed to Altair Support. See the
Technical Support page for further contact information.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Introduction p.12

Altair Software and Hardware 2019 Release Notes

New Applications
Altair Activate
Activate enables product creators and system simulation and control engineers to model,
simulate, and optimize multi-disciplinary systems to ensure that all design requirements are
successfully met while also identifying system level problems early in the design process.

Altair Compose
Compose is a multi-language environment designed to efficiently perform numerical
computations, develop algorithms, and analyze and visualize various types of data. Compose
includes OML (Open Matrix Language) which is a high level, matrix-based, numerical computing
language. Compose is also tightly coupled with Altair HyperWorks products to offer powerful
scripting and computing capabilities.

Altair CFD Solvers


Altair HyperWorks provides a full suite of CFD tools to help meet product design and engineering
end goal, fast and accurate simulations of fluid flow and heat transfer systems.
Products include:

Altair AcuSolve
A general purpose CFD solver providing users with a full range of physical models.
Simulations involving flow, heat transfer, turbulence, and non-Newtonian materials are
handled with ease by the robust and scalable solver technology.

Altair nanoFluidX
A particle-based fluid dynamics simulation tool that predicts the flow in complex geometries
with complex motion, particularly well-suited for geartrain and powertrain applications such
as oil distribution analysis. nanoFluidX also performs tank sloshing simulations with great
ease.

Altair ultraFluidX
A simulation tool for ultra-fast predictions of the aerodynamic properties of passenger
and heavy-duty vehicles. ultraFluidX is also used to evaluate buildings and environmental
aerodynamics.

Altair HyperLife
HyperLife is an easy-to-learn fatigue analysis software developed on a solver-neutral framework.
It provides a comprehensive tool set for durability analysis, directly interfacing with all the major
finite element analysis (FEA) result files. With an embedded material library, HyperLife offers
solutions for fatigue life predictions under static and transient loading across a wide range of
industrial applications.
HyperLife is included with the HyperWorks Desktop package.

Altair Virtual Wind Tunnel for ultraFluidX


Virtual Wind Tunnel for ultraFluidX is a digital wind tunnel application that is customized for
simulating the aerodynamics of passenger and heavy-duty vehicles using Altair ultraFluidX.
Simulations are set up with ease using automated workflows that are tailored towards the

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Introduction p.13

requirements of the Lattice Boltzmann method employed by uFX. Virtual Wind Tunnel for
ultraFluidX allows users to import geometry, assign mesh controls, identify parts, define run
parameters, and launch the uFX solver.
Altair Inspire Cast
Inspire Cast is a fast, easy, accurate and affordable casting simulation environment focused on
creating high-quality components. In version 2019, it now supports units-based licensing for both
Altair solidThinking and Altair HyperWorks customers.

Hardware and Platform Changes


Operating system additions
Support for the following platforms has been added:
• SUSE Linux Enterprise Server 12 SP2 64-bit

Discontinued hardware platform support systems


Support for the following platforms has been dropped:
• Windows 8.1 64-bit
• SUSE Linux Enterprise Server 11 SP3 64-bit
• SUSE Linux Enterprise Server 12 SP1 64-bit

Installation
HyperWorks 2019 suite contains independent product packages
Independent product packages give you the flexibility to download desired packages as needed.
Any HyperWorks 2019 standalone SA update package can be installed either on top of an existing
2019 installation, or can be installed independently without the prerequisite of a 2019 base.

Installer capabilities and features


HyperWorks 2019 brings with it the robust capabilities and features of HyperWorks 2018
installers, as well as additional support for HotFix installers. These HotFix installers are quick
patch type installers that are used to install on top of a prerequisite base installation, unlike the
other full installers. These are marked with the word “hotfix” in the installer name and bring with
them the quick fixes and features to better suit your needs.

Installation and Packaging Features


• Added Altair Activate product on Windows.
• Added Altair Compose product on Windows and Linux.
• Added Altair Inspire Cast product on Windows.
• Added Altair Virtual Wind Tunnel for ultraFluidX product on Windows and Linux.
• Added CFD Solver products on Windows and Linux.
• Improved support for HotFix installation when using the Master Installer.
• Added support for server mode installations of Altair Feko + WinProp.
• ALTAIR_LICENSE_PATH can now be set during a silent installation.
• The uninstaller will now provide a list of files if it cannot remove them.
• Improved the Application Install Check used for overwriting installations.
• Improved required disk space calculations to make them more accurate.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Introduction p.14

Invoking
• Added support for Altair HyperStudy file associations.
• Added Linux Menu support for Altair Compose and Altair Flux.
• Updated Linux Compatibility Tool.

Resolved Issues
• “Remove All” was not selected by default for non-English locales in the uninstaller.
• Japanese was not appearing in the locale selector of several installers.
• Issues related to silent installation.
• Help was not installed properly if Tutorials were deselected.
• A space at the end of a shortcut folder name caused an issue in the Start Menu.

Known Issues
• If you deselect a product using the Master Installer in Linux console mode, it does not get
deselected properly.
• Using the Back/Previous option with an installer may not reset the installer variables correctly if
changes are made and the install session is continued.
• On Linux, installing a directory with spaces is not supported.
• In some cases, the Linux installers will report an incorrect amount of available disk space.
• Special characters in the path to the temp location can cause the Java in the installer to not
function correctly.
• On Linux, during a console mode install, when using the response file output command -r in the
Help Configuration response file may not write out correctly.
• If there is not enough TMP/TEMP space on the main drive (for example, C: under Windows), then
the installer will prompt user to input a new location. Some Java TMP/TEMP space will still try to go
to the main drive even when selecting this new location.
• Clicking the Cancel button to stop an installation via the Master Installer does not clean up the
already installed files, but does clean up the files in the TMP/TEMP folder. You will need to uninstall/
delete the installed files from the chosen install folder manually if Cancel was clicked.
• Clicking Cancel to stop an installation causes the Add/Remove uninstaller icon to possibly not
function correctly, and then manual removal of the installed files would be necessary.
• The HyperWorks installers do not support the use of the default InstallAnywhere
installer.properties files. We request that a unique name is used when using a response
file; for example, installer_hw2019.properties, and to use it with the -f <path_to_file>/
<filename> command line option.
• For NETSETUP client installs from a server installation of HyperWorks, a UNC path must be used to
get to the server installation path through Windows Explorer or Windows Network.

Note: Using mapped drive letters or variables is not currently supported in the client
installer.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Introduction p.15

• On Linux, there is an issue with using the Master Installer with the IATEMPDIR variable to specify
a custom temporary directory location. All sub-installers will try to use /tmp from the machine
running the installers for temporary installer files.
• With some versions of Gnome, there is a bug where the Linux icons are not placed in a hierarchy.
Instead, they are placed in “Other” with a flat layout, meaning that all the icons appear at the same
folder level in “Other.”
• The installer does not run the Linux Menu installation by default, the user must run the installation
script.
• When the Master Installer is used, desktop shortcuts, if any, will not be removed during
uninstallation.
• Linux console mode may not function if you have a DISPLAY variable set.

Proprietary Information of Altair Engineering


Prepare to Install Altair
HyperWorks 2
Prepare to Install Altair HyperWorks

Summary of the items required and procedures needed to install and successfully run Altair HyperWorks
applications on supported platforms.

This chapter covers the following:

• Platform Support (p. 17)


• Installation Media (p. 18)
• Download from Altair Connect (p. 20)

Before starting installation, make sure you have everything you need.
• HyperWorks 2019 and Altair License Manager software, delivered from Altair in USB/DVD format or
HyperWorks 2019 image packages downloaded from Altair Connect.
• A USB compatible input port on the machine or a DVD compatible drive.
• Access to an activated and running HyperWorks 14.0 license server or a node locked license.
• A compatible machine that contains the minimum hardware/software requirements to run
HyperWorks applications. Reference the Altair HyperWorks 2019 Platform Support document for
further details.
• Sufficient disk space for install: The full suite of HyperWorks 2019 applications and help files needs
8 GB of temp space. The temp files are removed after successful completion of an installation.

Reference the Altair HyperWorks 2019 Platform Support documentation for operating systems and
minimum requirement considerations, and the HyperWorks 2019 Hardware Recommendations and
Certifications document for further hardware inquiries.

General steps for installing HyperWorks are:


1. Install and activate an Altair License Manager (the latest version) if one does not already exist.
Alternatively, use a node locked license.
2. Install HyperWorks 2019 on the designated machine(s).
3. Set an environment variable that points the HyperWorks 2019 application to an activated and
running Altair license server. Alternatively, set the environment variable to point to a node locked
license.
4. Set up HyperWorks online help, if needed.
5. The software to install the Altair License Manager is a separate package from the HyperWorks
2019 application packages. Download the Altair license package from the Altair website and follow
the Altair® License Management System 14.0 Installation and Operation Guide to install and start
the Altair License Manager properly.
Altair HyperWorks 2019 Installation Guide
Prepare to Install Altair HyperWorks p.17

Platform Support
Platforms, operating systems, and processors supported by Altair HyperWorks 2019. This includes 2019
solver packages.

Platforms HyperWorks 2019

OS Version Architecture GUI Products Solvers

Windows 7/10 x86_64 YES YES

Linux
1 RHEL and CentOS x86_64 YES YES

6.6/7.2

SLES 12 SP2

SLES = SUSE Linux Enterprise Server


RHEL= Red Hat Enterprise Linux

1. Check system requirements for Linux package details.


Altair HyperWorks 2019 may install and run on other non-supported Linux distributions but Altair
does not test, certify, verify or warrant the reliability of the products on these platforms.
• Altair products are tested on Gnome window managers.
• Xen kernels are currently not supported kernels for Altair HyperWorks 2019 applications.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Prepare to Install Altair HyperWorks p.18

Installation Media
The Altair HyperWorks 2019 software package you received from Altair includes a set of DVDs or a USB
thumb drive containing HyperWorks 2019, the Altair License Manager and documentation.

The software is available for registered customers to download from Altair Connect.

Download the images for the platforms on which you expect to launch HyperWorks. There are eighteen
packages required for a complete HyperWorks installation on Windows, and eleven for Linux. Here is an
example list of the Master Installer and product sub-installers for Windows:
1. Altair HyperWorks Master Installer
2. Altair HyperWorks Desktop
3. Altair SimLab
4. Altair Feko + WinProp
5. Altair Flux
6. Altair HyperWorks Solvers
7. Altair CFD Solvers
8. Altair Virtual Wind Tunnel ultraFluidX
9. Altair Activate
10. Altair Compose
11. Altair Inspire
12. Altair Inspire Cast
13. Altair Inspire Form
14. Altair Inspire Extrude Metal
15. Altair Inspire Extrude Polymer
16. Altair HyperWorks Desktop Help
17. Altair HyperWorks Solvers Help
18. Altair ConnectMe

The two Help sub-installers together make up a complete HyperWorks 2019 Help installation.

USB Hardware Keys (License Dongles)


Altair supports a subset of the available HOSTID values from X-Formation as well as hardware license
dongles (USB keys) on some platforms. In order to use a dongle, you must have a free/open USB port
on the machine that will be your license server.

If you have purchased a hardware dongle to use for licensing, you must obtain the dongle ID via the
software before requesting your license file. Hardware dongles are supported on Windows and Linux
platforms.

In order for the dongle to function properly, you must first install the correct drivers for your platform.
These drivers are available from Aladdin, the manufacturer of the key. Download and install the driver
according the directions available at the following URL:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Prepare to Install Altair HyperWorks p.19

http://www.aladdin.com/support/hasp/enduser.aspx

Once the driver is installed and the dongle is in place, use the almutil –hostid command to query for
all the HOSTIDs on the machine and report the dongle HOSTID.

Configure Non-US Keyboards


Instructions for your operating system to install a local keyboard configuration.

Altair HyperWorks ships with the keyboard configuration set for a US keyboard. Other countries
(Germany, for example) use extended keyboards to generate native characters not present in the US
ASCII character set.

• Configure non-US keyboards on Windows 10.


a) From the Start Menu, select Control Panel.
b) Select Clock, Language, and Region.
c) Select Language.
d) Click Advanced Settings and select the proper one from the drop-down list.
e) Click Save.
• Configure non-US keyboards on Windows 7.
a) From the Start Menu, select Control Panel.
b) Select Region and Language.
c) Select the Keyboard and Languages tab.
d) Click Change keyboards and select the proper one from the drop-down list.
e) Click OK.
f) Click OK to close the dialog.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Prepare to Install Altair HyperWorks p.20

Download from Altair Connect


Instructions on how to download Altair products from Altair Connect.
Before you begin, open Altair Connect in a web browser.
1. From the menu bar, click Downloads.
2. From the Software Downloads drop-down, click HyperWorks.
3. From the Step 1: Select Suite Version drop-down, select a suite version.
4. From the Step 2: Select Platform drop-down, select a platform.
5. Under Step3: Select Package, select the software packages to download.
6. From the Software tab, click the download button under each software package you would like to
download.

Figure 1:

Figure 2:

Proprietary Information of Altair Engineering


Install Altair HyperWorks 3
Install Altair HyperWorks

Instructions for installing Altair HyperWorks.

This chapter covers the following:

• Install Altair HyperWorks: Local Installation (p. 22)


• Install Altair HyperWorks: Client/Server Installation (p. 36)

Two procedures are necessary to enable HyperWorks. First, using the installation configuration you
selected in Prepare to Install Altair HyperWorks as a guide, install the HyperWorks software on your
machine(s). Secondly, you must be able to point to an activated license server that allows HyperWorks
applications to draw license units.

Important: You should not mix installers of different major release versions, for example –
2019 with 2018 installers, updates and hotfixes.

HyperWorks 2019 can be installed via a Graphical User Interface (GUI) mode, silent mode, or console
mode. The following sections describe how to install the software via each method.

The HyperWorks 2019 Help is a browser-based HTML system that uses ActiveX on Windows and Java
Script on Linux. It can be installed with the applications or installed alone behaving as an online help
server.

For Help installations on a network server, make sure to have the Help UNC or network path prior to
running the installer. You will be prompted for this information during the install.
Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.22

Install Altair HyperWorks: Local Installation

Installation Files
Altair HyperWorks 2019 has the ability to install the individual product installers separately from one
another, referenced as sub-installers in this document, while also giving you an option to install all of
them at once via the Master Installer in a batch-like mode (recommended).

The Windows installers have added the Altair Engineering, Inc. digital signatures for enhanced security.

Reference Table 1 for specific file names and details on the product groups per individual sub-installers.

The HyperWorks Master Installer, for example hw2019_win64.exe for Windows, is a quick and easy
setup installer allowing for various combinations of the independent sub-installers to be installed at
one time. It is done without the need to wait for all the packages to extract prior to setting up the
installation, which should allow for a quick setup to install a complete HyperWorks 2019 installation.
Using the Master Installer is the recommended method for installing HyperWorks 2019 products.

Table 1: HyperWorks 2019 Installer File Names

Installer Name Description

hw2019_win64.exe Master Installer, used to setup and install


hw2019_linux64.bin the separate individual HyperWorks installers
simultaneously. You can select which products to
install, or install them all at once.

hwCFDSolvers2019_win64.exe Installer of the CFD Solvers suite of products


hwCFDSolvers2019_linux64.bin (includes AcuSolve on Windows and Linux, and
nanoFluidX and ultraFluidX on Linux).

hwDesktop2019_win64.exe Installer of the HyperWorks Desktop suite of


hwDesktop2019_linux64.bin products (includes most GUI applications, such as
HyperView, HyperMesh, HyperGraph, HyperStudy,
and so on).

hwSolvers2019_win64.exe Installer of the HyperWorks Solvers suite


hwSolvers2019_linux64.bin of products (includes Radioss, OptiStruct,
MotionSolve, and so on).

hwDesktopHelp2019_win64.exe Installer of the HyperWorks Desktop Help content.


hwDesktopHelp2019_linux64.bin

hwSolversHelp2019_win64.exe Installer of the HyperWorks Solvers Help content.


hwSolversHelp2019_linux64.bin

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.23

Installer Name Description

hwFeko2019_win64.exe Installer for Feko and WinProp GUI and solver


hwFeko2019_linux64.bin products.

hwFlux2019_win64.exe Installer for Flux GUI and solver products.


hwFlux2019_linux64.bin

AltairSimLab2019.1_win64.exe Installer of the SimLab product. Refer to the


AltairSimLab2019.1_linux64.bin SimLab installation guide for additional details.
SimLab2019.1_Additionals_Windows.zip

AltairActivate2019.1_win64.exe Installer of the Activate product.

AltairCompose2019.1_win64.exe Installer of the Compose product.


AltairCompose2019.1_linux64.bin

hwVirtualWindTunnelUltraFluidX2019_win64.exe Installer of the Virtual Wind Tunnel for ultraFluidX


hwVirtualWindTunnelUltraFluidX2019_linux64.bin product.

AltairInspire2019.1_win64.exe Installer of the Inspire product.

AltairInspireCast2019.1_win64.exe Installer of the Inspire Cast product.

AltairInspireExtrudeMetal2019.1_win64.exe Installers of the Inspire Extrude Metal and Inspire


AltairInspireExtrudePolymer2019.1_win64.exe Extrude Polymer products.

AltairInspireForm2019.1_win64.exe Installer of the Inspire Form product.

hwConnectMe2019_win64.exe Installer of the ConnectMe tool.

To install Help along with the application, download and place the Help files sub-installers
hwDesktopHelp and hwSolversHelp files, which are executable files on Windows and bin file types on
Linux, in the same residing directory as the HyperWorks Master Installer. Help files contain the help and
tutorial model files. The user has the option to select and install complete help and tutorials, or either
one individually.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.24

Install Altair HyperWorks via GUI Mode

Windows (Local) Installation


Complete the following steps to extract and install the software.

1. Log in to the machine on which the software is to be installed, then insert the USB/DVD, or place
the downloaded files in a temporary directory.
Example of a directory with all the required sub-installers for a complete HyperWorks 2019
installation on a Windows 64-bit platform, with the Master Installer highlighted:

Figure 3:

For a base Help Files install both the hwDesktopHelp and hwSolversHelp sub-installers will need
to be installed together using the Master Installer. For Manufacturing Solutions or Engineering
Solutions to be installed, the Master Installer will have to be used together with the hwDesktop
and hwSolvers sub-installers.

Note: Please make sure that the downloaded files have “read + execute” permissions
before continuing with an installation. Use Windows Explorer file properties to change
the permissions.

2. Double-click the hw2019_win64.exe Master Installer executable file to start the installer.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.25

3. If UAC (User Account Control) is enabled, then a prompt displays showing the Altair Engineering,
Inc. digital signature for elevated permissions. Click Yes to continue with installer.

Figure 4:

4. In the multi-language selector prompt, select the proper locale and click OK to continue.
The default locale setting is specific to the install machine regional settings. The language
selection only corresponds to the installer settings not to the HyperWorks product language
settings. HyperWorks products are in English.
5. In the Introduction panel, click Next to continue.
6. In the Choose Installation Type panel, choose Local and click Next.
7. In the Choose Install Folder panel, choose the HyperWorks install directory and click Next.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example C:\

8. In the Change Shortcut Folder (Local) panel, choose a Start Menu name for the HyperWorks
install and select whether desktop shortcuts are created. There are options on this panel to
associate HyperWorks file types to products, install ConnectMe, and to generate thumbnail
previews for HyperMesh files. These options are selected by default. Once options are chosen,
click Next to continue.
9. In the Choose Install Set panel, select the products to install. Click Next to continue.
You can now install compatible hotfixes, that are not selected by default, for HyperWorks Desktop,
HyperWorks Solvers, and CFD Solvers as well.

Products that do not have sub-installer present or were not picked up by the Master Installer in
the residing directory will be listed as (Unavailable) and are not available to be installed.

Note: Manufacturing Solutions and Engineering Solutions require both the hwDesktop
and hwSolvers sub-installers to be present. The Help Files requires both the
hwDesktopHelp and hwSolversHelp sub-installers to be present.

10. If Help was NOT selected to be installed, the Help Configuration panel is displayed. Select one of
the options:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.26

• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.

11. In the Set up Licensing panel, your current license is displayed. Select one of the following
options:
• Choose Enter license server to input the license server (port@host) or choose a license file.
• Choose Skip this step if you do not want to change your license settings at this time.
12. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Click Install to continue.

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

13. Once the installation completes, click Done to exit the installer.

Linux Installation
Complete the following steps to extract and install the software.

Altair HyperWorks install directories with spaces are not supported on Linux.

1. Run the shell command sh with the installer binary as an argument.


2. In the multi-language selector prompt, select the proper locale and click OK to continue.
The language selection only corresponds to the installer settings not to the HyperWorks product
language settings. HyperWorks products are in English.
3. In the Introduction panel, click Next to continue.
4. In the Choose Install Folder panel, choose the HyperWorks install directory and click Next.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example /

5. In the Choose Install Set panel, select the products to install. Click Next to continue.
You can now install compatible hotfixes, that are not selected by default, for HyperWorks Desktop,
HyperWorks Solvers, and CFD Solvers as well.

Products that do not have sub-installer present or were not picked up by the Master Installer in
the residing directory will be listed as (Unavailable) and are not available to be installed.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.27

Note: Manufacturing Solutions and Engineering Solutions require both the hwDesktop
and hwSolvers sub-installers to be present. The Help Files requires both the
hwDesktopHelp and hwSolversHelp sub-installers to be present.

6. If Help was NOT selected to be installed, the Help Configuration panel is displayed. Select one of
the options:
• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.

Note: A valid Linux web browser will need to also be defined in this panel
(HW_MSG_BROWSER).

7. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Click Install to continue.

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

8. Once the installation completes, click Done to exit the installer.

Register the Altair HyperView Player Plugin


Instructions for manually registering the latest Altair HyperView Player Plugin in the case of multiple
HyperView/HyperView Player installations.

The HyperView Player plugin for Microsoft Office documents and Internet Explorer is installed and
registered by default with the HyperView Player installation.
1. Click Start > All Programs > Altair 2019 > Tools.
2. Right click on Register HVPControl and select Run as administrator.
3. Invoke the currently installed HyperView Player either using the Start Menu shortcut, or from the
following location: <InstallDirectory>\hw\bin\win64\hvp.exe

On Linux, please reference the web or local Help section for detailed information.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.28

Install Altair HyperWorks via Console Mode


Console mode installations mimic the default Graphical User Interface steps provided by the Altair
HyperWorks installer but use only the standard input and output.

The advantage to console mode installation is that Linux users no longer need X-windows (X11) to run
the installer.

Console mode allows for text to be output to the console terminal line-by-line. It does not allow for any
formatting, clearing of the screen, or positioning of the cursor.

To trigger a console mode installer from the command line, append the following command parameter
to the installer: -i console.
Example console mode install call:

hw2019_linux64.bin –i console

The Linux console mode is only supported on the HyperWorks Linux installers. Just follow the on screen
instructions to complete the installation.

Install Altair HyperWorks via Console Mode on Linux


1. Open a command terminal window/prompt.
a) cd – change directory – to the location where the installer executable resides.
b) Execute the sh command on the installer binary with the additional parameter "-i console",
for example sh hw2019_linux64.bin -i console .
The Altair HyperWorks installer extracts the JVM (Java Virtual Machine) and the install modules to
the TMP location of the machine and launches the installer.

sh hw2019_linux64.bin

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Note: If the /tmp location on the machine is full, the installer will try to use the user’s
home folder for temp files or the user can set the environment variable IATEMPDIR to
a custom specified TMP location.

2. In the multi-language selector prompt, select the proper locale and press Enter to continue.
The language selection only corresponds to the installer settings not to the HyperWorks product
language settings. HyperWorks products are in English.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.29

3. In the Introduction panel, press Enter to continue.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.30

4. In the Choose Install Folder panel, choose the HyperWorks install directory and press Enter.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example /

5. In the Choose Install Set panel, choose the products you wish to unselect and enter the number
in the line provided and press Enter. The “X” next to the product selects it to be installed. By
default, all the available full products are selected and marked to be installed. You can now install
compatible hotfixes, that are not selected by default, for Altair HyperWorks Desktop, HyperWorks
Solvers, and CFD Solvers as well. Products which do not have a sub-installer present or picked up
by the Master Installer in the residing directory will be listed as (Unavailable) and are not available
to be installed.

Note: Altair Manufacturing Solutions and Altair Engineering Solutions require both the
hwDesktop and hwSolvers sub-installers to be present. The Help Files requires both
the hwDesktopHelp and hwSolversHelp sub-installers to be present.

Choose Install Set


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

ENTER A COMMA_SEPARATED LIST OF NUMBERS REPRESENTING THE FEATURES YOU WOULD


LIKE TO SELECT, OR DESELECT. TO VIEW A FEATURE'S DESCRIPTION, ENTER
'?<NUMBER>'. PRESS <RETURN> WHEN YOU ARE DONE:

1- [-] HyperWorks
2- |-[X] Desktop v2019
3- |-[X] SimLab v2019.1
4- |-[X] Feko + WinProp v2019
5- |-[X] Flux v2019
6- |-[X] Solvers v2019
7- |-[X] CFD Solvers v2019
8- |-[X] Virtual Wind Tunnel ultraFluidX v2019
9- |-[X] Compose v2019.1
10- |-[ ] Help Files - Desktop v2019 / Solvers v2019
11- |-[ ] Help
12- |-[ ] Tutorials

Please choose the Features to be installed by this installer.:

6. If Help was NOT selected, to be installed, the Help Configuration panel is displayed. Select one
of the options:
• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.
7. In the Choose Web Browser for Help panel, input the path of the web browser to use with
HyperWorks help. Press Enter.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.31

8. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Press Enter to continue.

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

9. Once the installation completes, press Enter to exit the installer.

Install Altair HyperWorks via Silent Mode


Silent mode enables the installer to run without any user interaction.

A near-silent mode is possible on Windows.

InstallAnywhere and Altair HyperWorks end-user-defined variables may be set through command line
parameters or a properties response file.

Response files are created and used in silent mode since there is no end user interaction.

The installer runs either on the defaults provided by the installer package or by providing a response file
from which the installer retrieves the values for various InstallAnywhere and HyperWorks variables used
to control the install.

The installer automatically checks the residing directory for a file called installer.properties,
however, this file name and type is NOT supported by the HyperWorks installers and cannot reside in
the same folder as our installs.

The response file will need a unique name in order to work properly with the HyperWorks installers,
example, hw2019_installer.properties, will work with the HyperWorks installer.

You can generate a response file from the installer by running through the installer with the following
command line syntax:

-r "[FullPath]\hw2019_installer.properties"

The file will get created once the installer is complete. To trigger a silent installer from the command
line, type the following:

[InstallerName] –i silent

You may also call a properties response file from the command line by typing:

[InstallerName] –i silent –f “[FullPath]\hw2019_installer.properties”

An example of running a silent install using a properties response file located in C:\ResponseFiles
called hw2019_installer.properties on Windows:

hw2019_win64.exe –i silent –f "C:\ResponseFiles\hw2019_installer.properties"

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.32

Note: Use quotes around any directory and pathnames that may contain spaces.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.33

Response Files
Response files are used with the silent mode installers to give the default values of an install that
includes local help.

The files contain text in a simple key=value format.

#Choose Installation Type


#------------------------
LOCAL_INSTALLATION=1
SERVER_INSTALLATION=0

#Choose Install Folder


#---------------------
USER_INSTALL_DIR=C:\\Program Files\\Altair\\2019

#Change Shortcut Folder (Local)


#------------------------------
SET_START_MENU_FOLDER=Altair 2019
INSTALL_DESKTOP_SHORTCUTS=0
DONOT_INSTALL_DESKTOP_SHORTCUTS=1
CREATE_HWD_FA=1
DONOT_CREATE_HWD_FA=0
CREATETHUMBNAILSCHKD=1
INSTALL_CME=1

#Choose Install Set


#------------------
CHOSEN_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,ALTRINSP,ALTRCAST,
ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW
CHOSEN_INSTALL_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,ALTRINSP,
ALTRCAST,ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW
CHOSEN_INSTALL_SET=Custom

#Command Line Feature List


#-------------------------
CL_CHOSEN_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,ALTRINSP,ALTRCAST,
ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW

#Set up Licensing
#----------------
USER_INPUT_ADD_LIC=0
ALTAIR_LICENSE_PATH_VALUE=
USER_INPUT_SKIP_STEP=1

Figure 5: Example: Properties Response File

The values in the response files are all referenced from user input taken from a Altair HyperWorks
install and used as default values toward future installs.

Note: The installer will use double backslashes “\\” on Windows platforms for the directory
names.
Spaces should not be used between the VARIABLE=VALUE statements in the response files

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.34

Sample Response File with Descriptions of Variables


A sample pre-defined response file to be used with the Altair HyperWorks 2019 Installers.

Please make sure to use a unique name for the response file and not the general
installer.properties file name structure, since the generic name is not supported in HyperWorks
installers.

# SAMPLE response file for Altair HyperWorks 2019 Windows installers


# Modifying the below variables will allow for customized installation of Altair
HyperWorks
# Replay feature output
# This file was built by the Replay feature of InstallAnywhere.
# It contains variables that were set by Panels, Consoles or Custom Code.
# Binary format is used to activate and deactivate variables - 1 is "on" and 0 is
"off"
# INSTALLER_UI sets the user interface and the options are console, GUI and silent
# The below example is using a silent install method INSTALLER_UI=silent
# Uninstall information only to be used with silent uninstalls are
INSTALL_CLEANUP_ALL and FEATURE_UNINSTALL
# INSTALL_CLEANUP_ALL=1
# will set the uninstall to completely remove all files and folders from an install
Note: backup any files before uninstalling
# FEATURE_UNINSTALL=COMPLETE
# This will uninstall all features installed. The only method used with the Altair
HyperWorks installer.
# Choose Installation Type - Setting this will variable to the appropriate option
will install
# Altair HyperWorks as a local install compared to a server install.
#------------------------
# The below example will install Altair HyperWorks as a local install
LOCAL_INSTALLATION=1
SERVER_INSTALLATION=0
# Choose Install Folder - This is the location where the Altair HyperWorks
installation will be placed.
# The directory will be created if it does not exist.
# Note: "\\" are always used to separate directory trees
#---------------------
# The below example will install Altair HyperWorks into the default location for a
Windows install USER_INSTALL_DIR=C:\\Program Files\\Altair\\2019

#Change Shortcut Folder (Local) - This section will install Shortcuts for the Windows
Start Menu and Desktop.
# The below example shows the default Start Menu directory and the Desktop shortcuts
being installed as well.
#------------------------------
SET_START_MENU_FOLDER=Altair 2019
INSTALL_DESKTOP_SHORTCUTS=1 DONOT_INSTALL_DESKTOP_SHORTCUTS=0 CREATE_HWD_FA=1
DONOT_CREATE_HWD_FA=0 CREATETHUMBNAILSCHKD=1 INSTALL_CME=1
#Choose Install Set - Installs the chosen Altair HyperWorks products, either Custom
or Complete.
# This depends on the selection and the availability of the product installer package
#------------------
# IMPORTANT: The below CL_CHOSEN_FEATURE_LIST is a required variable in Altair
HyperWorks 2019 installers
# and needs to be set to the same CHOSEN_FEATURE_LIST content.

CHOSEN_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,ALTRINSP,
ALTRCAST,ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW

CHOSEN_INSTALL_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.35

ALTRINSP,ALTRCAST,ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW
CHOSEN_INSTALL_SET=Custom

#Command Line Feature List


#-------------------------
CL_CHOSEN_FEATURE_LIST=HW,HWD,SL,FEKO,Flux,SLVR,CFDS,VWTUFX,ALTRATV,ALTRCMP,ALTRINSP,
ALTRCAST,ALTRFORM,ALTRXMTL,ALTRXPLR,HWFhelp,helpHW,tutsHW

# This is the list of the features, according to the Choose Install Set GUI panel
picks
# HW - Altair HyperWorks
# HWD - Altair HyperWorks Desktop
# HFXHD – Altair HyperWorks Desktop hotfix
# SL - Altair SimLab
# SLVR - Altair HyperWorks Solvers
# HFXHS – Altair HyperWorks Solvers hotfix
# CFDS – Altair CFD Solvers
# HFXCFDS - Altair CFD Solvers hotfix
# VWTUFX - Altair Virtual Wind Tunnel ultraFluidX
# FEKO – Altair Feko
# Flux – Altair Flux
# HWFhelp - Altair HyperWorks help files
# helpHW - Help
# tutsHW – Tutorials
# ALTRATV – Altair Activate
# ALTRCMP – Altair Compose
# ALTRINSP - Altair Inspire
# ALTRCAST – Altair Inspire Cast
# ALTRFORM – Altair Inspire Form
# ALTRXMTL – Altair Inspire Extrude Metal
# ALTRXPLR – Altair Inspire Extrude Polymer

#Help Configuration - this panel is to set Help options for populating the file
hwhelp.cfg in the install directory.
#------------------
# 0 is false/off and 1 is true/on in the variables below.
# The HELP_CONNECT_NETWORK will require the MW_MSG_HELP_WIN variable to be set.
#HELP_CONNECT_NETWORK=0
# Setting the HW_MSG_HELP_WIN variable will try to install the Help locally.
#HW_MSG_HELP_WIN=C:\\Program Files\\Altair\\2019\help

# The HELP_CONNECT_ALTAIR variable, when active will point to the Altair Web Help -
internet connection required
#HELP_CONNECT_ALTAIR=1

# The HELP_SETUP_LATER will not set anything in the hwhelp.cfg file but will try to
access help from the Altair Web site when chosen.
#HELP_SETUP_LATER=0

#Set up Licensing – this panel allows you to check and modify your Altair license
settings
#----------------
USER_INPUT_ADD_LIC=1
ALTAIR_LICENSE_PATH_VALUE=<licenseServerPort@Host>
USER_INPUT_SKIP_STEP=0

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.36

Install Altair HyperWorks: Client/Server


Installation
Instruction for setting up the client machine if a server type installation is chosen.

Requirements for a NETSETUP client install include:


• Existence of an Altair HyperWorks network server install.
• The UNC paths of the location of the HyperWorks network server installs (or use Networks on
Windows 7/10 to get to the NETSETUP client installer directory).

Altair Virtual Wind Tunnel, Inspire products, Activate, Compose, and Flux are not available in the server
type installs.

Note: The installer does not allow for the use of drive letter or mapped drive letter paths.

Install Altair HyperWorks via GUI Mode


Client NETSETUP of an Altair HyperWorks network server install on Windows only.

The NETSETUP supports the GUI and silent installation modes. The example below is shown for a GUI
NETSETUP client Windows 7 64-bit install.

1. From the Control panel, go to Networks.


2. Click on the machine and install location of the HyperWorks server install.
3. Go to the NETSETUP folder.
4. Go to the win64 folder.
5. Click on the NETSETUP.bat file.
A command prompt terminal window will be displayed showing that the installer is unpacking on
the client machines. The locale language selection prompt will then be displayed.
6. Select the locale language and click OK to continue.
The Install Desktop Shortcuts options panel is displayed.
7. Make changes if needed and click Next to continue.
The Set up Licensing panel is displayed.
8. Check your Altair license settings, and make changes if needed.
The Pre-Installation Summary panel is displayed.
9. Review the summary and click Install to complete the HyperWorks NETSETUP client install.
The appropriate Start Menu and Desktop Shortcuts are created on the client machine.
10. Once it completes, click Done to exit the Install wizard.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.37

Windows (Server Mode) Installation


Complete the following steps to extract and install the software.

1. Double click the installer executable file to start the installer.


2. If UAC (User Account Control) is enabled, then a prompt displays showing the Altair Engineering,
Inc. digital signature for elevated permissions. Click Yes to continue with installer.

Figure 6:

3. In the multi-language selector prompt, select the proper locale and click OK to continue.
The default locale setting is specific to the install machine regional settings. The language
selection only corresponds to the installer settings not to the HyperWorks product language
settings. HyperWorks products are in English.

Figure 7:

4. In the Introduction panel, click Next to continue.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.38

Figure 8:

5. In the Choose Installation Type panel, choose Server and click Next.

Figure 9:

6. In the Choose Install Folder panel, choose the HyperWorks install directory and click Next.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example C:\

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.39

Figure 10:

7. In the Change Shortcut Folder (Server) panel, choose a Start Menu name for the HyperWorks
install and select whether desktop shortcuts are created. Once options are chosen, click Next to
continue.

Figure 11:

8. In the Choose Install Set panel, select the products to install. Click Next to continue.
Products that do not have sub-installer present or were not picked up by the Master Installer in
the residing directory will be listed as (Unavailable) and are not available to be installed.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.40

Note: Manufacturing Solutions and Engineering Solutions require both the hwDesktop
and hwSolvers sub-installers to be present. The Help Files requires both the
hwDesktopHelp and hwSolversHelp sub-installers to be present.

Figure 12:

9. If the install folder was not provided as a UNC path, enter the UNC path in the UNC (Uniform
Naming Convention) mount point panel and click Next to continue.

Note: User input should be in UNC standard form to be accepted. For example,

\\MachineName\SharedFolder\InstallFolder

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.41

Figure 13:

10. If Help was NOT selected to be installed, the Help Configuration panel is displayed. Select one of
the options:
• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.42

Figure 14:

11. In the Set up Licensing panel, your current license is displayed. Select one of the following
options:
• Choose Enter license server to input the license server (port@host) or choose a license file.
• Choose Skip this step if you do not want to change your license settings at this time.

Figure 15:

12. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Click Install to continue.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.43

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

Figure 16:

13. Once the installation completes, click Done to exit the installer.

Figure 17:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Install Altair HyperWorks p.44

Install Altair HyperWorks via Silent Mode


Steps to create a properties file for the client NETSETUP installer.

This step only needs to be done once in order to establish the defaults for the installer.

1. From the Control panel, go to Networks.


2. Click on the machine and install location of the HyperWorks server install.
3. Go to the NETSETUP folder.
4. Go to the win64 folder.
5. Click on the NETSETUPproperties.bat file.
A command prompt will be displayed to make sure the end user has write permissions to the
NETSETUP network location, where the properties response file gets created.

Figure 18:

6. Input Y and press Enter to continue.


A command prompt terminal window will be displayed showing that the installer is unpacking on
the client machines. The locale language selection prompt will then be displayed.
7. Select the locale language and click OK to continue.
The Install Desktop Shortcuts options panel is displayed.
8. Make changes if needed and click Next to continue.
The Pre-Installation Summary panel is displayed.
9. Review the summary and click Install to complete the HyperWorks NETSETUP client install.
The appropriate Start Menu and Desktop Shortcuts are created on the client machine.
10. Once it completes, click Done to exit the Install wizard.
The installer creates a file under the NETSETUP platform folder called
NETSETUP_installer.properties. This will be used for future client NETSETUP installs.

To run the silent NETSETUP installer on other machines using the selected defaults from the above
setup, go to the NETSETUP folder and click on the NETSETUPsilentinstall.bat file.

Proprietary Information of Altair Engineering


Connect to the Altair License
Management System 14.0 4
Connect to the Altair License Management System 14.0

The Altair License Management System 14.0 (ALMS) provides a common units-based licensing model
for all Altair software related to CAE, on-demand computing, and business intelligence.

This chapter covers the following:

• Requirements (p. 46)


• Node Locked Licenses (p. 47)

This new system has been designed to enable Altair HyperWorks Partner Products (selected third party
products) to be licensed via HyperWorks Units as well.

The ALMS is comprised of two components: the License Server and the Usage Reporting System (URT).
The license system is based on X-Formation's LM-X license server. The URT is a java application that
reports anonymous transactional logs to Altair. As part of the license agreement that enables partner
software to be used, product usage must be reported to Altair.

Altair License Management System 14.0 is based on X-Formation’s LM-X License Management System
Version 5.
Altair HyperWorks 2019 Installation Guide
Connect to the Altair License Management System 14.0 p.46

Requirements
In order for applications to use the ALMS, the environment variable, ALTAIR_LICENSE_PATH, must point
to the appropriate location.

Multiple license paths are allowed and should be separated by a semicolon (;) on Windows and a colon
(:) on Linux. The proper format for a network license location is port@hostname. If you are using a
local license file, simply set the value to the full pathname of the file.

A few examples of license paths:

On Windows:

ALTAIR_LICENSE_PATH=6200@server.foo.bar.com
ALTAIR_LICENSE_PATH=6200@srv1;6200@srv2;6200@srv3
ALTAIR_LICENSE_PATH=c:\Program Files\Altair\Licensing14.0\altair_lic.dat

On Linux:

ALTAIR_LICENSE_PATH=6200@server.foo.bar.com
ALTAIR_LICENSE_PATH=6200@srv1:6200@srv2:6200@srv3
ALTAIR_LICENSE_PATH=/usr/local/altair/licensing14.0/altair_lic.dat

For High Availability License (HAL) System and/or multiple servers setups, list the three servers in the
order: primary; secondary; tertiary.

Examples of license paths:

BASH shell (.profile, .bashrc):

export ALTAIR_LICENSE_PATH=6200@server.name.com

C shell (.tchsrc, .cshrc):

setenv ALTAIR_LICENSE_PATH 6200@server.name.com

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Connect to the Altair License Management System 14.0 p.47

Node Locked Licenses


For node-locked license (a license that is locked to a local machine), you can either place the license file
in the <install_dir>/altair/security/ directory named as altair_lic.dat, or set the environment
variable, ALTAIR_LICENSE_PATH, to point to the appropriate location where the license file resides.

The preferred method is to save your license to a location separate from HyperWorks installations and
set the environment variable to point at this license.

Proprietary Information of Altair Engineering


Start Altair HyperWorks
Applications 5
Start Altair HyperWorks Applications

This chapter covers the following:

• Start on Windows (p. 49)


• Start on Linux (p. 50)
Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.49

Start on Windows
Instructions for starting Altair HyperWorks applications in Windows.
The installation process creates a HyperWorks group available from the Start menu. The folder
containing the applications receives a default name by the Altair HyperWorks Installation wizard.
Most applications can be started using the following instructions. The example below uses the default
settings.

1. Click Start > Programs > Altair 2019.


2. From the list, select the name of the program to run.

Alternatively, Altair ConnectMe can also be used to launch a product. ConnectMe lists all of the Altair
products that can be installed on a machine. You can download ConnectMe from Altair Connect, and
install it via the master installer or as a standalone.

Change the Default Working Directory on Windows


Instructions for changing the default working directory.

The default working directory specified by a HyperWorks application is C:\Users\[UserID]\Documents.

Note: If you create a shortcut directly from the <install_location>\application\bin


directory, the start in directory of the shortcut will be from that directory. We recommend
that you change the start in path to: "%userprofile%\documents" or any directory you
prefer.

1. Click Start > Programs > Altair 2019.


2. Right-click on the HyperWorks application for which you want to set the working directory.
3. From the menu, select Properties.
4. Select the Shortcut tab.
5. In the Start in text box, enter the explicit path name of the folder from which you want to run the
HyperWorks application.
6. Click OK
Your user files are created in the directory specified in Step 5. For example, if you had selected
HyperMesh, the command.tcl and hmmenu.set would go to this directory.

The default start-in directory can also be changed by selecting Altair ConnectMe > Settings >
General.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.50

Start on Linux
All Altair HyperWorks applications start by running the appropriate script from the
<install_location>/altair/scripts directory.

The scripts directory contains the launch procedure for each HyperWorks application, and tools such as
hvtrans. In addition, it contains the /invoke sub-directory where various sub-procedures used by the
launch procedures are stored.

The general start command to enter at the terminal prompt is:

<install_location>/altair/scripts/<script name>

where <script name> is the script name associated with the particular application and the optional
[file name] applies to the applications that require an input file when they start.

For example, to start HyperMesh you would enter the following at the prompt:

<install_location>/altair/scripts/hm

The following scripts are used to launch HyperWorks applications:

Command Options Description

acusim Launch AcuSolve Product


environment

basicfea Launch BasicFEA profile

blanknest Launch BlankNesting

cadfeko Launch CADFEKO-model creator


(geometry, mesh, configuration)

cadfekobatch Launch command line model


mesher

Compose Launch Compose

Compose_Batch Launch Compose in batch mode

Compose_Console Launch Compose console mode

Compose_Help Open Compose help

editfeko Launch EDITFEKO-advanced


text-based model creator

es_aerospace Launch Engineering Solutions/


HyperWorks Aero

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.51

Command Options Description

es_basicfea Launch Engineering Solutions/


BasicFEA_profile

es_cfd Launch Engineering Solutions/


HyperWorks CFD

es_crash Launch Engineering Solutions/


Crash

es_droptest Launch Engineering Solutions/


Drop Test

es_nvh Launch Engineering Solutions/


NVH

feko_help Launch Feko help

FluxSupervisor Launch Flux Supervisor

hc Launch HyperCrash

help Open HyperWorks local help

hfsolver Launch Manufacturing Solutions/


Radioss 1 Step

hg Launch HyperGraph

hm Launch HyperMesh

hmbatch -c<command filename> Launch HyperMesh using batch


-tcl <file> mode

hmdesktop Launch HyperMesh client from


HyperWorks Desktop

hst Launch HyperStudy

hst -studyfile=<filename> Automatically read the file after


launching HyperStudy

hstbatch Launch HyperStudy using batch


mode

hv Launch HyperView

hvp Launch HyperView Player

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.52

Command Options Description

hvvh Launch HyperWorks Verification


and Validation Harness tool

hw_batchmesh Launch the Batchmesher


user interface where you can
interactively set up the required
entries

hwx Launches HyperWorks X

hyperlife Launches HyperLife

hx Launch HyperXtrude

mdl_batch -c<session filename> Launch MotionSolve using batch


mode

mfs_forging Launch Manufacturing Solutions/


Forging application

mfs_hf Launch Manufacturing Solutions/


HyperForm application

mfs_hyperweld Launch Manufacturing Solutions/


HyperWeld application

mfs_hx Launch Manufacturing Solutions/


HyperXtrude application

mfs_hypermold Launch Manufacturing Solutions/


HyperMold application

mit Launch HyperGraph Model


Identification tool

motionsolve Launch MotionSolve

motionsolve_subroutine_builder Launch MotionSolve Subroutine


Builder tool

mview Launch MotionView

nfx Launch nanoFluidX

optfeko Launch OPTFEKO-optimization


engine

optistruct Launch OptiStruct

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.53

Command Options Description

ossmooth Launch OSSmooth

pmstudio Launch Process Studio

postfeko Launch POSTFEKO-solution


visualizer (post-processor)

prefeko Launch PREFEKO-model pre-


processor

queuefeko_gui Launch QUEUEFEKO GUI

radioss Launch Radioss

resmap Launch HyperWorks Results


Mapper

runfeko Launch the Feko solver

SimLab2019.1 Launch SimLab

templex Template.tpl <output> Launch Templex

ufx Launch ultraFluidX

VirtualWindTunnel_ultraFluidX Launch Virtual Wind Tunnel for


ultraFluidX

VirtualWindTunnel_ultraFluidX_Help Launch Virtual Wind Tunnel for


ultraFluidX help

On Linux, running a Window Manger, the products can be invoked from an icon type shortcut by double
clicking the icon of the product you wish to launch.

You will need to install the shortcut icons by using the script:

<install_location>/altair/LinuxMenu/install_menu.sh

with the –i option to install or –u to uninstall the shortcut icons for that installation.

Obtain a List of Arguments for an Application on Linux


To obtain a list of arguments and their descriptions, add -help to the start command.
For example, to obtain a list of arguments for HyperMesh, enter the following at the command prompt:

<install_location>/altair/scripts/hm –help

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Start Altair HyperWorks Applications p.54

The application returns a list of the available arguments and what they do.

Proprietary Information of Altair Engineering


Set up Altair HyperWorks Help 6
Set up Altair HyperWorks Help

The Altair HyperWorks help system is a browser-based HTML help system. This section describes how to
set up and access HyperWorks help system.

This chapter covers the following:

• Start Help from the Application Menu (p. 56)


• Start Help from the altair/scripts Directory on Linux (p. 57)
• Access Help Installed on a Server on Windows (p. 58)

The HyperWorks help system can be installed with applications or installed alone on a server.
Help systems for Altair AcuSolve, Feko, Flux, SimLab, and Virtual Wind Tunnel are always installed on
the local machine with applications.

In order for the help to work properly from applications, you must set up a valid Internet browser and
a valid path to the HyperWorks help installation if help is not installed with the application. Help can be
installed via different ways:
• On a local machine along with the HyperWorks software
• Pre-installed on a shared network location
• Use Altair website help

In order for HyperWorks help to work properly, you must set up a valid browser on the machine from
which the application is launched. For Windows, HyperWorks uses the default Windows browser. For
Linux, the valid browser is set during the installation time. You can verify the browser setting stored
in the hwhelp.cfg file. The hwhelp.cfg file is located in the <installation directory>/altair/
directory on Linux, and the top-level installation directory on Windows.

If Help is pre-installed on a shared network location, the information will be stored in the hwhelp.cfg
file as well. A typical hwhelp.cfg file should contain the following information:
HW_MSG_BROWSER /usr/bin/firefox
HW_MSG_HELP <install_dir>/altair/help

If HW_MSG_HELP is not set in the hwhelp.cfg file, HyperWorks application will connect to the Altair
website help automatically.

Important: The help server on Linux platforms does not support tilde (~) completion
of paths. Please make sure that you use the full path for the items HW_MSG_HELP and
HW_MSG_BROWSER if you set them as environment variables, or in hwhelp.cfg. For example,
use /path/to/help_user/my_help instead of ~help_user/my_help.
Altair HyperWorks 2019 Installation Guide
Set up Altair HyperWorks Help p.56

Start Help from the Application Menu


Before you begin, set up the browser and help environment before starting the application as described
in Set up Altair HyperWorks Help

The steps to start help from within an application via the Help menu are similar for most applications.

1. Start the application.


2. Click the Help menu and choose the help for the selected application.

Once the online help has been launched, you can use the Index, Contents, or Search tabs to locate the
help for a specific topic. The context sensitive help works as well.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Set up Altair HyperWorks Help p.57

Start Help from the altair/scripts Directory on


Linux
Each Altair HyperWorks Help book can be invoked via command prompt by running the following script:

altair/scripts/help

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Set up Altair HyperWorks Help p.58

Access Help Installed on a Server on Windows


If you have chosen the Server setup type described in Installing HyperWorks: Client/Server Installation,
each client is installed through NETSETUP as described in Install Altair HyperWorks via GUI Mode. Altair
HyperWorks applications will be available from the Start menu.

If both the HyperWorks application and help are installed on the software server, help can be accessed
on this client as long as a valid browser is installed on the client machine.

Proprietary Information of Altair Engineering


Set up CAD Translators 7
Set up CAD Translators

This chapter covers the following:

• UG Environment Variable Settings (p. 60)


• CATIA V5 License (p. 62)
Altair HyperWorks 2019 Installation Guide
Set up CAD Translators p.60

UG Environment Variable Settings


Since the UG reader needs to use the UGOpen library during the run time, it requires that a valid UG
2
installation and UG license be present and available to the user with the assemblies, gateway and
solid_modeling modules.

The UG installation must be the same bit-level and platform as the version of Altair HyperMesh (thus,
64-bit HyperMesh must be used with 64-bit UG).

Windows Environment Variables


The following environment variables must be set prior to starting:

UGII_BASE_DIR
3
Must point to the UG installation directory .

UGI_ROOT_DIR
3
Must point to the UG installation UGII directory .

PATH
4
Must include the %UGII_BASE_DIR%\UGII\ directory .

SPLM_LICENSE_SERVER
2
Must point to the UG license server .

UGS_LICENSE_SERVER
2
Must point to the UG license server .

UGS_LICENSE_BUNDLE
2
Must specify the UG license bundle .

For example, an UG installation located at C:\Program Files\UGS\NX 6.0:

UGII_BASE_DIR
C:\Program Files\UGS\NX 6.0

UGI_ROOT_DIR
%UGII_BASE_DIR%\UGII\

PATH
%UGII_BASE_DIR%\UGII\

UGS_LICENSE_SERVER
28000@licsrv

UGS_LICENSE_BUNDLE
NXPTNR100

Linux Environment Variables


The following environment variables must be set prior to starting:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Set up CAD Translators p.61

UGII_BASE_DIR
3
Must point to the UG installation directory .

UGI_ROOT_DIR
3
Must point to the UG installation bin directory .

SPLM_LICENSE_SERVER
2
Must point to the UG license server .

UGS_LICENSE_SERVER
2
Must point to the UG license server .

UGS_LICENSE_BUNDLE
2
Must specify the UG license bundle .

For example, an UG installation located at /soft/usr/ugs060:

UGII_BASE_DIR
/soft/usr/ugs060

UGI_ROOT_DIR
/soft/usr/ugs060/bin

UGS_LICENSE_SERVER
28000@licsrv

UGS_LICENSE_BUNDLE
NXPTNR100

2. When using UG versions prior to NX6, a UG license is not required. UG versions 9.0 and later utilize
the SPLM_LICENSE_SERVER variable, while older versions utilize UGS_LICENSE_SERVER
3. UG is very sensitive about the environment variables. You should NOT have '/' at the end of
UGII_BASE_DIR path and you MUST have '/' at the end of UGII_ROOT_DIR path.
4. It is advisable to specify %UGII_BASE_DIR\UGII\UGOpen directory at the beginning of PATH
environment variable to avoid DLL version conflict.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Set up CAD Translators p.62

CATIA V5 License
Altair HyperMesh supports import of CATIA V5 models with .CATPart, .CATProduct and .cgr
extensions.

If you intend to import CATIA V5 models, or CATIA V4 models embedded in CATIA V5 models, you must
obtain a Altair HyperWorks license file with the FEATURE CatiaV5Reader from Altair Engineering.

It is no longer necessary to install, update or manage the third-party library license file.

Proprietary Information of Altair Engineering


Uninstall 8
Uninstall

This chapter covers the following:

• Uninstall: Windows (p. 64)


• Uninstall: Linux (p. 66)
Altair HyperWorks 2019 Installation Guide
Uninstall p.64

Uninstall: Windows
The Altair HyperWorks uninstaller will only Remove All files from the install.

Note: Any modified files or added files, like the altair_lic.dat file, will also be removed
from within that particular install location. Backup any and all files you wish to save prior to
running the uninstaller. There is no partial uninstaller available.

1. Choose one of the following methods:


• From the Start Menu, click Altair 2019 > Tools > Uninstall_HyperWorksMasterInstaller
2019
• From the Control Panel, click Add/Remove or Uninstall a Program and double-click Altair
HyperWorks Master Installer 2019.
2. Follow the prompts to proceed with uninstallation.

Windows Silent Uninstalls Using a Response File


Silent uninstalls for Altair HyperWorks only allows for complete uninstalls of the products, this includes
all folders, directories and files of the HyperWorks install.
1. Backup any important files before proceeding with a silent uninstall.
2. A response file is necessary for using the silent uninstall capabilities. Create a response file adding
the following three variables within it and save it as hw2019_silent_uninstaller.properties.
INSTALLER_UI=silent
FEATURE_UNINSTALL=COMPLETE
INSTALL_CLEANUP_ALL=1
3. Open a command prompt (Administrative elevation is recommended to bypass any User Account
Control prompts as shown in image below):

Figure 19:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Uninstall p.65

4. Run the HyperWorks Uninstaller executable with the hw2019_silent_uninstaller.properties


file using the syntax in the example below (where <INSTALL_PATH> is the path used to install
HyperWorks and <RESPONSE_PATH> is the path where the response file resides):

"C:\<INSTALL_PATH>\2019\uninstalls\Uninstall_HyperWorksMasterInstaller2019
\Uninstall_HyperWorksMasterInstaller2019.exe” –f C:\<RESPONSE_PATH>
\hw2019_silent_uninstaller.properties

This will remove the HyperWorks install completely in silent mode.

Note: Files in the installation directory and the Start Menu folder will be removed, but
any Desktop Shortcuts may remain and need to be manually deleted.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Uninstall p.66

Uninstall: Linux
Run the command rm –Rf install_directory to uninstall the product, where install_directory is
where the HyperWorks installation you would like to remove resides.

Proprietary Information of Altair Engineering


Appendix 9
Appendix

This chapter covers the following:

• Windows (Local) Installation (p. 68)


• Linux Installation (p. 74)
Altair HyperWorks 2019 Installation Guide
Appendix p.68

Windows (Local) Installation


Complete the following steps to extract and install the software.

1. Double click the installer executable file to start the installer.


2. If UAC (User Account Control) is enabled, then a prompt displays showing the Altair Engineering,
Inc. digital signature for elevated permissions. Click Yes to continue with installer.

Figure 20:

3. In the multi-language selector prompt, select the proper locale and click OK to continue.
The default locale setting is specific to the install machine regional settings. The language
selection only corresponds to the installer settings not to the HyperWorks product language
settings. HyperWorks products are in English.

Figure 21:

4. In the Introduction panel, click Next to continue.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.69

Figure 22:

5. In the Choose Installation Type panel, choose Local and click Next.

Figure 23:

6. In the Choose Install Folder panel, choose the HyperWorks install directory and click Next.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example C:\

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.70

Figure 24:

7. In the Change Shortcut Folder (Local) panel, choose a Start Menu name for the HyperWorks
install and select whether desktop shortcuts are created. There are options on this panel to
associate HyperWorks file types to products, install ConnectMe, and to generate thumbnail
previews for HyperMesh files. These options are selected by default. Once options are chosen,
click Next to continue.

Figure 25:

8. In the Choose Install Set panel, select the products to install. Click Next to continue.
You can now install compatible hotfixes, that are not selected by default, for HyperWorks Desktop,
HyperWorks Solvers, and CFD Solvers as well.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.71

Products that do not have sub-installer present or were not picked up by the Master Installer in
the residing directory will be listed as (Unavailable) and are not available to be installed.

Note: Manufacturing Solutions and Engineering Solutions require both the hwDesktop
and hwSolvers sub-installers to be present. The Help Files requires both the
hwDesktopHelp and hwSolversHelp sub-installers to be present.

Figure 26:

9. If Help was NOT selected to be installed, the Help Configuration panel is displayed. Select one of
the options:
• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.72

Figure 27:

10. In the Set up Licensing panel, your current license is displayed. Select one of the following
options:
• Choose Enter license server to input the license server (port@host) or choose a license file.
• Choose Skip this step if you do not want to change your license settings at this time.

Figure 28:

11. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Click Install to continue.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.73

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

Figure 29:

12. Once the installation completes, click Done to exit the installer.

Figure 30:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.74

Linux Installation
Complete the following steps to extract and install the software.
Altair HyperWorks install directories with spaces are not supported on Linux.

1. Open a command terminal window/prompt.


a) cd – change directory – to the location where the installer executable resides.
b) Execute the sh command on the installer binary, for example sh hw2019_linux64.bin.
The HyperWorks installer extracts the JVM (Java Virtual Machine) and the install modules to the
TMP location of the machine and launches the installer.

sh hw2019_linux64.bin

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Note: If the /tmp location on the machine is full, the installer will try to use the user’s
home folder for temp files or the user can set the environment variable IATEMPDIR to
a custom specified TMP location.

2. In the multi-language selector prompt, select the proper locale and click OK to continue.
The language selection only corresponds to the installer settings not to the HyperWorks product
language settings. HyperWorks products are in English.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.75

Figure 31:

3. In the Introduction panel, click Next to continue.

Figure 32:

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.76

4. In the Choose Install Folder panel, choose the HyperWorks install directory and click Next.

Note:
• The installer does not allow the use of characters # and ;
• Installing to a root drive is not permitted, for example /

Figure 33:

5. In the Choose Install Set panel, select the products to install. Click Next to continue.
You can now install compatible hotfixes, that are not selected by default, for HyperWorks Desktop,
HyperWorks Solvers, and CFD Solvers as well.

Products that do not have sub-installer present or were not picked up by the Master Installer in
the residing directory will be listed as (Unavailable) and are not available to be installed.

Note: Manufacturing Solutions and Engineering Solutions require both the hwDesktop
and hwSolvers sub-installers to be present. The Help Files requires both the
hwDesktopHelp and hwSolversHelp sub-installers to be present.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.77

Figure 34:

6. In the Choose Web Browser for Help dialog, input the path of the internet browser to be used
with the HyperWorks Help. Click Next to continue.
7. If Help was NOT selected to be installed, the Help Configuration panel is displayed. Select one of
the options:
• Choose Connect to a network installed Help location to input the path, either UNC or
drive path, to where the Help was installed to create the product link.
• Choose Connect to the Altair website Help to allow the products to connect to the Altair
website Help. A working Internet connection is needed for this functionality.
• Choose Set up Later to allow for a post Help install over the current installation. This option
will default to the website help if an Internet connect is established.

Note: A valid Linux web browser will need to also be defined in this panel
(HW_MSG_BROWSER).

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.78

Figure 35:

8. In the Pre-Installation Summary panel, review the Product Features list, Install Folder and disk
space requirements. Click Install to continue.

Note: Install times are machine hardware dependent. Anti-virus software may
lengthen the install times. The HyperWorks sub-installer and Master Installer may need
to be allowed through any third party firewalls or virus scanning software in order to
not be prompted during install time to allow them access to be installed.

Proprietary Information of Altair Engineering


Altair HyperWorks 2019 Installation Guide
Appendix p.79

Figure 36:

9. Once the installation completes, click Done to exit the installer.

Proprietary Information of Altair Engineering

You might also like