new mastercam adminstrator guide - macdac engineering · 2018. 6. 1. · registry 24 grouppolicies...

MASTERCAMADMINSTRATOR GUIDE

February 2018

MASTERCAM ADMINSTRATOR GUIDE

February 2018© 2018 CNC Software, Inc. – All rights reserved.Software: Mastercam2019

Terms of UseUse of this document is subject to the MastercamEnd User License Agreement. The MastercamEnd User LicenseAgreement can be found at:

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

Be sure you have the latest information!Informationmight have changed or been added since this document was published. The latest version of the doc-ument is installed withMastercamor 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

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

TABLE OF CONTENTS

Updates 5

License Types 5

Update Codes for Licensing Hardware 5

Before entering the update code 5

Updating Codes for HASP Licenses 6

SIM Not Found error 7

Update Codes for Software Licenses 8

Repairing aMastercam2019 installation 11

To repair an installation 11

UpdatingMastercam2019 11

To download and install Mastercamupdates 12

Launching Mastercam 13

Determining the Initial License Type 13

Mastercam Launcher 13

StartingMastercam Launcher 14

Information displayed in the dialog box 14

Using Command-Line Switches 17

SettingMastercam shortcut command-line switches 17

Command-line switches 18

Error messages 20

NetHASP error messages 20

CodeMeter error messages 20

MastercamAdvanced Configuration Utility 21

Network Administration 23

Network Administrator Qualifications 23

Installation 23

System Settings 24

Mastercam2019 installation locations 24

iii

Registry 24

Group policies 24

Setting installation defaults 24

NetHASP Networks 25

Network Administration (NetHASP) 25

Installing the NetHASP Server 26

Updating NetHASP Codes 27

Using the NHaspX.exe Utility 29

Monitoring NetHASP Users 30

Network Administration (Software Licenses) 32

Server Setup for Software Licenses 33

Maximumnumber of CodeMeter licenses 38

Monitoring Software License Networks 39

If You Need More Help 40

MastercamResources 41

Contact Us 41

iv

5

UPDATES

This administrator's guide covers installation and configuration of networked scenarios. Use this administrator'sguide to learn about updating license codes, startingMastercam2019 withMastercam Launcher or command-lineswitches, and administering an installation over a network.

This chapter describes how to update Mastercam license codes (SIMs) on HASPs and software license codes, as wellas your version of Mastercam. Instructions for updating NetHASP codes are located in "Updating NetHASP Codes"on page 27.

License TypesMastercam is a protected software, and requires a license to run. Historically, this license has been stored in a phys-ical USB plug-in device. The device could either be a local HASP or aNetHASP located on a corporate network.

As of the release of Mastercam2019, software licenses (also referred to as CodeMeter licenses) are now availableas retail licenses. These licenses eliminate the need for a physical device connected to a computer. Mastercamhassupported the limited distribution of software licensing via CodeMeter since X7.

Update Codes for Licensing HardwareUpdate your Mastercam licensing hardware (HASP or NetHASP) with an update code obtained from your Reseller orMastercamCustomer Service. You need to do this when you install or upgrade to a new release of Mastercam, andif you are not onMastercamMaintenance. Youmust activate your licensing hardware with this update code beforeyou can run the newor updated version of Mastercam.

The update code for a HASP or aNetHASP is a file that is delivered to you by one of these methods:

l Included with your Mastercam2019 software kit

l Mailed on electronicmedia

l E-mailed as a file attachment

Contact your localMastercamReseller if you cannot locate your update code.

Before entering the update code

l If you receive your update code via email, save the file attachment to an accessible location. (Do notchange the file extension.)

l If you receive your update code via post or as part of an installation kit, insert the receivedmedia inthe appropriate drive to access the file.

Update code files have a file extension that indicates the type of license they update. The Mastercam installation pro-gramassociates 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

Mastercam Adminstrator Guide—Updates

Note: Remove all other licensing hardware before entering the Mastercamupdate code.

Installing a HASP

Mastercam supports both single-user and network licensing. Follow the procedure below to install licensing hard-ware (also known as aHASP) for a single user. Youmust complete the following procedure prior to updating theHASP code. Updates over a remote connection will fail.

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 youmaydamage the port and the HASP.

Updating Codes for HASP Licenses

See instructions for "Updating NetHASP Codes" on page 27 and for "Update Codes for Software Licenses" onpage 8.

CAUTION: Before this phase of the update process, youmust have Mastercam installed.Youmust com-plete the following procedure on the computer to which the HASP is attached. Updates over a remote con-nection will fail.

To enter a HASP update code

You can enter a HASP code automatically by double-clicking the update code file (*.HCODE). To update the codemanually, perform the following procedure.

1. Choose one of the followingmethods to run HaspX.exe. The method you choose is based on your version ofMicrosoft Windows, the update code format, and your preference.

l (Windows 7 and 8) From the Windows desktop, choose Start, All Programs,Mastercam 2019, Util-ities, Hasp X.

l (Windows 10) From the Windows desktop, choose Start,Mastercam 2019, Hasp X.

l Use Windows Explorer to navigate to the Mastercam2019 installation location, and double-clickHaspX.exe.

The HaspX utility analyzes the license and displays the serial number and supportedMastercamproducts.Verify that the displayed serial number matches the serial number provided with your Mastercam2019 soft-ware kit.

Note: Keep a record of the serial number in the event that you need to contact your Reseller or TechnicalSupport at CNC Software.

2. In the HaspX dialog box, choose Update code to open the code file that you received. The HaspX utilityextracts the update code from the file.


6

7

3. Choose Update at the top of the HaspX dialog box. The programupdates the license and displays theproducts (including any newly activated products) that the license supports.

Once you update the license, the HaspX utility displays important license information at the bottomof the dia-log box.

l Start date/End date: Displays the start date and end date for the SIM.

l Maintenance Expiration date: Shows the date your Maintenance plan expires, based on your annualrenewal date.

l HASP Status: Showswhether the utility found the HASP SIM on your computer.

4. Choose OK to exit the HaspX utility.

SIM Not Found error

On rare occasions, Mastercammight not find your SIM. Try the following suggestions to fix the problem:

l Remove and reconnect the HASP or NetHASP.

l Try installing the HASP or NetHASP in a different USB 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 eitherbroken or not receiving power from the USB port.

l Reinstall the HASP drivers (see the "Manually installing the HASP drivers" below).

If the problempersists, contact CNC Software Technical Support for assistance.

Manually installing the HASP drivers

Mastercam2019 includes HASP drivers. If the HASP driver needs to be reinstalled, choose Start, All Programs,Mastercam 2019, Utilities, Hasp Setup (Windows 7 and 8) or Start, Mastercam 2019, Hasp Setup (Windows10), and then follow the onscreen instructions.


Update Codes for Software LicensesAlthoughwe have made themmore widely available with the release of Mastercam2019, Mastercamhas sup-ported the limited distribution of software licensing via CodeMeter since X7. As with hardware licenses, when youinstall or upgrade to a new release of Mastercam, youmust update your Mastercam licensing software with anupdate code obtained from your Reseller or MastercamCustomer Service.

Before you update your license youmust deactivate it with the ActivationWizard.

1. Select Start, Mastercam Licensing Utilities, Activation Wizard.

The MastercamProduct ActivationWizard displays.

2. Select Deactivate an Existing License File.

3. Select the license that you would like to deactivate.

4. Select your preferred activationmethod, and clickNext.

If you are connected to the internet, the ActivationWizard verifies your internet connection and retrievesyour license. See the ActivationWizard Help for instructions on how to deactivate a license for a computerthat is not connected to the internet.

5. ClickNext when the button becomes active.

6. The Confirmation page displays. Ensure that the license you are about to deactivate is the correct one, andthen selectNext.

The ActivationWizard processes the deactivation.

7. The Product Deactivation Successful page displays once your Mastercamproducts or evaluations havebeen deactivated. Write down your License number and Activation code. You will need them to reactivateyour updated license.

Your Reseller will modify your current activation code to include any updated information or modifications to yourlicense. Once you have deactivated your license, update your license by following these steps.


8

9



2. Select Activate New License.

3. Accept the terms on the Terms and Conditions page, and then pressNext.

4. Enter the License number and Activation code you received from your Reseller or CNC Software, Inc..


6. If you are connected to the internet, the ActivationWizard verifies your internet connection and retrievesyour license. ClickNext when it becomes active.


Your host does not need an internet connection. See the ActivationWizard Help for instructions on how toactivate a license for a computer that is not connected to the internet.

7. The Wizard displays the products enabled with your Software License. Check the box to agree to the versionof Mastercam supported by your license, and then clickNext.

The wizard activates license.

8. Click Finish to complete the activation.


10

11

Repairing a Mastercam 2019 installationIf you encounter a problemafter an installation and no problemswere detected with your license, youmay need torepair your Mastercam2019 installation.

To repair an installation

1. Launch theMastercam installation from the USB drive or from the web download.

2. Choose Repair, and then follow the prompts.

Updating Mastercam 2019A maintenance upgrade is an executable file (.EXE) that you run to update your installation.

Before you do an update, youmust exit Mastercam. If you start an update withMastercamopen, you are asked toclose all sessions runningMastercamon the PC before continuing with the update installation.

CAUTION: The following instructions apply only to English-basedMastercam installations with updatesreceived fromCNC Software, Inc. For information on downloading non-EnglishMastercamupdates fromother locations, contact your localMastercamReseller.


To download and install Mastercam updates

1. Download the latest update from the Mastercamwebsite (www.mastercam.com/en-us/Support/Downloads),or get the update from your localMastercamReseller.

2. Copy the downloaded file to the PC onwhich you want to do the update.

3. If Mastercam is running, close it.

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

5. When the installation is complete, click Finish.

You can also update Mastercamwith the Automatic Update Service.

1. Select File, Help, Check for Updates. The MastercamUpdates dialog box displays.

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

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

3. Click Check Now.


12

https://www.mastercam.com/en-us/Support/Downloads

13

LAUNCHING MASTERCAM

This chapter describes howMastercamautomatically determines which license type will support a user's session,and how you can override this via the Mastcam Launcher or command-line switches.

Determining the Initial License TypeMastercamdetermines the initial license type automatically when it starts. Mastercam searches for licenses in thefollowing order:

1. Checks for a HASP connected to your computer.

l If you do have aHASP, your license type isHASP.

l If you do not have aHASP, Mastercammoves to the next step.

2. Checks for a Software license available, either locally or on a network.

l If you have a Software license available, your license type is Software.

l If you do not have a Software license, Mastercammoves to the next step.

3. Checks for aNetHASP connected to your computer, locally or on a network.

l If you have a network NetHASP, your license type isNetHASP.

l If you do not have aNetHASP, Mastercammoves to the next step.

4. If Mastercam cannot find any of the above license types, your license type isUndefined.

5. Mastercamasks if you have an activation code.

l If Yes, the ActivationWizard opens.

l If No, Mastercam closes and no further actions happen.

Mastercam LauncherMastercam Launcher is primarily designed for clients with network configurations of MastercamandMastercamResellers. Use Mastercam Launcher to control the startup options for a particular seat (license) of Mastercam. WithMastercam Launcher, you can do the following:

l Assign product (platform) levels and availability, such asMill or Mill 3D.

l Edit the availability of Mastercamadd-on products and their usage status.

l Start Mastercamwith either a HASP, software licensing, or aNetHASP.

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

l Save the current settings to the registry and/or openMastercamwhen you clickOK.

Additionally, if you are runningMastercamwith a Reseller license, you can do the following:

l Emulate a Reseller, Industrial, or Educational license while runningMastercam.

l RunMastercamwith or without Maintenance.

Mastercam Adminstrator Guide—Launching Mastercam

Starting Mastercam Launcher

Start Mastercam Launcher by selecting Start, All Programs,Mastercam 2019, Utilities, Mastercam Launcher(Windows 7 and 8) or Start,Mastercam 2019, Mastercam Launcher (Windows 10). When you start MastercamLauncher, the following dialog box displays.

Figure 2 - 1: Mastercam Launcher dialog box

Information displayed in the dialog box

l License information: Displays the license number being used, the user type, the license expiration date,and the Maintenance expiration date.

Note:

l If you are using a permanent license, the expiration date is listed as “Permanent”.

l Maintenance expiration date shows the date that Maintenance on the license expires. For temporarycodes, the expiration date and the Maintenance expiration date are the same.

l Platform area: This grid shows the product (platform) names, the available platform level on your license,and the platform status.

The drop-down arrow in the Level column lets you select a specific product level. Network clients can seeavailable levels, and choose the one to use. Mastercam Launcher will only display licensed levels.

The drop-down arrow in the Status column lets you choose from the following status settings:


14

15

l Active – the product is available for use.

l Inactive – the product is not available for use (performs as if you are not licensed for the product).

l Startup – Mastercam2019 starts up in that product.

Figure 2 - 1: Local license

Figure 2 - 2: Network license

Note:

l If you do not have license support for a platform, the entire row is inactive.

l All platforms and add-ons are available if you are running a Reseller license type.

l Add-on Products area: This section lists all of the available add-on products, and howmany licenses are avail-able.

To check out a license for the session, click the arrowbutton in the Status column for the add-on product youwant to work with, and set the status to Enable. If you choose the Disabled status, that add-on is not availablefor you to use, even though it is available on the network.

A Not Licensed statusmeans that you do not or your network does not have a license for that add-on, andtherefore you do not have access to that add-on.

Productsmarked Automatic Checkout are checked out automatically when needed.

Add-on products that are not included in the license are inaccessible. If an add-on is included but all of theinstances are in use, the number in the Licenses available column is 0, and you cannot use the add-on.


Figure 2 - 3: Local setup

Figure 2 - 4: Network setup

l License Type area: The radio buttons in this area let you switch your license type between HASP, NetHASP,and Software licenses. The availability of the switch options depends on your access to each of those devicesat the time you start Mastercam Launcher.

If you select the Software option, you can set howMastercam searches for the software license on startup.

l Default will programMastercam to first search for a license locally, and if one is not found, for a licenseon the network.

l Local search only andNetwork search only will programMastercam to search for a license only onthe local workstation or only on the network, respectively.

l Create Shortcut: Creates a shortcut on the desktop based on the current settings inMastercam Launcherand prompts you for the shortcut’s name. The shortcut contains all of the switches needed to openMaster-camaccording to the settings you chose inMastercam Launcher.

When you create a shortcut and do not enter a name for it, Mastercamnames the first shortcutMastercam(1) and increments the number for each customized shortcut you create without specifying a name.


16

17

l Save on exit: Select to save the Mastercam Launcher settings to the Registry when you clickOK. If you clickCancel to exit the dialog box, the settings are not saved to the Registry, even if you have selected this option.

l Start Mastercam: Select to have Mastercam launch when you clickOK. If you click Cancel to exit the dialogbox, Mastercamdoes not start, even if you have selected this option.

l Emulation area (Resellers only): This section letsMastercamResellers set upMastercam to run underReseller, Industrial, or Educational functionality. Resellers can also set upMastercam to run with or withoutMaintenance.

Using Command-Line SwitchesAs an alternative to the Mastercam Launcher, you can use command-line switches for these specific tasks:

l Override the initial license type.

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

l Request specific network licenses when you start Mastercam.

l OpenMastercam in a particular product or product level, or to suppress products or product levels withsingle-user licenses.

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

Mastercam checks out product licenses at startup and then exchanges themeach time you choose amachine defin-ition for a different machine type (Mill, Lathe, Router, Wire, or Mill-Turn). This flexible structure allows networklicensing to be dynamically allocated.

If you start Mastercam2019 without command-line switches, Mastercamdoes the following:

1. Determines the initial license type according to the protocol described in "Determining the Initial LicenseType" on page 13.

2. Checks out aMastercamDesign license, if one is available.

3. If a Design license is not available, Mastercam checks out the highest-level license available for Mill, Lathe,Router, or Wire.

WhenMastercam is running, if you choose amachine definition type (Mill, Lathe, Router, Wire, or Mill-Turn) that isdifferent from the current product license, Mastercam releases the current license and checks out a product licensefor the machine type.

By adding command-line switches to the Mastercam shortcut, you can control which product level licenses arechecked out during the Mastercam session. For example, to create a shortcut that checks out only Mill 3D andRouter 3D licenses when aMill or Router machine definition is selected, add the following command-line switches toyour Mastercam shortcut: /M3 /R3.

Setting Mastercam shortcut command-line switches

To set command-line switches for a Mastercam shortcut

1. From the Windows desktop, right-click the Mastercam2019 shortcut.

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" below for moreinformation.) For example, to request a single Mill Entry license at startup, enter:

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

To request aMill 3D license and a Router license:

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

To request three licenses at startup—Mill, Lathe, and Router:

"C:\Program Files\mcam2019\Mastercam.exe" /M2 /L1 /R2

CAUTION:

If the directory name contains spaces, youmust enter the shortcut using the following format:

l Place quote marks around the directory path.

l Place the command-line options outside of the quote marks.

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

Command-line switches

The following table lists all command-line switches for eachMastercamproduct. However, all productsmight not beincluded 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 sup-ported by your license, amessage shows the products enabled by the license andmodified by the command-lineswitch.

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

l /H = Force initial license type to HASPl /N = Force initial license type to NetHASPl /Software = Force initial license type to Softwarel /SoftwareLocal = Force initial license type to Software, look local onlyl /SoftwareLan = Force initial license type to Software, look network only

Initial License Type


18

19

l /D = Design only (requires a stand-alone Design license). For example, use this switch if you want to load apart that contains toolpaths but do not want to check out aMill, Lathe, or Router license.

l /noD = Disable Design only

Mastercam Design

l /ME = Mill Entry l /M3 = Mill 3D

l /M2 = Mill l /noM = Disable Mill

Mastercam Mill

l /LE = Lathe Entry l /L1 = Lathe

l /noL = Disable Lathe

Mastercam Lathe

l /RE = Router Entry l /R3 = Router 3D

l /R2 = Router l /noR = Disable Router

Mastercam Router

l /W2 = Wire l /noW = Disable Wire

Mastercam Wire

l /Art = Art l /noArt = Disable Art

Mastercam Art

l /noRem= Suppress product message

All Products

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

l /MT1 = Simplified access to Mill-Turn functions forLathe users

l /noT = Disable the Mill-Turn add-onl /MT2 = Full access to Mill-Turn functions

l /Engr = Engraving add-on l /noEngr = Disable the Engraving add-on

l /Port = Port Expert add-on l /noPort = Disable the Port Expert add-on

l /Blade = Blade Expert add-on l /noBlade = Disable the Blade Expert add-on

l /Probe = Probing add-on l /noProbe = Disable the Probing add-on

Mastercam Add-on Features


l /X5 = MultiAxis add-on l /noX5 = Disable the MultiAxis add-on

l /Nest = Nesting l /noNest = Disable Nesting

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

l /PD = ProDrill l /noPD = Disable ProDrill

Mastercam Add-on Features (continued)

Error messagesWhenMastercam starts up on a network, it attempts to get a license froma server. Listed below are common errormessages that display whenMastercam is unable to acquire a license.

NetHASP error messages

Error checking out a [product name] license. No licenses have been purchased for this product.Contact your localMastercamReseller, 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 maximumallowable number of users have checked out the product.

The SIM has become disconnected. Mastercam will automatically shut down. You will get one chance tosave your file.Approximately once every 2 to 10 minutes, Mastercam verifies that the NetHASP server is still running and that theNetHASP is attached to the server. If this test fails—for example, due to a power loss or server failure—this errormessage is displayed on all PCs runningMastercam.

Take thismessage seriously. Save your work quickly, and shut downMastercam. Check the NetHASP connection andreconnect, as necessary.

CodeMeter error messages

Requested Product Code is not available.Contact your localMastercamReseller, and purchase the necessary options.

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 (Start,CodeMeter, CodeMeter Control Center) and click theWebAdmin button to troubleshoot.

All available licenses are in use.The maximumallowable number of users have checked out the product.

Network communication error.The software license is no longer communicating with the server. Save your work quickly, and shut downMaster-cam. Open the CodeMeter Control Center (Start, CodeMeter, CodeMeter Control Center) and click theWebAd-min button to troubleshoot.


20

21

Mastercam Advanced Configuration UtilityMastercam includes aMastercamAdvanced Configuration utility, with which you can access andmodify globalMastercamproperties. The dialog box contains two areas to control how features are selected and the parametersset. For example, you can use the Advanced Configuration to specify whether Mastercamdisplays its splash screenat startup.


Start the utility by selecting Advanced Configuration in the Start Menu, found underMastercam 2019 (Master-cam 2019, Utilities if you are usingWindows 7 or 8). For more information on the options, click the Help button.


22

23

NETWORK ADMINISTRATION

This chapter provides information on installing and administeringMastercam2019 in a network setting.

Network Administrator QualificationsA full-time network administrator must be available and able to perform the following tasks:

l Recover froma network crash in a reasonable amount of time. Network licensing depends on a stable net-work.

l Configure the network as required by this document and the nethasp.txt document. See "AdditionalNetHASP information" on page 32 for details on nethasp.txt.

l Be proficient with a text editor.

l Understand and edit command-line parameters.

l Learn enough about Mastercam2019 to understand which licenses are checked out when each of the Master-camproducts starts up.

l Understand how to use the Mastercam2019 NHaspX.exe utility.

l Agree to install Mastercam2019 on all PCs that require it.

Attempting to runMastercam froma common directory on a network drive does not work. The applicationmust be physically installed on each PCwhere it will be used.

l Have internet and e-mail access, as well as the ability to accept attachments.

l Software networks – Be familar with basicWibu CodeMeter support and troubleshooting.

l NetHASP configurations – Be familiar with the NetHASP, a red device that is plugged into the NetHASPserver's USB port. Although the NetHASP looks like aHASP, it is very different. The HASP and NetHASP arenot interchangeable.

CAUTION: Keep the NetHASP in a physically safe place. All Mastercam2019 users on the networkare vulnerable to its loss.

InstallationMastercam2019 must install components into the Windows system32 folder, as well as register these componentsglobally. Youmust have Administrator privileges to install Mastercam.

Additionally, to install Mastercam2019 properly, the user must have the Impersonate a client after authen-tication group policy. The Administrator group gets this permission by default, but some upgrade scenariosmaynot have this permission set. Without this permission, the installation will fail at the very end, after all program fileshave been copied. In this case, the status text on the installation reads “Publishing Product Information.”

When installing as an Administrator for other users, youmust select the Anyone who uses this computer (allusers) option. This option is the default setting for the installation.

Mastercam2019 cannot be installed on a drive created with the SUBST command. Use the actual path to the desiredinstallation folder, not the substituted drive letter.

Mastercam Adminstrator Guide—Network Administration

For Mastercam2019 to install and run successfully, the computer must have standardWindows permissions.

System SettingsThe following sections describe important system settings, including file and Registry permissions, as well as net-work configuration and group policies.

Mastercam 2019 installation locations

The default Mastercam2019 installation folders are based on the Windows version andMastercam file type (non-modifiable and user-modifiable).

User-modifiable data is stored in two different locations, depending onwhether the data is user-specific or shared.

Mastercam Installation Locations

Program files (non-modifiable)C:\Program Files\mcam2019

C:\Program Files\Common Files\Mastercam

User-modifiable files

C:\Users\\Documents\my mcam2019

C:\Users\Public\Documents\shared mcam2019

Mastercam2019 requires read and write access to the user’s My Documents and Shared folders.

Registry

To runMastercam2019, the user needs permission to read from the following registry key. This key is created dur-ing the installation and contains default Mastercam2019 settings.

HKEY_LOCAL_MACHINE\SOFTWARE\CNC Software, Inc.\

The user also needs to have read and write permission for this registry key. This key is created when the user firststartsMastercam2019 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 install-ation.

Group policies

Setting group policies can severely restrict permissions onWindows systems. Mastercam2019 runswith the defaultgroup policies. Most other group policies have no effect onMastercam’s ability to run. However, a combination ofgroup policiesmight cause issues withMastercam2019.

Setting installation defaults

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


24

25

l Installation language

l Program language

l Units

l Installation type

l Destination directory

To set installation defaults

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

2. Open mcim.ini in a text editor. (Do not use aword processor to edit this file.)

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

4. Save the file.

Note: Youmust runmodified installations from the saved location.

Maximum number of NetHASP licenses

l The NetHASP-20 allows for the simultaneous use of up to 20 seats of each licensed product.

l The NetHASP-50 allows for the simultaneous use of up to 50 seats of each licensed product.

CAUTION: All product groupsmust be the same version. For example, if your license supports one seat ofMill Entry and one seat of Mill 3D, the version number for both productsmust be the same. A different ver-sion number cannot be assigned to each group of products.

NetHASP Networks

Mastercam2019 can use aNetHASP to service Mastercam licenses froma central location. Because these licensesare served over a network, a firewalled server running aNetHASPmust allow the license server to communicatethrough 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 throughthe firewall.

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

Note: These configuration steps do not apply to networked software licenses.

Network Administration (NetHASP)The following section provides guidance for installing, updating, andmonitoring networks run through aNetHASP server. See "Network Administration (Software Licenses)" on page 32 if you administer a network ofCodeMeter software licenses.


Installing the NetHASP Server

Although NetHASP supportsmost networks, CNC Software, Inc. tests and supports its use only withWindows 7, Win-dows 8, or Windows 10 in a TCP/IP network environment. For more information, see "Additional NetHASPinformation" on page 32.

To set up the NetHASP server

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

2. Insert the Mastercam2019 flash drive into aUSB port. Use one of the followingmethods to install Master-cam2019:

l If your computer is set up for Autorun, the Mastercam2019 installation programopens automatically.

l Navigate to the flash drive, and double–click Launcher.exe.

3. Choose Utilities from the installationmenu.

4. From the menu, choose NetHASP Server, and follow the on-screen instructions.

5. Choose Finish to exit when the installation is complete.

Note: You can, but are not required to, install Mastercamproducts on the NetHASP server.

6. Use the NHaspX.exe utility to check available Mastercam licenses.

You can copy NHaspX.exe from the flash drive. For more information on this utility, see "Using theNHaspX.exe Utility" on page 29.

To set up Mastercam 2019 for the NetHASP

1. Install Mastercam2019.

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

3. Run NHaspX.exe. Set the SIM type toNetHASP and the Mode toNetwork.

4. From the flash drive’s support folder, copy the nethasp.ini file to the mainMastercamdirectory (usuallyc:\Program Files\mcam2019).

5. Use your preferred text editor to edit nethasp.ini for the appropriate network protocol and identify thecomputer(s) that are being used as the NetHASP server(s).

CAUTION: If this step is omitted, whenMastercam2019 starts and checks for network licenses, ittakes extra time to search all PCs on the network to find the NetHASP server. If all licenses havebeen checked out by other Mastercam2019 users on your network, the searchmight take an espe-cially long time. Configuring nethasp.ini to look for the NetHASP server at a specific address elim-inates this delay.

6. Create or edit shortcuts for runningMastercamwith command-line switches as described in "UsingCommand-Line Switches" on page 17.

The Mastercam2019 installation process automatically installs NetHASP drivers. If the installation procedure wasnot completed or if the NetHASP drivers were removed, Mastercam cannot recognize the NetHASP. To fix this prob-lem, run haspdinst.exe from the Mastercam \common directory (for example, C:\Program Files\m-cam2019\common).


26

27

Figure 3 - 1: Recommended nethasp.ini for TCP/IP

Adding licenses

The number of licenses you purchase for each product is stored in the NetHASP. The maximumnumber of licensesallowed for each product is further limited by the type of NetHASP.

Once you have reached the maximumnumber of licenses, use one of the following options to add additionallicenses:

l Exchange your NetHASP (for example, exchange aNetHASP-20 for aNetHASP-50 or NetHASP-100).

l Keep your NetHASP and obtain another one with the additional licenses you need. This option requires you toset up a separate NetHASP server for the second NetHASP; NetHASPs cannot be connected to each other onthe same server.

Updating NetHASP Codes

For general information on entering HASP codes, please refer to "Update Codes for Licensing Hardware" onpage 5.

CAUTION: Before you begin this phase of the installation process, youmust first complete the NetHASPServer installation (see "Installing the NetHASP Server" on the previous page). Also note that you can per-form this update only on the computer to which the NetHASP is attached. The process cannot be com-pleted over a remote connection.


To enter a NetHASP update code

You can enter aNetHASP code automatically by double-clicking the update code file (*.NHCODE). To update the codemanually, perform the following procedure.

1. Choose one of the followingmethods to run the NHaspX.exe. The method you choose is based on theupdate code format and your preference:

l (Windows 7 and 8) From the Windows desktop, choose Start, All Programs,Mastercam 2019, Util-ities, NHasp X.

l (Windows 10) From the Windows desktop, choose Start,Mastercam 2019, NHasp X.

l Use Windows Explorer to navigate to the Mastercam2019 installation location and double-clickNHaspX.exe.

2. In the NetHASPX dialog box, make sure thatMode is set to Local.

The NHaspX utility analyzes the license and displays the serial number and current Mastercamproducts.Verify that the displayed serial number matches the serial number provided with your Mastercam2019 soft-ware kit.

Note: Keep a record of the serial number in the event that you need to contact Technical Support at CNC Soft-ware or your Reseller.

3. ClickUpdate code file. The NHaspX: Select an Update Code file dialog box opens.

4. Select an nhcode file, and clickOpen.


28

29

5. Choose Update from the NhaspX dialog box. The programupdates the SIM and displays the products forwhich the SIM has been activated.

6. Change the Mode back toNetwork.

7. Choose OK to exit the NHaspX utility.

Using the NHaspX.exe Utility

Use the NHaspX.exe utility, provided by CNC Software, Inc., to configure and administer your Mastercam2019 net-work licensing. This section includes a description of each option you can choose when running this utility.

Figure 3 - 1: NHaspX.exe dialog box

l Mode: Choose Local to update the NetHASP from the local computer. Choose Network to read theNetHASP connected to the NetHASP server, whichmay or may not be the local computer.

l Update code file: Click to browse to the location of the update code file provided by CNC Software or yourReseller.

l Product list (untitled): The large area lists the number of workstations authorized for each product followedby the product name.

l Read: Displays the product list that is programmed in the NetHASP.


l Update: To update the NetHASP, it must be connected to the local computer, and youmust set theMode toLocal. Before selectingUpdate, enter the update code file name. If the update code file is not found, a not found error message displays.

l Active licenses: (Available only inNetworkmode.) Displays information on the number of licenses currentlychecked out, the number of licenses authorized, and the number of licenses that are currently available foreach product. (See "Monitoring Software License Networks" on page 39 below for details.)

Note: None of the licenses that are checked out from the local computer are reported by Active licenses.

l Stop: Available only when you choose Active licenses to monitor and report license information. ChooseStop to end the reporting function.

l User type: (read-only) Displays one of the following user types: Industrial, Educational, or Dealer.

l Serial number: (read-only) Displays the NetHASP serial number.

l Start date/End date: (read-only) Displays the first and last date for which the NetHASP licenses are valid orUnlimited if the licenses are available permanently.

l Maintenance expiration date: (read-only) Displays the date your Maintenance plan expires, based on yourannual renewal date.

l CATIA Maintenance expiration date: (read-only) If you have the CATIA add-on, displays the date yourCATIA Maintenance plan expires.

Monitoring NetHASP Users

You canmonitor NetHASP activity using the NHaspX.exe utility. Choose the button labeled Active licenses toshow:

l Which products are licensed

l The number of active users

l The maximumnumber of users

l The number of available licenses for each product

Note:

l Youmust first set Mode toNetwork to enable the Active licenses option.

l This function runs slowly if nethasp.ini is not present or is set up incorrectly. For more information, see "Toset up the NetHASP server" on page 26.

l The NHaspX.exe utility does not report the licenses that are checked out on the computer on which it is run-ning.

Using Aladdin Monitor

Besides NHaspX.exe, you can use the AladdinMonitor utility to view a list of users logged in to the NetHASP server.To install this utility, run the Mastercam installation program from the Mastercam2019 installationmedia, chooseUtilities and thenNetHASP Monitor, and complete the on-screen instructions.

AladdinMonitor is a third-party application for monitoring NetHASP usage. AladdinMonitor is included withMaster-cam for your convenience. However, CNC Software, Inc. can provide only limited support for this application. Pleasecontact Aladdin (www.aladdin.com) for technical support issues. Following is a quick guide for using AladdinMonitor.


30

http://www.aladdin.com/

31

Run AladdinMonitor. In the left windowpane, locate the NetHASP tomonitor. Click the NetHASP's entry to displayinformation about the HASP in the right-hand pane.

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

l Mastercamproducts in use (programnumber)

l Number of users currently using each product

l Maximumusers allowed for each product

l Remaining product activations

Please refer to the following table for programnumbers and their equivalent Mastercamproducts:

ProgramNumber

Mastercam ProductProgramNumber

Mastercam Product

1 [NHaspX tech info] 29 STEP Read

2 Mill Entry 31 Engraving

3 Mill * 32 Curve 5-axis/Drill 5-axis

4 Mill * 37 Pro/E Read

5 Mill 3D * 40 CATIA V5 Read

6 Lathe Entry 41 CATIA V5 Write

7 Lathe 42 CATIA V4 R/W

8 Wire 43 Unigraphics Read

9 Design 44 Swarf 5-axis

10 Solids 46 Mastercam for SOLIDWORKS 2D

11 Router Entry 48 Mastercam for SOLIDWORKS 3D

12 Router * 49 Port Expert

13 Router * 50 Blade Expert

14 Router 3D * 52 Mastercam for SOLIDWORKS Lathe

17 Art 53 Probing

19 Multiaxis 56 CATIA V5 with PMI


ProgramNumber

Mastercam ProductProgramNumber

Mastercam Product

24 CoroPlus 57 Mori APT/CL Post

28 ProDrill 60 Mill-Turn

* Newname starting with X9

The Login table box shows 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

Registry settings

The NHaspX.exe utility reads and writes the HASP or NetHASP SIM type information fromand to the Registry:HKEY_CURRENT_USER\Software\CNC Software, Inc.\Sim Type

The value of Sim Type isH for the HASP andN for the NetHASP. EachMastercamuser must have read and writepermission to this part of the registry.

The NetHASPmode is also written to the registry: HKEY_CURRENT_USER\Software\CNC Software,Inc.\NetHASP mode

The two possible values are Network and Local.

Additional NetHASP information

This document provides only a brief introduction to setting up network licensing for Mastercam. For more inform-ation, use the NetHASP License Manager help system (accessed from the NetHASP Server application) and the neth-asp.txt document, located in the NetHASP Server installation location—for example:c:\NetHaspServer\nethasp.txt.

CAUTION: The NetHASP License Manager Help and nethasp.txt document were written by AladdinKnowledge Systems. CNC Software, Inc. has not contributed to or edited this information and assumes noresponsibility for its accuracy.

Network Administration (Software Licenses)In addition to HASPs and NetHASPs, Mastercam recognizes a thirdmethod of licensing, a software license calledCodeMeter, provided by Wibu Systems Inc. These licenses eliminate the need for a physical device connected to acomputer. Customers can create a network of software licenses and use the CodeMeter WebAdmin program toestablish a common server.

The following section provides guidance for installing, updating, andmonitoring networks of CodeMeter softwarelicenses. See "Network Administration (NetHASP)" on page 25 if you administer your network with aNetHASP.


32

33

Server Setup for Software Licenses

Any workstation can host and/or serve this network. You can, but are not required to, install Mastercamproductson your server. However, to act as a server, the host computer must have an active CodeMeter license. The applic-ations to activate the license and run CodeMeter software are installed by default when you install Mastercam. IfMastercam is not installed on your server, you can download CodeMeter and the MastercamProduct Activation util-ity from the Mastercamwebsite. http://www.mastercam.com/en-us/Support-Downloads-Drivers-and-Applets

Activate your license



2. Select Activate New License.

3. Accept the terms on the Terms and Conditions page, and then pressNext.

4. Enter the License number and Activation code you received from your Reseller or CNC Software, Inc..



http://www.mastercam.com/en-us/Support-Downloads-Drivers-and-Applets

6. If you are connected to the internet, the ActivationWizard verifies your internet connection and retrievesyour license. ClickNext when it becomes active.

Your host does not need an internet connection. See the ActivationWizard Help for instructions on how toactivate a license for a computer that is not connected to the internet.

7. The Wizard displays the products enabled with your Software License. Check the box to agree to the versionof Mastercam supported by your license, and then clickNext.


34

35

The wizard activates license.

8. Click Finish to complete the activation.

Enable the server with CodeMeter

1. Launch the Code Meter Control Center from your system tray.

2. ClickWebAdmin.


3. Click Configuration, Server.

4. Enable the Network Server. Then click Apply. This will broadcast the software license over the network.


36

37

5. Make note of the IP address of the server. You will need this if the client PC has difficulty contacting theserver.

Client connection

Once the license has been activated on the server, clients should be able to install and runMastercam. Occasionally,some clientsmay have difficulty finding the server. Follow this procedure to direct a client to the server.

1. Launch the Code Meter Control Center from your system tray.

2. ClickWebAdmin.


3. Click the Configuration tab.

4. Click add new Server.

5. Enter the Server IP address of the PC or server that is hosting the network, then clickOK.

6. Click Apply, and close the CodeMeter WebAdmin.

The client PC should nowbe able to runMastercam.

Maximum number of CodeMeter licenses

CodeMeter allows for the simultaneous use of up to 500 seats of each licensed product. If the number of seats inyour network exceeds this amount, youmust set up an additional server on another workstation. See "Server Setupfor Software Licenses" on page 33.


38

39

CAUTION: All product groupsmust be the same version. For example, if your license supports one seat ofMill Entry and one seat of Mill 3D, the version number for both productsmust be the same. A different ver-sion number cannot be assigned to each group of products.

Monitoring Software License Networks

You canmonitor activity on a software license network with CodeMeter'sWebAdmin. To launch the WebAdmin util-ity, open the CodeMeter Control Center from your system tray and click the WebAdmin button. From the utility youcanmonitor activity such as:

l Which products are licensed

l The number of active users

l The maximumnumber of users

l The number of available licenses for each product


IF YOU NEED MORE HELP

For assistance with installingMastercam2019, licensing, or to obtainmore information on usingMastercam2019,contact your localMastercamReseller. If your MastercamReseller is unavailable, you can call CNC Technical SupportMonday 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:

l Be sure you have already tried to contact your MastercamReseller.

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

l Be ready to describe the problem in detail. Write downwhat happened, particularly if you cannot call imme-diately after the problemoccurs.

l Be in front of your computer when you call.

l If possible, try to duplicate the problembefore calling. Our Support Services technicianmay require you toduplicate the problemwhile 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, andmemory.

You can also leave amessage for CNC Support Services twenty-four hours a day, seven days aweek via our email orwebsite 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, such as part and post files

Use Mastercam’s Zip2Go utility to gather Mastercampart data into a compressed Z2G or ZIP file. This utility makes iteasy to provide your MastercamReseller or CNC Support Services with a file attachment that contains the inform-ation they need. Zip2Go scans the machine groups in your current part file and captures information such as yourMastercam configuration, machine definition, and post files. For more information on using Zip2Go, please refer tothe MastercamHelp.

Important Contact Information

Address

CNC Software, Inc.671 Old Post RoadTolland, Connecticut, 06084-9970USA

Phone (860) 875-5006

Fax (860) 872-1565

MastercamKnowledge Base http://kb.mastercam.com

Mastercam Forum http://forum.mastercam.com

Website http://www.mastercam.com

Email [email protected]

Mastercam Adminstrator Guide—If You Need More Help

40

https://kb.mastercam.com/Default.aspxhttp://forum.mastercam.com/http://www.mastercam.com/mailto:[email protected]

41

Mastercam ResourcesEnhance your Mastercamexperience by using the following resources:

l Mastercam Documentation—Mastercam installs a number of helpful documents for your version of softwarein the Documentation folder of your Mastercam2019 installation.

l Mastercam Help—AccessMastercamHelp by selectingHelp, Contents fromMastercam's File tab or by press-ing [Alt+H] on your keyboard.

l Mastercam Reseller—Your localMastercamReseller can help withmost questions about Mastercam.

l Technical Support—Our Technical Support department (+1 860-875-5006 or [email protected]) isopenMonday through Friday from8: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 basicMastercam features and functions. Visit our website, or select Help, Tutorials fromMastercam's File tab tosee the latest publications.

l Mastercam University—MastercamUniversity, an affordable online learning platform, gives you 24/7 access toMastercam trainingmaterials. Take advantage of more than 180 videos to master skills at your own pace andhelp prepare for MastercamCertification. For more information onMastercamUniversity, please contactyour AuthorizedMastercamReseller, visit www.mastercamu.com, or email [email protected].

l Online Communities—You can find awealth of information at www.mastercam.com. For tech tips and thelatest Mastercamnews, follow us on Facebook (www.facebook.com/mastercam), Twitter(www.twitter.com/mastercam), or Google+ (plus.google.com/+mastercam). Visit our YouTube channel to seeMastercam in action (www.youtube.com/user/MastercamCadCam)! Registered users can search for inform-ation or ask questions on the MastercamWeb forum, forum.mastercam.com, or use the knowledgebase atkb.mastercam.com.

Contact Us

For questions about this or other Mastercamdocumentation, contact the Technical Documentation department byemail at [email protected].

Mastercam Adminstrator Guide—If You Need More Help

mailto:[email protected]?subject=Technical Supporthttp://www.mastercamu.com/mailto:[email protected]?subject=Mastercam Universityhttp://www.facebook.com/mastercamhttp://www.twitter.com/mastercamhttp://plus.google.com/+mastercamhttp://www.youtube.com/user/MastercamCadCamhttp://forum.mastercam.com/http://kb.mastercam.com/mailto:[email protected]?subject=Documenation Question

ATTENTION! UPDATES MAY BE AVAILABLE.PLEASE REFER TO MASTERCAM.COM/SUPPORT

FOR THE LATEST DOWNLOADS.

https://www.instagram.com/mastercamcadcam/http://i.youku.com/Mastercamhttps://www.instagram.com/mastercamcadcamhttps://plus.google.com/u/0/112469607931783596009https://www.youtube.com/user/MastercamCadCamhttps://twitter.com/Mastercamhttps://www.facebook.com/Mastercam

UpdatesLicense TypesUpdate Codes for Licensing HardwareBefore entering the update codeUpdating Codes for HASP LicensesSIM Not Found error

Update Codes for Software LicensesRepairing a Mastercam 2019 installationTo repair an installation

Updating Mastercam 2019To download and install Mastercam updates

Launching MastercamDetermining the Initial License TypeMastercam LauncherStarting Mastercam LauncherInformation displayed in the dialog box

Using Command-Line SwitchesSetting Mastercam shortcut command-line switchesCommand-line switches

Error messagesNetHASP error messagesCodeMeter error messages

Mastercam Advanced Configuration Utility

Network AdministrationNetwork Administrator QualificationsInstallationSystem SettingsMastercam 2019 installation locationsRegistryGroup policiesSetting installation defaultsNetHASP Networks

Network Administration (NetHASP)Installing the NetHASP ServerUpdating NetHASP CodesUsing the NHaspX.exe UtilityMonitoring NetHASP Users

Network Administration (Software Licenses)Server Setup for Software LicensesMaximum number of CodeMeter licensesMonitoring Software License Networks

If You Need More HelpMastercam ResourcesContact Us