NX Install WNT
NX Install WNT
Introduction ...................................................................................................................................... 4
Conventions ............................................................................................................................................ 4
Basic Windows Techniques ..................................................................................................................... 4
Document Revisions ............................................................................................................................... 5
Media Contents ...................................................................................................................................... 6
Supported Workstations ......................................................................................................................... 6
Licensing NX ............................................................................................................................................ 7
Siemens NX Launcher ............................................................................................................................. 7
Overview of the Installation Process ....................................................................................................... 8
Installation Software Integrity ................................................................................................................ 8
Release Frequency .................................................................................................................................. 8
Functional Product Releases ................................................................................................................... 8
Functional Releases and Associated Monthly Releases .......................................................................... 9
NX Start Menu Changes ........................................................................................................................ 10
Preparing for the Installation............................................................................................................ 11
Licensing Configuration Decisions......................................................................................................... 11
Java Runtime Environment ................................................................................................................... 11
Check File System ................................................................................................................................. 11
Check Disk Space................................................................................................................................... 12
Set Up TCP/IP Network Services ........................................................................................................... 12
Installing NX .......................................................................................................................................... 13
Installation Features Pre-Selected Based On Previously Installed Release ........................................... 13
Installation Features to Cabinet Files Listing ......................................................................................... 13
Changes to Add-On Products Features Default Installation Settings .................................................... 14
Installation Steps................................................................................................................................... 15
Installation Feature Contents................................................................................................................ 18
Using the Maintenance Options ........................................................................................................... 20
Running NX ...................................................................................................................................... 21
Java Runtime Environment ................................................................................................................... 21
Running NX from the Start Menu ......................................................................................................... 21
Running NX by Double-Clicking ............................................................................................................. 21
2
Troubleshooting............................................................................................................................... 39
Windows Diagnostic Tools .................................................................................................................... 39
Launch.exe does not show proper user interface ................................................................................. 39
“Connection to license server machine failed.” during installation ...................................................... 39
Certificate Errors During Installation..................................................................................................... 40
Error writing to file ugshext.dll during update installation ................................................................... 41
Creating Install Log Files........................................................................................................................ 41
Repairing registry entries ...................................................................................................................... 42
NX Won't Start ...................................................................................................................................... 42
Can't Connect to License Server ...................................................................................................................... 42
No Licenses Available ..................................................................................................................................... 42
Error Handling Failed – NX Initialization error ................................................................................................ 45
NX Startup Very Slow ............................................................................................................................ 45
3
Introduction
This document explains the installation and running of NX on supported 64-bit Windows workstations. NX
is not supported on any Windows 32-bit platform. See the Release Notes for operating system
requirements.
Conventions
All references to "Windows" in this manual refer to 64-bit versions of Windows.
Our company name is "Siemens", however, some program names, folder names and some product kit
names may still retain the old UGS company name.
All references to "Siemens License Server" in this manual refer to Siemens License Server software.
Windows menu items and commands will be written in bold letters.
When presenting a series of choices from a Windows pull-down menu, an arrow →will be used to
represent the series of submenus, (e.g., Start→All Apps→Windows System→File Explorer). If you do not
have the Symbol font installed, or you browse this document on a non-Windows computer, you may see
the registered trademark symbol (®) in place of the arrows.
Document Revisions
January 2019 Initial Release for NX.
March 2019 Added content for update installations with MSP file.
April 2019 Updated content for MSP file installations.
June 2019 Updated content for functional release information and NX Launcher product.
August 2019 Minor updates and fixes.
December 2019 Updated for 1899 Series
June 2020 Updated for 1926 Series
December 2020 Updated for 1953 Series
February 2021 Added note about bypassing licensing form using 28000@LocalHost on page 12.
June 2021 Updated for 1980 Series
December 2021 Updated for 2007 Series
March 2022 Added note about higher versions of prerequisites installed on page 12. Fixed
typographical error on page 19.
June 2022 Updated for 2206 Series.
December 2022 Updated for 2212 Series.
January 2023 Added note about "/w" (wait) option on setup.exe during MSI and MSP
automatic (silent) upgrades.
June 2023 Updated for 2306 Series.
July 2023 Added missing install features for silent (automatic) installation.
September 2023 Updated Java information text on page 19.
December 2023 Updated for 2312 Series.
February 2024 Added missing information about needing to set FEAT_UGFLEXLM when using
ADDLOCAL for silent/unattended installations.
June 2024 Updated for 2406 Series.
September 2024 Updated Check Disk Space space estimate page 12
December 2024 Updated for 2412 Series.
6
Media Contents
NX software is provided on DVD media and via download.
Any reference to DVD or media in this document refers to either a physical DVD or a hard drive location
where you have copied or extracted the downloaded installation image files.
The NX media contains the following main items:
README.txt Gives a brief description of the contents of the media, an
official title and version, and any special instructions.
Launch.exe Program to start the installation process and access other
files on the media.
nx This is the main NX "BASE & OPTIONS" kit, which contains
the installation program, optional products and
Translators.
nxlauncher This is the installation folder for the option Siemens NX
Launcher application.
mapped This is the installation folder for the Siemens NX Mapped
Drive installer.
docs Contains installation guide, Release Notes and Fixed PR
information.
Supported Workstations
The NX supported workstations are not listed in this installation manual; the information is frequently
outdated by new vendor offerings and support certifications. For information on NX supported
workstations, consult the Certification link on the Support Center Web site:
https://support.sw.siemens.com/.
7
Licensing NX
NX can be licensed in one of two ways:
1. NX can communicate with a license server which has had the Siemens License Server software installed
on it. The license server is installed separately by the Siemens License Sever installation program; it is
not part of the main NX installation. It is only required on license server nodes. You obtain the Siemens
License Server installation from Siemens Support Center (https://support.sw.siemens.com/en-
US/product/1586485382).
Note: The current Siemens License daemons support NX versions 5.0 thru current but they are not
backward compatible with NX 4.0. For NX 4.0 and prior releases you will require the old
license daemons supplied in NX 4.0. You may run both the old and new servers at the same
time.
2. NX can acquire licensing information directly from a special node locked license file called a
"Standalone Node-Locked License". In this scenario, no license server is needed, but this does require
access to a file that is encoded to your machine’s Ethernet address. In this case it is not necessary to
install the Siemens License Server product.
Siemens NX Launcher
The Siemens NX Launcher is an optional standalone application that you can use to launch NX. It provides an
interface in which you can select an NX environment and NX application, and set any necessary connection
options.
The Siemens NX Launcher installation is available on the NX product media or download. Instructions for
installation are provided in this document.
8
Release Frequency
Beginning with NX January 2019 release, the frequency of releases will be increased. Most releases after
January 2019 for NX will be distributed as full installations which can be used to install a full, new
installation, or upgrade a previous NX installation (from releases beginning with January 2019).
This installation guide describes the procedure for new installations and upgrade installations. The
upgrade installation will not be available until the next release of NX after the first functional release.
to a following monthly release can be done with a smaller download file and a faster installation process.
It is not required to install the first functional release of each functional release family to install a
subsequent monthly version of NX. For example, if you skip the June and July releases of NX, you can
install the August 2019 release as a full installation to begin using NX at the August version. After
installing the August release, you can then use either full September install or the September update only
installation to upgrade your August product version to the September product version.
Beginning with the June 2019 functional release (1872), the Start Menu for NX will use the same folder name
for every functional release, including the January 2019 release (1847). The new Start Menu starting with the
June 2019 release will have new link names which separates different areas of programs into categories. With
Windows 10, there are no sub-folders in the Start Menu so this change is being done to create a structure that
groups different types of programs together so that they can be located similar to how the sub-folders work in
the Windows 7 Start Menu.
Because the same Start Menu folder will be used for all functional releases, this means that only one version of
NX will have a defined start menu icon for its products. Only one version will have links from the Start Menu
even if multiple versions are installed. The last version installed will take control of the Start Menu links. If you
have an 1872 release or later version installed and afterward you install an 1847 series version, including the
deferred releases for continued support of 1847 series, that version will change the Start Menu links for NX
and other programs to point to the 1847 series.
It is recommended that if you will be installing an older version of NX on a machine with an 1872 or later
version, that you make a copy of the Start Menu links for the current version before installing so that you can
replace them if needed.
The Siemens NX Launcher is as an optional product to use to launch NX applications from any version with the
ability to pre-configure environments. NX Launcher will create its own Start Menu link outside of the NX Start
Menu. More information on the Siemens NX Launcher is available in the NX Help.
11
Installing NX
Please complete all of the pre-installation procedures from the previous sections before starting the
installation.
The following NX product functions will not be available when the 3 install features are left off by
default.
1. Functionalities dependent on Simcenter Nastran feature
- NX stress and vibration wizards
- NX Design Simulation
- Simcenter Structures
2. NX cannot be launched in non-english language unless a specific Localization feature is installed
3. Compilation of NXOpen applications may not work as expected when Programming Tools feature is not installed
4. NXOpen Wizards will not be available when Programming Tools feature is not installed
Starting at 2306, Model Based Part Manufacturing is a new feature which does not install by default.
Starting at 2312, the following additional features are not installed by default:
Simcenter 3D Acoustics Solvers
Additive Manufacturing Simulation
Ship Building
Greater China Tools
NX VR
Starting at 2412, the following additional features are not installed by default:
Samcef Solver
Simcenter 3D Thermal Flow
Meshing Services
CFD Designer
15
Installation Steps
Please use the following instructions to perform the installation:
1. Log onto your workstation, using an account with Administrator privileges.
2. Place the NX DVD into the DVD drive on your system. When the DVD mounts, it will automatically run
the launch program and present the launch screen.
If this "autorun" feature is turned off for your DVD drive, follow the next two steps to start the
launch program.
In File Explorer click on the icon for your DVD drive.
In the top level folder, double-click on the program Launch.exe.
3. Select Install NX from the media Launch screen (if available). {A media launch screen may not be
available, or may be disabled on your system}
OR
Using File Explorer, navigate directly to the nx folder on the DVD drive, and double-click on setup.exe
to start the setup program.
4. Select the language in which to run the setup.exe program. This will be the user interface language for
the installation program and does not determine the runtime language of NX.
The setup.exe program, in addition to starting the NX installation, will install prerequisite software
products if the local machine does not already have them or a newer version installed:
- Microsoft Visual C++ 2015-2022 runtime redistributable (14.40.33810.0)
- Microsoft .NET 4.8 Framework (4.8.4115.00)
- Microsoft .NET Windows desktop runtime 6.0.35 (6.0.35.34113)
- Microsoft .NET Windows desktop runtime 8.0.11 (8.0.11.34221)
- Microsoft ASP.NET Core runtime 6.0.35 (6.0.35.24462)
- Microsoft ASP.NET Core runtime 8.0.11 (8.0.11.24521)
If the machine already has all of these software products, the NX installation will start immediately
when running setup.exe.
If the local machine does not have one or any of the prerequisite software products, the setup.exe will
run their installation program(s) from Microsoft to attempt to silently install the products to the
machine. However, depending on your UAC settings, the installers for these products may pop-up a
request to install on the system. You should accept the request so that the prerequisite software is
installed.
Note: If your machine has a higher version of any of the prerequisites already installed, the setup.exe
will not attempt to install the older prerequisite. The prerequisites supplied are the minimum
required, newer versions already installed on machines will be used if they already exist.
If you prefer to install the prerequisite software separately before installing NX, you will find the .NET
4.8 Framework installer (ndp48-x86-x64-allos-enu.exe), .NET Windows desktop runtime 6.0.35
(windowsdesktop-runtime-6.0.35-win-x64.exe), .NET Windows desktop runtime 8.0.11
(windowsdesktop-runtime-8.0.11-win-x64.exe), ASP.NET Core runtime 6.0.35 (aspnetcore-runtime-
6.0.35-win-x64.exe), ASP.NET Core runtime 8.0.11 (aspnetcore-runtime-8.0.11-win-x64.exe) and Visual
C++ redistributable installer (VC_redist.x64.exe) in the nx folder with the setup.exe program.
16
5. At the Welcome dialog, click Next to continue. Clicking on the Cancel button at any time during the
installation will discontinue (and roll back) the installation.
6. Custom Setup – By default, if you do not have a previous version of NX installed, all install features
are selected for installation to local hard drive, which is the same as the Typical setup from
previous releases. If you have a previous release as mentioned in the section above, Installation
Features Pre-Selected Based On Previously Installed Version, the features selected will match
your previous version installed features plus any new features that did not exist previously. The
NX Platform feature (and the Model-Based Definition feature in NX 2007) is/are required and can
not be changed to not install. Any of the other Add-on products can be set to install or not install
to local disk based on the feature selection drop down to the left of the feature name in the
scrolling box. Click on the drop down and you will be given three options:
1. Will be installed on local hard drive – select this to install the feature to the destination
path.
2. Entire feature will be installed on local hard drive – same as “Will be installed on local
hard drive” except for the Add-on products selection. For Add-on products, this will allow you
to select all subfeatures to install to local disk without having the set each feature separately.
3. Entire feature will be unavailable – sets the feature to not install to disk. During
maintenance mode, changing from “Will be installed on local hard drive” to “Entire feature will
be unavailable” will remove files for the feature from your hard drive. Selecting “Entire feature
will be unavailable” on the Add-on products feature will set all subfeatures to be unavailable on
hard drive.
Click the Browse button to change the destination location or accept the default directory path
provided. The installation will create the directory if it does not exist.
7. Licensing - Enter the name of a license server, a list of license servers or a path to a single
“Standalone Node-Locked License” file. The installation will only support (1) of these options.
• Server name(s) are machine(s) that supply licensing information for running NX. This may or
may not include the hostname of your local node (the computer running this installation). The
hostname(s) of the license server(s) should be entered in the form "<port>@<hostname>"
(where <port> is the TCP port on which the Siemens License Server service runs on the license
server; usually this will be 29000).
• License file is a path to a single “Standalone Node-Locked License” file that NX will read to
acquire license information. A “Standalone Node-Locked License” file is a special license file
that is node locked to your machine’s physical address. It is not the same type of file used by
License Servers. The installation dialog provides a “Browse” button to allow users to navigate
to their license file.
The answer to this dialog will be used to set the SPLM_LICENSE_SERVER environment variable on your
system. This environment variable may be changed at any time by the Administrator.
Note: If you are installing before your license server is set up or you are off the network and there is
no connection to the license server, you can bypass this form by entering “29000@LocalHost” as the
license server and then change the SPLM_LICENSE_SERVER environment variable manually after you
have installed NX and your license server is set up and running.
8. Software Configuration - Select the runtime language for NX. In the language selection screen you
may choose the language to be used by NX at runtime, to present menus and text. This selection
will set the UGII_LANG environment variable which may be easily changed at a later time or set
differently for different users.
(New starting with 2312) If you select Programming Tools to install and you have a supported
17
Visual Studio version installed on the same machine, there will be a check box shown on the
Software Configuration dialog to allow for the selection to install the NX Open Visual Studio
extensions during the installation of NX. Leave the check box unchecked if you do not want the
extensions to install, check the box to install the extensions. If you do not see this option on the
dialog it means you either did not select Programming Tools to install or you do not have a
supported version of Visual Studio installed. If you choose not to install the extensions during
installation you can run the extensions VSIX installers manually after installation from the
UGOPEN\NXOpenWizard subfolders. Double-click the vsix file in each subfolder to install the
extensions.
9. Ready to Install - The final dialog is the Setup Confirmation screen. Verify your installation selections
before proceeding to the file copy sequence. To change any settings, use the Back button to navigate
back to the appropriate installation dialog. Click Install to begin the installation.
Upon the completion of the file copy process, the installation procedure will configure NX to run on this
machine. At the conclusion of the installation, NX will be ready to run and selectable from the Start Menu
(shown as Siemens NX->NX in the Start Menu).
The installation automatically generates a log file in the %TEMP% folder. The file is named MSI*.LOG
where * is a series of numbers and characters which make the filename unique in the %TEMP% folder.
After installation, you can view this log file by selecting the “Show the Windows Log” check box before
closing the installation program or opening the file in the %TEMP% folder.
18
The Repair option will attempt to reinstall or correct any files that do not match the original installation.
Note: This option compares checksums for thousands of NX files so it takes a very long time to
complete.
The Remove option will uninstall the product completely.
21
Running NX
Java Runtime Environment
The Java Runtime Environment (JRE) is not shipped with NX, but NX does require JRE for certain products. Please
see the NX Release Notes for more information about which Java implementations and versions are
supported for use with NX.
Running NX by Double-Clicking
You can also run NX by double-clicking on an NX part (.prt) file.
The NX installation option will establish a filename association between part files and the latest version of
NX installed. Double-clicking a .prt file should work correctly unless the association has been changed by
other applications or removed by an uninstallation of (another version of) NX. The cleanest and fastest
way to reestablish this filename association is to:
1. Uninstall desired version of NX
2. Reinstall desired version of NX
service installed with NX support 5.0 through current, but they are not backward compatible with
NX 4.0 and earlier versions.
Note: To run NX 4.0 or earlier, you must continue to run the NX 4.0 (uglmd) service.
23
Automatic Installation of NX
The installation of NX can also be accomplished by an automatic, unattended install. This feature may aid
those System Administrators with a large number of site installations.
Caution: Use of this type of installation is intended for experienced installers only.
The setup.exe program installs the two prerequisite software products for NX prior to installing NX. It is
recommended that the setup.exe program be used to run the automatic installation to install the prerequisite
software or install the prerequisite software using their installation programs prior to performing the
automatic installation of NX.
The setup.exe program is used to launch the unattended installation in addition to running unattended
installations of the prerequisite software. Command line switches for setup.exe are used to pass values to
the msiexec.exe program.
The unattended installation is controlled by the Windows system component, msiexec.exe. In order to
install silently you must pass switches and NX specific configurable properties to msiexec.exe on the
command line. The msiexec.exe program has several command line switches. For full documentation on
these switches, see the Microsoft help documentation “Help and Support” for msiexec.
There are a few command line switches for the setup.exe program which can be used:
/h – setup.exe help, lists available switches.
/s – run setup.exe silently without any dialogs.
/a – perform an administrative installation.
/w – setup.exe waits for the msiexec.exe command to complete before closing.
Use the /w option on setup.exe when running the program from inside a script or when using an software
configuration management system, like SCCM. This option causes the program to wait until the
msiexec.exe process completes before exiting the setup.exe and proceeding to the next step in the
script/software configuration process. This option will not cause setup.exe to wait in a regular command
prompt, it will only wait when setup.exe is called from inside another script or software configuration
management system.
/v – pass parameters to the msiexec.exe program.
Parameters for msiexec.exe must be immediately following /v and may be optionally wrapped in quotes.
You can pass multiple parameters with one /v option. If any parameters passed require spaces, e.g.
C:\Program Files, you must pass the parameter with escaped quotation marks, e.g. \"C:\Program Files\".
The parameters passed with the /v option are set to the msiexec.exe program as command line switches.
A few of the commonly used msiexec.exe command line switches are:
/h – msiexec help, will list available switches.
/q – specifies the UI level. /qn+ specifies no dialogs except for the ending "install done" dialog
{recommended}. /qn specifies a silent installation with no dialogs. If this option is used there is no
indication when the install completes, you must use the Task manager to monitor the "msiexec.exe".
/L – specifies a logfile to be created, and the level of the messages to be written to the logfile {e.g.
msiexec /L*v "logfile"}. This example gives the most verbose log file; see msiexec switches for various log
switch options.
/i - specifies the msi file use for installation {e.g., msiexec.exe /i SiemensNX.msi}.
/x- specifies the msi file use for uninstallation {e.g., msiexec.exe /x SiemensNX.msi}.
24
TRANSFORMS This property sets the installation user interface language transform (.mst)
and the language used to create the Start Menu links. Valid choices are cs-
cz.mst, de-de.mst, es-es.mst, fr-fr.mst, it-it.mst, ja-jp.mst, ko-kr.mst, pl-
pl.mst, pt-br.mst, ru-ru.mst, zh-cn.mst, zh-tw.mst.
TARGETDIR This property sets the directory where an NX administrative installation will
be placed. This property is for administrative installations only. See
Installing NX for Parallel Product Testing for more information.
NXOPEN_EXTENSIONS This property is new beginning wth 2312. This property works in conjunction
with the installation of the FEAT_PROGRAMMING_TOOLS feature. If you
install the Programming Tools and you have a supported Visual Studio
version installed, this property defines whether the installation program will
install the NX Open VSIX extensions to Visual Studio on the installation
system. Set this property to 1 (NXOPEN_EXTENSIONS=1) if you want the
installation automatically install the VSIX extension to Visual Studio (if it is
installed) and do not set the property if you do not want VSIX extensions to
be installed during installation.
If you are doing a full installation then you must specify ADDLOCAL=ALL. If ADDLOCAL is not specified on
the command, it is the same as ADDLOCAL="FEAT_NXPLATFORM" only.
("FEAT_NXPLATFORM,FEAT_MODEL_BASED_DEFINITION" prior to NX 2212)
Starting in NX 2312**, FEAT_NXPLATFORM does not include FEAT_UGFLEXLM, you need to include both
FEAT_NXPLATFORM and FEAT_UGFLEXLM in ADDLOCAL if not using ADDLOCAL=ALL. Use
ADDLOCAL=”FEAT_NXPLATFORM,FEAT_UGFLEXLM”.
** Note: The need to include FEAT_UGFLEXLM with FEAT_NXPLATFORM is no longer needed starting in
2406. ADDLOCAL=”FEAT_NXPLATFORM” will install both FEAT_NXPLATFORM and FEAT_UGFLEXLM
beginning in 2406.
The remaining selectable install features for a custom install are:
FEAT_ADDMANSIM FEAT_MODELBASEDPARTMANUFACTURING
FEAT_AUTOMATED_TESTING_STUDIO FEAT_MOLDED_PART_DESIGN
FEAT_AUTOMOTIVE FEAT_NXACOUSTICS
FEAT_CFDD FEAT_NXREPORTING
FEAT_COMPOSITES FEAT_NXNASTRAN
25
FEAT_DIAGRAMMING FEAT_NXTMG
FEAT_DRAFTING FEAT_OPTIMIZATION_TOOLS
FEAT_ECLASS_NX_AUTHOR FEAT_PROGRAMMING_TOOLS
FEAT_FABRICMODELER FEAT_ROUTING
FEAT_GREATERCHINATOOLS FEAT_SAMCEF
FEAT_IMMERSIVE FEAT_SHIP_BUILDING
FEAT_INDUSTRIAL_ELECTRICAL_DESIGN FEAT_SIMULATION
FEAT_MANUFACTURING FEAT_STUDIO_RENDER
FEAT_MANUFACTURING_PLANNING FEAT_TOOLING_DESIGN
FEAT_MECHATRONICS FEAT_TRANSLATORS
FEAT_MESHINGSRV FEAT_VALIDATION
The following install language files for each language:
FEAT_BRAZ_PORTUGUESE FEAT_KOREAN
FEAT_CZECH FEAT_POLISH
FEAT_FRENCH FEAT_RUSSIAN
FEAT_GERMAN FEAT_SIMPL_CHINESE
FEAT_ITALIAN FEAT_SPANISH
FEAT_JAPANESE FEAT_TRAD_CHINESE
Caution: The setup.exe examples below may appear on multiple lines because of document
formatting but they must be entered on your computer as one line. Arguments with
embedded spaces must be quoted.
This first example installs NX silently, using a full installation, selecting the runtime language to be French,
setting the license server to 29000@myserver, setting the Start Menu language to French (fr-fr.mst), and
using the installation location of F:\Program Files\Siemens\NX. No dialogs are displayed.
setup.exe /s /v"/qn ADDLOCAL=ALL LANGUAGE=french INSTALLDIR=\"F:\Program
Files\Siemens\NX\" LICENSESERVER=29000@myserver TRANSFORMS=fr-fr.mst"
This next example installs NX silently selecting five features to be installed. The installation is done to
E:\Program Files\Siemens\NX, the runtime language is defaulted to English, and the license server is
specifically set to 29000@xyz. No dialogs are displayed.
setup.exe /s /v"/qn ADDLOCAL=\"FEAT_NXPLATFORM,FEAT_AUTOMOTIVE,
FEAT_TRANSLATORS,FEAT_DRAFTING\" INSTALLDIR=\"E:\Program Files\Siemens\NX\"
LICENSESERVER=29000@xyz"
This example installs NX silently. The installation is done to E:\Program Files\Siemens\NX, the runtime
language is defaulted to English, and the license server is specifically set to 29000@xyz. In addition a
verbose (*v) log file is generated to C:\temp\install.log. The "/qn+" switch will cause an ending message
dialog to appear.
setup.exe /s /v"/qn+ /L*v C:\temp\install.log ADDLOCAL=ALL
INSTALLDIR=\"E:\Program Files\Siemens\NX\" LICENSESERVER=29000@xyz"
26
This example installs NX silently. The installation is done to E:\ Siemens\NX, the runtime language is set
to Japanese, and the license server is specifically set to 29000@abc. The setup.exe wait switch (/w) is
used to keep the setup.exe from closing until the msiexec.exe program completes the installation. Use
the /w option when putting commands in a script where you need to wait until the installation is
complete before performing the next command. At a command prompt, the setup.exe will return to the
command prompt. In a batch script, running setup.exe /w will wait until setup.exe exits before the next
batch command is executed.
setup.exe /s /w /v"/qn ADDLOCAL=ALL LANGUAGE=japanese INSTALLDIR=E:\Siemens\NX
LICENSESERVER=29000@abc"
This example installs NX silently selecting four features to be installed. The installation is done to E:\
Siemens\NX, the runtime language is set to Japanese, the Japanese language files are installed for the four
features selected, and the license server is specifically set to 29000@abc. The setup.exe wait switch (/w)
is used to keep the setup.exe from closing until the msiexec.exe program completes the installation. Use
the /w option when putting commands in a script where you need to wait until the installation is
complete before performing the next command. At a command prompt, the setup.exe will return to the
command prompt. In a batch script, running setup.exe /w will wait until setup.exe exits before the next
batch command is executed.
setup.exe /s /w /v"/qn
ADDLOCAL=\"FEAT_NXPLATFORM,FEAT_AUTOMATED_TESTING_STUDIO,
FEAT_TRANSLATORS,FEAT_DRAFTING\" LANGUAGE=japanese INSTALLDIR=E:\Siemens\NX
LICENSESERVER=29000@abc"
This next example installs NX silently selecting five features and two additional language features (French
and German) to be installed. The installation is done to E:\Program Files\Siemens\NX, the runtime
language is defaulted to English, and the license server is specifically set to 29000@xyz. No dialogs are
displayed.
setup.exe /s /v"/qn ADDLOCAL=\"FEAT_NXPLATFORM,FEAT_AUTOMATED_TESTING_STUDIO,
FEAT_TRANSLATORS,FEAT_DRAFTING,FEAT_FRENCH,FEAT_GERMAN\"
INSTALLDIR=\"E:\Program Files\Siemens\NX\" LICENSESERVER=29000@xyz"
This example installs NX silently selecting all features which installs all features including all language
features. In addition, the NXOPEN_EXTENSIONS property is set to 1 to have the install run the VSIX
installations for the NX Open extensions to Visual Studio (if Visual Studio is installed). The installation is
done to E:\apps\Siemens\NX, the runtime language is defaulted to Japanese, and the license server is
specifically set to 29000@xyz. No dialogs are displayed.
setup.exe /s /v"/qn ADDLOCAL=ALL NXOPEN_EXTENSIONS=1
INSTALLDIR=\"E:\apps\Siemens\NX\" LANGUAGE=japanese LICENSESERVER=29000@xyz"
This last example performs a silent administrative installation of NX to the D:\Admin folder. The
administrative installation requires the TARGETDIR property and not the INSTALLDIR property. No other
properties are used by the administrative installation. See Installing NX for Parallel Product Testing for
more information about using an administrative installation.
setup.exe /s /a /v"/qn TARGETDIR=\"D:\Admin\""
27
Installing NX as an Upgrade
The following section applies to monthly updates after the first functional release has been installed. For
example, if you install the June 2022 functional release, then the monthly update in July to that version can be
done as an upgrade installation as shown in this section.
Using File Explorer, navigate directly to the nx folder on the DVD drive, and right-click on setup.exe
to start the setup program.
4. A dialog stating: “This setup will perform an upgrade of ‘Siemens NX’ Do you want to continue?” will
be shown. Click Yes.
5. At the Welcome dialog, click Next to continue.
6. Click Install to begin to upgrade NX. Clicking on the Cancel button at any time during the installation
will discontinue (and roll back) the installation.
Clicking on the Cancel button at any time during the installation will discontinue (and roll back) the
installation.
The MSP files provided as an upgrade only installation can be used to update the parallel installation location
with updated files.
Note: The parallel installation must be in the same format that it was originally dumped to disk with the
SiemensNX.msi file at the top level and the Siemens\NX folder still existing. E.g. E:\Parallel was the
original installation location and E:\Parallel\SiemensNX.msi and E:\Parallel\Siemens\NX exist.
To update a parallel installation (administrative install) location with an MSP file, do the following:
Since the administrative installation does not create any registry entries or modify environment variables,
to remove the administrative installation you only need to delete the files and folders from the workstation.
Use Windows Explorer and remove all the files and folders under the location used to install the
administrative installation.
31
The unattended installation is controlled by the Windows system component, msiexec.exe. In order to
install silently you must pass switches and NX (Mapped Drive) specific configurable properties to
msiexec.exe on the command line. The msiexec.exe program has several command line switches. For full
documentation on these switches, see the Microsoft help documentation “Help and Support” for msiexec.
There are a few command line switches for the setup.exe program which can be used:
/h – setup.exe help, lists available switches.
/s – run setup.exe silently without any dialogs.
/a – perform an administrative installation.
/w – setup.exe waits for the msiexec.exe command to complete before closing.
Use the /w option on setup.exe when running the program from inside a script or when using an software
configuration management system, like SCCM. This option causes the program to wait until the
msiexec.exe process completes before exiting the setup.exe and proceeding to the next step in the
script/software configuration process. This option will not cause setup.exe to wait in a regular command
prompt, it will only wait when setup.exe is called from inside another script or software configuration
management system.
/v – pass parameters to the msiexec.exe program.
Parameters for msiexec.exe must be immediately following /v and may be optionally wrapped in quotes.
You can pass multiple parameters with one /v option. If any parameters passed require spaces, e.g.
C:\Program Files, you must pass the parameter with escaped quotation marks, e.g. \”C:\Program Files\”.
The parameters passed with the /v option are set to the msiexec.exe program as command line switches.
A few of the commonly used msiexec.exe command line switches are:
/h – msiexec help, will list available switches.
/q – specifies the UI level. /qn+ specifies no dialogs except for the ending “install done” dialog
{recommended}. /qn specifies a silent installation with no dialogs. If this option is used there is no
indication when the install completes, you must use the Task manager to monitor the “msiexec.exe”.
/L – specifies a logfile to be created, and the level of the messages to be written to the logfile {e.g.
msiexec /L*v “logfile”}. This example gives the most verbose log file; see msiexec switches for various log
switch options.
/i - specifies the msi file use for installation {e.g., msiexec.exe /i SiemensNX.msi}.
/x- specifies the msi file use for uninstallation {e.g., msiexec.exe /x SiemensNX.msi}.
The only required configurable property for NX (Mapped Drive) installation is the TARGETDIR setting
which points to the already installed version of NX on a network or mapped drive. All other options will
default to pre-defined values.
The first example installs NX (Mapped Drive) silently to set the UGII_LANG variable to french, install the
local files for Mapped Drive to F:\Program files\Siemens\NX, set the SPLM_LICENSE_SERVER variable to
29000@myserver, set the Start Menu to be in French (fr-fr.mst transform) and reference the NX software
already installed in N:\network\NX. No dialogs are displayed during installation.
setup.exe /s /v"/qn ADDLOCAL=ALL LANGUAGE=french INSTALLFOLDER=\"F:\Program
Files\Siemens\NX\" LICENSESERVER=29000@myserver TRANSFORMS=fr-fr.mst
TARGETDIR=N:\network\NX"
This next example installs NX (Mapped Drive) silently to the default location installation location
(INSTALLFOLDER not set to another location), the SPLM_LICENSE_SERVER is set to 29000@xyz,
36
referencing the NX software already installed in N:\network\NX and both Start Menu and UGII_LANG is in
the default English. No dialogs are displayed.
setup.exe /s /v"/qn ADDLOCAL=ALL TARGETDIR=\"N:\network\NX\"
LICENSESERVER=29000@xyz"
37
Additional Topics
Uninstalling NX
To remove the NX product:
Note: Beginning at NX 2212, the product version string (2212) is being added to the Siemens NX product
name on the Add/Remove and Apps & Features product listings to make it easier to find the current
version of the installed software.
Windows 10 & 11:
1. Open the Start menu.
2. Click Settings.
3. Click System on the Settings menu.
4. Select Apps & features from the left pane.
5. Select Siemens NX 2412 and then click the Uninstall option.
6. Click the Uninstall pop-up button to confirm.
Note: You can also use the Classic Control Panel and use Add/Remove Programs as in Windows 7/8.
Changes
This topic provides an overview of significant changes in the installation kits for this release.
Kit Consolidation
Beginning in NX 11, to simplify kit selection at installation time, many kits have been combined into larger
selectable groups in the “Custom” installation selection menu. At the conclusion of the installation the
folder structure will be similar to previous NX versions. For example, a single “Translators” kit selection
now includes all the translators that were previously selectable in prior NX installation.
UGII_ROOT_DIR obsoleted
In NX 11, the %UGII_ROOT_DIR% environment variable was retired.
To find executables and libraries, a central runtime directory called NXBIN is now used.
NXBIN directory
The NXBIN directory, is created on all platforms at the %UGII_BASE_DIR%\nxbin location during the NX
installation. Executables and libraries from the user selected installed kits are consolidated into the NXBIN
directory during the installation.
Configuration and script files that used to be found under %UGII_ROOT_DIR% will now be in
%UGII_BASE_DIR%\ugii. Executables, libraries and jar files that used to be found under
%UGII_ROOT_DIR% will now be in %UGII_BASE_DIR%\nxbin.
While the NX installation no longer sets the UGII_ROOT_DIR variable, the definition on the system will
remain to support earlier releases. If your code or scripts rely on %UGII_ROOT_DIR%, modify them to
ensure they work in NX.
Troubleshooting
Windows Diagnostic Tools
Windows provides a variety of tools that you can use to understand how your computer is working and
diagnose problems. Some examples are:
Windows System Info Can be found via Start→All apps→Windows Administrative Tools→System
Information. It provides information about your system, and allows you to print this
information, or save it in a file. You can also run Windows Diagnostics by typing
msinfo32 in a Command Prompt window.
Event Viewer Provides you with a log showing various low-level events that have occurred while
your system has been running. Again, you can typically access this utility via Start→
All apps→Windows System→Control Panel→Administrative Tools.
System Properties The System Properties item in Control Panel lets you check and modify the values of
environment variables that affect the behavior of your system. Variables are located
under Start→ All apps→Windows System→Control Panel→ System→Advanced
system settings→Advanced tab→Environment Variables.
Net Commands Windows provides a wide variety of commands for diagnosing networking problems,
which can affect the system’s ability to communicate with the Siemens License
Server daemons. For more information, you might start by looking up the ping and
netstat utilities in Windows Help, or type net help in a Command Prompt window.
If you need help with any of these tools, please consult your Windows documentation or Help.
NX Won't Start
If NX fails to start, a window will display the reason for the failure.
Can't Connect to License Server
Check that the Siemens License Server is available. Open a Command Prompt window, change to the
%UGII_BASE_DIR%\UGFLEXLM directory and enter the command:
lmutil lmstat –c 29000@<hostname>
{where 29000 is the port number and <hostname> is the hostname of the Siemens license server}
For example:
cd /d C:\Program Files\Siemens\NX\UGFLEXLM {default location}
lmutil lmstat -c 29000@<hostname>
{where 29000 is the port number and <hostname> is the hostname of the Siemens license server}
Diagnostic messages will appear telling you some possible sources of your problem.
No Licenses Available
Using the Licensing Tool to Select Bundles
Note: Prior to NX 9.0, License Options was used to set persistent or default bundle selections via the
UGS_LICENSE_BUNDLE variable that it created. As of NX 9.0, Licensing Tool does not create a
43
All licenses for module "gateway" are already in use or no bundles have been selected. Your license file
may contain Suite Packages, otherwise known as Bundles and Portfolio Bundles. To use a bundle, it must
be preset prior to running NX. If bundles are preselected, the application will attempt to check out a
bundled feature before trying to check out the floating feature.
Licensing Tool is an interactive user interface that aids in setting persistent or default bundle selections in
the user accessible registry entry:
HKEY_CURRENT_USER\Software\Siemens_PLM_Software\Common_Licensing\NX_BUNDLES
To set the bundle(s) in the registry:
Click on Start→All apps→Siemens NX→Licensing Tool
Caution: Customers using Bundle/Portfolio licenses must either set the bundle selection(s) via the
'UGS_LICENSE_BUNDLE' variable or the ‘NX_BUNDLES’ registry entry with the package
name(s) of the bundle(s) before attempting to run NX. Licensing Tool honors the bundle
selections set by the variable but once Licensing Tool is used to apply a bundle, the
UGS_LICENSE_BUNDLE variable is no longer honored nor effective. If the ‘NX_BUNDLES’
registry entry exists (even if the value is ‘blank’), it would have to be deleted in order to
make the bundle selections effective for the UGS_LICENSE_BUNDLE variable if set.
44
License File Could Not If you are receiving your license data file via e-mail, you need to save it in text format.
Be Read Some users using MSWord as their reader may receive garbage in the license file (e.g.
License_Ugslmd.txt) when it is received in e-mail.
See saltd.log When the Siemens License Server service is started, the log file saltd.log is created.
The log file can give you the best information on the state of the license server. This
file can be opened with the Notepad editor, and it will give some indication as to what
went wrong. Errors may be a result of a corrupted license file, the lmhostid not
matching the license file, or networking problems involving TCP/IP or DNS
configuration. Use the instructions given earlier to check that there is a working
TCP/IP network connection to your Siemens License Server. This file is located by
default at:
C:\ProgramData\Siemens\License Server\saltd.log
This can only be performed from the license server.
Note: The DLL location stored in the registry will be for the last version of ugshext.dll registered. If an older
version of ugshext.dll is registered after a newer version, the older version ugshext.dll will be used for
part preview. Due to differences in the DLL functionality between versions, this could mean the part
preview on newer parts may not work properly when an older version of ugshext.dll is registered.
48