Mathcad 15 Administration Guide
Mathcad 15 Administration Guide
Administrator’s Guide
July 2011
i
Mcad_AdminGuide.book Page ii Tuesday, May 3, 2011 8:38 AM
Copyright © 2011 Parametric Technology Corporation and/or Its Subsidiary Companies. All Rights Reserved.
User and training guides and related documentation from Parametric Technology Corporation and its subsidiary companies
(collectively "PTC") are subject to the copyright laws of the United States and other countries and are provided under a license
agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the licensed software user the
right to make copies in printed form of this documentation if provided on software media, but only for internal/personal use and in
accordance with the license agreement under which the applicable software is licensed. Any copy made shall include the PTC
copyright notice and any other proprietary notice provided by PTC. Training materials may not be copied without the express
written consent of PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including
electronic media, or transmitted or made publicly available by any means without the prior written consent of PTC and no
authorization is granted to make copies for such purposes.
Information described herein is furnished for general information only, is subject to change without notice, and should not be
construed as a warranty or commitment by PTC. PTC assumes no responsibility or liability for any errors or inaccuracies that may
appear in this document.
The software described in this document is provided under written license agreement, contains valuable trade secrets and
proprietary information, and is protected by the copyright laws of the United States and other countries. It may not be copied or
distributed in any form or medium, disclosed to third parties, or used in any manner not provided for in the software licenses
agreement except with written prior approval from PTC.
UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL DAMAGES AND
CRIMINAL PROSECUTION. PTC regards software piracy as the crime it is, and we view offenders accordingly. We do not
tolerate the piracy of PTC software products, and we pursue (both civilly and criminally) those who do so using all legal means
available, including public and private surveillance resources. As part of these efforts, PTC uses data monitoring and scouring
technologies to obtain and transmit data on users of illegal copies of our software. This data collection is not performed on users
of legally licensed software from PTC and its authorized distributors. If you are using an illegal copy of our software and do not
consent to the collection and transmission of such data (including to the United States), cease using the illegal version, and contact
PTC to obtain a legally licensed copy.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright notice, of your
PTC software.
ii Chapter <C#>
Mcad_AdminGuide.book Page iii Tuesday, May 3, 2011 8:38 AM
Contents
About the Administrator’s Guide
How to Read This Manual 1
For the System Administrator 1
For the End User 1
Other Sources of Information 2
Technical Support 2
Comments 2
Installing Mathcad
Using PTC.Setup for Installation 7
Selecting Product Features 7
Starting PTC.Setup 7
License Management
License Management 11
About License Management 11
Obtaining a License File 11
iii
Mcad_AdminGuide.book Page iv Tuesday, May 3, 2011 8:38 AM
Borrowing Licenses 22
iv
iv
Mcad_AdminGuide.book Page 1 Tuesday, May 3, 2011 8:38 AM
Before You Install An introduction to the concepts covered and terminology used
in this manual (see page 3).
Before You Install An introduction to the concepts covered and terminology used
in this manual (see page 3).
lmtools Launches the FLEXnet utility LMTOOLS, similar to the shortcut icon
created in Start > Programs > PTC License Management tools.
Functionality includes customer configuration of the license service,
starting and stopping the lmgrd license server(s), server and licensing
status, as well as diagnostic tools. lmutil provides the same functionality
as command-line arguments.
lmutil Provides optional arguments to check the server and licensing status.
Refer to the FLEXnet Licensing End User Guide.
ptcflush Releases licenses. This may be necessary if there are network problems.
ptchostid Returns the Host ID, with required formatting, used for license requests.
ptcshutdown Shuts down a license server process for administrative maintenance of the
license server. On Windows systems, you can also use LMTOOLS to stop
a license server process. See “License Administration Tools” in the
FLEXnet Licensing End User Guide.
ptcstartserver Starts a license server process. On Windows systems, you can also use
LMTOOLS to start a license server process.
ptcstatus Displays information on server status and the current usage and
availability of licenses.
Order of Installation
You can elect to perform either the Mathcad install or the FLEXnet install first. In
addition, you can specify a license file or server as part of a silent install.
System Requirements
FLEXnet Server Requirements
• Windows 2000 SP4, or Windows XP Home or Professional Edition
• 16 MB free memory (for license management processes)
• 9 MB of hard disk space (not including log file)
• CD-ROM or DVD drive
• SVGA or higher graphics card and monitor
• Mouse or compatible pointing device
To serve floating and registered-user licenses, you must use FLEXnet 10.8.5 or later.
FLEXnet 10.8.5 for Windows is available on the Mathcad CD.
Note You can also use the FLEXnet executable for Linux, Solaris, or 64-bit Windows provided with
other PTC products. You cannot use a FLEXnet executable provided by another vendor, as it
does not include PTC’s vendor daemon.
Under regular usage, license administration places little load on your server or network.
The FLEXnet license daemon and PTC vendor daemon both require approximately 3
MB of memory when running. Additionally, aside from license check-out and check-
in, and periodic heartbeats sent out to verify the continued presence of the license
server, Mathcad generates no network traffic to the FLEXnet server when running.
However, as more workstations access the license server, network traffic may become
an issue, and your log file will grow more quickly.
Mathcad Requirements
• Pentium-compatible 32-bit (x86) or 64-bit (x86-64, EM64T) processor, 400 MHz
or higher; 700+ MHz recommended
• Windows XP Home SP2 or Professional Edition SP2, Windows XP Professional
x64 Edition SP2, Windows Vista, or Windows 7; Windows XP SP3, XP-x64 SP3,
Vista, or Windows 7 recommended
• Windows Installer 3.0 or later
• Microsoft .NET Framework® 3.5 or later
• MSXML 4.0 SP2 Parser and SDK (this exact version of MSXML is required)
• 256 MB of RAM; 512 MB or more recommended
• 1.75 GB of hard disk space (350 MB for Mathcad, 1.4 GB for temporary space
during installation)
• CD-ROM or DVD drive (not required for silent installations)
• SVGA or higher graphics card and monitor
• Keyboard and mouse or compatible pointing device
MSXML and the .NET Framework are available for download from the Microsoft Web
site at http://www.microsoft.com/downloads/.
Internet Explorer 5.0 and Adobe Reader 5.0 or later are required for full functionality
of the Help system. Download the software from Microsoft or Adobe respectively:
• http://www.microsoft.com/windows/products/winfamily/ie/default.mspx
• http://www.adobe.com/products/acrobat/
Upgrading from a Previous Version of Mathcad
Installing Mathcad Alongside Previous Versions
Mathcad 15 cannot be installed on a workstation currently running Mathcad 14. You
must uninstall Mathcad 14 before proceeding to install Mathcad 15. If you do not
uninstall Mathcad 14, the Mathcad 15 installation process saves your user-defined
settings, removes Mathcad 14, and then installs Mathcad 15.You can however install
Mathcad 15 alongside Mathcad 11, 12, and 13. You do not need to uninstall these
versions of Mathcad before you install Mathcad 15, nor does installing Mathcad 15
automatically remove these Mathcad installations.
FLEXnet and Upgrading from Earlier Versions of Mathcad
If you are upgrading from an earlier version of Mathcad Enterprise Edition, you must
install FLEXnet from your Mathcad CD. Both FLEXlm and the vendor daemon
provided with previous versions of Mathcad are not compatible with Mathcad 15.
Previous versions of Mathcad are compatible with the version of FLEXnet provided
with Mathcad 15. Additionally, multiple versions of FLEXnet can exist on the same
server or network. This allows you to use the current version of FLEXnet to manage
Mathcad 15 licenses, and an existing installation of FLEXlm to manage licenses for
earlier versions of Mathcad.
More information on running multiple license services is available in the FLEXnet
Licensing End User Guide.
Vendor Daemon
In addition to a license file, FLEXnet also requires a vendor daemon to properly serve
Mathcad licenses. This vendor daemon actually dispenses a license to your machine
when you start Mathcad. Without it, Mathcad cannot check out a license at start up.
The vendor daemon is provided as part of the FLEXnet install, available on the Mathcad
CD. The vendor daemon is included on the CD.
Installing Mathcad
Using PTC.Setup for Installation
Before You Proceed
Installing Mathcad with a New License
Installing Mathcad with an Existing License Server
Note When you begin an installation by clicking on the required component, an error message is
displayed if the required security privileges are not satisfied.
In the Define Installation Components screen, click before each of the product
components to choose the following commands from the list:
• Install this feature — Install the component.
• Do not install this feature — Do not install the component. changes to
if a component is not installed.
• Install all sub-features — If a product component has subcomponents, you can
install them by selecting this option. The icon changes to to indicate
that the components will be installed.
Starting PTC.Setup
If PTC.Setup does not start automatically, use one of the following procedures:
• Start Windows Explorer, browse to the folder that contains the installation program,
and double-click the setup.exe icon.
• At an MS-DOS prompt, type the following command:
<cdrom>:\setup.exe
• From the task bar, select Start > Run, and enter the following command:
<cdrom>:\setup.exe
Installing Mathcad / 8
Note Only persons with administrative privileges can install Mathcad onto a workstation. If you lack
administrator privileges for the workstation onto which you are installing, or are not sure you
have administrator privileges, contact your system administrator.
Note In order to run the software as a trial, you must obtain a license from the PTC Web site. When
the installation is complete, the License Wizard guides you through the trial licensing process.
Note The Custom installation option requires access to all Mathcad 15 installation CDs.
Installing Mathcad / 9
Note Refer to the Windchill ProductPoint Installation and Administrator's Guide for information
about ProductPoint.
16. Click Install. The installation starts and the Mathcad License Setup wizard opens.
Note In order to run the software as a trial, you must obtain a license from the PTC Web site. The
Mathcad License Setup wizard guides you through the trial licensing process.
17. Follow the instructions on the screen to complete the license acquisition process.
Note For a single and triad license server, enter the server hostname and port number and click OK.
Installing Mathcad / 10
Note If the installation is silent, an MSI file is created when you click Install.
Note All prerequisite software must be installed before performing a silent installation.
Note The installation instructions are also found in the README_MSI file that is generated
in the installation package directory.
3. Confirm that the workstation satisfies the system requirements outlined on page 5.
This includes the installation of prerequisite software.
4. Copy the contents of the customized installation package directory created in Step
2 to a shared network directory (for example, H:\silent).
5. Open a command prompt window and navigate to the directory created in Step 4.
6. Run the installation using the following command:
– msiexec.exe /I "H:\silent\Mathcad15WixInstaller.msi"
– The customized installation takes several minutes and quits without notification.
License Management
License Management
Using the License Service
Borrowing Licenses
License Management
About License Management
When launched, Mathcad searches for an available license. If available, this license is
allocated to the workstation, and Mathcad opens for use. If a license is not available,
Mathcad opens the license wizard, so you can configure your license setting.
You can use the Mathcad License Setup wizard to acquire a new license file, install
an existing license file, or configure Mathcad to use a FlexLM license server.
Note You do not need to reinstall Mathcad to reconfigure your license. Use the license wizard to
update your license information.
To start the license wizard, at a command prompt, navigate to your Mathcad installation
directory and type mathcad.exe /license.
Note You can also run the Mathcad License Setup wizard by starting the mclicens.exe program
in the mclicense folder of your installation directory.
Mathcad requires use of a license server for floating and registered-user licenses.
Locked license files reside on the workstation, and do not require a license server.
If users with server-based licenses wish to run Mathcad while disconnected from your
network — for example, on a laptop while out of the office — they can borrow a license
from the server for a limited amount of time. This borrowed license is stored on the
workstation, so Mathcad does not need to access the license server at start up. More
information on borrowing licenses is available in “Borrowing Licenses” on page 22.
Note If you have a locked or home-use license file, you do not need to install and configure FLEXnet.
Save the license file generated for you to the LICENSES folder of the Mathcad installation on the
appropriate workstation. Specify the location and name of this file when prompted by the
Mathcad License Setup wizard.
11
License Management11
Mcad_AdminGuide.book Page 12 Tuesday, May 3, 2011 8:38 AM
License Management / 12
Note The use of non-ASCII characters in the path of your license file may cause an error. When saving
your license file, use only ASCII characters in folder names.
To obtain your license files, use your PTC user account to log on to the PTC Customer
Support site at http://www.ptc.com/support/mathcad.htm. If you do not have a PTC
user account, follow the instructions on the Web site to create one. Once you log in,
click the Licensing tab and then click “Configure New Software”. Enter the Sales
Order Number to process your request. You must provide the CPU ID for each server
or workstation in your request.
To determine the CPU ID for a server or workstation:
1. Type ipconfig /all at a command prompt, and press [Enter].
2. Find the 12-digit number labelled “Physical Address,” in the form XX-XX-XX-
XX-XX-XX. Enter this number as the CPU ID.
Note The CPU ID, or MAC address, identifies the active network adapter on a workstation. Mathcad
attempts to match the CPU ID in a locked or home-use license file against all detected MAC
addresses at startup. As long as any available address matches, Mathcad launches.
After you complete your request, your licenses will arrive by email, as attachment files.
To use your licenses:
• If you ordered floating or registered-user licenses, save the license file to your
server. Then, install FLEXnet from the Mathcad CD, following the instructions in
the section “Installing the License Service” on page 13.
• If you ordered locked or home-use licenses, distribute the license files to the
corresponding workstations. Launch Mathcad on each workstation, and point the
application to the license file in the Mathcad License Setup wizard.
License Management12
Mcad_AdminGuide.book Page 13 Tuesday, May 3, 2011 8:38 AM
License Management / 13
If you intend to serve licenses from multiple servers, see “Using Multiple License
Servers” on page 18 before you obtain your license files.
Transferring a License File to Another Server or Workstation
To transfer a license file to another computer, you must de-allocate a current license,
then request the license file for the new computer. To do so, use the “Recon
Software Licenses” option available at the PTC Customer Support Web site.
Note Obtain a license file before you install FLEXnet, as the installer validates your license file.
Note When the license service (lmgrd.exe) runs, it uses C:\FLEXlm\ to store temp files related
to the licensing services. To avoid possible errors, do not install to this folder.
6. To configure the license service to start automatically the next time you reboot the
server, click FLEXnet Server Options and enable Start on Reboot. Use the
Command Line Arguments box to specify any desired startup parameters. For
information on the allowed parameters, click Command Line Arguments to open
the FLEXnet Licensing End User Guide.
7. Click Install to begin installation. You can click Cancel to terminate installation,
if necessary. If installation fails, check the log file ptcsetup.log, located in the
temp directory, for errors.
8. When installation completes, the License Service launches automatically. Click
Exit to end installation.
License Management / 14
Note If your organization already uses FLEXnet or FLEXlm to meter another application, read
“Licensing Both Mathcad and Other Applications” on page 18 before proceeding.
License Management / 15
2. On the Service/License File tab, select FLEXlm server for PTC (see Figure 1).
Figure 1: Select the FLEXlm server for PTC service to check the status of
Mathcad licenses.
3. Click Perform Status Enquiry, located on the Server Status tab. If the service has
been configured properly, you should see a status report that shows:
• The name of the license server.
• The port number used by the license service.
• The license file in use.
• The status of the server and the PTC vendor daemon.
• The number of licenses in use, and the workstation to which they are assigned.
The report indicates borrowed licenses with the word linger, followed by the
length of the borrow period, in seconds, in parentheses after the workstation
information.
4. If your status report does not return the correct information, verify that the server
has been configured properly. On the Config Services tab (see Figure 2):
• Click FLEXlm server for PTC in the Service Name list.
• Confirm the path to the licensing service daemon (lmgrd.exe, located in the
i486_nt\obj folder of your FLEXnet installation).
• Confirm the path to the license file (license.dat, located in the licensing
folder of your FLEXnet installation). If this information is incorrect, run the
ptcsetup utility to point the license service to the proper license file.
License Management / 16
• Confirm the path to the log file used by the PTC license management service.
The default is ptclmgrd.log, located in the licensing folder of your
FLEXnet installation. If your license server hosts multiple services, you should
create an individual log for each service.
• Verify that Use Services is selected.
• Double-check that paths to files are absolute and include the name of the file.
Figure 2: Use the Config Services tab to confirm the license service daemon,
license, and log file used by the “FLEXlm server for PTC” service.
License Management / 17
If you purchased a 5-seat floating Mathcad license, you could edit the options file to
add the lines:
INCLUDE MATHCAD HOST Eng1
INCLUDE MATHCAD HOST Eng2
INCLUDE MATHCAD HOST Eng3
INCLUDE MATHCAD HOST Eng4
INCLUDE MATHCAD HOST Eng5
where MATHCAD is the metered application, or feature, and Eng1, Eng2, ... are the
specific workstations allowed to use Mathcad. If you purchased two licenses for the
Signal Processing Extension Pack, and wanted to deny them specifically to Eng2 and
Eng3, you would add the following lines to the options file:
EXCLUDE 256 HOST Eng2
EXCLUDE 256 HOST Eng3
where 256 is the feature name for the Signal Processing Extension Pack. Both the
workstation and feature names are case-sensitive.
Supported FLEXnet Keywords
The vendor daemon used by Mathcad supports the full set of FLEXnet options file
keywords. The following keywords may prove useful in administering licenses:
• BORROW_LOWWATER — specifies the number of licenses that cannot be
borrowed.
• DEBUGLOG — the log file used by the vendor daemon for debug information.
• EXCLUDE — prevents access to the specified feature.
• EXCLUDE_BORROW — prevents the borrowing of a license for the specified
feature.
• EXCLUDEALL — prevents access to all features served by the vendor daemon.
• GROUP — defines a group of users for use with any options.
• HOST_GROUP — defines a group of hosts for use with any options.
• INCLUDE — allows use of the specified feature, if a valid license is available.
• INCLUDE_BORROW — allows a user to borrow licenses.
• INCLUDEALL — allows a user to use all features served by the vendor
daemon.
• MAX — limits usage for a particular feature or group, prioritizing usage among
users.
• NOLOG — turns off logging of certain items in the debug log file.
• REPORTLOG — specifies the report log file to be written. This file can be read
by SAMreport, available from Acresso Software.
• RESERVE — reserves licenses for the specified feature for the specified user
or group.
• TIMEOUTALL — allows the server to reclaim inactive licenses after a
specified number of seconds.
License Management / 18
More information on using these and other keywords is available in the FLEXnet
documentation; see “End-users of Mathcad should refer to the User’s Guide as their
primary source of information, although the following sections of this guide may be of
interest as well:” on page 1.
Customizing a Registered-user License
If you purchased a registered-user license, you are bound by the license agreement to
restrict Mathcad usage to the proper number of workstations. One way to do this is with
the RESERVE keyword:
RESERVE 1 MATHCAD HOST Eng1
This would reserve one Mathcad license exclusively for the workstation Eng1. You can
also create a group of user names or host names, using the GROUP or HOST_GROUP
keywords.
Licensing Both Mathcad and Other Applications
If you are already serving licenses for other applications with FLEXlm or FLEXnet for
Windows, you can manage licenses for all your applications from one server. Install
FLEXnet from the Mathcad CD to the server. Once installation completes, FLEXnet
displays all licenses served from the server. When configuring FLEXnet to meter
Mathcad, make sure the Mathcad license service is selected on the Config Services tab
(see Step 4 on page 15).
Tip To prevent name conflicts between Mathcad license files and those for other applications, save
your Mathcad license files to a folder named “Mathcad” within your existing license folder.
Note Do not merge your Mathcad license with licenses of other software vendors into a combined
license file for use on the same license server. Although the server can handle combined license
files, license files from PTC use a vendor-specific HOSTID, which makes them incompatible
with license files using a FLEXnet HOSTID.
License Management / 19
License Management / 20
server has the appropriate license. For example, if you wanted to use two servers to
serve licenses for another application, but only one of those servers would serve
Mathcad licenses, you would set the following two environment variables:
PTC_LICENSE_FILE=7788@Server1
[OTHERAPP]_LICENSE_FILE=27000@Server1;27000@Server2
This prevents Mathcad from querying Server2 for a license, since Server2 has no
Mathcad licenses.
License Management / 21
if necessary, re-enable or restart the service. If the service is running, verify that it
is using the license file supplied by PTC.
You may also have multiple license server processes running on the server.
Consolidate all services under one license server process, or move the Mathcad
license service to another server.
Desired vendor daemon is down (-97, 121)
Causes: The vendor daemon is missing or in the wrong location, or you made a
change to a Cadence license dongle on the server metering Mathcad.
Solution: Check that the vendor daemon is located in the same folder as the
FLEXnet daemon, lmgrd.exe; if it is not, find the file on the server and move it
to this folder. If you made a change to a Cadence license dongle, reboot the server.
Note This error may also occur if the FLEXnet daemon cannot create its temporary directory
(C:\FLEXlm), or any of the files within it.
License Management / 22
Borrowing Licenses
If you normally access a FLEXnet server for a license when you run Mathcad, but
occasionally need to use Mathcad without network access, you can borrow a license
from the server for use while disconnected from the network. Your license file specifies
the maximum allowed borrowing period.
Note A license can only be borrowed from within Mathcad. To borrow a license, you use your
FLEXlm floating license to open Mathcad and then click Tools > License > Borrow.
Borrowed licenses are checked out from the available pool until they expire, regardless
of whether the workstation using the borrowed license is running Mathcad. If you have
a pool of 25 floating licenses and borrow one, the workstations on your network can
only use the remaining 24 licenses until the borrowed license returns to the pool.
Note Borrowing a registered-user license also reduces the overall number of licenses. However, since
the license is already allocated to the workstation, it does not reduce the number of licenses
available to other users.
Mathcad automatically selects the maximum borrow period. To borrow a license for a
shorter duration, select a different return date. Click “OK” to borrow the license.
Borrowed licenses appear in the status report with the text (linger: xxxxxx) appended
to the end, where the six-digit number xxxxxx indicates the duration of the borrowing
period, in seconds. To generate a status report, read the section “Using the License
Service Utilities” on page 14.
Borrowing Licenses22