MASTERCAM 2017

TRANSITION GUIDE
March 2016

MASTERCAM 2017 TRANSITION GUIDE

March 2016
Copyright 2016 CNC Software, Inc. All rights reserved.
Software: Mastercam 2017

Terms of Use
Use of this document is subject to the Mastercam End User License Agreement. A
copy of the Mastercam End User License Agreement is included with the Mastercam product package of which this document is part. The Mastercam End User
License Agreement can also 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
Transition to Mastercam 2017

Before You Begin

Running the Migration Wizard

Launching the Migration Wizard

Basic Migration

Advanced Migration

Handling Remaining Files

11

Machine Simulation Files

11

CIMCO Machine Files

11

Key Mapping File

12

Miscellaneous Files

13

Migrating files without changing locations

If You Need More Help

14
15

Mastercam 2017 Documentation

16

Contact Us

17

iii

iv

Mastercam 2017 Transition Guide Transition to Mastercam 2017

TRANSITION TO MASTERCAM 2017

This guide is designed to help you update your Mastercam files for use in Mastercam 2017. A standard installation to the default locations is assumed. If you need
assistance with a non-standard installation, you should contact your local Mastercam Reseller. Use the information included here to automatically migrate the
majority of your files, manually copy any files not included automatically, and to
get up and running with the latest version of Mastercam.

Mastercam 2017 Transition Guide Before You Begin

BEFORE YOU BEGIN

Mastercam 2017 includes a powerful, yet straightforward Migration Wizard. The
Migration Wizard has two options you can choose from: Basic or Advanced. For
Basic, you select and set the target directories and the destination location to
update the majority of your files to the current version. For Advanced, you choose
what file types and version types to migrate in addition to selecting and setting
the target directories and destination location. Some of the files migrated by this
wizard are:
l Part files
l Defaults files
l Operation and tool libraries
l Control definitions
l Machine definitions

Many factors affect the Migration Wizards processing time. The most significant
of these is the number of part files you have stored in your personal (..\my
mcamx9) and shared (..\shared mcamx9) directories. You may choose to relocate your part files to shorten the migration process.

Mastercam 2017 Transition Guide Running the Migration Wizard

RUNNING THE MIGRATION WIZARD

Run the Migration Wizard the first time you launch Mastercam 2017 and before
you begin to make changes to the Mastercam 2017 setup.
Before running the Migration Wizard, be aware of the following:
l NC and NCI files are not migrated.
l If files have not changed from the originally distributed versions, then

they will not be updated to the latest version.

If the Migration Wizard encounters any errors, it halts the process until you take
appropriate action.

Launching the Migration Wizard

1. Launch Mastercam using your preferred method.
2. Select File, Convert, and then click Migration Wizard.

3. The Migration Wizard displays.

Mastercam 2017 Transition Guide Running the Migration Wizard

Basic Migration
By selecting the Basic option, you will automatically update all Mastercam file
types from the previous version to the current version. To migrate files with the
Basic option, follow the instructions below:
1. Select Basic on the Welcome to the Mastercam Migration Wizard page.

2. On the File Locations page, choose the destination folder for the shared
mcamx files.
3. Choose the destination folder for the my mcamx files.

Note: You cannot set the source folder when doing Basic migration.
4. Click Next.
5. Review your choices on the Finish page.
6. Once you are satisfied with your selections, click Finish.

Mastercam 2017 Transition Guide Running the Migration Wizard

Advanced Migration
By selecting the Advanced option, you can choose which file types to update, as
well as file versions. To update and migrate files with the Advanced option, follow
the instructions below:
1. Select Advanced on the Welcome to the Mastercam Migration Wizard page.

2. On the File Locations page, select the Migrate shared mcamx files and
Migrate my mcamx files checkboxes.
3. Choose the source folder and destination folder for the shared mcamx files.
4. Choose the source folder and destination folder for the my mcamx files.
You can also include subfolders or use the source folder as the destination
folder by selecting and deselecting the checkboxes.

Mastercam 2017 Transition Guide Running the Migration Wizard

5. Click Next.
6. On the File Types page, select the type of files you want to migrate. Then,
click Next.

7. On the Versions page, select the Mastercam file versions you want to
migrate. Then, click Next.

8. Review your selections on the Finish page.

9. Once you are satisfied with your selections, click Finish.

CAUTION: If you are logged on as an administrator, the Migration Wizard processes the nethasp.ini file at this time.

10

Mastercam 2017 Transition Guide Handling Remaining Files

HANDLING REMAINING FILES

Certain files are not migrated through the wizard and must be manually copied
into the Mastercam 2017 structure. These include files that are outside of the
default installation locations, as well as the following:

Machine Simulation Files

Machine Simulation files are located in your ..\shared mcamx9 \MachineSimulation\MachSim folder. If you have created any custom machines or layouts,
you should bring them into Mastercam 2017. Simply copy the contents of the
MachSim folder, including all sub-folders and files, into your ..\shared
Mcam2017\MachineSimulation\MachSim folder.

CIMCO Machine Files

If you are running or logged in as an administrator, CIMCO Machine files are located under your ..\Program Files\mcamX9\common\Editors
\CIMCOEdit7\Machines folder. In order to copy files into your Mastercam 2017
installation you must be logged in as an administrator. Copy all of the files with a
.mch extension from the X9 location to the Mastercam 2017 location as shown
below:
..\Program Files\mcam2017\common\Editors \CIMCOEdit7\Machines
Note: If you are not running or logged in as an administrator, CIMCO Machine
files are located under your C:\Users\<username>\AppData folder. The exact
location and folder structure may vary, and AppData may be a hidden folder.

11

Mastercam 2017 Transition Guide Handling Remaining Files

Key Mapping File

If you have customized your key mapping (KMP) file, you can bring this file into
Mastercam 2017 using the following procedure.
1. Copy your mastercam.kmp file located in your ..\Documents\my
mcamx9\CONFIG into your ..\Documents\my mcam2017\ CONFIG
folder.
2. Open Mastercam 2017 and click File, Options.
3. On the Quick Access Toolbar page, click Customize next to Keyboard shortcuts.

12

Mastercam 2017 Transition Guide Handling Remaining Files

4. In the Customize Keyboard dialog box, click Reset All. Your custom key mapping file will overwrite the Mastercam 2017 key mapping file.

Miscellaneous Files
Miscellaneous files include:
l Graphics files (JPG, BMP, etc.)
l NC and NCI files
l Native format files from other applications (DWG, STL, etc.)

Copy these file types from their location in the X9 structure to a corresponding location within the Mastercam 2017 structure. They do not need to run through any
kind of update process.

13

Mastercam 2017 Transition Guide Handling Remaining Files

Migrating files without changing locations

Use the Migration Wizard to update files in non-standard locations without changing their location. Select File, Convert, and then click Migration Wizard. Choose
Advanced to see which file types are supported. On the File Locations page,
select Use source folder as destination folder.
This should complete your transition to the latest version of Mastercam. Launch
Mastercam 2017 and enjoy the upgrades and enhancements.

14

Mastercam 2017 Transition Guide If You Need More Help

IF YOU NEED MORE HELP

For assistance with installing Mastercam 2017, its HASP or NetHASP, or to obtain
more information on using Mastercam 2017, contact your local Mastercam
Reseller. If your Mastercam Reseller is unavailable, you can call CNC Technical Support Services Monday through Friday, 8:00 a.m.5:30 p.m., USA Eastern Standard
Time.
When calling CNC Software for technical support, please follow these guidelines:
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 Ser-

vices 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 for CNC Support Services 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, such as part and post files

15

Mastercam 2017 Transition Guide If You Need More Help

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

Address

CNC Software, Inc.

671 Old Post Road
Tolland, Connecticut, 06084-9970
USA

Phone

(860) 875-5006

Fax

(860) 872-1565

FTP Address

ftp://ftp.mastercam.com

Internet Address

http://www.mastercam.com

Email

support@mastercam.com

Mastercam 2017 Documentation

Mastercam installs the following documents in the \Documentation folder of
your Mastercam 2017 installation:
l Whats New in Mastercam 2017
l Mastercam 2017 Installation Guide
l Mastercam 2017 Administrator Guide
l Mastercam 2017 Transition Guide
l Mastercam 2017 Quick Reference Card
l Mastercam 2017 ReadMe

16

Mastercam 2017 Transition Guide If You Need More Help

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

17

ATTENTION! UPDATES MAY BE AVAILABLE.

PLEASE REFER TO MASTERCAM.COM/SUPPORT FOR
THE LATEST DOWNLOADS.