You are on page 1of 88

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

4 MASTERCAM X3 / Installation Guide

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

6 MASTERCAM X3 / Installation Guide

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

8 MASTERCAM X3 / Installation Guide

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

10 MASTERCAM X3 / Installation Guide

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

12 MASTERCAM X3 / Installation Guide

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

14 MASTERCAM X3 / Installation Guide

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

16 MASTERCAM X3 / Installation Guide

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.

18 MASTERCAM X3 / Installation Guide

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.

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.


5 When requested to enter user information (name and

company), you must enter it to continue the installation.

INSTALLING MASTERCAM X3 / Running the Installation Program 19

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.

20 MASTERCAM X3 / Installation Guide

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.

INSTALLING MASTERCAM X3 / Running the Installation Program 21

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.

22 MASTERCAM X3 / Installation Guide

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.

INSTALLING MASTERCAM X3 / Running the Installation Program 23

X To install sample files, videos, and NetHASP software:


1 Insert Disk 2 and choose the option you want to install.
2 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.
3 When the license agreement is displayed, you must accept it

to continue the installation.


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.

24 MASTERCAM X3 / Installation Guide

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

26 MASTERCAM X3 / Installation Guide

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.

28 MASTERCAM X3 / Installation Guide

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

30 MASTERCAM X3 / Installation Guide

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

32 MASTERCAM X3 / Installation Guide

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-

MASTERCAM X3 STARTUP / Mastercam Launcher 33

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

34 MASTERCAM X3 / Installation Guide

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

MASTERCAM X3 STARTUP / Mastercam Launcher 35

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

36 MASTERCAM X3 / Installation Guide

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

38 MASTERCAM X3 / Installation Guide

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

MASTERCAM X3 STARTUP / Using Command Line Switches 39

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

40 MASTERCAM X3 / Installation Guide

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)

MASTERCAM X3 STARTUP / Using Command Line Switches 41

/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

42 MASTERCAM X3 / Installation Guide

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

44 MASTERCAM X3 / Installation Guide

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.

MASTERCAM X3 STARTUP / Using the Update Manager 45

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

46 MASTERCAM X3 / Installation Guide

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.

MASTERCAM X3 STARTUP / Using the Update Manager 47

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:


1 From the Mastercam menu, choose Help, Update

Mastercam to run the Update Manager program.

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

48 MASTERCAM X3 / Installation Guide

Otherwise, all available updates display in the upper pane


of the Mastercam Update Manager window.

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.

MASTERCAM X3 STARTUP / Using the Update Manager 49

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
of the Mastercam Update Manager window.

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

1 From the Mastercam menu, choose Help, Update

Mastercam to run the Update Manager program.


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

50 MASTERCAM X3 / Installation Guide

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.

MASTERCAM X3 STARTUP / Using the Update Manager 51

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

52 MASTERCAM X3 / Installation Guide

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

54 MASTERCAM X3 / Installation Guide

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

56 MASTERCAM X3 / Installation Guide

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

58 MASTERCAM X3 / Installation Guide

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

60 MASTERCAM X3 / Installation Guide

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

62 MASTERCAM X3 / Installation Guide

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

64 MASTERCAM X3 / Installation Guide

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

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.
Instructions for Updating NetHASP Codes are in Appendix A.
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.

A6

66 MASTERCAM X3 / Installation Guide

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 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.

68 MASTERCAM X3 / Installation Guide

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.

70 MASTERCAM X3 / Installation Guide

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.

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.
The update code is a file that may be delivered to you using one of the
following methods:

USING THE NHASPX.EXE UTILITY 71

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.

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 or NetHASP 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 X installation kit electronic media: Insert the
media in the appropriate drive to access the file.
Printed documentation: Have a copy of the document
available.

A6

72 MASTERCAM X3 / Installation Guide

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

74 MASTERCAM X3 / Installation Guide

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

76 MASTERCAM X3 / Installation Guide

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