02 Installation Gibbscam v12
02 Installation Gibbscam v12
Installation
Proprietary Notice
This document contains proprietary information of 3D Systems, Inc. (“3DS”) and is to be used only
pursuant to and in conjunction with the license granted to the licensee with respect to the
accompanying licensed software from 3DS. Except as expressly permitted in the license, no part of this
document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into
any language or computer language, in any form or by any means, electronic, magnetic, optical,
chemical, manual or otherwise, without the prior expressed written permission from 3DS or a duly
authorized representative thereof.
It is strongly advised that users carefully review the license in order to understand the rights and
obligations related to this licensed software and the accompanying documentation.
Use of the computer software and the user documentation has been provided pursuant to a 3DS
licensing agreement.
Copyright © 1993 – 2017 3DS. All rights reserved. The Gibbs and GibbsCAM logos, GibbsCAM, Gibbs,
Virtual Gibbs, and “Powerfully Simple. Simply Powerful.” are either trademark (s) or registered
trademark(s) of 3DS in the United States and/or other countries. All other trademark(s) belong to their
respective owners.
Portions of this software and related documentation are copyrighted by and are the property of Siemens Product
Lifecycle Management Software Inc.
Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in
the United States and/or other countries.
Contains PTC Creo GRANITE Interoperability Kernel by PTC Inc. All PTC logos are used under license from PTC
Inc., Needham, MA, USA. 3DS is an independent Software Provider.
Portions of this software © 1994–2017 Spatial Technology Inc. / Dassault Systèmes / Spatial Corp.
Portions of this software © 2001–2017 Geometric Software Solutions Co. Ltd.
Contains Autodesk® RealDWG by Autodesk, Inc., © 1998-2017 Autodesk, Inc. All rights reserved.
DMG MORI Models provided in conjunction with GibbsCAM © 2007–2017 DMG Mori Seiki Co., Ltd.
Contains VoluMill™ and VoluTurn™ by Celeritive Technologies, Inc. © 2007–2017 Celeritive Technologies, Inc. All
rights reserved.
This Product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/). This Product includes cryptographic software written by Eric Young
([email protected]).
Portions of this software © MachineWorks Ltd.
Portions of this software and related documentation are copyrighted by and are the property of Electronic Data
Systems Corporation.
Other portions of GibbsCAM are licensed from GibbsCAM licensors, which may not be listed here.
3D Systems, Inc.
Modified: Friday, September 15, 2017 11:42 AM
Contents
INTRODUCTION 6
Welcome 6
What Your Order Should Contain 6
Important Information About Security 7
INSTALLATION 13
DVD File Layout 13
Before Installing 15
If a Version of GibbsCAM Is Already Installed 16
Before Installing Network Licensing Option (NLO) 16
Before Installing With a Hardware Key 16
3
Before Installing Across a Network 18
About the Installer 18
File Locations 18
User Data Files 19
Global Data (Program Data) Files 19
Installation Files 19
Existing Communications, CutDATA and Library Files 19
User Access To AppData Folders 20
Installing the System Files 20
Step-By-Step Instructions 20
Running Multiple Instances of the Product 23
REGISTRATION 28
Registering GibbsCAM 28
Running the Registration Tool 29
Internet Registration 30
E-Mail Registration 31
Offline Registration 32
Completing E-Mail or Offline Registration 34
Registration Tools 35
Standalone Licensing Utility 36
Verifying Activation Server Connectivity 37
License Updates 37
4
RLM Web Server Interface 44
NLO Step 2 - Install the Client Software On Each Node 44
MAINTENANCE 48
Migrating from Previous Releases 48
Using the Migration Tool 48
Installing Post Packages 50
Undoing All Customizations 50
CONVENTIONS 51
Text 51
Graphics 51
5
Introduction
Introduction
l Welcome
l “Installation Changes for GibbsCAM 12” on page 7
l “System Requirements ” on page 9
l “Contacting 3D Systems GibbsCAM” on page 11
l “Links to Online Resources” on page 52
Welcome
Congratulations on your purchase of GibbsCAM 12, version 12.0, the most productive CAM
system available. This guide contains all the information you need to install the system and
begin using the software. If you have any problems with the installation procedure, contact
your reseller or the 3D Systems Technical Support department; they will be happy to assist you
with the installation process.
GibbsCAM 12 ships on dual-layer DVDs. When you insert a DVD, your language and platform
should be automatically detected. (A different installer is available for each supported language.)
In addition, customers who are current on Maintenance can download the appropriate installer
from the Gibbs Online Services website, https://online.gibbscam.com.
The contents of the DVD are accessed through an interface that should launch when the DVD
is inserted. For information on this tool, see “DVD File Layout” on page 13.
Your order contains a Product Code. In the registration process, the Product Code and other
information are supplied to obtain a license file. Licensing is secured by hardware key or
Network License Option (NLO). At first startup, GibbsCAM will prompt you to supply the
license file. All steps in this process are thoroughly explained in “Registration” on page 28.
If you want to migrate settings and preferences from a installation of GibbsCAM, run the
Migration Tool before running the newly installed release for the first time. For complete
information, see “Migrating from Previous Releases” on page 48.
6
Introduction
These dual-layer DVDs (also called the “product media”) contain GibbsCAM software for all
product modules and options as well as documentation, sample part files, training videos,
and extra software. For more information, see “DVD File Layout” on page 13.
In addition, all new customers will receive a USB hardware key.
Installation
Installation Media and Gibbs Online
GibbsCAM v12.x software is delivered on multiple dual-layer DVDs for most languages. When a
release is first issued on DVD, its installer executables are identical to the installer executables
posted to Gibbs Online. As modifications occur, the Gibbs Online versions will be updated.
7
Introduction
Folder/File Organization
The layout of GibbsCAM files installed on your machine is standardized. For example, binary
executables are separated from resource files. For details, see “File Locations” on page 18.
8
Introduction
Packager
You can easily create and use package files (*.gcpkg) containing a GibbsCAM part and the
transportable portion of the environment that the part requires or expects.
For more information, see the Common Reference guide, section “Pack and Go”.
Update Notifier
When GibbsCAM first starts, it checks for updated releases (if an Internet connection is
available). If a later version of GibbsCAM is available, a message dialog appears:
• If you are current on Maintenance, the message prompts you to visit a web page where you
can see information about the update and decide whether to download and install it. The
update system will never automatically install any software.
• Otherwise, the message tells you that Maintenance is required if you want the latest version.
System Requirements
The requirements to run GibbsCAM do not have specific values. The requirements vary
depending upon the operating system you use and the complexity of your part. We have a list of
basic guidelines, seen below, that are common to all users. We also offer minimum supported
requirements based upon your operating system, and we describe a recommended system.
Operating Windows 7, Windows 8.1, Windows 10, or Windows Vista (SP1 or SP2); or
System Windows Server (2008 • 2008 R2 • 2012). A 64-bit OS platform is required. Please
install the latest available OS service packs and patches through Windows
Update.
9
Introduction
Microsoft This release requires two versions of Microsoft .NET Framework: 3.5 and 4.0. Most
.NET machines will already have one or both of these (for example, if Office is installed), but if
Framework either is lacking, then the GibbsCAM installer will tell you what is needed.
Hardware Minimum system requirements depend on the operating system. There are also
recommended hardware requirements. Please remember that the more complex a
part, the higher your system requirements.
Video Please install the latest available driver for your video card. The standard Windows
Drivers drivers are typically not adequate, because of the GibbsCAM application’s advanced
use of OpenGL and video RAM. We strongly recommend that you keep your system
up-to-date with fully installed and updated drivers.
Network The Network Licensing Option (NLO) can be set up on 64-bit versions of any of the
Licensing following platforms: Windows Server (2008 • 2008 R2 • 2012); Windows Vista (SP1
or SP2); Windows 7, 8, or 10.
Minimum Requirements
The requirements for running GibbsCAM on these systems — 64-bit Windows
Vista / 7 / 8.1 / 10 or 64-bit Windows Server 2008 / 2008 R2 / 2012 — are as follows.
CPU • Intel Core 2 or newer. This includes Core i3 / i5 / i7 / i9, Xeon, Pentium dual-
core, and Celeron (1.7 GHz or faster)
• AMD Athlon 64 or newer. This includes Ryzen, FX, Opteron, Epyc, Phenom,
Turion, and Sempron.
• Please note that all 64-bit CPUs meet our minimum requirements.
10
Introduction
Recommended System
A computer that matches or exceeds the following requirements will run GibbsCAM very
comfortably. Please note that the larger or more complex your parts are, the more
GibbsCAM will demand from your system.
Technical Support
Technical Support is available to all users. Our Technical Support department is available to
answer your questions Monday through Friday, 5:00AM to 5:00PM Pacific Time.
When contacting the Technical Support department, it is helpful if you know the following
information:
• Type of computer
• Operation system
• Amount of memory
11
Introduction
12
Installation
Installation
l DVD File Layout
l “Before Installing” on page 15
l “About the Installer” on page 18
l “File Locations” on page 18
l “Installing the System Files” on page 20
Activation Check\ Contains the ActivationCheck utility for testing the connection to the
License Activation Server.
Drivers\ Subfolders contain executables and information for installing hardware key
drivers for [Aladdin] HASP keys and for [Sentinel] Rainbow keys.
13
Installation
Installers\ Contains files for installing GibbsCAM 12, v12.0. For more information,
see “Installing the System Files” on page 20.
Predator\ Contains files for installing a version of the Predator CNC Editor and
Predator Virtual CNC Viewer.
The version of Predator software that is included on the GibbsCAM 12
DVD is a light version of the product. When you install the light
version, use the serial number “LIGHT” to activate it. The light version
is a very functional editor with no limitation on the size of the edited
file. To understand the differences between the light version and the
full-function version, see the Predator CNC Editor Feature Grid
PDF file in the Extras\ folder. Please visit http://www.predator-
software.com for more information or if you are interested in
upgrading to the full-function version of the product.
Samples\ Contains sample part files, Machine Sim models, custom MDDs, and similar
files. These files require a significant amount of hard disk space. Sample part
files are also available from https://online.gibbscam.com.
Tools\ Contains files for special installations on machines that might not run
the GibbsCAM application:
14
Installation
Before Installing
Before you install the software, ensure that you meet the system requirements and that you
have installed the most recent service pack for your operating system and the latest drivers for
your video card.
At some point before installing the new software, be sure to review the Release Notes (available
online from http://www.GibbsCAM.com) to check for any last-minute information.
15
Installation
• Before starting a newly installed version of GibbsCAM, users may want to run the Migration
Tool to migrate their settings and preferences from a previous release. The installation
process ends with a link to Migration Tool.
16
Installation
Most users have the Rainbow Sentinel hardware key licensing scheme, which is a square, tan
parallel port key or a purple USB key that gets attached to the computer.
Newer users may have the Aladdin HASP hardware key which is a white parallel port key or a
very dark purple USB key.
The time-based system is also a HASP key but is either a blue parallel port key or a black USB
key.
l If you use the HASP key, please do not use the “HASP HL” drivers. Please use the
“HASP4” drivers. The HL drivers cause an incompatibility with the GibbsCAM system.
Unfortunately this is beyond our control as the incompatibility can be from hardware,
software, or the OS. If you have installed the HL drivers please download and install the
HASP Device Driver GUI Installation drivers from here:
www.aladdin.com/support/hasp/hasp4/enduser.aspx.
USB Key
If you use a USB key,place it into a USB port on your computer when you install the GibbsCAM
software. The key can be hot-swapped. USB ports do not allow more than one device to be
plugged into a port. You can purchase a USB hub to provide additional ports.
17
Installation
File Locations
The GibbsCAM installer writes files to three different locations, because different kinds of data
are accessed for different purposes:
• User data changes with each user.
• Global data applies to all users.
• Install data includes generic data and Reporter templates.
The installer is the only program that writes install data. The installer and the GibbsCAM
application write global data and install data. However, if the installer is re-run, it will not affect
user data and global data files that have been changed by the application.
Folders containing the three types of data are detailed below. If you customize these files or
upgrade your version of GibbsCAM frequently, accessing and copying these files can become
quite important. The GibbsCAM Migration Tool is the preferred method for migrating settings
and preferences from previous GibbsCAM releases.
The following table shows the folder hierarchy.
18
Installation
Installation Files
Installation files are read-only. They include generic versions of Global and User data files as
well as Reporter Templates, which are located in the...\PlugIns\Data\Report\ folder. If you
create custom reports, they should be placed in this folder.
Only users with Administrator privileges can migrate installation files from a previous release
using the Migration Tool, and not all installation files can be migrated.
19
Installation
new version is installed you can copy protocol.txt, material.txt and the Library\ folder
to the new GibbsCAM folder.
Step-By-Step Instructions
The following instructions assume you want to use the fully interactive installation wizard. If,
instead, you prefer to install non-interactively without the wizard, see “Unattended (Quiet)
Installation Mode” on page 24.
20
Installation
This release requires two versions of Microsoft .NET Framework: 3.5 and 4.0. Most
machines will already have one or both of these (for example, if Office is installed), but if
either is lacking, then the GibbsCAM installer will tell you what is needed. If you need either
or both, they are available for download from the Microsoft website.
5. In the Ready to Install step, click Install.
If prompted by the User Account Control to use administrator privileges, click Yes.
21
Installation
When GibbsCAM is installed, a dialog asks permission regarding the collection of usage
statistics. These consist of general technical data (such as OS platform and graphics subsystem)
as well as software module statistics that are specific to GibbsCAM, such as frequency of
library/module calls and GibbsCAM software performance. No personally identifiable
information is ever collected (such as company name or user name, computer or network ID,
or the like), and no information on part design or part names is ever collected. Information is
never collected without permission, and permission can be withheld either by the system
administrator or (if the administrator allows it) by GibbsCAM.com users.
At installation time — or at any other time by running Bin\GCStatsAdmin.exe — the
administrator chooses whether to opt in or out of usage data collection, and also specifies
whether or not to permit individual users to override the administrator’s choice.
If users have this permission, they can exercise it as a preference: File > Preferences, Interface
tab, Usage Statistics button. Any changed setting takes effect immediately upon clicking the OK
button.
6. The final question to answer is whether to launch Migration Tool after installation. The
default is yes, to help remind you to migrate your old settings and preferences before
starting the new version of GibbsCAM software. For more information on Migration Tool,
see “Migrating from Previous Releases” on page 48.
7. Click Install, and allow When the installation is complete, click Finish to close the setup.
22
Installation
If you are installing GibbsCAM for the first time, you must register the software. If you are
upgrading from a pre-10.5 release of GibbsCAM, you must re-register the first time you install
v10.5 or later. For more detailed information on registering the software, see “Registering
GibbsCAM” on page 28.
Reminder: For best results migrating settings and preferences from a previous release, each user
should run the Migration Tool before starting a newly installed version of GibbsCAM. For more
information, see “Migrating from Previous Releases” on page 48.
23
Installation
Please Note: The most useful switches and options require administrator privileges. To
open a Command Prompt with administrator privileges, right-click the cmd.exe program
and choose Run as administrator.
Also: If you use PowerShell instead of Command Prompt, be aware of the need to escape
each doublequote (") character by prepending a grave accent (`); for example, the
PowerShell version of
"C:\Program Files\[...]"
would be
`"C:\Program Files\[...]`".
Examples
• To install to a location other than the default ("C:\Program Files\[...]"), use the
INSTALLLOCATION property. For example, to install quietly in D:\GibbsCAM_Test\, enter
24
Installation
Note that the INSTALLDIR and TARGETDIR parameters do not work with this type of .msi
file, and so INSTALLLOCATION is required instead.
• To install one feature in addition to GibbsCAM, use the ADDLOCAL parameter with
MainFiles. For example, to install the SOLIDWORKS add-in along with GibbsCAM:
msiexec /i "<path>\GibbsCAM12_[...].msi" /qn ADDLOCAL=MainFiles,SolidWorksAddIn
25
Installation
KeyCreator8Addin KeyCreator 8
KeyCreator9Addin KeyCreator 9
Caveats
Because of third-party vendor requirements, some GibbsCAM prerequisites cannot be installed
using the GibbsCAM .msi file, but are instead contained within the GibbsCAM .exe file and
extracted to a user data folder (such as C:\Users\<LoginName>\AppData\Local\Temp\...\Disk1\).
Their names, purposes, and quiet-mode installation commands are provided below.
Any of the following that has already been installed does not need to be re-installed:
• Name: SQL Server Compact Edition
Purpose: Needed for proper toolholder support.
Quiet install command: msiexec /i SSCERuntime_x86-ENU.msi /quiet
• Name: SQL Server Compact Edition, 64-bit
Purpose: Needed for proper toolholder support on 64-bit GibbsCAM only
Quiet install command: msiexec /i SSCERuntime_x64-ENU.msi /quiet
• Name: Sentinel hardware key driver
Purpose: Needed only if your GibbsCAM software is secured using Sentinel Rainbow keys.
Quiet install command:"Sentinel Protection Installer 7.6.3.exe" /S /v/qn
• Name: HASP key drivers
Purpose: Needed only if your GibbsCAM software is secured using HASP keys.
Quiet install command: haspdinst.exe -i -nomsg
26
Installation
The sample package for Custom Drill Cycles provides a good example. A sample set of macros is
available to illustrate custom drill cycles for Variable Peck.
These macros, along with the custom MDDs to support them, can be downloaded from the
Macros wiki (https://macros.GibbsCAM.com). For example, in the web page for the category
Custom_Drill_Cycles, you can download the following items.
• Example macros for: Variable-peck drilling by Distance or Percentage; Fagor style variable-
peck drilling; Pecking/drilling of Tapered squares; and Peck chamfering.
• MDDs (*.mdd files) supporting custom drill cycles for: 3-axis vertical mill, 5-axis vertical
mill, and 2-axis horizontal lathe.
• Sample parts (*.vnc files) illustrating the use of custom drill cycles.
• A single *.zip file containing all the files mentioned above.
Installing a sample package for custom drill cycles is simple. In your global data folder (such as
C:\ProgramData\3D Systems\GibbsCAM\11.<x>.<y>.\):
1. Under its Macros\ folder, create new subfolder CustomDrillCycles\ and move the
Gibbs.*.Generic\ folders into it.
2. Change to its MDD\ folder and move the sample *.mdd files into it.
3. Place the sample part files (*.vnc) wherever you like.
After your
C:\ProgramData\...\Macros\CustomDrillCycles\Gibbs.PeckDistance.Generic\ folder
is populated and your C:\ProgramData\...\MDD\ folder contains the sample MDD referenced
by the part, simply open a sample part and look at each of its processes. For example:
• In the 3-axis Mill part, Mill3a.vnc, the Holes process dialog’s Drill tab offers a pull-down of
custom drill cycles under Entry/Exit Cycle when the bottommost option button is selected. To
view or adjust parameter values, click User Cycle Data.
• In the Lathe part, Lathe2a.vnc, the Holes process dialog offers a pull-down of custom drill
cycles under Entry/Exit Cycle when the bottommost option button is selected. To view or
adjust parameter values, click the User Cycle Data the button.
• In the 5-Axis part, Mill5a.vnc, the Drilling Options tab shows pull-down options when
Custom Cycle is selected. To view or adjust parameter values, click the Define Custom Data
button.
27
Registration
Registration
• Registering GibbsCAM
• “Registration Tools” on page 35
• “License Updates” on page 37
Registering GibbsCAM
When a fresh installation of GibbsCAM is first started, it reports that no license file is found.
After registration is complete, however, GibbsCAM will continue on to run as usual.
The License Installation or License Update dialog lets you drag a license onto the dialog for
application installation, browse the computer for a license file, or run the Registration Tool to
obtain a license file through the Gibbs Activation Service.
28
Registration
• If you already have a license file for v11 or earlier, however, you can simply drag and drop it
onto this dialog, or click Browse for your license file on this computer... to navigate to it and
select it.
Reseller Activation - If your Reseller will be assisting you with your installation,
have your registration files (and hardware keys, if any) ready in advance.
29
Registration
4. Complete your registration using one of the following methods. If you do not have an e-mail
account, enter the e-mail address of your reseller.
Internet Registration
If the Registration Tool determines that the computer can directly contact the Gibbs Activation
Service, the final page of the Registration Tool lets you click Finish to automatically obtain a
license file.
30
Registration
E-Mail Registration
If the Registration Tool determines that the computer cannot directly contact the Gibbs
Activation Service but has access to e-mail, the final page of the Registration Tool lets you click
Finish to send the license registration data to Gibbs as an e-mail attachment.
Clicking the Finish button will bring up an e-mail form page using your default e-mail program.
31
Registration
Follow the e-mail program's directions to send the license registration data. 3D Systems
GibbsCAM will process your license registration as quickly as possible. When you receive it, see
Completing E-Mail or Offline Registration.
Offline Registration
If the Registration tool determines that the computer cannot directly contact the Gibbs
Activation Service and lacks access to e-mail, then the Registration Tool will prompt you to click
Finish to save license registration data to a file:
32
Registration
When you click Finish, the Save As dialog prompts you to save your license registration data to a
file:
After you save your registration data file, you can send it to 3D Systems GibbsCAM in several
ways:
A computer If you have access to a computer with e-mail access, e-mail the file to
with e-mail [email protected].
access
Your Reseller Your reseller may be able to assist you in your activation. If your Reseller can
assist you, have your registration files and (and hardware keys, if any) ready
in advance.
Regular Mail Copy the registration file to a CD, flash drive, DVD or floppy disk and mail it
to:
33
Registration
GibbsCAM Support
c/o 3D Systems
323 Science Drive
Moorpark, CA 93021 USA
Note: Please allow adequate time for your license file to be returned to you.
Your media will not be returned.
6. You can either drag and drop the license file onto that dialog or click the Browse for your
license file on this computer… link, which opens a dialog that lets you navigate to the file and
select it:
34
Registration
7. After you locate and open the license file, you should see a message dialog resembling the
following:
8. When you click OK, GibbsCAM starts; your installation of GibbsCAM 12 has been
authenticated.
Registration Tools
Two registration utilities are provided:
• RegistrationTool.exe — See Standalone Licensing Utility
• ActivationCheck.exe — See “Verifying Activation Server Connectivity” on page 37
35
Registration
The Licensing Utility allows you to send license registration data and obtain and manage
licenses for several different types of GibbsCAM installations:
• The Hardware Locked type is equivalent to the license installation from running GibbsCAM
from a non-NLO GibbsCAM installation.
• The Network License Client type is equivalent to the license installation from running
GibbsCAM from an NLO GibbsCAM installation.
• The Network License Server type installs the NLO server and license to a folder you specify.
• The Hardware Locked (offline) type installs a non-NLO client license to a folder you specify.
This may be useful when pre-generating licenses for computers that may not have Internet
access and can only be used with removable hardware key licenses. To generate an offline
license, follow these steps:
a. Specify a deployment destination for the offline license in Licensing Utility
36
Registration
b. Attach the hardware key that you intend to use on the offline computer.
c. Click the Run Registration Tool... link and generate the offline license file following
instructions in “Running the Registration Tool” on page 29. This action generates a
license file in the specified folder.
d. Move the generated license-x.xxx.lic file to the offline computer.
e. Start GibbsCAM.
f. Drag and drop the license file onto the GibbsCAM License Installation dialog (or use the
Browse for your license file on this computer... link).
License Updates
If you need to update or change your license file to add options to your license, you can connect
to the Gibbs Activation Service from the File > Preferences dialog, Interface tab.
37
Registration
Click the License Update button to open the Update Registration dialog.
To update your Product key and license, follow the steps for “Running the Registration Tool” on
page 29.
38
About Network Licensing
39
About Network Licensing
Installing the Network License option (NLO) is a two-phase process: First, you set up the server;
then, you install the client software on each node. For condensed steps, see below; for details,
see “NLO Step 1 - Setting Up The Server” on page 40.
40
About Network Licensing
4. In the License Server Manager dialog, if the service is installed and running, click Stop
Service and then click Uninstall Service to remove the service from the license-server machine.
Then close the License Server Manager.
5. Close the GibbsCAM Licensing Utility v1.xx.y dialog.
41
About Network Licensing
4. In the second screen, enter your registration information and click Next.
5. The final screen allows you to save or e-mail the data, or to go back to make changes. When
you are done, click Finish to register your license over the Internet.
42
About Network Licensing
Make note of the machine’s Host Name as shown above. It will be helpful in
checking the status of the server.
43
About Network Licensing
Launching the server from a Command Prompt provides information on the hostname, the
license filename, port numbers, and the ISV executable and options file (gibbsnet.exe and
gibbsnet.opt).
44
About Network Licensing
The license data will be retrieved from the Gibbs Activation Service and placed in the
appropriate Activation Data folder.
4. Repeat the previous steps (installing the GibbsCAM software and registering the product
code) for each GibbsCAM client of the license server machine.
45
About Network Licensing
In order to specify the port number, you must also specify an options file for this ISV server.
Once you have specified the port number, instruct your firewall to allow connections to
both the port number on the SERVER line (for RLM) and the port numbers on any ISV lines.
• Question: When starting RLM, I get the message “(RLM) Cannot bind Web Server port <####>,
exiting”. What is the problem and solution?
Answer:That error message generally indicates that another copy of RLM is already running
and using that port (previously 9000, now 5054) as its web server port.
Check your system for other running copies of the RLM server, and if they should not be
running, stop them, then re-start the RLM server.
Another possible problem is that another program is using the port. You can use the
netstat command to see if another program is using this port.
• Question: RLM gives the following error message when attempting to install itself as a service
on Vista from an account with administrator privileges: “Error: Access to Service Control
Manager denied”. What is the problem and solution?
Answer: Launch a Command Processor window (using “Run as administrator”), and install
RLM from the new command window. “Run as administrator” is an option when you right-
click the Windows Command Processor icon on the desktop or in the Start menu.
• Question: By default, RLM Web Server allows open access to all commands. I need to restrict
access to some server functions. How can I do that?
Answer: The RLM options file allows control over access to the status, reread, shutdown
administration commands as well as control over the editing of options files. Options are
provided to allow (INCLUDE or INCLUDEALL) or to disallow (EXCLUDE or EXCLUDEALL)
administration command usage. Additionally, options are provided to create groups of users
(GROUP) or hosts (HOST_GROUP).
In addition, the RLM options file allows you to turn off logging of status requests via the
NOLOG option.
The RLM options file is called rlm.opt. It should reside in the directory from which you run
the RLM executable, rlm.exe.
There are five privileges that can be controlled in the RLM options file. Each privilege is
specified with the appropriate privilege name.
RLM privileges controlled by the RLM options file
46
About Network Licensing
By default, all privileges are granted to all users unless otherwise restricted in the RLM
options file.
Note that the RLM web interface does not have access to the username (however, the
rlmutil utilities do pass the username), so, to be most effective, command restrictions
should be done based on hostname or IP addresses. By default, all commands are enabled
(unless disabled with the -x rlmdown or -x rlmremove rlm startup options, in which case
RLM options have no effect.).
Legal characters in the RLM options file
In general, all options file fields are white-space delimited, meaning that no data item can
contain embedded spaces, tabs, newlines or carriage returns. In addition, the following
characters are illegal in data items in the ISV or RLM options (and license) file: “<”, “>”, “&”,
single quote (' or ‘ or ’), back-quote (`) and double-quote (" or “ or ”).
Note that everything in the RLM options file is case-insensitive.
Example of an RLM options file
In the following example RLM options file, status commands are only allowed from hosts
on subnet 172.16.7.*, no one on the host named excluded_host can perform a reread
command, and only users on IP address 172.16.7.93 can perform a shutdown:
47
Maintenance
Maintenance
The following are miscellaneous topics that can be helpful in some circumstances after you
have installed GibbsCAM.
• Migrating from Previous Releases
• “Installing Post Packages” on page 50
• “Undoing All Customizations” on page 50
48
Maintenance
2. The second dialog shows you the files that can and cannot be copied forward to the current
release. Appropriate restrictions are respected if Administrator privileges are lacking.
49
Maintenance
• VMMs are extracted to the VMM\ subfolder of the global data folder — normally
C:\ProgramData\3D Systems\GibbsCAM\<version>\VMM\
• Post files are extracted to the Posts\ subfolder of the global data folder — normally
C:\ProgramData\3D Systems\GibbsCAM\<version>\Posts\
• Certain other special-purpose files (such as .txt files for GCode Files\ and macro files for
CustomDrillCycles\) are also extracted to the correct folders.
When a post package is installed in this way, if the target folder already contains .mdd or .vmm
files with identical names, the pre-existing versions are overwritten.
50
Conventions
Conventions
GibbsCAM documentation uses two special fonts to represent screen text and keystrokes or
mouse actions. Other conventions in text and graphics are used to allow quick skimming, to
suppress irrelevancy, or to indicate links.
Text
Screen text. Text with this appearance indicates text that appears in GibbsCAM or on your
monitor. Typically this is a button or text for a dialog.
Keystroke/Mouse. Text with this appearance indicates a keystroke or mouse action, such as
Ctrl+C or right-click.
Code. Text with this appearance indicates computer code, such as lines in a macro or a
block of G-code.
Graphics
Some graphics are altered so as to de-emphasize irrelevant information. A “torn” edge signifies
an intentional omission. Portions of a graphic might be blurred or dimmed to highlight the
item being discussed. For example:
Annotations on a graphic are usually numbered callouts (as seen above), and sometimes include
green circles, arrows, or tie-lines to focus attention on a particular portion of the graphic.
Faint green borders that outline areas within a graphic usually signify an image map. In online
help or a PDF viewer, you can click a green-bordered area to follow the link.
51
Links to Online Resources
52