MASTERCAM 2022

ADMINISTRATOR GUIDE
May 2021
 MASTERCAM 2022 ADMINISTRATOR GUIDE
 

May 2021
© 2021 CNC Software, Inc. – All rights reserved.
Software: Mastercam 2022

Terms of Use
Use of this document is subject to the Mastercam End User License Agreement. The Mastercam End User License
Agreement can be found at:

http://www.mastercam.com/companyinfo/legal/LicenseAgreement.aspx

Be sure you have the latest information!

Information might have changed or been added since this document was published. The latest version of the
document is installed with Mastercam or can be obtained from your local Reseller. A ReadMe file (ReadMe.PDF) –
installed with each release – includes the latest information about Mastercam features and enhancements.

ii
 TABLE OF CONTENTS

Introduction 5

Before You Begin 5

Mastercam Resources 5

Contact Us 6

Installing and Setting Up Licenses 7

Installing a Software License 7

Installing a Hardware License 7

Installing a HASP 7

Installing a NetHASP 7

Setting Up a NetHASP Server 8

Setting Up Mastercam with a NetHASP 8

Installing a Mill-Turn License 9

License Monitoring 10

NetHASP Monitoring 10

NHaspX Utility 10

Aladdin Monitor 11

Using Mastercam Licenses Remotely 13

Using a Hardware License Remotely 13

Using a Software License Remotely 13

Software License Borrowing 13

Updating Mastercam Products and Licenses 14

Updating a License 14

Updating Software Licenses 14

Updating Hardware Licenses 14

Updating a HASP 15

Updating a NetHASP 16

Updating Mastercam 17

iii
Launching Mastercam 19

Mastercam Launcher 19

Command-lines 19

Command-line Switches 20

License Types 20

Mastercam Design 20

Mastercam Mill 20

Mastercam Lathe 20

Mastercam Router 20

Mastercam Wire 21

Mastercam Art 21

Mastercam Mill-Turn 21

All Products 21

Mastercam Add-ons 21

Using Shortcuts and Command-lines 22

Customizing Your Mastercam Installation 23

Setting Registry Options 23

Setting Group Policies 23

Setting Installation Defaults 23

If You Need More Help 25

Troubleshooting 26

Repairing an Installation 26

Reinstalling NetHASP/HASP Drivers 26

Common Error Messages 26

Frequently Asked Questions 27

iv
 Mastercam 2022 Administrator Guide—Introduction

INTRODUCTION

The Mastercam 2022 Administrator Guide covers the installation, updating, and administration of Mastercam's licenses
and products.

NOTE
This document covers only hardware licensing. For information on software licensing, refer to the Activation
Wizard help. Select Start, Mastercam Licensing Utilities, Activation Wizard Help.

CAUTION
Please note that Mastercam 2021 is the last version that officially supports Windows 7.

Before You Begin

Mastercam 2022 uses one of three license types to run: HASP, NetHASP, or software. HASPs and NetHASPs are
hardware licenses, meaning they are licenses stored in a physical USB plug-in device. The software license is digital and
is managed by CodeMeter. These licenses are either Retail or Evaluation. Before continuing, be aware of your current
license type.

This guide also refers to Mastercam's various folder locations. Mastercam creates two types of folders: non-modifiable
and user-modifiable. The default folder locations and types are listed below.

Mastercam Installation Locations

Program Files (Non-modifiable)

C:\Program Files\Mastercam 2022\Mastercam

C:\Program Files\Common Files\Mastercam

Documents (User-modifiable)

C:\Users\<User name>\Documents\My Mastercam 2022\Mastercam

C:\Users\Public\Public Documents\Shared Mastercam 2022

Mastercam Resources
Enhance your Mastercam experience by using the following resources:

 l Mastercam Documentation—Mastercam installs a number of helpful documents for your version of software in
the Documentation folder of your Mastercam 2022 installation.

 l Mastercam Help—Access Mastercam Help by selecting Help, Contents from Mastercam's File tab or by
pressing [Alt+H] on your keyboard.

 l Mastercam Reseller—Your local Mastercam Reseller can help with most questions about Mastercam.

5
Mastercam 2022 Administrator Guide—Introduction

 l Technical Support—Our Technical Support department (+1 860-875-5006 or support@mastercam.com) is open

Monday through Friday from 8:00 a.m. to 5:30 p.m. USA Eastern Standard Time.

 l Mastercam Tutorials—We offer a series of tutorials to help registered users become familiar with basic
Mastercam features and functions. Visit our website, or select Help, Tutorials from Mastercam's File tab to see
the latest publications.

 l Mastercam University—Mastercam University, an affordable online learning platform, gives you 24/7 access to
Mastercam training materials. Take advantage of more than 180 videos to master skills at your own pace and
help prepare for Mastercam Certification. For more information on Mastercam University, please contact your
Authorized Mastercam Reseller, visit university.mastercam.com/, or email training@mastercam.com.

 l Online Communities—You can find a wealth of information at www.mastercam.com.

 l Follow us on Facebook (www.facebook.com/Mastercam), Twitter (twitter.com/Mastercam), and

Instagram (www.instagram.com/mastercamcadcam/) for the latest tech tips and Mastercam news.

 l See Mastercam in action on YouTube (www.youtube.com/user/MastercamCadCam).

 l For more information on CNC Software, Inc., to find and apply to jobs, and connect with people using
Mastercam, visit us on LinkedIn (www.linkedin.com/company/cnc-software/).

 l Registered users can search for information or ask questions on the Mastercam Web forum,
forum.mastercam.com, or use the Mastercam Knowledge Base at kb.mastercam.com.

Contact Us
For questions about this or other Mastercam documentation, contact the Technical Documentation department by
email at techdocs@mastercam.com.

6
 Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

INSTALLING AND SETTING UP LICENSES

A license is required to run Mastercam 2022. This license can be a hardware license, such as a HASP or a NetHASP, or a
software license. Listed below are installation steps for the different license types, how to set up servers, and how to
monitor licenses.

Installing a Software License

This document does not cover installing a software license. For information on software licensing, refer to the
Activation Wizard help. Select Start, Mastercam Licensing Utilities, Activation Wizard Help.

Installing a Hardware License

Use the procedures below to install and setup your hardware license.

Installing a HASP
Mastercam uses HASPs for single-user hardware licensing. Follow the procedure below to install your HASP for a
single user.

 1. Locate an available USB port on the computer.

 2. Plug the HASP into the port.

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.

Installing a NetHASP
Mastercam 2022 uses a NetHASP to service Mastercam installations 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. This requires two configuration steps:

 l The firewall must be configured to open port 475.

 l The NetHASP server program (C:\windows\sysWOW64\nhsrvice.exe) must be allowed to work through the firewall.

Please consult your firewall documentation for instructions on how to change these settings.

NOTE
The NetHASP is followed by a number indicating the maximum number of simultaneous seats of each licensed
product, such as NetHASP-20 or NetHASP-50. All product groups must be the same version.

CAUTION
Keep the NetHASP in a physically safe place. All Mastercam users on the network are vulnerable to its loss.

7
Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

Setting Up a NetHASP Server

To set up a NetHASP server, follow the procedure below.

 1. Connect the NetHASP to a USB port on the computer you want to use as the NetHASP server.

 2. Open the Mastercam 2022 installer.

 3. In the Mastercam Installer, select Utilities, NetHASP Server and follow the instructions.

NOTE
If you installed Mastercam 2022 onto your current computer, then the NetHASP drivers have already
been installed with Mastercam.

 4. Select 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 NHasp utility to check available Mastercam licenses.

Setting Up Mastercam with a NetHASP

After setting up the NetHASP server, you will need to set up Mastercam 2022 to use it. Follow the procedure below.

NOTE
The following procedure is for client-side configuration.

 1. Install Mastercam 2022.

 2. Install the TCP/IP network protocol, if it is not already installed.

 3. Run NHaspX. It is located in the Mastercam Licensing Utilities Start menu folder.

 4. Set Mode to Network.

 5. From the Mastercam installation's support folder, copy the nethasp.ini file to your desktop.

8
 Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

 6. Use your preferred text editor to edit the nethasp.ini file for the appropriate network protocol and identify the
computer that is used as the NetHASP server.

 7. Copy the edited nethasp.ini file to the main Mastercam directory. By default, this directory is C:\Program

Files\Mastercam 2022\Mastercam.

NOTE
Configuring the nethasp.ini file to look for the NetHASP server at a specific address improves the time it
takes a computer to find the server on the network.
By omitting this step, when Mastercam 2022 launches and checks for network licenses, it takes extra time
to search all computers on the network to find the NetHASP server. If all licenses have been checked out
by other Mastercam 2022 users on your network, the search might take an especially long time.
If all licenses are in use, you receive a "no license found" error when launching Mastercam.

 8. When you launch Mastercam 2022, it looks at the specified address.

Installing a Mill-Turn License

Mastercam also supports licenses specifically for Mastercam Mill-Turn. This license is bound to a specific HASP or
NetHASP SIM number. The HASP or NetHASP is used as the license to run Mastercam, and a software license is used
as the license to run Mill-Turn. Mill-Turn licenses can also be a fully software-based license.

NOTE
If you are installing Mastercam Mill-Turn as a fully software-based license, refer to the Activation Wizard Help
instead. Select Start, Mastercam Licensing Utilities, Activation Wizard Help.

After updating your HASP or NetHASP with the Mill-Turn code file, follow the procedure below to install the software
license:

 1. Ensure that the HASP or NetHASP used to run Mastercam is plugged into the computer that the Mill-Turn
binding file will be installed on.

 2. Select Start, CodeMeter, CodeMeter Control Center (Windows 10) or Start, All Programs, CodeMeter,
CodeMeter Control Center (Windows 8).

The CodeMeter Control Center dialog box displays.

9
Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

 3. Select File, Import License.

 4. Browse to the .WibuCmRaU file that was sent with your Mill-Turn codes and click Import.

 5. After the license has been successfully imported, a dialog box will display.

NOTE
If you receive errors during this process, please contact your Mastercam Reseller.

 6. The CodeMeter Control Center dialog box now displays a Mastercam Mill-Turn license with your HASP or
NetHASP serial number in the name.

If the license is to be installed on a server running a NetHASP, the CodeMeter server will need to be enabled to
broadcast the Mill-Turn license across the network. Refer to the Activation Wizard Help (Start, Mastercam Licensing
Utilities, Activation Wizard Help) for instructions on how to enable the CodeMeter server and to configure the
client systems to see the license.

License Monitoring
If you have a NetHASP or software license, you can monitor license activity. Monitoring a license allows you to see:

 l Which products are licensed

 l The number of active users

 l The maximum number of users

 l The number of available licenses for each product

NetHASP Monitoring
NetHASPs allow you to monitor licenses through either the NHaspx utility or the Aladdin Monitor.

NHaspX Utility
You can monitor NetHASP activity using the NHaspX utility. Select the Active licenses button to monitor the activities
listed in the previous section. Mode must be set to Network in the NHaspX dialog box to enable the Active licenses
button.

The NHaspX utility does not report the checked-out licenses on the computer on which it is running. Also, it may run
slowly if the nethasp.ini file is not present or is set up incorrectly.

10
 Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

Aladdin Monitor
Besides using the NHasp utility, you can use the Aladdin Monitor utility to view a list of users logged into the NetHASP
server. To install the Aladdin Monitor, run the Mastercam installation program from the Mastercam 2022 installation
media, choose Utilities, and then NetHASP Monitor, and follow the instructions. These drivers are also available for
download on the My Mastercam website (https://my.mastercam.com/Support-Downloads-Drivers-and-Applets).

Aladdin Monitor is a third-party application for monitoring NetHASP usage and is included with Mastercam for your
convenience. However, CNC Software, Inc. can provide only limited support for this application. Contact Thales Group
(https://www.thalesgroup.com) for technical support issues.

Following is a basic workflow for using the Aladdin Monitor.

 1. Run the Aladdin Monitor by selecting AKS Monitor from the Aladdin folder in the Start menu.

 2. In the left window pane, select the NetHASP to monitor.

 3. The right window pane then updates with that NetHASP's information.

After you select a NetHASP, the Program table lists the following information:

 l Mastercam products in use (Program number).

 l Number of users currently using each product.

 l Maximum users allowed for each product.

 l Remaining product activations.

Refer to the following table for program numbers and their equivalent Mastercam products.

Program Mastercam Program Mastercam Program Mastercam Product

Number Product Number Product Number

[NHaspX tech
1 13 Router 42 CATIA V4 Read/Write
info]

2 Mill Entry 14 Router 3D 43 Unigraphics Read

3 Mill 17 Art 44 Swarf 5-axis

Mastercam for
4 Mill 19 Multiaxis 46
SOLIDWORKS 2D

Mastercam for
5 Mill 3D 24 CoroPlus 48
SOLIDWORKS 3D

6 Lathe Entry 28 ProDrill 49 Port Expert

7 Lathe 29 STEP Read 50 Blade Expert

11
Mastercam 2022 Administrator Guide—Installing and Setting Up Licenses

Program Mastercam Program Mastercam Program Mastercam Product

Number Product Number Product Number

Mastercam for
8 Wire 31 Engraving 52
SOLIDWORKS Lathe

Curve 5-axis/Drill
9 Design 32 53 Probing
5-axis

10 Solids 37 ProE/Creo Read 56 CATIA V5 with PMI

11 Router Entry 40 CATIA V5 Read 60 Mill-Turn

12 Router 41 CATIA V5 Write    

The Login table box displays details for the selected product. This information includes:

 l User login ID (IP address)

 l User host name

 l Network protocol being used

 l Period of inactivity required before the product entry is deleted.

12
 Mastercam 2022 Administrator Guide—Using Mastercam Licenses Remotely

USING MASTERCAM LICENSES REMOTELY

You may wish to use Mastercam 2022 outside of work, such as from a home office. The procedure for remote use
depends on license type. See the following Knowledge Base articles for instructions on using each license type. For
information on license types, refer back to "Introduction" on page 5.

NOTE
You will be asked to log in to your My Mastercam account when accessing the following links.

Using a Hardware License Remotely

I have a...

 l Purple USB HASP / (FAQ 50720): https://kb.mastercam.com/KnowledgebaseArticle50720.aspx

 l Red USB NetHASP / (FAQ 50721): https://kb.mastercam.com/KnowledgebaseArticle50721.aspx

Using a Software License Remotely

I have a...

 l Single seat software license / (FAQ 50722): https://kb.mastercam.com/KnowledgebaseArticle50722.aspx

 l Network software license / (FAQ 50723): https://kb.mastercam.com/KnowledgebaseArticle50723.aspx

Software License Borrowing

You can also borrow Mastercam software licenses from your workplace network. License borrowing allows you to use
the license without access to the network or the internet. For more information about license borrowing, refer to the
License Borrow Utility help. Select Start, Mastercam Licensing Utilities, License Borrow Utility Help.

13
Mastercam 2022 Administrator Guide—Updating Mastercam Products and Licenses

UPDATING MASTERCAM PRODUCTS AND LICENSES

Use the procedures below to update the Mastercam product or a Mastercam license.

Updating a License
Use the procedures below to update your licenses.

Updating Software Licenses

This document does not cover updating software licenses. For information on software licensing, refer to the
Activation Wizard help. Select Start, Mastercam Licensing Utilities, Activation Wizard Help.

Updating Hardware Licenses

You must update your Mastercam licensing hardware (HASP or NetHASP) with an update code obtained from your
Reseller or CNC Software, Inc. Customer Service. This needs to be done when you install or upgrade to a new release
of Mastercam.

The update code is a file delivered to you by one of these methods:

 l Included in your Mastercam 2022 software kit.

 l Mailed on electronic media.

 l Emailed as a file attachment.

Contact your local Mastercam Reseller if you cannot locate your update code.

If you received your update code via email, save the file attachment to an accessible location. Do not change the file
extension. If you received your updated code via post or as part of an installation kit, insert the received media in the
appropriate drive to access the file.

Update codes have a file extension that indicates the type of license they update. The Mastercam installation program
associates these file extensions with the program that you use to update the SIM codes.

File Extension License Type Update Program

*.HCODE HASP HaspX.exe

*.NHCODE NetHASP NHaspX.exe

14
 Mastercam 2022 Administrator Guide—Updating Mastercam Products and Licenses

Updating a HASP

You can enter a HASP code automatically by double-clicking the update code file (*.HCODE). To update the code
manually for both the update code file and the update code string, do the following.

CAUTION
You must complete the following procedure on the computer to which the HASP is attached. Updates over a
remote connection will fail.

 1. Choose one of the following methods to run HaspX.exe.

 a. (Windows 8) Select Start, All Programs, Mastercam Licensing Utilities, Hasp X.

 b. (Windows 10) Select Start, Mastercam Licensing Utilities, Hasp X.

 c. If Mastercam is not installed on the server, download the HASP drivers from the Mastercam website
(https://my.mastercam.com/Support-Downloads-Drivers-and-Applets).

 2. Depending on what type of update code that you received, follow one of the steps below:

 a. If you received a *.HCODE file to update your HASP, select Update code. Navigate and open the

. HCODE file.

The HaspX utility extracts the update code from the file.

 b. If you received the update code as a string of numbers, enter the code into the text box indicated
below. The code must be entered in exactly as it was received, including spaces and dashes.

15
Mastercam 2022 Administrator Guide—Updating Mastercam Products and Licenses

 3. Select Update. HaspX updates the license and displays the products (including any newly activated products)
that the license supports.

 4. Once you update the license, the HaspX dialog box displays important license information at the bottom of the
dialog box.

 5. Click OK to exit the HaspX dialog box.

Updating a NetHASP

You can enter a NetHASP code automatically by double-clicking the update code file (*.NHCODE). To update the code
manually, do the following.

CAUTION
This update must be done only on the computer on which the NetHASP is attached. This process cannot be
completed over a remote connection.

 1. Choose one of the following methods to run NHaspX.exe.

 a. (Windows 8) Select Start, All Programs, Mastercam Licensing Utilities, NHaspX.

 b. (Windows 10) Select Start, Mastercam Licensing Utilities, NHaspX.

 c. If Mastercam is not installed on the server, download the HASPX drivers from the Mastercam website
(https://my.mastercam.com/Support-Downloads-Drivers-and-Applets).

 2. In the NHaspX dialog box, ensure that Mode is set to Local.

16
 Mastercam 2022 Administrator Guide—Updating Mastercam Products and Licenses

NHaspX analyzes the license and displays the serial number and current Mastercam products.

 3. Verify that the displayed Serial number matches the serial number provided with your Mastercam 2022
software kit.

NOTE
Keep a record of the serial number in the event that you need to contact Technical Support at CNC
Software, Inc. or your Reseller.

 4. Select Update code file. The Select an Update Code file dialog box displays.

 5. Select an update code file (*.NHCode), and click Open.

 6. In the NHaspX dialog box, select Update. NHaspX updates the SIM and displays the products for which the SIM
has been activated.

 7. Change the Mode back to Network.

 8. Select OK to exit the NHaspX dialog box.

Updating Mastercam
Use the procedures below to update Mastercam to the latest version.

NOTE
If you encounter issues with your Mastercam update, please contact your local Mastercam Reseller.

A maintenance upgrade is an executable file that you run to update your installation. Before you do an update, you
must exit Mastercam. If you start an update with Mastercam open, you are asked to close all sessions running
Mastercam on the computer before continuing with the update installation.

 1. Download the latest update from the Mastercam website (www.mastercam.com/Support/Downloads), or get
the update from your local Mastercam Reseller.

 2. Copy the downloaded file to the computer on which you want to update.

 3. If Mastercam is running, close it.

 4. Double-click the update file, and follow the instructions.

 5. When the installation is complete, click Finish.

17
Mastercam 2022 Administrator Guide—Updating Mastercam Products and Licenses

You can also update Mastercam with the Automatic Update Service (AUS).

 1. Open Mastercam.

 2. Select File, Help, Check for Updates. The Mastercam Updates dialog box displays.

NOTE
Your computer must be connected to the Internet to check for updates.

 3. The dialog box will display the date of the most recent check for updates. Select or deselect the checkboxes to
Automatically check for updates or to Show new update alerts.

 4. Click Check Now.

 5. Follow the prompts to install the update.

18
 Mastercam 2022 Administrator Guide—Launching Mastercam

LAUNCHING MASTERCAM

Mastercam determines the initial license type automatically when it starts. However, you can force Mastercam to
always start with a specific license type.

On start up, Mastercam attempts to connect to a HASP, which is the default license type for Mastercam 2022.
Mastercam searches for the licenses in the following order:

 l HASP

 l Software (local)

 l Software (network)

 l NetHASP

If you do not have any of the above licenses currently activated, you will then be asked if you have an activation code.
If you select Yes, the Activation Wizard opens. If you select No, Mastercam closes and no further action takes place.

Mastercam Launcher
The Mastercam Launcher controls start up options for a seat (license) of Mastercam. You can set the following
Mastercam start up options:

 l Assign product levels and availability.

 l Create a customized Mastercam shortcut on the desktop based on current settings.

The Mastercam Launcher recognizes which type of license you have on your machine, and this dialog box displays only
those options you can change. To open the Mastercam Launcher, select Start, Mastercam 2022, Mastercam
Launcher (Windows 10) or select Start, All Programs, Mastercam 2022, Mastercam Launcher (Windows 8).

Select the Help button to learn more about the items that are displayed.

Command-lines
You can use command-line switches for specific tasks when launching Mastercam. These include:

 l Overriding the initial license type.

 l Loading licenses for selected product levels and add-ons.

 l Requesting specific network licenses on start up.

 l Opening Mastercam in a particular product or product level, or to suppress products with single-user licenses.

NOTE
Shortcuts created by the Mastercam Launcher include the appropriate command-line switches.

19
Mastercam 2022 Administrator Guide—Launching Mastercam

Command-line Switches
Listed below are all command-line switches for Mastercam products. However, not all products may 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 what is supported
by your license, a message displays the products enabled by the license and modified by the command-line
switch.

License Types
Use these command-line switches to override the default registry settings.

 l /H = Sets the initial license type to HASP.

 l /N = Sets the initial license type to NetHASP.

 l /Software = Sets the initial license type to Software (local, then network).

 l /SoftwareLocal = Sets the initial license type to Software (local only).

 l /SoftwareLan = Sets the initial license type to Software (network only).

Mastercam Design
 l /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 Mil license.

 l /noD = Disable Design only

Mastercam Mill
 l /ME = Mill Entry

 l /M2 = Mill

 l /M3 = Mill 3D

 l /noM = Disable Mill

Mastercam Lathe
 l /LE = Lathe Entry

 l /L1 = Lathe

 l /noL = Disable Lathe

Mastercam Router
 l /RE = Router Entry

 l /R2 = Router

20
 Mastercam 2022 Administrator Guide—Launching Mastercam

 l /R3 = Router 3D

 l /noR = Disable Router

Mastercam Wire
 l /W2 = Wire

 l /W2 = Wire

 l /noW = Disable Wire

Mastercam Art
 l /Art = Art

 l /noArt = Disable Art

Mastercam Mill-Turn
 l /MT1 = Simplified access to Mill-Turn functions for Lathe users.

 l /MT2 = Full access to Mill-Turn functions.

 l /noT = Disable Mill-Turn

All Products
 l /noRem = Suppress product messages on start-up.

Mastercam Add-ons

 l /C5 = CurveDrill5ax  l /noC5 = Disable Curve/Drill5ax

 l /Port = Port Expert  l /noPort = Disable Port Expert

 l /Probe = Probing.  l /noProbe = Disable Probing

 l /Nest = Nesting  l /noNest = Disable Nesting

 l /PD = ProDrill  l /noPD = Disable ProDrill

 l /Engr = Engraving  l /noEngr = Disable Engraving

 l /Blade = Blade Expert  l /noBlade = Disable Blade Expert

 l /X5 = Multiaxis  l /noX5 = Disable Multiaxis

 l /SW5 = Swarf 5-axis  l /noSW5 = Disable Swarf 5-axis

21
Mastercam 2022 Administrator Guide—Launching Mastercam

Using Shortcuts and Command-lines

Use the following procedure to set command-line switches for a Mastercam shortcut:

 1. From your desktop, right-click on the Mastercam 2022 shortcut and select Properties.

The Mastercam 2022 Properties dialog box displays.

 2. Select the Shortcut tab.

 3. Add one or more command-line switches to the Target parameter.

Precede each command by a "/" and separate each by a space. There must also be a space between
"...\Mastercam.exe" and the first /Command. For example, to request a single Mill Entry license at start up,
enter:

"C:\Program Files\Mastercam 2022\Mastercam\Mastercam.exe" /ME

To request a Mill 3D license and a Router license:

"C:\Program Files\Mastercam 2022\Mastercam\Mastercam.exe" /M3 /R2

NOTE
The Target must have quotation marks around the directory path and the command-line options must be
outside of the quotation marks.

 4. To accept the command-line changes to the Mastercam shortcut, click OK to exit the Properties dialog box.

22
 Mastercam 2022 Administrator Guide—Customizing Your Mastercam Installation

CUSTOMIZING YOUR MASTERCAM INSTALLATION

If you are setting up Mastercam to install on multiple computers, or would like to have all user installations use the
same files, use the sections below to customize your installations.

NOTE
Mastercam 2022 cannot be installed on a drive created with the SUBST command. Use the actual path to the
desired installation folder, not the substituted drive letter.

CAUTION
Changing any of the files below will affect your Mastercam installation. It is recommended that you do not modify
these files unless you have experience with making the necessary modifications.

Setting Registry Options

To run Mastercam 2022, you need permission to read from the following registry key. This key is created when
Mastercam 2022 is first installed. This includes global settings for all users during their first time running Mastercam.

HKEY_LOCAL_MACHINE\SOFTWARE\CNC Software, Inc.\

You also need to have read and write permission for the following registry key. This key is created when Mastercam
2022 first starts and is used to store per-user settings.

HKEY_CURRENT_USER\SOFTWARE\CNC Software, Inc.\

Registry permissions are the Windows defaults, so no adjustment should be needed in a default Windows installation.

Setting Group Policies

Setting group policies can severely restrict permissions on Windows systems. These registry permissions are the
Windows defaults, so no adjustment should be needed in a default Windows user configuration.

Most other group policies have no effect on Mastercam's ability to run. However, a combination of group policies may
cause issues with Mastercam 2022.

Setting Installation Defaults

You can set installation defaults in the mcim.ini file, which is included in the \support folder in the installation media. The
mcim.ini file is text that contains the defaults for the following installation settings:

 l Installation language

 l Program language

 l Units

23
Mastercam 2022 Administrator Guide—Customizing Your Mastercam Installation

 l Installation type

 l Destination directory

To set these defaults, follow the procedure below.

 1. Copy the contents of the installation media to a local or network drive.

 2. Open mcim.ini in your preferred text editor. Do not use a word processor to open this file.

 3. To disable a setting, comment it out by inserting ;; before the first character of the line.

 4. Save the file.

NOTE
You must run modified installations from the saved location.

24
 Mastercam 2022 Administrator Guide—If You Need More Help

IF YOU NEED MORE HELP

For assistance with installing Mastercam 2022, licensing, or to obtain more information on using Mastercam 2022,
contact your local Mastercam Reseller. If your Mastercam Reseller is unavailable, you can call CNC Technical Support.
When calling CNC Software, Inc. for technical support, please follow these guidelines:

 l Be sure you have already tried to contact your Mastercam Reseller.

 l Provide the serial number of your HASP, NetHASP, or software license.

 l Be ready to describe the problem in detail. Write down what happened, particularly if you cannot call
immediately after the problem occurs.

 l Be in front of your computer when you call.

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

 l 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 twenty-four hours a day, seven days a week via our email or website addresses. When
sending email, please include:

 l The serial number of your HASP, NetHASP, or software license

 l Telephone number and contact information where you can be reached

 l Files required to reproduce an issue

Use Mastercam's Zip2Go utility to gather and compress open part data into a ZIP file. This utility makes it easy to
provide your Mastercam Reseller or CNC Software, Inc. with a file attachment that contains the information they
need. Zip2Go scans the machine groups in your current file and captures information such as your machine groups,
configuration files, post files, tool and material libraries and toolpath files. For more information on using Zip2Go,
please refer to the Mastercam Help.

Important Contact Information

CNC Software, Inc.

671 Old Post Road
Address
Tolland, CT 06084, USA
USA

Phone +1 860-875-5006

Fax (860) 872-1565

Mastercam Knowledge Base http://kb.mastercam.com

Mastercam Forum http://forum.mastercam.com

Website http://www.mastercam.com

Email support@mastercam.com

25
Mastercam 2022 Administrator Guide—If You Need More Help

Troubleshooting
Listed below are common issues that may occur after installing Mastercam or a Mastercam license. For more specific
Mastercam issues, refer to the Mastercam Knowledge Base (https://kb.mastercam.com/).

Repairing an Installation
If you encounter a problem after installation and no problems were detected with your license, you may need to
repair your Mastercam 2022 installation.

 1. Launch the Mastercam installation from the USB drive or from the Mastercam website download.

 2. Select Repair, and follow the instructions.

Reinstalling NetHASP/HASP Drivers

Mastercam 2022 automatically installs NetHASP and HASP drivers. If the installation procedure was not completed, or
if the drivers were removed Mastercam cannot recognize the NetHASP or HASP.

Select Hasp Setup from the Mastercam Licensing Utilities Start menu folder, and then follow the onscreen
instructions.

Common Error Messages

Listed below are common error messages that display when attempting to start Mastercam or activate a license.

All available licenses are in use.

The maximum allowable number of users have checked out the product.

Requested Product Code is not available / Error checking out a product name license. No licenses have been
purchased for this product.
Contact your local Mastercam Reseller.

Active NetHASP server not found.

The NetHASP license manager is not running. Check the NetHASP server and restart as necessary.

Authorization period on the license has expired.

An expired temporary license is being used to run Mastercam. A new code with a extended or permanent end date is
required to launch the software.

Connection to the Mastercam license has been lost. Mastercam will be automatically shut down. You will
get one chance to save your file.
Approximately once every two to 10 minutes, Mastercam verifies that the NetHASP server is still running and that the
NetHASP is attached to the server. If this test fails—for example, due to a power loss or server failure—this error
message displays on all computers running Mastercam.

You must save your work quickly and shut down Mastercam. Check the NetHASP connection and reconnect as
necessary.

26
 Mastercam 2022 Administrator Guide—If You Need More Help

The Mastercam version you have attempted to run is not supported by your Maintenance contract. Please
contact your local Mastercam Reseller for assistance.
The maintenance date of the license being used is not valid for the version of Mastercam that is attempting to open. If
your maintenance is still valid, you will need to get a copy of your updated license from your Reseller. If you are no
longer on maintenance, you will need to renew your contract to run this release of the software.

No Server found which has allowed access to this computer.

The workstation is not authorized to access the license server. Open the CodeMeter Control Center from the Start
menu (under the CodeMeter folder).

Network communication error.

The software license is no longer communicating with the server. Save your work quickly and shut down Mastercam.
Open the CodeMeter Control Center and click the WebAdmin button to troubleshoot.

SIM Not Found

Mastercam could not find your license. Try the following suggestions:

 l Remove and reconnect the HASP or NetHASP.

 l Try installing the HASP or NetHASP in a different port.

 l Check that the light at the end of the HASP or NetHASP is on. If it is not on, the HASP or NetHASP is either
broken or not receiving power from the USB port.

 l Reinstall the HASP drivers.

Frequently Asked Questions

Listed below are frequently asked question about licensing, installation, and other administrative issues.

Will a temporary license expire if the computer is offline?

Yes.

What happens if the hard disk on the software license host computer crashes?
A new license is required. The lost, stolen, or damaged license policy applies. However, in some cases the license can
be restored if the only change is a new hard drive.

Can localized and native English versions of Mastercam be used with the same software license?
Yes.

Does software licensing work with virtual servers?

Yes

Can I use one software license with multiple computers? / Is there a process for changing computers?
You cannot use one license simultaneously on multiple computers. If you would like to run on a different computer
(such as your home computer), you will need to deactivate the license on the first system and activate it on the other.

Only Mastercam retail network software licenses can be borrowed using the Mastercam License Borrow Utility. For
more information about license borrowing, refer to the License Borrow Utility help. Select Start, Mastercam
Licensing Utilities, License Borrow Utility Help.

If the original computer host is lost, stolen, or damaged, the lost, stolen or damaged license policy is applied to acquire
a new license. In some cases running the Activation Wizard again may restore their license.

Can a software license be passed to a remote computer that is disconnected from a network?

27
Mastercam 2022 Administrator Guide—If You Need More Help

No. However, you can use the License Borrow Utility to borrow a license and then disconnect from the network.

What happens if the server subnet is changed?

The software licenses will continue to function. You may need to re-point computers running the software licenses to
the new server.

Do I need a new activation code when the next version of Mastercam is released?
No, a new activation code is not needed. The software license will need to be reactivated when maintenance is
renewed, but the activation code remains the same.

28
 ATTENTION! UPDATES MAY BE AVAILABLE.
PLEASE REFER TO MASTERCAM.COM/SUPPORT
FOR THE LATEST DOWNLOADS.