MCAMX3 Installation Guide

Installation Guide
Installation Guide.indd 1
4/29/08 1:47:35 PM
Mastercam X3
Installation Guide
July 2008
Be sure you have the latest

information!
Information might have been changed or added since this document was
published. The latest version of this document is installed with Mastercam or
can be obtained from your local Reseller. The ReadMe file (ReadMe.htm)
includes the latest information about new features and enhancements.
ii MASTERCAM X3 / Installation Guide
Mastercam X3 Installation Guide

Date: July 2008
Copyright 2008 CNC Software, Inc. All rights reserved.
Software: Mastercam X3
ISBN: 1-883310-75-X
IMPORTANT NOTICE!
PLEASE READ THIS STATEMENT AND THE SOFTWARE LICENSE AGREEMENT

COMPLETELY BEFORE USING THIS SOFTWARE. YOU MUST ACCEPT THE
TERMS OF THIS LICENSE BEFORE YOU CAN OPERATE THE SOFTWARE
PROGRAM.
BY CONTINUING TO USE THIS SOFTWARE, YOU (EITHER AN INDIVIDUAL OR A
SINGLE ENTITY) INDICATE YOUR INTENTION TO BE BOUND BY AND ACCEPT
THE TERMS AND CONDITIONS OF THIS SOFTWARE LICENSE. IF YOU DO NOT
AGREE TO THESE TERMS AND CONDITIONS, YOU MAY NOT ACCESS OR
OTHERWISE USE THIS SOFTWARE AND WILL IN FACT BE PROHIBITED FROM
DOING SO. THIS COMPUTER SOFTWARE MAY BE USED ONLY PURSUANT TO
THE TERMS AND CONDITIONS SET FORTH BELOW, AND SOLELY IN
CONJUNCTION WITH THE ACCOMPANYING SECURITY MECHANISM (UNLESS
OTHERWISE SPECIFIED IN THE "EXCEPTIONS TO SECURITY MECHANISM
REQUIREMENTS" SECTION OF SUCH TERMS AND CONDITIONS) WHICH
MUST BE PRESENT ON YOUR COMPUTER (OR NETWORK AS APPLICABLE) AT
ALL TIMES DURING SUCH USE.
Please Note: Your company may have additional restrictions and guidelines in
place regarding the use of this Software that are in addition to those found within
this Software License. If you have any questions or concerns as to the existence of
any such additional restrictions or guidelines, you should consult with your
supervisor or your IT Department before using this Software.
Read This If You Have Received This Software From A Third Party: If you received
this Software from someone other than an authorized CNC Software, Inc. reseller,
you do not have a legal software license. (For example, if you acquired this
Software simply by buying a machine or Software from the former owner or from
an auction, you do not have a valid license.) You should contact CNC Software,
Inc. (860-875-5006) in order to obtain a new and valid license. Use of this Software
without a valid software license is unlawful, a violation of the Copyright Act and
may expose you to criminal liability under 17 United States Code Sec. 506,
including fines and damages.
Software License
If you have paid a license fee, CNC Software, Inc. ("CNC") a Connecticut
corporation with its principal place of business at 671 Old Post Road, Tolland,
Connecticut, 06084 hereby grants to you a non-exclusive, non-transferable license
(the "License") to use this software program and its accompanying documentation
(and, if applicable, to permit your authorized employees to use them), solely in
accordance with the terms and conditions of this Software License Agreement.
You may use the Software solely for your internal business purposes and solely in
conjunction with the accompanying hardware or software device, method, scheme
or other security measure provided by CNC which allows a user to access the
Software and prevents unauthorized access to the Software (the "Security
Mechanism"). The Software, any updates to the Software through purchase or due
to enrollment in an authorized software Maintenance program (including any that
you download through the Internet), and the Documentation in printed or
electronic form shall hereinafter collectively be referred to as the "Software" and
are all governed by this License.
iii
Restrictions
You may not use the Software without a Security Mechanism provided by CNC or
CNC's suppliers. When CNC or CNC's resellers provide you with a single-user
Security Mechanism, the Software may only be used (in executable code form
only) on a single computer to which the Security Mechanism is physically
attached. In the event CNC or CNC's resellers provide you with a multiple-user
Security Mechanism for use over an internal network (a "Network Security
Mechanism"), the Software may be used: (a) in executable code form only; (b) only
on end-user computers that are connected to the internal network to which the
Network Security Mechanism is attached; and (c) only by the number of users and
accessed by the number of end-user computers for which licenses were purchased
and as further allowed by the Network Security Mechanism. You may physically
transfer the Software from one computer equipped with a single-user Security
Mechanism to another only if the Security Mechanism is included in the transfer
and is installed with the new computer.
You shall not: (a) copy (except as provided below), adapt, modify the Software; (b)
publish, display, disclose or create a derivative work from the Software or any part
thereof; (c) de-compile or translate, disassemble, create or attempt to create, by
reverse engineering or otherwise, the source code form of the Software from the
executable code of the Software; (d) remove any proprietary notices, labels or
marks from the Software; (e) sell, rent, lease, distribute or otherwise transfer or
provide all or any part of the Software to any person or entity without the prior
written consent of CNC; (f) use the Software to provide outsourcing, service
bureau, time sharing or other services to any third party; or (g) sublicense, assign,
delegate or otherwise transfer your rights in the Software, under the Software
License Agreement or any of the related rights or obligations for any reason
without the prior written consent of CNC. You shall not circumvent, bypass,
modify, reverse engineer, disassemble, disable, alter, enhance or replicate the
function of the Security Mechanism in any manner whatsoever. Any attempt to do
so shall result in automatic termination of this License without prejudice to all
other legal rights and remedies of CNC.
Copying Restrictions
You may make one (1) copy of the Software for backup or archival purposes,
provided that you reproduce all proprietary notices of CNC on any such copy.
Non Transferable
You may not transfer or assign the Software or this Software License Agreement or
any rights or obligations hereunder. Any attempt to do so will automatically
terminate this License without the need for notice. This termination is without
prejudice to all other legal rights and remedies of CNC.
Intellectual Property Rights
The Software is and includes intellectual property of CNC. All associated

intellectual property rights, including, without limitation, worldwide patent,
trademark, copyright and trade secret rights, are reserved by CNC. CNC retains all
right, title and interest in and copyrights to the Software, regardless of the form or
media in or on which the original or other copies may subsequently exist. This
Software License Agreement shall not constitute a sale of the Software and no title
or proprietary rights to the Software are transferred to you hereby. You
acknowledge that the Software is a unique, confidential and valuable asset of CNC,
and CNC shall have the right to seek all equitable and legal redress which may be
available to it for the breach or threatened breach of this Software License
Agreement including, without limitation, injunctive relief. Unauthorized copying
of the Software or failure to comply with the above restrictions shall result in
automatic termination of this License and this Software License Agreement
without prejudice to all other legal rights and remedies of CNC.
Confidentiality
You acknowledge that the Software contains proprietary trade secrets of CNC and
you hereby agree to maintain the confidentiality of the Software using at least as
great a degree of care as you use to maintain the confidentiality of your own most
11
12
13
14
15
16
17
18
19
110
iv MASTERCAM X3 / Installation Guide
confidential information. You agree to promptly communicate the terms and

conditions of this Software License Agreement to those persons employed by you
who come into contact with the Software, and to use your best efforts to ensure
their compliance with such terms and conditions, including, without limitation,
absolutely preventing such persons to use any portion of the Software for the
purpose of deriving the source code of the Software or defeating the Security
Mechanism.
Enforcement Obligations
In the event you become aware that any person or entity in your employ or under
your control is using the Software in a manner not authorized by this Software
License Agreement, you shall immediately take all steps necessary to stop such
unauthorized use of the Software. You shall promptly notify CNC in writing of any
unauthorized use of the Software of which you become aware.
Limited Warranties
CNC WARRANTS THAT THE MEDIA ON WHICH THE SOFTWARE IS

DISTRIBUTED WILL BE FREE OF DEFECTS IN MATERIAL OR WORKMANSHIP
FOR A PERIOD OF THIRTY (30) DAYS AFTER PURCHASE. THE FOREGOING
LIMITED WARRANTY EXCLUDES DEFECTS ARISING OUT OF ACCIDENT,
NEGLECT, MISUSE, FAILURE OF ELECTRIC POWER AND CAUSES OTHER THAN
ORDINARY AND AUTHORIZED USE. EXCEPT FOR THE FOREGOING LIMITED
WARRANTY, THE SOFTWARE IS PROVIDED "AS IS, WITH ALL FAULTS." THIS
LIMITED WARRANTY IS THE ONLY WARRANTY PROVIDED BY CNC REGARDING
THE SOFTWARE. TO THE MAXIMUM EXTENT PERMITTED BY LAW, CNC
DISCLAIMS ALL OTHER WARRANTIES OF ANY KIND, EITHER EXPRESSED OR
IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. CNC IS NOT
OBLIGATED TO PROVIDE ANY UPDATES TO THE SOFTWARE.
Sole and Exclusive Remedy for Breach of Warranty: YOUR SOLE EXCLUSIVE
REMEDY AND CNC'S SOLE OBLIGATION HEREUNDER SHALL BE, AT CNC'S
SOLE OPTION (i) REPLACEMENT OF THE DEFECTIVE MEDIA; OR (ii) REFUND
OF THE PURCHASE PRICE OF THE SOFTWARE. CNC SHALL HAVE NO OTHER
OBLIGATION OR LIABILITY TO YOU ARISING FROM OR RELATED TO THIS
LICENSE OR YOUR USE OF THE SOFTWARE. ANY USE BY YOU OF THE
SOFTWARE IS AT YOUR OWN RISK.
Note on Documentation: While CNC makes every effort to ensure that its
Documentation for the Software is accurate and up-to-date, it cannot guarantee
the Documentation at all times represents the latest operation and functionality of
the Software. The content of all documentation, in electronic or printed form, for
the Software is provided for informational purposes only. The content of the
Documentation may be changed without notice to you. CNC expressly disclaims
any warranty or representation that the Documentation is an accurate and/or
current reflection of the Software's operation and performance.
Disclaimer of Consequential
Damages and Limitation of
Liability
IN NO EVENT WHATSOEVER WILL CNC, OR ITS EMPLOYEES, SHAREHOLDERS,

DISTRIBUTORS OR RESELLERS BE LIABLE TO YOU FOR ANY INDIRECT,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN
CONNECTION WITH THIS SOFTWARE LICENSE AGREEMENT OR THE USE OF
THE SOFTWARE, EVEN IF CNC HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES. WITHOUT LIMITING THE FOREGOING, CONSEQUENTIAL
DAMAGES SHALL INCLUDE, WITHOUT LIMITATION, SPECIAL, PUNITIVE OR
EXEMPLARY DAMAGES, DAMAGES FOR LOSS OF BUSINESS, LOSS OF PROFITS,
BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND LOSS OF
OR DAMAGE TO ANY PRODUCTS THAT THE SOFTWARE IS USED IN
CONJUNCTION WITH.
CNC'S ENTIRE LIABILITY WITH RESPECT TO ITS OBLIGATIONS UNDER THIS
SOFTWARE LICENSE AGREEMENT OR OTHERWISE SHALL NOT EXCEED THE
AMOUNT OF THE LICENSE FEE PAID BY YOU FOR THE SOFTWARE. SOME
JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED
WARRANTIES OR LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES,
SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU.
Indemnification
Educational Pricing
Termination
General
Attorneys Fees
You shall indemnify and hold harmless CNC, its officers, directors, employees,
resellers and agents (the "Indemnified Parties") from and against all losses,
settlements, claims, actions, suits, proceedings, judgments, awards, damages,
liabilities, costs and expenses including, without limitation, reasonable attorneys'
fees (collectively "Losses") which arise out of or are related to any breach of this
Software License Agreement by you or your employees, agents, resellers, dealers or
sub-dealers, and shall reimburse the Indemnified Parties for any and all legal,
accounting and other fees, costs and expenses reasonably incurred by any of them
in connection with investigating, mitigating or defending any such Losses.
If this Software was obtained through or in accordance with a CNC "Educational
Pricing" plan, option, grant, schedule or program, it may not be used by anyone,
including you, to conduct any computer aided design, computer aided drafting,
computer aided machining, or training activities that, directly or indirectly,
generate or otherwise result in monetary revenues for the benefit of any individual
or any entity, other than the school that originally received this Software.
This Software License Agreement is effective until terminated. You may terminate
this Software License Agreement at any time by returning to CNC all copies of the
Software under your control and by returning the Security Mechanism to CNC.
CNC may terminate this Software License Agreement if CNC determines, in its sole
discretion, that you have violated the terms of this Software License Agreement.
Upon termination of this Software License Agreement, you agree to immediately
return to CNC all copies of the Software, return the Security Mechanism to CNC,
and certify to CNC in writing that all known copies, including backup copies, have
been returned. All provisions relating to confidentiality, proprietary rights,
indemnification and non-disclosure shall survive the termination of this Software
License Agreement. You may not transfer this Software to the purchaser of any
equipment on which the Software may be resident. You may not transfer this
Software via liquidation, bankruptcy, auction, close of business, or any other
method that does not involve an authorized Mastercam reseller. This License is
for you alone. In the event you breach the provisions of this Section, CNC shall be
entitled to liquidated damages in the amount of Fifteen Thousand Dollars
($15,000), plus its reasonable attorney's fees and court costs.
This Software License Agreement shall be governed by and construed in
accordance with the laws of the state of Connecticut, USA without regard for
Connecticut's conflicts of law principles. The sole and exclusive jurisdiction and
venue for any litigation arising from or related to this Software License Agreement
or the subject matter hereof shall be in an appropriate state or federal court located
in Hartford, Connecticut. You hereby submit to the personal jurisdiction of the US
District Court for the District of Connecticut and the Superior Court of the State of
Connecticut. This Software License Agreement shall constitute the entire
agreement between you and CNC with respect to the subject matter hereof. Any
waiver or modification of this Software License Agreement shall be valid only if it is
in writing and signed by both parties hereto. If any part of this Agreement is found
invalid or unenforceable by a court of competent jurisdiction, the remainder of
this Agreement shall be interpreted so as to reasonably affect the intention of the
parties.
In the event that CNC is required to take legal action to enforce its rights under this
License Agreement and obtains a ruling or settlement in its favor, you shall be
11
12
13
14
15
16
17
18
19
110
vi MASTERCAM X3 / Installation Guide
liable to CNC for its reasonable attorney's fee incurred in investigating and
prosecuting its claim.
U.S. Government Restricted

Rights
The Software provided hereunder is a "commercial item," as that term is defined in

48 C.F.R. 2.101, consisting of "commercial computer software" and "commercial
computer software documentation," as such terms are used in 48 C.F.R. 12.212.
Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4, the
Software made available to the United States of America, its agencies and/or
instrumentalities, is provided with only those rights set forth in this Agreement.
Use, duplication or disclosure of the Software by the government is subject to the
restrictions as set forth in subparagraph (c) (1) and (2) of the Commercial
Computer Software-Restricted Rights clause at 48 C.F.R. 52.227-19, as amended, or
any successor regulations thereto.
Export Restrictions
You represent and warrant that you will not, without obtaining prior written
authorization from CNC and, if required, of the Bureau of Export Administration of
the United States Department of Commerce or other relevant agency of the United
States Government, export or re-export, directly or indirectly, the Software from
the United States to (i) any country destination or entity to which export is
restricted by the Export Administration Regulations of the United States
Department of Commerce; (ii) any country or entity subject to sanctions
administered by the Office of Foreign Assets Control, United States Department of
the Treasury; or (iii) such other countries or entities to which export is restricted by
any other United States government agency. You further agree that you are solely
responsible for compliance with any import laws and regulations of the country of
destination of a permitted export or re-export, and any other import requirement
related to a permitted export or re-export.
Exceptions to Security
Mechanism Requirements
CNC software programs Mastercam Design LT and Mastercam Demo as well as

printed and electronic documentation do not require the use of Security
Mechanisms, and the provisions in this Software License Agreement relating to
Security Mechanisms do not apply to your use of such programs, provided,
however, that such provisions shall apply to your use of all other Software and
documentation provided hereunder.
Survival
All provisions of this Software License Agreement relating to confidentiality, nondisclosure, CNC's proprietary rights, disclaimers, and limits of liability, or
indemnification by Customer shall survive termination of this License for any
reason.
Reservation of Rights
All rights not expressly granted are reserved by CNC.
Trademarks
Mastercam is a registered trademark of CNC.

Windows, Windows 2000, Windows XP, and Windows Vista are registered
trademarks of Microsoft Corporation. Mastercam Verify is created in conjunction
with MachineWorks Ltd. Mastercam Backplot includes Copyrighted intellectual
property rights owned by NWD.
Printed in the United States of America.
Printed on recycled paper.
vii
Contents
1. Understanding Your Mastercam X3 Installation ...1
X
X
System Requirements...........................................................2
Installation Requirements .....................................................4
Licensing .................................................................................4
Installing a HASP (Single-User License).................................4
Using a NetHASP (Network Licensing) ..................................5
Updating from Previous Versions ........................................6

Users Updating from a Prior Mastercam X Release ...............6
Scenario 1: Remove the existing Mastercam X ...............6
Scenario 2: Replace the existing Mastercam X ...............7
Scenario 3: Leave the current Mastercam X ...................7
About the Migration Utility ....................................................7
About Migrating Manually ..............................................9
Upgrading from Mastercam Version 9.1 or Older ..................9
X
X
Mastercam Support and Services .....................................10

Documentation Resources .................................................12
Upgrades .......................................................................12
New System Startup ......................................................12
General ..........................................................................12
2. Installing Mastercam X3 .................................................15

X
Running the Installation Program ......................................16

Disk 1.....................................................................................16
Disk 2.....................................................................................22
Entering the SIM Update Code ..........................................24

Updating HASP Codes ..........................................................25
Troubleshooting ...................................................................28
Manually Installing SIM Drivers ...................................28
Running a Repair ...........................................................28
viii
3. Mastercam X3 Startup .....................................................29

X
X
X
Starting Mastercam ............................................................30

Mastercam Launcher ..........................................................31
Using Command Line Switches .........................................37
Error Messages ..............................................................41
Using the Update Manager ................................................43

Downloading and Installing Updates (Same PC).................44
Downloading and Installing Updates on Another PC ..........47
Troubleshooting the Update Manager .................................51
A. Information for the Network Administrator

X
X
X
.........53
Network Administrator Qualifications ...............................54

Installation ............................................................................55
System Settings ..................................................................56
File System ............................................................................56
Registry .................................................................................56
Network.................................................................................57
Group Policies.......................................................................57
Setting Installation Defaults .................................................57
X
X
Windows Vista ....................................................................60

Installing the NetHASP Server ...........................................61
Maximum Number of NetHASP Licenses .....................63
Adding Licenses ............................................................64
Entering the SIM Update Code ..........................................65

Updating NetHASP Codes ............................................66
Troubleshooting ...................................................................68
Manually Installing SIM Drivers ...................................68
Using the NHaspX.exe Utility .............................................69

Entering the SIM Update Code.............................................70
Monitoring NetHASP Users................................................72

Using Aladdin Monitor .................................................72
Registry Settings ............................................................74
Additional NetHASP Information .................................75
chapter 1
Understanding Your
Mastercam X3
Installation
This Installation Guide provides the information you need to install the
latest Mastercam release, upgrade your access codes, migrate and
convert your existing Mastercam files, if any, and start Mastercam. An
appendix provides information for network administrators to install
Mastercam on a network.
This chapter outlines what you need to install Mastercam and describes
what you should do to prepare for it. It covers the following topics:
System Requirements ............................................. page 2

Installation Requirements ....................................... page 4
Updating from Previous Versions........................... page 6
Mastercam Support and Services ........................ page 10
Documentation Resources .................................... page 12
2 MASTERCAM X3 / Installation Guide
System Requirements
Requirements for the Mastercam suite of products are based on
minimum specifications for reliable operation. These requirements
apply to the installation of one or more Mastercam products.
Mastercam X3 System Requirements

Processor
1.5 GHz (minimum) 32-bit Intel-compatible

processor.
64-bit Intel-compatible processors are
supported.
Operating System
Windows XPor Windows Vista (Business

or Ultimate), including the latest service
packs and recommended updates.
.NET 2.0 framework.
*Windows 2000 is no longer supported starting
with Mastercam X3.
Memory
1 GB (minimum). Because available RAM significantly affects performance, your use of the
software could require more RAM to ensure
optimal performance.
Graphics Card
128MB OpenGL-compatible graphics card

(minimum).
Full hardware acceleration display setting is

recommended.
Integrated graphics share system RAM and
can degrade performance on large or
complex parts.
96 dpi / small fonts should be used at resolutions less than 1280 pixels in width. If the dpi
setting is too large to display the entire
contents of the ribbon bar, you can display
the options that are not visible by choosing
the chevron.
Hard Disk Drive Space 1.7 GB available hard disk space (minimum).
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / System Requirements 3
Mastercam X3 System Requirements

Monitor
1024 X 768 pixel resolution (minimum) at 96

dpi.
1280 X 1024 pixel resolution (recommended).

Mouse
2-button (minimum).
3-button or 2-button with middle mouse
wheel (recommended).
Network Protocol
(NetHASP users only) TCP/IP protocol for

NetHASP installation; VPN is unsupported.
Additional Supported
Hardware
Dual monitors.
Multiprocessors. (One processor per instance
of Mastercam.)
3Dconnexion navigation device.
Additional Software
12
13
14
Acrobat Reader Version 4.0 or higher.
15
16
17
18
19
110
Installation Requirements
To install and run Mastercam X3, you must have the following:
Mastercam X3 installation program on CD (2-CD set), DVD

(available from your Authorized Mastercam Reseller), or
downloaded from www.mastercam.com (Maintenance
subscribers only)
Valid Mastercam X3 license (HASP SIM or netHASP)
Update code information (current users only)
Licensing
Mastercam supports both single-user and network licensing.
If you are using single-user licensing, you need a small

device called a HASP SIM. The standard HASP SIM is a USB
device. If your computer cannot accept a USB device, you
can obtain a parallel HASP SIM through your Authorized
Mastercam Reseller for an extra charge.
If you are using network licensing, you need a red device
called a NetHASP (parallel or USB) SIM. This device is also
called a network SIM and must be installed on a network PC.
For more information on network licensing and the NetHASP,
see Appendix A.
These devices protect against illegal use of Mastercam software.
Installing a HASP (Single-User License)

X To install the single-user license:
1 Turn off the computer and monitor and all external periph-
eral devices.
2 Based on the type of HASP, locate an available parallel or USB
port on the computer. If you are unsure of the ports location,

consult your computer documentation.
Note: You can connect a printer cable to the back of a parallel
HASP and continue to use the port for printing.
3 Plug the male end of the HASP into the port.
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Installation Requirements 5
CAUTION: The HASP attaches to your port in only one orientation. Do not force it into the port as you may damage the port
and the HASP.
If the HASP does not slide easily into the port, try the
following:
Check its orientation. Match the HASP to the port and try
again.
Check the HASP for damaged pins. If the pins are
damaged and you cannot easily straighten them, contact
your Mastercam Reseller for a replacement.
1
12
13
4 If you are installing a HASP to a parallel port, tighten the two
screws on the HASP to firmly attach it to your computer.

5 If necessary, connect your printer cable to the HASP. Then
tighten the screws on the printer cable connector to firmly

attach it to the HASP.
Using a NetHASP (Network Licensing)

With network licensing, a group of Mastercam users who are all
connected to the same network can run Mastercam from any PC on
the network. Instead of requiring one HASP per computer to run
Mastercam, a single NetHASP is installed on any PC on the network.
That computer is referred to as the NetHASP server; it is not necessarily a network server. An individual Mastercam user then checks out
a license from the available licenses on the network when starting
Mastercam.
NetHASP installation is a network administrator task. See Appendix A
for instructions.
14
15
16
17
18
19
110
Updating from Previous Versions

Use this section to prepare your current Mastercam for the installation of Mastercam X3.
Users Updating from a Prior Mastercam

X Release
If you are updating from a previous Mastercam X release, you should
decide if you will leave your existing Mastercam installation on your
PC or replace it with Mastercam X3 before you begin installing
Mastercam X3.
There are three possible scenarios for updating to Mastercam X3 from
a prior Mastercam X release.
Scenario 1: Remove the existing Mastercam X

When you remove and entirely replace your existing Mastercam X
with the new release, you ensure that you install all of the latest files. If
you rename your existing Mastercam folder rather than deleting it,
you preserve all of the files in the existing installation.
X Removing an existing Mastercam installation:
1 Uninstall Mastercam X using the Windows Control Panel Add
or remove programs function (Programs and Features in

Vista).
2 Rename your existing Mastercam X folder. The uninstall
process does not remove the folder and will preserve all
customized files, thereby creating a backup. You will no
longer be able to use the Mastercam X application in this
folder because you uninstalled it.
3 Install Mastercam X3.
4 Follow directions in the Mastercam X3 Transition Guide
(available in PDF format in your Mastercam \Documentation

folder) for migrating and converting your files for use in
Mastercam X3.
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Updating from Previous Versions 7
Scenario 2: Replace the existing Mastercam X

In this scenario, you install a Mastercam release over a previous
Mastercam X installation, replacing it with the new version. You will
have an opportunity to backup your modified files as part of the
installation process. We strongly recommend that you do this backup.
Scenario 3: Leave the current Mastercam X

In this scenario, you install Mastercam X3 in a different folder from
the existing Mastercam X installation (a side by side installation)
and keep both versions available. You can then migrate your customized files to the new installation to duplicate your custom work environment. This is the recommended scenario.
1
12
13
If you are updating from Mastercam X2 or one of its maintenance

releases, (Mastercam X2, X2 MR1, X2 MR2, or X2 MR2 SP1),the installation program will give you the opportunity to run a migration utility
as part of the installation. The migration utility will copy customizable files (such as .CONFIG and .OPERATIONS files) to the new directory, create backups of files with the same name that it finds in the
new directory, and modify certain file types to work with the new
release.
14
If you are you are updating from MastercamVersion X MR2 or older,

you will have to migrate your customized files manually.
16
The Mastercam X3 Transition Guide contains detailed information on

migrating and converting files. It will be installed in PDF format in
your Mastercam \Documentation folder.
About the Migration Utility
15
17
If you are updating from Mastercam X2 or one of its maintenance

releases, (Mastercam X2, X2 MR1, X2 MR2, or X2 MR2 SP1) and you
are leaving your existing Mastercam installation, you can use the
migration utility as part of the installation.
18
The Mastercam X3 migration utility:
19
Copies customizable files (except part files) and certain

installed files that have been modified (that is, files with a
modify date different from the creation date) to their corresponding locations in the Mastercam X3 installation.
Creates backups of the new versions of these same files by
creating a filename.bak of the newly installed files before
replacing them with the customized files it is migrating. This
110
assures that you will have access to both the customized files
and the newly installed files.
Modifies .CONFIG files and updates paths, if necessary.

Note: Except for the .CONFIG files, the migration utility only
moves files; it does not convert them for use with Mastercam X3.
After using the utility to move files, you must still convert them
either by importing them or by opening them in Mastercam X3.
The following table lists the files that the migration utility acts on.
Table 1: Mastercam X3 migration utility files affected
Directory
Files
Extensions
root directory
NetHASP configuration
Communications settings
nethasp.INI
mcomm.CFG
\cnc_machines
Component libraries (general

machine definitions)
Machine definitions
.GMD
Control definitions
.MMD, .LMD,
.RMD, .WMD
.CONTROL
\config
Configuration files
Key mapping files
Toolbar mapping files
.CONFIG
.KMP
.MTB
product
folder\Mill\Formula
Formula files
.FORMULA
product
folder\ops
Operation libraries
Defaults
.OPERATIONS
.DEFAULTS
product
folder\posts
Post processors
.PSB, .PST, .SET
product
folder\tools
Tool libraries
.TOOLS
\materials
Material libraries
.MATERIALS
\wire\power
Power libraries
.POWER
\nesting
Nesting defaults
.DEFX, .NSLX
\common\editors\mastercam\machines
\VB
.XML
VB scripts
.VBS
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Updating from Previous Versions 9
About Migrating Manually

If you are installing Mastercam X3 into the same folder as your
current Mastercam X2 installation (replacing your current installation), you cannot use the migration utility. However, the installation
program will not replace your customized files with the newly
released version, so your customized files will be preserved.
If you are installing Mastercam X3 to a different folder but cannot use
the migration utility, you must copy any of the following files that you
have modified to your Mastercam X3 installation:
Control definitions (*.CONTROL)

Formula files (*.FORMULA)
Power libraries (*.POWER)
Tool holder descriptions (*.HOLDERS)
Nesting defaults (*.DEFX, *.NSLX)
1
12
13
14
Post processors except for 5-axis post processors (*.PST)

Setup sheets (*.SET)
Key mapping files (*.KMP)
15
Toolbar mapping files (*.MTB)

NetHASP configuration (nethasp.INI)
Communications settings (mcomm.CFG)
Upgrading from Mastercam Version 9.1

or Older
If you are upgrading to Mastercam X3 from Mastercam Version 9.1 or
an earlier release, no special file backup or archiving is necessary
other than your companys customary protocol for new software
installation.
The Mastercam X3 installation program does not overwrite
Mastercam installations that are Version 9.1 or older; Mastercam X3 is
installed in a separate and unique location from these versions of
Mastercam. The Mastercam X directory and file structures are
completely new and separate. You can run Mastercam X3 and older
Mastercam versions concurrently. For more information on migrating
your older Mastercam files and libraries, please see the Mastercam X3
Transition Guide. It will be installed in PDF format in your Mastercam
\Documentation folder.
16
17
18
19
110
Mastercam Support and Services

Use the following Web sites to find information on Mastercam:
www.emastercam.com
Mastercam global user forum
www.mastercam.com
CNC Software, Inc. corporate Web

site
www.mastercamedu.com
CNC Software, Inc. Educational Division Web site
For assistance with installing Mastercam, its SIM or NetHASP, or to

obtain more information on using Mastercam, contact your local
Mastercam Reseller. If your Reseller is unavailable, you can call CNC
Technical Support Services Monday through Friday, 8:00 a.m.5:30
p.m., USA Eastern Standard Time.
When calling CNC Software for technical support, please follow these
guidelines:
Be sure you have already tried to contact your Mastercam

Reseller.
Provide the serial number of your SIM HASP or NetHASP.
Be ready to describe the problem in detail. Write down what
happened, particularly if you cannot call immediately after
the problem occurs.
Be in front of your computer when you call.
If possible, try to duplicate the problem before calling. Our
Support Services technician may require you to duplicate the
problem while you are on the phone.
When you call, have ready a complete description of your
hardware, including your operating system (OS), central
processing unit (CPU), graphics card and settings, and
memory.
You can also leave a message for CNC Support Services twenty-four
hours a day, seven days a week via our e-mail or Web site addresses.
When sending e-mail, please include:
The serial number of your SIM HASP or NetHASP

Telephone number and contact information where you can
be reached
Files required to reproduce an issue, such as .MCX and post
files
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Mastercam Support and Services 11
TIP: Use Mastercams Zip2Go utility to gather Mastercam part

data into a compressed .Z2G file. This utility makes it easy to
provide your Reseller or CNC Support Services with a file
attachment that contains the information they need. Zip2Go
scans the machine groups in your current part file and captures
information such as your Mastercam configuration, machine
definition, and post files. For more information on using
Zip2Go, please refer to the Mastercam Help.
Important Contact Information

Address
CNC Software, Inc.

671 Old Post Road
Tolland, Connecticut, 06084-9970
USA
Phone
(860) 875-5006
Fax
(860) 872-1565
FTP Address
ftp://ftp.mastercam.com
Internet Address
http://www.mastercam.com
E-mail
support@mastercam.com
1
12
13
14
15
16
17
18
19
110
Documentation Resources
For more information on using Mastercam, refer to the following
resources:
Upgrades
Mastercam X3 Whats New: (printed document and PDF
file located in the Mastercam \Documentation directory)
Describes the enhancements and other features of a major
release, Maintenance Release (MR) or Service Pack (SP).
Mastercam X3 Transition Guide (printed document and
PDF): Assists Mastercam Version 9 and Mastercam X users
with the process of migrating their settings, libraries, and
parts to Mastercam X3. Includes PDF checklists to use as
migration worksheets.
Mastercam Version 9 to X Function Map (PDF): Maps all
functions available in Mastercam Version 9 to a Mastercam X
equivalent.
New System Startup

The Mastercam X3 Getting Started Guide (printed document and PDF): Use this guide to:
Get a basic orientation to the Mastercam X interface and
functions.
Customize and configure Mastercam X for optimum efficiency.
Understand the fundamentals of using Mastercam X to
design and cut parts.
Mastercam X3 Quick Reference Card (printed document
and PDF): Provides a graphical summary of Mastercam X3
key features and functions.
General
Help: Embedded, compiled HTML Help system, located in
the Mastercam \HELP directory.
To open Help to its default topic, choose Help, Contents
from the Mastercam menu, or press [ALT+H].
UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Documentation Resources 13
To open context-sensitive help, click the help button in

any dialog box or ribbon bar to open a related help topic.
To display a menu of functions newly added in the release,
choose Help, Whats New.
The Mastercam X3 Reference Guide (PDF): Supplements
the Help and other Mastercam product documentation.
Includes comprehensive conceptual information, detailed
overviews, examples, definition of terms and workflowrelated information on using Mastercam X and its functions.
To open, choose Help, Reference Guide.
Notes:
You must install Adobe Reader (version 4.0 or higher)
before you can view or print PDF documentation.
All PDF documents are available from the Mastercam X3
\Documentation directory.
1
12
13
14
15
16
17
18
19
110
chapter 2
Installing Mastercam X3
This chapter describes installing Mastercam on a single computer or on
a client computer in a network. Installing Mastercam on a network
server and other administrator tasks are described in Appendix A.
In this chapter, you will learn about:
Running the Installation Program . . . . . . . . . . . . . page 16

Entering the SIM Update Code . . . . . . . . . . . . . . . page 24
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 28
Running the Installation Program

Mastercam X3 is distributed in several formats:
CD (two-CD set)
DVD (available on request from your Mastercam Reseller)
Download from www.mastercam.com (only with a current
Mastercam Maintenance contract)
Note: Autodesk Inventor View is no longer distributed on CD. It is
included in the DVD installation and can also be downloaded
from www.mastercam.com. Inventor View provides Autodesk
Inventory compatibility if you do not have Inventor installed on
the same system as Mastercam.
This section describes installing Mastercam from CD.
Note: This section describes a typical installation using default
settings. Installation behavior can be modified by settings in the
mastercam.ini file. For a description of this file, see Setting
Installation Defaults on page 57.
Disk 1
Use CD Disk 1to install Mastercam X3. It provides two types of installations:
Express Install (Recommended): Installs Mastercam X3 with

minimal interaction with you.
Custom Install: Use this option to migrate customized files
from a previous installation. It provides options to install or
remove selected features, to reinstall (repair) the most
recently installed features, and to uninstall Mastercam
completely.
View Whats New File: Displays the Whats New? file, which
contains information on this Mastercam release.
Contact Us: Lists information you can use to contact CNC
Software, Inc.
Exit: Closes the installation program.
INSTALLING MASTERCAM X3 / Running the Installation Program 17
IMPORTANT: Before proceeding, make sure that you have

prepared for the installation as described in Chapter 1 of this
guide.
X To perform an Express Install:
1 Insert Disk 1 and choose Install Mastercam X3.
2 Choose the Express installation type, and then choose OK.
Note: Customized files will be migrated unless this feature is

disabled in the mastercam.ini file.
3 Mastercam X InstallShield Wizard runs. Follow the on-screen
instructions. Throughout the installation, click Next to

advance to the next step, Back to revert to the previous
screen, and Finish to complete an installation.
4 When the license agreement is displayed, you must accept it
to continue the installation.

X To perform a Custom Mastercam installation (migrate, modify,
repair, or remove):
1 Insert Disk 1 and choose Install Mastercam X3.
2 Choose the Custom installation type, and then choose OK.


5 When requested to enter user information (name and
company), you must enter it to continue the installation.
If a previous Mastercam X version is installed, you have two

choices:
Replace Previous Version: Replace your previous

Mastercam X installation by installing Mastercam X3 into
the same folder as your current Mastercam. The installation program:
Uninstalls the current version.
Installs Mastercam X3 into the folder you indicate.
If a previous version of Mastercam X2 is present, gives
you the opportunity to migrate customized files from
it.
Gives you the opportunity to backup customized files

from the version you are replacing.
Choose Yes or No. If you choose Yes, indicate the

folder where you want to store the backup files. We
strongly recommend that you back up your files.
Leave Previous Version: Install Mastercam X3 in a

different folder so that you keep the previous versions
installed. (This is the default setting.) If the existing
Mastercam installation is Mastercam X2 or one of its
maintenance releases, you will have an opportunity to
migrate certain customized files to the new folder. If you
do not have Mastercam X2, you will have to migrate your
customized files manually. See the Mastercam X3 Transition Guide for detailed information on migrating and
converting files. It will be installed in PDF format in the
\Documentation folder.
7 Indicate the folder where you want to install Mastercam X3.
You can accept the recommended folder, choose a different

folder, or create a new folder by entering a new folder name.
8 Select your SIM type. Select HASP if your SIM is a single
Mastercam seat license. Select NetHASP if your SIM is a

network license.
9 Select the default units. Regardless of the default units you
choose, you can open and program parts in the other units.
10 Choose Install. The installation program runs.
11 If there is a previous Mastercam X2 version still installed,
choose the version you want to migrate from, or reject migration.
12 When the migration is complete, you will be notified. Click
OK.
To see a list of migrated files, open Migration Log.txt in the root of

your Mastercam X3 installation.
If you are not on Mastercam Maintenance, you must also update your
SIM with an update code. See Entering the SIM Update Code on page
24 for more information.
Disk 2
Disk 2 contains optional products, as well as some of the same
options as Disk 1. You can add these optional products to your installation at any time.
Sample Files: Installs sample files that illustrate the features

of each Mastercam product, and the Mastercam X Art Classic
Design Library. You will have an opportunity to select which
sample files you want to install. You can install sample files at
the same time as you install Mastercam X3 or later. Adding
sample files after you have installed Mastercam is described
next.
Videos: Installs videos that highlight the features and newly
added functions of this release. You can also download these
and other videos from www.mastercam.com.
NetHASP Server: Installs the NetHASP server software for
support of network licensing. This installation is described in
Installing the NetHASP Server on page 61.
NetHASP Monitor: Installs the NetHASP Monitor utility
(aksmon.exe), which lists all users that are logged in to the
NetHASP server at a specific point in time. This installation is
described in Monitoring NetHASP Users on page 72.
Contact Us: Lists information you can use to contact CNC
Software, Inc.
Exit: Closes the installation program.
X To install sample files, videos, and NetHASP software:

1 Insert Disk 2 and choose the option you want to install.


4 When requested to enter user information (name and
company), you must enter it to continue the installation.

5 Each option installs separately. You must finish each installa-
tion before going on to the next. Follow the on-screen

instructions.
X To add sample files to an existing Mastercam installation:
1 Insert Disk 2, choose Sample Files, and then follow the on-
screen instructions.
2 Choose Modify, and then choose Next.
3 Select the sample files you want to install, and choose Next.
4 Choose Finish and Exit.
Entering the SIM Update Code

When you install or upgrade Mastercam X and you are not on
Mastercam Maintenance, you must also update your HASP and
NetHASP SIMs with an update code. The SIM must be activated with
the update code before you can run the new or updated version of
Mastercam X.
Note: Instructions for Updating NetHASP Codes are on page 66.
The update code is a file that may be delivered to you using one of the
following methods:
Included with your Mastercam software kit

Mailed on electronic media
E-mailed as a file attachment
Printed documentation received via fax, e-mail or mail
Note: Contact your Reseller if you cannot locate your update code.
Update code files have a file extension that indicates the type of SIM
license they update. The Mastercam X installation program associates
these file extensions with the program you use to update the SIM
codes.
Update code
file extension
SIM license type
Update code program
.HCODE
HASP
HaspX.exe
.NHCODE
NetHASP
NHaspX.exe
Note: If you have more than one HASP SIM on your computer, you
should remove any SIMs other than the Mastercam SIM before
entering the update code.
INSTALLING MASTERCAM X3 / Entering the SIM Update Code 25
TIPS:
After you finish installing Mastercam X, you can run the
appropriate program by doubleclicking the update code
file.
You can also access the HASP utility when running
Mastercam by choosing Help, About from the Mastercam
menu and then clicking the Hasp button.
X Before entering the update code:
Use one of the following methods to prepare for the update,
based on the format of the update code you received and
your personal preference:
E-mail attachment: Save the attachment as a file to an

accessible location. (Do not change the file extension.)
Mastercam X3 installation kit electronic media: Insert
the media in the appropriate drive to access the file.
Printed documentation: Have a copy of the document
available.
Updating HASP Codes

IMPORTANT: Before you begin this phase of the installation
process, see Installing a HASP (Single-User License) on page 4
and Running the Installation Program on page 16.
X To enter a HASP update code:
1 Choose one of the following methods to run HaspX.exe. The
method you choose is based on the format of the update

code you received and your personal preference:
From the Mastercam X3 menu bar, choose Help, About,

and then click Hasp.
From the Windows desktop, choose Start, All Programs,
Mastercam X3, Hasp X.
Double-click the update code file (*.HCODE).
Use Windows Explorer to navigate to the Mastercam
installation location and double-click HaspX.exe.
The HaspX utility analyzes the SIM and displays the SIM
serial number and current Mastercam products. Verify that
the displayed serial number matches the serial number

provided with your Mastercam X3 documentation.
TIP: Keep a record of the serial number in the event that you
need to contact Technical Support Services at CNC Software or
your Reseller.
2 In the HaspX dialog box, use one of the following methods to
enter the update code:
If you received your update code as a file, choose Update

code to open the code file you received. The HaspX utility
extracts the update code from the file.
If you received your update code as printed documentation, enter the code in the text field next to the Update
code button. (Do not click the Update code button.)
INSTALLING MASTERCAM X3 / Entering the SIM Update Code 27
3 Choose Update at the top of the HaspX dialog box. The
program updates the SIM and displays the products for

which the SIM has been activated.
4 Choose OK to exit the HaspX utility.
Notes:
Start date / End date: Displays the start date and end date for
the SIM. For some evaluation copies of Mastercam, the HASP
SIM starts and expires on a specified date. You cannot use the
software after the end date.
Maintenance Expiration date: This field shows the date your
Maintenance plan expires, based on your annual renewal
date.
HASP Status: This area shows whether the utility found the
HASP SIM on your computer.
Troubleshooting
Manually Installing SIM Drivers
The Mastercam installation program automatically installs the software needed to use the HASP SIM with Mastercam. In the event that
the SIM drivers need to be reinstalled, choose Start, All Programs,
Mastercam X3, Hasp Setup, and then follow the instructions on
screen to install the SIM drivers.
Running a Repair
If you encounter a problem after an installation and you have not
been notified that there is a SIM or HASP driver problem, first attempt
to repair the installation as described next.
X To repair an installation:
1 Install Disk 1.
2 Choose Install Mastercam X3.
3 Choose Custom Install.
4 Choose Repair, and then follow the prompts.
chapter 3
Mastercam X3 Startup
This chapter describes the processes you can use to run Mastercam X3
following the installation. It also provides information on how to maintain the application using the online Update Manager function.
Starting Mastercam . . . . . . . . . . . . . . . . . . . . . . . . . page 30

Mastercam Launcher . . . . . . . . . . . . . . . . . . . . . . . . page 31
Using Command Line Switches . . . . . . . . . . . . . . . page 37
Using the Update Manager . . . . . . . . . . . . . . . . . . . page 43
Starting Mastercam
During installation, Mastercam shortcuts are added to the Start, All
Programs menu, and to the desktop.
X Use one of the following methods to start Mastercam:
Double-click the Mastercam X3 shortcut on the desktop.

Choose Start, All Programs, Mastercam X3, Mastercam
X3.
The Mastercam initialization screen displays briefly, followed by the
Mastercam software license agreement. After you view and accept the
license agreement, the Mastercam X3 window opens.
TIP: For information on customizing your Mastercam shortcuts, see Using Command Line Switches on page 37.
MASTERCAM X3 STARTUP / Mastercam Launcher 31
Mastercam Launcher
Use Mastercam Launcher (in X2 MR2 or later) to control the startup
options for a particular seat (license) of Mastercam. You can set the
following Mastercam startup options:
Assign product (platform) levels and availability, such as Mill,

Level 1
Edit the availablility of Mastercam Add-on products and the
status of their use
3
32
3
Start Mastercam with either a HASP or NetHASP

Use Dealer, Industrial, Educational, or Student functionality
(editing capabilities for Mastercam Resellers only)
Run Mastercam with or without Maintenance (editing capabilities for Mastercam Resellers only)
Create a customized Mastercam shortcut on the desktop
based on the current Mastercam Launcher settings
Save the current settings to the registry and/or open
Mastercam when you click OK.
34
35
The Mastercam Launcher is primarily designed for NetHASP clients

and Mastercam Resellers. Some of the options on this dialog box
(such as running Mastercam with or without Maintenance) are only
available if you have a Resellers HASP.
36
You can start Mastercam Launcher by clicking Start, All Programs.

Navigate to your latest Mastercam install and select Mastercam
Launcher. You can also click the desktop icon for Mastercam
Launcher.
37
38
39
310
Figure 3-1: Mastercam Launcher dialog box
Information area: Displays the HASP (or NetHASP) number

being used, its expiration date, and the Maintenance expiration date.
Notes:
If a permanent SIM is being used, the HASP expiration will
display the word Permanent rather than a date.
Maintenance expiration date shows the date that Maintenance on the SIM expires. For temporary codes, the SIM expiration date and the Maintenance expiration date will be the
same.
Platform area: This section shows a grid with the name of

each of the Mastercam product lines (platforms), the avail-
able level of that platform on your SIM, and the status of the
platform.
The Level column has a drop-down arrow that allows you to
select a specific level of a product. For NetHASP clients, you
can see what levels are available at that time and choose
which one you want to use. Only the levels that are licensed
on the SIM will appear.
The Status column also has a drop-down arrow that allows
you to choose from the following status settings:
Active the product is available to be used.

Inactive the product is not available to be used (acts as if
you are not licensed for the product).
Startup
Mastercam starts up in that product.
Figure 3-2: Example of Reseller - HASP setup
3
32
3
34
35
Figure 3-3: Example of NetHASP client (non-Reseller)
36
37
38
Notes:
If a platform is not enabled on a SIM, the entire row is inactive.
For a Reseller HASP or NetHASP, all platforms and add-ons are
available. For a non-Reseller NetHASP, the fields for items that
are not licensed are unavailable.
Add-on Products area: This section lists all of the available

Add-on products, and how many licenses are currently available.
39
310
To check out a license for the session, click the arrow button
in the Status column for the Add-on product you want to
work with, and set the status to Enable. If you choose the
Disabled status, that Add-on is not available for you to use,
even though it is available on the NetHASP.
A Not Licensed status means that the Add-on is not licensed
on your SIM, and therefore you do not have access to that
Add-on.
Not all Add-ons are checked out at start-up. Items that are
not checked out at start-up are marked Automatic Checkout.
Add-on products that are not available on the SIM are inaccessible. If an Add-on is on the SIM but all of the instances
are in use, the available number in the Licenses available
column will be 0, and you will not be able to use it.
Figure 3-4: Example of Reseller - HASP setup
Figure 3-5: Example of NetHASP client (non-Reseller)
3
32
3
34
HASP Type area: The radio buttons in this area allow you to
switch your SIM type between HASP, NetHASP, and NetHASP
Local. The availability of the switch options is dependent on
your access to each of those devices at the time you start
Mastercam Launcher.
HASP Emulation area (Resellers only): This section allows
Mastercam Resellers to set up Mastercam to run under
Dealer, Industrial, Educational, or Student functionality.
They can also set up Mastercam to run with or without Maintenance.
Note: The Maintenance check box is on and disabled if the Dealer
or Student emulation option is selected and active/editable if the
Industrial or Educational emulation option is selected.
Create Shortcut: Creates a shortcut on the desktop based on

the current settings in Mastercam Launcher and prompts
you for a name. The shortcuts contain all of the switches
needed to open Mastercam according to the settings you
chose in Mastercam Launcher.
When you create a shortcut and do not enter a name for it,
Mastercam will name the first shortcut as Mastercam (1), and
35
36
37
38
39
310
increment the number for each customized shortcut you

create without specifying a name.
Save settings on exit: Select to save the settings in the

Mastercam Launcher to the registry when you click OK to exit
the dialog box. If you click Cancel to exit the dialog box, the
settings will not be saved to the registry, even if you have
selected this option.
Start Mastercam: Select to have Mastercam launch when
you click OK. If you click Cancel to exit the dialog box,
Mastercam will not start, even if you have selected this
option.
MASTERCAM X3 STARTUP / Using Command Line Switches 37
Using Command Line Switches

Instead of using Mastercam Launcher, you can use command line
switches to load licenses for selected product levels and add-on
features when you click the Mastercam X icon. You typically use
command line switches to request specific NetHASP licenses when
you start a Mastercam session, although you can also use them with
HASP licenses to open Mastercam in a particular product or product
level or to suppress products or product levels.
Prior to Mastercam X, separate program files existed for each product
type, such as Mill9.exe, Lathe9.exe, and so on. Checking out different
Mastercam product licenses often required you to exit and restart a
different Mastercam program. In Mastercam X, you start all products
using a single .exe file (Mastercam.exe). Product licenses are checked
out at startup and then exchanged each time you choose machine
definitions for different machine types (Mill, Lathe, Router, Wire).
This flexible structure allows NetHASP licensing to be dynamically
allocated.
If you start up Mastercam X without using command line switches,
Mastercam first checks out a Mastercam Design license if one is available. If not, it checks out the highest level license available for Mill,
Lathe, Router, or Wire to ensure that a product-level license is allocated. When you choose a machine definition type (Mill, Lathe,
Router, Wire) that is different from the current product license allocation, the current license is released and a product license matching
the selected machine type is checked out.
Note: If no command line switch is provided at startup for a
product, Mastercam checks out the highest available level license
first. For example, if the NetHASP has both Mill Level 1 and Mill
Level 3 licenses available, the Mill Level 3 license is checked out. If
it is not available, the Mill Level 1 license is used.
By adding command line switches to the Mastercam shortcut, you
control which product level licenses are checked out during the
Mastercam session. For example, to create a shortcut that checks out
only Level 1 licenses when a Mill, Router, or Lathe machine type is
selected, add the following command line switches to your
Mastercam shortcut: /M1 /R1 /L1.
3
32
3
34
35
36
37
38
39
310
X To set command line switches for a Mastercam shortcut icon:

1 From the Windows desktop, use the right-mouse
button to select the Mastercam X3 icon.

2 Choose Properties, and then select the Shortcut
tab.
3 Add one or more command line switches to the Target field.
Precede each command by a / and separate each by a

space. (See Command Line Switches on page 39 for a
complete listing.) For example, to request a single Mill Entry
license at startup, enter:
C:\mcamX\mastercam.exe /ME
To request a Mill Level 3 license and a Solids license:
C:\mcamX\mastercam.exe /M3 /S
To request three licenses at startupMill Level 1, Lathe Level
1, and Solids:
C:\mcamX\mastercam.exe /M1 /L1 /S
IMPORTANT: If the directory name contains spaces, you

must enter the shortcut using the following format:
Place quote marks around the directory path.
Place the command line options outside of the quote marks.
For example:
c:\mastercam version X\mastercam.exe /M3
3
32
4 To accept the command line changes to the Mastercam icon
and exit the Properties dialog box, click OK.
Command Line Switches

All command line switches are listed below for each Mastercam
product. However, all products may not be included with your
Mastercam installation.
Note: If you use a command line switch to suppress products or
check out a lower level product than the HASP or NetHASP
supports, a message displays listing the products enabled by the
HASP or NetHASP and modified by the command line switch. You
can use the /noRem command line switch to suppress this
message.
TIP: To view information on all the Mastercam products and

features included with your installation, choose Help, About
from the Mastercam menu. The list includes all product types
that are available with your installation, regardless of whether
they are currently checked out.
3
34
35
36
37
38
39
310
Mastercam Design
/D = Design only (requires a stand-alone Design license).
For example, use this switch if you want to load a part
that contains toolpaths but do not want to check out a
Mill, Lathe, or Router license.
/noD = Disable Design only
Mastercam Mill
/ME = Mill Entry
/M1 = Mill Level 1
/M2 = Mill Level 2
/M3 = Mill Level 3
/noM = Disable Mill
Mastercam Lathe
/LE = Lathe Entry
/L1 = Lathe Level 1
/noL = Disable Lathe
Mastercam Router
/RE = Router Entry
/R1 = Router Level 1
/R2 = Router Plus
/R3 = Router Pro
/noR = Disable
Router
Mastercam Wire
/W2 = Wire
/noW = Disable Wire
Mastercam Art
/Art = Art
/noArt = Disable Art
All Products
/noRem= Suppress
product message
Mastercam Add-on Features

/S = Solids (Mill,
Lathe, Router, Wire,
Design)a
/noS = Disable Solids (Mill,

Lathe, Router, Wire, Design)
/C5 = Curve/Drill5ax
(add-on for Mill Level
1 or Level 2)
/noC5 = Disable Curve/

Drill5ax (add-on for Mill
Level 1 or Level 2)
/V5 = Verify 5-Axis
/noV5 = Disable Verify

5-Axis
/X5 = Multi-Axis addon
/noX5 = Disable the MultiAxis add-on
/N = Use NetHASP
(remote)b
/NL Use NetHASP (local)b
/H = Use HASPb
/Nest = Nesting
/noNest = Disable Nesting
a. There are numerous checks in Mastercam for a valid Solids

license, including Solids creation, Analyze, Parasolids file
conversion, STL file conversion, SAT file conversion, STEP
file conversion and Xform functions. To create, transform, or
export a Solid, you must check out a Solids license.
b. Use these command line switches to manually override the
registry settings that were written by the NetHASP / HASP
installation programs.
Error Messages
When Mastercam starts, it attempts to get a license from the NetHASP
server. Following are the most common error messages you may
receive when a license cannot be obtained:
Error checking out a [product name] license. No licenses have been
purchased for this product. Contact your Reseller and purchase the
necessary options.
Active NetHASP server not found. The NetHASP license manager is
not running. Check the NetHASP server and restart as necessary.
All available licenses are in use. The maximum number of users
allowed to license a product are using it at the current time.
Approximately once every 2 to 10 minutes, Mastercam verifies that
the NetHASP server is still running and that the NetHASP is attached
to the server. If this test failsfor example, due to a power loss or
server failurethe following message is displayed on all PCs running
Mastercam:
3
32
3
34
35
36
37
38
39
310
The SIM has become disconnected. Mastercam will automatically

shut down. You will get one chance to save your file. This message
should be taken very seriously. Save your work quickly and shut down
Mastercam. Check the NetHASP connection and reconnect, as necessary.
MASTERCAM X3 STARTUP / Using the Update Manager 43
Using the Update Manager

Mastercams online Update Manager lets you use an Internet connection to download and install selected updates to your local
Mastercam installation. You can optionally download and save the
update files for later installation. This flexibility allows you to transfer
and install the update files to other workstations that do not have
Internet access.
If you are using one PC to update other Mastercam installations in
your company, there are a few things to keep in mind:
The PC used to download the updates must have Internet

access and an installation of Mastercam.
The same version of Mastercam must be installed on all PCs
in the group you want to update, including the PC used to
download the updates, and their Maintenance contract dates
should also be the same.
Do not use the install locally method to update the PC that
downloads the updates. Instead, after you download the
updates for local installation, restart the Update Manager on
that PC and use its Internet connection to download and
install selected updates.
You can run the Update Manager at any time during a
Mastercam session by choosing Help, Update Mastercam
from the Mastercam menu. Or if you have added this function to a toolbar, you can click the icon to run it.
Most updates require you to exit Mastercam X before the installation
can be completed. If this is necessary, you are asked to close all
sessions of Mastercam X that are running on the PC before continuing
with the update installation.
3
32
3
34
35
36
37
38
39
310
Notes:
For English-language Mastercam installations, the Update
Manager connects you directly to CNC Software, Inc. for
update information.
For non-English Mastercam installations, the Update Manager
redirects you to your local Reseller for information on available
updates.
Although you can run the Update Manager from the
Mastercam X application, it is a separate application that
resides in the Mastercam X \UPDATESERVICE directory.
This section includes instructions on:
Downloading and Installing Updates (Same PC) (page 44)

Downloading and Installing Updates on Another PC (page 47)
IMPORTANT: These instructions apply only to English-based
Mastercam installations that connect with and receive updates
from CNC Software, Inc. For information on downloading nonEnglish Mastercam updates from other locations, contact your
local Reseller.
Downloading and Installing Updates

(Same PC)
X To download and install Mastercam updates on the same
computer:
1 From the Mastercam menu, choose Help, Update
Mastercam to run the Update Manager program.

2 The Update Manager uses the effective Maintenance
contract dates on your HASP / NetHASP with your Internet

connection to contact CNC Software, Inc. and check if
updates are available.
If no updates are available for your Mastercam installation, the following message displays and you must click
OK to exit the Update Manager.
3
32
Otherwise, all available updates display in the upper pane

of the Mastercam Update Manager window.
3
34
35
36
37
38
39
As you use the mouse to highlight each update in this

section, its details appear in the lower pane. Select one or
more updates to install, and then click OK to continue.
310
Note: The updates you can view and download are based on your
current Mastercam X version and your effective Maintenance
contract dates.
3 For most selected updates, you are asked to close the
Mastercam session before you can continue with the update

installation.
When this message displays, close the Mastercam application and then click OK to continue.
4 In the lower left corner of the Mastercam Update Manager
window, a series of messages display, indicating the progress

of the download and installation process. For example:
The spinning Mastercam X icon also indicates that the installation is progressing. An InstallShield window displays briefly
behind the Update Manager window before the installation
begins, and then closes automatically.
5 When the installation is complete, notice that the selected
updates no longer appear in the upper pane of the

Mastercam Update Manager window.
If you are finished installing updates, click OK to exit. You

may be prompted to restart your PC and must close all
applications and restart before you can run Mastercam.
Otherwise, repeat Step 2Step 5 to select and install additional updates.
Downloading and Installing Updates on

Another PC
This procedure is similar to the preceding one except that it is a twopart process.
First run the Update Manager on a Mastercam PC with

Internet access to download and save the selected files to a
specified location.
Then run the Update Manager on another Mastercam PC
that does not have Internet access to install the selected
updates.
3
32
3
X To download Mastercam updates without installing them:

34
2 The Update Manager uses the effective Maintenance
contract dates on your HASP / NetHASP with your Internet

connection to contact CNC Software, Inc. and check if
updates are available.
If no updates are available for your Mastercam installation, the following message displays and you must click
OK to exit the Update Manager.
35
36
37
38
39
310
Otherwise, all available updates display in the upper pane

As you use the mouse to highlight each update in this

section, its details appear in the lower pane. Select one or
more updates to install. Then choose the option to Save
Files to Update Another Computer.
Note: The updates you can view and download are based on your
current Mastercam X version and your effective Maintenance
contract dates.
3 Use the Browse for Folder dialog box to navigate to the loca-
tion where you want to save the update files, and then click
OK.
IMPORTANT: Save all of the update files you will install on

other PCs to a single location. No files other than the downloaded update files should reside in that location. To install
properly, the update files must be isolated from other files and
must be saved together in the same location.
4 In the lower left corner of the Update Manager window, a
3
32
series of messages display, indicating the progress of the

download process. For example:
3
5 The spinning Mastercam X icon also indicates that the down-
load is progressing. When the download is complete, notice

that the selected updates no longer appear in the upper pane
If you are finished downloading updates, click

Cancel to exit the Update Manager.
Otherwise, repeat Step 2Step 5 to download
additional updates.
X To install downloaded updates on a PC that does not have
Internet access:
Before beginning this procedure, make sure that the update files
are in a location that is accessible by the PC, for example, a
network drive, or the PCs hard disk, CD, or diskette drive.
34
35
36
37

2 The Update Manager recognizes that the PC does not have
Internet access and displays a dialog box asking if you want

to install updates locall. Click OK to continue.
38
39
310
3 Use the Browse for Folder dialog box to navigate to the loca-
tion where the update files reside (either locally or in an

accessible network location), and then click OK.
4 The installation begins and a series of messages display, indi-
cating the progress of each update installation. The spinning

Mastercam X icon also indicates that the installation is
progressing. When the installation is complete, click OK to
exit.
5 Close all applications and restart your PC before running
Mastercam.
Troubleshooting the Update Manager

The types of errors you may encounter while running the Update
Manager include:
Licensing / authorization: Errors of this type indicate that

the correct Mastercam X version could not be located or the
expiration date associated with your Mastercam X Maintenance plan could not be validated. Either the expiration date
format is incorrect, the value is too large or small, or it could
not be converted into a known value. A valid Maintenance
expiration date is required to authorize the download of
updates associated with Maintenance releases. Without it,
you can still continue to view and download non-Maintenance updates. However, you should contact your local
Reseller, or CNC Software Technical Support Services to
verify and correct the problem.
Internet connectivity: A connection could not be established
with the update server or an error occurred while attempting
to retrieve updates. To correct this problem, you should
check your Internet connection, wait a short period of time,
and try again later. If the problem persists, contact your
network administrator or CNC Software Technical Services
with a detailed description of the circumstances under which
the error occurred.
Unknown / unexpected error: For an unknown reason, a
fatal error occurred and the update could not continue. Wait
a while and try again. If the problem persists, report it to your
network administrator or contact CNC Software Technical
Support Services for assistance.
Note: See Mastercam Support and Services on page 10 for contact
information.
3
32
3
34
35
36
37
38
39
310
appendix a
Information for the

Network Administrator
This appendix provides information for the person tasked with
installing and administering Mastercam in a network setting. It
includes the following sections:
Network Administrator Qualifications . . . . . . . . . page 54

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 55
System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 56
Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 60
Installing the NetHASP Server . . . . . . . . . . . . . . . . page 61
Entering the SIM Update Code . . . . . . . . . . . . . . . page 65
Using the NHaspX.exe Utility . . . . . . . . . . . . . . . . . page 69
Monitoring NetHASP Users . . . . . . . . . . . . . . . . . . page 72
Network Administrator Qualifications

A full-time network administrator must be available and able to
perform the following tasks:
Recover from a network crash in a reasonable amount of

time. Network licensing depends on a stable network.
Configure the network as required by this document and the
nethasp.txt document. See Additional NetHASP Information
on page 75 for details on the nethasp.txt. Also see Information
for the Network Administrator on page 53.
Be proficient with a text editor.
Understand and edit command line parameters.
Learn enough about Mastercam to understand which
licenses are checked out when each of the Mastercam products start up.
Understand how to use the Mastercam NHaspX.exe utility.
Agree to install Mastercam on all PCs that require it.
Attempting to run Mastercam from a common directory on a
network drive does not work. The application must be physically installed on each PC where it will be used.
Be familiar with the NetHASP, a red device that is plugged
into the NetHASP server's parallel or USB port. Although the
NetHASP is similar in appearance to a HASP, it is functionally
very different. The HASP and NetHASP are not interchangeable.
Have e-mail access and the ability to accept attachments.
The most practical way to update a NetHASP is to e-mail the
update code file as an attachment.
IMPORTANT: Keep the NetHASP device in a physically safe
place. All Mastercam users on the network are vulnerable to its
loss.
INSTALLATION 55
Installation
Mastercam must install components into the Windows system32
folder, as well as register these components globally. Mastercam must
also install HASP security device drivers. For this reason, you can
install Mastercam X3 only as a member of the Administrator group.
Additionally, to install Mastercam X3 properly, the user must have the
Impersonate a client after authentication group policy. The Administrator group gets this permission by default, but some upgrade
scenarios may not have this permission set. Without this permission,
the installation will fail at the very end, after all program files have
been copied. In this case, the status text on the installation will read
Publishing Product Information.
When installing as an Administrator for other users, you must select
the Anyone who uses this computer (all users) option. This option
is the default setting for the installation.
Mastercam X3 will not install to a drive created with the SUBST
command. To install in this scenario, use the actual path to the
desired installation directory, not the substituted drive letter.
A6
System Settings
The following sections describe important system settings, including
file and registry permissions, as well as network configuration and
group policies.
File System
Mastercam X3 requires the user to have read and write access to the
installation directory. By default, Mastercam X3 installs into the root
of the Windows system volume (the drive where Windows is
installed), under a directory called \mcamx. The Windows system
volumes default permissions allow any user to read and write to
directories created in the root.
Note: Starting with Mastercam X3, configuration files (.CONFIG)
can reside in folders outside of the \mcamx structure (for
example, in a network location. Configuration files are the only
files that can reside elsewhere.
However, many users prefer to install Mastercam X3 into the
\Program Files directory to conform to Windows standards. When
you install Mastercam X3 into this directory, the directory inherits the
\Program Files directorys restricted permissions. In this case, users
who will use Mastercam X3 from this location must be granted write
permissions to the Mastercam installation directory (and all subdirectories). Users do not need write permissions for the \Program Files
directory.
Registry
To run Mastercam, the user needs permission to read from the
HKEY_LOCAL_MACHINE\SOFTWARE\CNC Software, Inc.\ key.
This key is created during the installation and contains default
Mastercam X3 settings.
The user also needs read and write permission to
HKEY_CURRENT_USER\SOFTWARE\CNC Software, Inc.\. This key
is created when the user first starts Mastercam X3 and is used to store
per-user settings.
These registry permissions are the Windows system default, so no
adjustment is needed in a default Windows installation.
SYSTEM SETTINGS 57
Network
Mastercam X3 can use a NetHASP security device to service
Mastercam licenses from a central location. Because these licenses
are served over a network, a firewalled server running a NetHASP
must allow the license server to communicate through the firewall.
Doing this requires two configuration steps:
The firewall must be configured to open port 475.

The NetHASP server program
(c:\windows\system32\nhsrvice.exe) must be allowed to
work through the firewall.
Please consult your firewall documentation for instructions on how to
change these settings.
Group Policies
By setting group policies, you can severely restrict the permission on a
Windows system. Mastercam X3 runs with the default group policies.
Most other group policies have no effect on Mastercams ability to
run. However, a combination of group policies might cause issues
with Mastercam X3.
Setting Installation Defaults

You can set the installation defaults in the mastercam.ini file, which is
included in the \data\mastercamX3 folder on Disk 1 of the CD distribution. mastercam.ini is a text file that contains the defaults for the
following installation settings:
Installation language
Language
Units
Installation type
SIM type
Destination directory
Whats New file display at the end of the installation
Migration with Express installation
User name for Express installation
Company name for Express installation
A6
X To set installation defaults:

1 Open mastercam.ini in a text editor. (Do not use a word
processor to edit this file.)

2 Comment out the setting that you want to disable by
inserting ;; before the first character. The following picture

shows the default mastercam.ini.
3 Save the file.
Figure A-1: Default mastercam.ini
;; mastercam.ini
;;
;; Uncomment the desired language(s) to have the
Mastercam X installation display the Select
;; Languages dialog. You will also need to create
a subdirectory in the installation image with the
;; available languages names. Copy all the files
from the english subdirectory and translate
them.
;; They will then be placed on the target system
when the language is selected. If you do not
translate
;; all the files some text will still be in English
[Languages]
english
;bulgarian
;chinese-simplified
;chinese-traditional
;croation
;czech
;danish
;finnish
;french-canda
;french
;german
;italian
;japanese
;polish
;portuguese-brazil
;portuguese
;romainian
;russian
;spanish
[DefaultLanguage]
english
(continued next page)
SYSTEM SETTINGS 59
Figure A-2: Default mastercam.ini (continued)
[DefaultUnits]
I ;; Inch
;;M ;; Metric
[InstallType]
;;R ;; Replace Previous Version
L ;; Leave Previous Version
[SimType]
H ;; Hasp
;;N ;;Nethasp
[DestinationDirectory]
c:\mcamx
[DisplayWhatsnew]
;;Y ;; Enable Whatsnew Checkbox
N ;; Disable Whatsnew Checkbox
[Migration] ;; For express installs only!
Y ;; Migrate files from last installed version of
Mastercam (X2 and higher)
;; N ;; Do not migrate.
[UserName] ;; For express installs only! Enter a
UserName incase the system UserName does not
exist.
My name
[CompanyName] ;; For express installs only! Enter
a CompanyName incase the system CompanyName does
not exist.
My company name
A6
Windows Vista
Windows Vista x64 requires signed drivers for the HASP. Mastercam
X3 does not ship with these signed drivers. For this reason, you must
install Mastercam X3 in Windows Vista x64s Disable Driver Signature Enforcement mode. You can access this mode by holding down
the F8 key before Windows Vista boots and selecting the mode from
the menu that appears.
INSTALLING THE NETHASP SERVER 61
Installing the NetHASP Server

Although NetHASP supports most networks, CNC Software, Inc. tests
and supports its use only with Windows XP or Windows Vista in a
TCP/IP network environment. For more information, see Additional
NetHASP Information on page 75.
X To set up the NetHASP server for Windows XP, Windows Vista,
or Windows 2000:
1 Connect the NetHASP to the computer you want to use as the
NetHASP server, either to a parallel or USB port based on the

NetHASP type.
2 Insert Mastercam X3 CD-ROM Disk 2 into your CD drive. Use
one of the following methods to start the Mastercam installation procedure:
If your computer is set up for Autorun, the Mastercam

installation program opens automatically.
Navigate to the CD drive and doubleclick Setup.exe.
3 Choose Install Optional Products from the installation
menu.
4 From the menu, choose Install NetHASP Server. Follow the
on-screen instructions, and choose Finish to exit when the

installation is complete.
Note: You can, but are not required to, install Mastercam products
on the NetHASP server.
5 Use the NHaspX.exe utility to check available Mastercam
licenses. You can copy NHasp.exe from the CD. For more
information on this utility, see Using the NHaspX.exe Utility
on page 69.
X To set up Mastercam for the NetHASP:
1 Install Mastercam X3 using instructions in Running the Installation Program on page 16.
2 Install the TCP/IP network protocol if not already installed.
3 Run NHaspX.exe. Set the SIM type to NetHASP and choose
one of the following Mode settings:
If the PC is not the NetHASP Server, choose Network.
A6
If the PC is also used as the NetHASP Server, choose Local.

4 Copy the nethasp.ini file to the main Mastercam directory
(for example, c:\mcamx). Use your preferred text editor to

edit the nethasp.ini for the appropriate network protocol and
identify the computer(s) that are being used as the NetHASP
server(s).
IMPORTANT: If this step is omitted, when Mastercam starts
and checks for network licenses, it requires additional time to
search all PCs on the network to identify the NetHASP server.
In the event that all licenses have been checked out by other
Mastercam users on your network, it may take an especially
long time. Configuring nethasp.ini to look for the NetHASP
server at a specific address virtually eliminates this delay.
5 Create or edit shortcuts for running Mastercam with
command line switches as described in Using Command Line
Switches on page 37.
Note: The Mastercam installation process automatically installs

NetHASP drivers. If the installation procedure was not completed
or if the NetHASP drivers were removed, Mastercam cannot recognize the NetHASP. To fix this problem, run haspdinst.exe from
the Mastercam \common directory (for example,
C:\mcamx\common).
INSTALLING THE NETHASP SERVER 63
Figure A-3: Recommended nethasp.ini for TCP/IP
[NH_COMMON]
;; This NetHASP.INI file is configured for TCPIP.
;; Please note that you will have to enter the
address of the
;; NetHASP key station:
NH_TCPIP = Enabled
;Use the TCP/IP protocol
[NH_TCPIP]
NH_SERVER_ADDR = 192.168.176.1, 192.168.176.5

; IP addresses of all the NetHASP
; License Managers you want to
; search.
; Unlimited addresses are possible.
; Possible address format examples:
; IP address:
192.114.176.65
; Local Hostname:
ftp.aladdin.com
NH_TCPIP_METHOD = TCP
;Send a TCP packet or UDP packet
; Default:
UDP
NH_USE_BROADCAST = Disabled
;Use TCPI/IP Broadcast mechanism.
; Default:
Enabled
Maximum Number of NetHASP Licenses

A NetHASP-20 or NetHASP-50 are the most common NetHASP configurations. The NetHASP-20 allows up to 20 seats of each product to be
A6
used. The NetHASP-50 allows up to 50 stations of each product to be

used. A total of 220 seats (simultaneous users) can be authorized with
a NetHASP-20: 20 Mill Entry, 20 Mill Level 1, 20 Mill Level 2, 20 Mill
Level 3, 20 Lathe Entry, 20 Lathe Level 1, 20 Wire, 20 Design, 20 Router
Entry, 20 Router, 20 Router Pro, and 20 Router Plus seats. A maximum
of 550 seats can be authorized with a NetHASP-50.
IMPORTANT: All product groups must be the same version.
For example, if your license supports one seat of Mill Entry and
one seat of Mill Level 3, the version number for both products
must be version X. A different version number cannot be
assigned to each group of products.
Adding Licenses
The number of licenses you purchase for each product is stored in the
NetHASP memory. The maximum number of licenses allowed for
each product is further limited by the type of NetHASP.
Once you have reached the maximum number of licenses, use one of
the following options to add additional licenses:
Exchange your NetHASP (for example, exchange a

NetHASP-20 for a NetHASP-50 or NetHASP-100).
Keep your NetHASP and obtain another one with the additional licenses you need. This option requires you to set up a
separate NetHASP server for the second NetHASP; NetHASPs
cannot be connected to each other on the same server.
ENTERING THE SIM UPDATE CODE 65

Mastercam X.
Instructions for Updating NetHASP Codes are in Appendix A.
following methods:

codes.
Update code
file extension
SIM license type
Update code program
.HCODE
HASP
HaspX.exe
.NHCODE
NetHASP
NHaspX.exe
A6
TIPS:
file.
You can also access the HASP utility when running
Mastercam by choosing Help, About from the Mastercam
menu and then clicking the Hasp button.

Mastercam X3 installation kit electronic media: Insert
the media in the appropriate drive to access the file.
available.
Updating NetHASP Codes

IMPORTANT: Before you begin this phase of the installation
process, you must first complete the NetHASP Server installation (see Installing the NetHASP Server on page 61).
X To enter a NetHASP update code:
1 Choose one of the following methods to run the NHaspX.exe.
The method you choose is based on the format of the update

code you received and your personal preference:
From the Windows desktop, choose Start, All Programs,

Mastercam X3, NHasp X.
Doubleclick the update code file (*.NHCODE).
Use Windows Explorer to navigate to the Mastercam
installation location and doubleclick NHaspX.exe.
ENTERING THE SIM UPDATE CODE 67
2 In the NetHASP X dialog box, make sure SIM type is set to
NetHASP and that Mode is set to Local.
A6
The NetHASPX utility analyzes the SIM and displays the SIM
serial number and current Mastercam products. Verify that
the displayed serial number matches the serial number
provided with your Mastercam X3 documentation.
TIP: Keep a record of the serial number in the event that you
need to contact Technical Support Services at CNC Software or
your Reseller.
3 Use one of the following methods to enter the update code:
If you received your update code as a file, choose Update

Code file to navigate to the saved file location and open
the code file you received. The NetHASPX utility extracts
the update code from the selected file.
If you received your update code as printed documentation, enter the code in the text field next to the Update
code file button. (Do not click the Update code file
button.)
4 Choose Update. The program updates the SIM and displays
the products for which the SIM has been activated.

5 Choose OK to exit the NetHASPX utility.
Note: For more information on the fields that appear in this

dialog box, see Installing a NetHASP (Network Licensing) on page
5.
Troubleshooting
Manually Installing SIM Drivers
The Mastercam installation program automatically installs the software needed to use the HASP SIM with Mastercam. In the event that
the SIM drivers need to be reinstalled, choose Start, Programs,
Mastercam X3, Hasp Setup, and then follow the instructions on
screen to install the SIM drivers.
USING THE NHASPX.EXE UTILITY 69
Using the NHaspX.exe Utility

Use the NHaspX.exe utility, provided by CNC Software, Inc., to
configure and administer your Mastercam network licensing. This
section includes a description of each option you can choose when
running this utility.
Figure A-4: NHaspX.exe dialog box
A6
SIM type: Choose HASP or NetHASP. When Mastercam

starts, it reads the SIM type from the registry and checks the
HASP or NetHASP for the appropriate licenses.
Mode: Choose Local to read the NetHASP from the local
computer. Choose Network to read the NetHASP connected
to the NetHASP server, which may or may not be the local
computer.
Update code file: Click to browse to the location of the
update code file provided by CNC Software or your Reseller,
or type the update code directly in the field.
Product list (untitled): The large area lists the number of

workstations authorized for each product followed by the
product name.
Read: Displays the product list that is programmed in the
NetHASP. The NetHASP is read from the local machine or
NetHASP server, based on the selected Mode setting.
Update: To update the NetHASP, it must be connected to the
local computer and you must set the Mode to Local. Before
selecting Update, enter the update code file name. If the
update code file is not found, a <file name> not found error
message displays.
Active licenses: (Available only in Network mode.) Displays
information on the number of licenses currently checked
out, the number of licenses authorized, and the number of
licenses that are currently available for each product. (See
Monitoring NetHASP Users below for details.)
Note: None of the licenses that are checked out from the local
computer are reported by Active licenses.
Stop: Available only when you choose Active licenses to

monitor and report license information. Choose Stop to end
the reporting function.
User type: (read-only) Displays one of the following user
types: Industrial, Educational.
Serial number: (read-only) Displays the NetHASP serial
number.
Start date / End Date: (read-only) Displays the first and last
date for which the NetHASP licenses are valid or Unlimited if
the licenses are available permanently.
Maintenance expiration Date: (read-only) Displays the date
your Maintenance plan expires, based on your annual
renewal date.

Mastercam X.
following methods:
USING THE NHASPX.EXE UTILITY 71

codes.
Update code
file extension
SIM license type
Update code program
.HCODE
HASP
HaspX.exe
.NHCODE
NetHASP
NHaspX.exe
TIPS:
file.
You can also access the HASP or NetHASP utility when
running Mastercam by choosing Help, About from the
Mastercam menu and then clicking the Hasp button.

Mastercam X installation kit electronic media: Insert the
media in the appropriate drive to access the file.
available.
A6
Monitoring NetHASP Users

You can monitor NetHASP activity using the NHaspX.exe utility.
Choose the button labeled Active licenses to show:
Which products are licensed

The number of active users
The maximum number of users
The number of available licenses for each product
Notes:
You must first set Mode to Network to enable the Active
License option.
This function runs slowly if nethasp.ini is not present or is set
up incorrectly. For more information, see the instructions for
setting up the NetHASP for Mastercam on page 61.
The NHaspX.exe does not report the licenses that are checked
out on the computer on which it is running.
Using Aladdin Monitor

Besides NHaspX.exe, you can use the Aladdin Monitor utility to view a
list of users logged in to the NetHASP server. To install this utility, run
the Mastercam X installation program from the Mastercam installation CD Disk 2, choose NetHASP Monitor, and complete the onscreen instructions.
Aladdin Monitor is a third-party application for monitoring NetHASP
usage. Aladdin Monitor is included with Mastercam for your convenience. However, CNC Software, Inc. can provide only limited support
for this application. Please contact Aladdin for technical support
issues. Following is a quick guide for using Aladdin Monitor.
MONITORING NETHASP USERS 73
Run Aladdin Monitor. In the left window pane, locate the NetHASP to
monitor. Click the NetHASP's entry to display information about the
HASP in the right-hand pane.
After you select a NetHASP, the Program table lists the following
information:
Mastercam products in use (program number)

Number of users currently using each product
Maximum users allowed for each product
Remaining product activations
A6
Please refer to the following table for program numbers and their
equivalent Mastercam products:
The Login table box shows details for the selected product. This information includes:
User login ID (IP address)

User host name
Network protocol being used
Period of inactivity required before the product entry is
deleted
Registry Settings
The NHaspX.exe utility reads and writes the HASP or NetHASP SIM
type information to the registry:
HKEY_LOCAL_MACHINE\Software\CNC Software, Inc.\Sim type
The value of Sim Type is H for the HASP and N for the NetHASP. Each
Mastercam user must have read and write permission to this part of
the registry.
The NetHASP mode is also written to the registry:
HKEY_LOCAL_MACHINE\Software\CNC Software, Inc.\NetHASP
mode
The two possible values are Network and Local.
MONITORING NETHASP USERS 75
Note: The Mastercam installation program writes entries in the

registry to HKEY_CURRENT_USER and
HKEY_LOCAL_MACHINE. If the user running the NHaspX.exe
utility has permission to write to HKEY_LOCAL_MACHINE, the
utility also updates this Mastercam entry with the SIM type information.
Additional NetHASP Information

This document provides a brief introduction to setting up network
licensing for Mastercam. For more information, use the NetHASP
License Manager help system (accessed from the NetHASP Server
application) and the nethasp.txt document, located in the NetHASP
Server installation location, for example:
c:\NetHaspServer\nethasp.txt
IMPORTANT: The NetHASP License Manager Help and
nethasp.txt document were written by Aladdin Knowledge
Systems. CNC Software, Inc. has not contributed to or edited
this information and assumes no responsibility for its accuracy.
A6
671 Old Post Road

Tolland, CT 06084 USA
www.mastercam.com
Printed in the USA
Installation Guide 1-883310-75-X
Installation Guide.indd 2
4/29/08 1:47:36 PM

MCAMX3 Installation Guide

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

MCAMX3 Installation Guide

Transféré par

Droits d'auteur :

Formats disponibles

Installation Guide

Be sure you have the latest

ii MASTERCAM X3 / Installation Guide

Mastercam X3 Installation Guide

PLEASE READ THIS STATEMENT AND THE SOFTWARE LICENSE AGREEMENT

Intellectual Property Rights

The Software is and includes intellectual property of CNC. All associated

iv MASTERCAM X3 / Installation Guide

confidential information. You agree to promptly communicate the terms and

CNC WARRANTS THAT THE MEDIA ON WHICH THE SOFTWARE IS

IN NO EVENT WHATSOEVER WILL CNC, OR ITS EMPLOYEES, SHAREHOLDERS,

vi MASTERCAM X3 / Installation Guide

U.S. Government Restricted

The Software provided hereunder is a "commercial item," as that term is defined in

CNC software programs Mastercam Design LT and Mastercam Demo as well as

All rights not expressly granted are reserved by CNC.

Mastercam is a registered trademark of CNC.

Printed on recycled paper.

Updating from Previous Versions ........................................6

Mastercam Support and Services .....................................10

2. Installing Mastercam X3 .................................................15

Running the Installation Program ......................................16

Entering the SIM Update Code ..........................................24

3. Mastercam X3 Startup .....................................................29

Starting Mastercam ............................................................30

Using the Update Manager ................................................43

A. Information for the Network Administrator

Network Administrator Qualifications ...............................54

Windows Vista ....................................................................60

Entering the SIM Update Code ..........................................65

Using the NHaspX.exe Utility .............................................69

Monitoring NetHASP Users................................................72

System Requirements ............................................. page 2

2 MASTERCAM X3 / Installation Guide

Mastercam X3 System Requirements

1.5 GHz (minimum) 32-bit Intel-compatible

Windows XPor Windows Vista (Business

128MB OpenGL-compatible graphics card

Full hardware acceleration display setting is

UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / System Requirements 3

Mastercam X3 System Requirements

1024 X 768 pixel resolution (minimum) at 96

1280 X 1024 pixel resolution (recommended).

(NetHASP users only) TCP/IP protocol for

Acrobat Reader Version 4.0 or higher.

4 MASTERCAM X3 / Installation Guide

Mastercam X3 installation program on CD (2-CD set), DVD

If you are using single-user licensing, you need a small

Installing a HASP (Single-User License)

port on the computer. If you are unsure of the ports location,

UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Installation Requirements 5

4 If you are installing a HASP to a parallel port, tighten the two

screws on the HASP to firmly attach it to your computer.

tighten the screws on the printer cable connector to firmly

Using a NetHASP (Network Licensing)

6 MASTERCAM X3 / Installation Guide

Updating from Previous Versions

Users Updating from a Prior Mastercam

Scenario 1: Remove the existing Mastercam X

or remove programs function (Programs and Features in

(available in PDF format in your Mastercam \Documentation

UNDERSTANDING YOUR MASTERCAM X3 INSTALLATION / Updating from Previous Versions 7

Scenario 2: Replace the existing Mastercam X

Scenario 3: Leave the current Mastercam X