Cover Page

Installation Guide
for version 4.5.1

Copyright 2009
Mentum S.A. All rights reserved.

Notice

This document contains confidential and proprietary information of Mentum S.A.

and may not be copied, transmitted, stored in a retrieval system, or reproduced in
any format or media, in whole or in part, without the prior written consent of
Mentum S.A. Information contained in this document supersedes that found in
any previous manuals, guides, specifications data sheets, or other information that
may have been provided or made available to the user. This document is provided
for informational purposes only, and Mentum S.A. does not warrant or guarantee
the accuracy, adequacy, quality, validity, completeness or suitability for any
purpose the information contained in this document. Mentum S.A. may update,
improve, and enhance this document and the products to which it relates at any
time without prior notice to the user. MENTUM S.A. MAKES NO
WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE, WITH RESPECT TO THIS DOCUMENT OR THE
INFORMATION CONTAINED HEREIN.
Trademark Acknowledgement
Mentum, Mentum Planet and Mentum Ellipse are registered trademarks owned by Mentum S.A.
MapInfo Professional is a registered trademark of PB MapInfo Corporation. RF-vu is a trademark
owned by iBwave. WaveSight is a trademark of Wavecall. This document may contain other
trademarks, trade names, or service marks of other organizations, each of which is the property of its
respective owner.
Last updated January 9, 2009

Contents

Contents
MENTUM
PRODUCTS

List of products

CONTACTING
MENTUM

Getting technical support

Send us your comments

4
4

INTRODUCTION

Components of Mentum Planet

Using this Installation Guide
Using this documentation
Online Help
Notational conventions
Documentation library

6
6
6
7
8
10

General hardware and software requirements

Configuring .NET Security

14
15

Before installing Mentum Planet software

Workflow for installing Mentum Planet software
To install Mentum Planet
To install Mentum Planet on a terminal server
Obtaining a license
To obtain a license for Mentum Planet
To refresh a license
To view license information
Using a commuter license
To use a commuter license
Migrating Mentum Planet projects
Improved data validation
Upgrade paths
Workflow for migrating Mentum Planet projects
Upgrading Mentum Planet software

18
19
19
22
23
23
25
25
25
26
27
27
27
28
29

CHAPTER 1
System
Requirements
CHAPTER 2
Installing Mentum
Planet

Contents
Installation Guide

To upgrade Mentum Planet software

Uninstalling Mentum Planet software

29
29

Determining the best installation for your organization

Understanding the License Server
How the License Server issues licenses
System requirements
Workflow for installing the License Server and distributing licenses
To install the License Server
To uninstall the License Server
Using the License Server Management tool
To use the License Server Management tool
Workflow for using the Remote Authorization tools
To obtain the commuter locking code
To check out a remote commuter license
To install the remote authorization code
Troubleshooting
If the Licence Server is not working
If the license key does not work

34
35
35
35
36
37
39
40
40
41
41
42
43
44
44
45

CHAPTER 3
Installing and
Managing the
License Server

APPENDIX A
Citrix
Troubleshooting

47

INDEX

49

ii

Mentum Products

This chapter contains the

following section:

List of products

The Mentum Product portfolio provides a range of

products for planning and maintaining wireless
networks.
This section describes the products that are available
as part of the portfolio. For additional details about
any of these products, see the Mentum web site at
http://www.mentum.com.

Mentum Products
Installation Guide

List of products
The following table describes wireless network planning and optimization
products. The table does not provide details about specific features and tools.
For more information, see the introductory chapters in the User Guide for the
specific product or visit the Mentum web site at http://www.mentum.com.
Product

Description

Mentum Planet

A Windows-based wireless network planning and analysis tool. You can

add technologies and tools to support the planning functions that you
require. Depending on the options that you choose, Mentum Planet
provides support for the following technologies:
TDMA/FDMAGSM (including GPRS and EGPRS), IS-136, AMPS,
NAMPS, and iDEN
CDMAW-CDMA (UMTS, including HSPA), cdma2000 (including
IS-95, 1xRTT, EV-DO)

Specialized modules
Measurement
Data Package

Test mobile and scan receiver functionality that can be added to Mentum
Planet so that you can import and analyze measurement data and
increase the accuracy of predictions.

Universal
Model

Propagation model that automatically adapts to all engineering

technologies (micro, mini, small and macro cells), to all environments
(dense urban, urban, suburban, mountainous, maritime, open), and to all
systems (GSM, GPRS, EDGE, UMTS, WIFI, WIMAX) in a frequency
range that spans from 400MHz to 5GHz.

Indoor/Outdoor

Indoor/outdoor module that links Mentum Planet with iBwave RF-vu

allowing you to view and plan indoor/outdoor networks and manage RFvu projects using the Mentum Planet Data Manager.

Optimization applications

Mentum
Ellipse

An integrated software solution for the optimal planning and design of

point-to-point and point-to-multipoint radio transmission links.

Renaissance

Frequency planning tool that uses evolutionary algorithms to find the

very best frequency plan that will minimize interference across the
network.

Capesso

Optimisation tool that enables engineers to improve upon manual

optimisation techniques by allowing them to consider and adjust multiple
input parameters simultaneously. The result is a quicker and more costeffective convergence towards a 'best network' configuration.

Contacting
Mentum
This chapter contains the
following sections:

Getting technical support

Send us your comments

Mentum is committed to providing fast, responsive

technical support. This section provides an extensive
list of contacts to help you through any issues you
may have.
We also welcome any comments about our
documentation. Customer feedback is an essential
element of product development and supports our
efforts to provide the best products, services, and
support we can.

Contacting Mentum
Installation Guide

Getting technical support

You can get technical support by phone or email, or by going to
http://www.mentum.com/index.php?page=customer-care&hl=en_US. Email
is the best way of getting technical support.
North America
Phone: +1 866 921-9219 (toll free), +1 819 483-7094
Fax: +1 819 483-7050
Email: [email protected]
Hours: 8am 8pm EST/EDT (Monday-Friday, excluding local holidays)
Europe, Middle East, and Africa
Phone: +33 1 39264642
Fax: +33 1 39264601
Email: [email protected]
Hours: 9am 6pm CET/CEST (Monday-Friday, excluding local holidays)
Asia Pacific
Phone: +852 2824 8874
Fax: +852 2824 8358
Email: [email protected]
Hours: 9am 6pm HKT (Monday-Friday, excluding local holidays)

When you call for technical support, ensure that you have your product ID
number and know which version of the software you are running. You can
obtain this information using the About command from the Help menu.
When you request technical support outside of regular business hours, a
Product Support Specialist will respond the next working day by telephone or
email, depending upon the nature of the request.

Send us your comments

Feedback is important to us. Please take the time to send comments and
suggestions on the product you received and on the user documentation
shipped with it. Send your comments to:
[email protected]

Introduction

This introduction contains the

following section:

Components of Mentum
Planet

Using this Installation Guide

Using this documentation

This Installation Guide is intended for Mentum

Planet software. This chapter outlines the core
components that are installed with Mentum Planet
and details how to use the documentation.

Introduction
Installation Guide

Components of Mentum Planet

The following table lists the core components of Mentum Planet. For a
complete list of available technologies and tools, see the Mentum web site at
http://www.mentum.com.
Software

Components

Mentum
Planet

Mentum Planet softwareoffers a complete network design

solution allowing you to design and optimize wireless networks.
Data Managerenables you to centralize data and gives you the
ability to share projects and files.
Data Manager Serverworks in tandem with the Data Manager
software to provide greater administrative control of Data
Manager projects and to reduce resource overhead on individual
users computers.
Documentation setcomprises a comprehensive online Help
system that includes a Resource Roadmap, context-sensitive
help for all dialog boxes, detailed procedures, and links to related
information. The documentation set also includes print-ready
searchable PDF files of the User Guides, Technical Notes, and
the Glossary.
MapInfo Professional softwareenables you to take advantage
of the spatial analysis capabilities of MapInfo.

Using this Installation Guide

The Mentum Planet software uses a License Server to distribute licenses. This
Installation Guide details how to install the Mentum Planet software and how
to install and manage the License Server.
For information on how to install the Mentum Planet Data Manager Server,
see the Data Manager Server Administrator Guide.

Using this documentation

Before using this documentation, you should be familiar with the Windows
environment. It is assumed that you are using the standard Windows XP
desktop, and that you know how to access ToolTips and shortcut menus, move
and copy objects, select multiple objects using the Shift or Ctrl key, resize
dialog boxes, expand and collapse folder trees. It is also assumed that you are
familiar with the basic functions of MapInfo Professional. MapInfo
Professional functions are not documented in this User Guide. For
information about MapInfo Professional, see the MapInfo online Help and

Introduction
Installation Guide

MapInfo Professional User Guide. You can access additional MapInfo user
documentation from the MapInfo website at www.mapinfo.com.
All product information is available through the online Help. You access
online Help using the Help menu or context-sensitive Help from within a
dialog box by pressing the F1 key. If you want to view the online Help for a
specific panel or tab, click in a field or list box to activate the panel or tab
before you press the F1 key. The following sections describe the structure of
the online Help.

Online Help
From the Help menu, you can access online Help for Mentum Planet software
and for MapInfo Professional. This section describes the structure of the
Mentum Planet online Help.
The online Help provides extensive help on all aspects of software use. It
provides

help on all dialog boxes

procedures for using the software

an extensive Mentum Planet documentation library in PDF

format

User Guides

The following sections provide details about the resources available through
the online Help.
Resource Roadmap

When you first use the online Help, start with the Resource Roadmap. It
describes the types of resources available in the online Help and explains how
best to use them. It includes a step-by-step guide that walks you through the
available resources.
Printing

You have two basic options for printing documents:

If you want a good quality print of a single procedure or section,

you can print from the Help window. Click Print in the Help
window.

If you want a higher quality print of a complete User Guide, use

Adobe Reader to print the supplied print-ready PDF file
contained in the Mentum Planet documentation library. Open the
PDF file and choose File Print.

Introduction
Installation Guide

Library Search

You can perform a full-text search on all PDF files contained in the Mentum
Planet documentation library if you are using a version of Adobe Reader that
supports full-text searches. The PDF files are located in the
Mentum\Planet\Help\User Guides folder.
You can also perform a search on all online Help topics by clicking the
Search tab in the Help window. Type a keyword, and click List Topics to
display all Help topics that contain the keyword. The online Help duplicates
the information found in the User Guide PDF files in order to provide more
complete results. It does not duplicate the information in the Release Notes,
or Glossary.
Frequently Asked Questions

The Frequently Asked Questions section provides answers to common

questions about Mentum Planet. For easy navigation, the section is divided
into categories related to product functionality.
Whats This? Help

Whats This? Help provides detailed explanations of all dialog boxes.

User Guides

All User Guides for Mentum Planet software is easily accessible as part of the
online Help.

Notational conventions
This section describes the textual conventions and icons used throughout this
documentation.
Textual conventions

Special text formats are used to highlight different types of information. The
following table describes the special text conventions used in this document.

Introduction
Installation Guide

bold text

Bold text is used in procedure steps to identify a user interface

element such as a dialog box, menu item, or button.
For example:
In the Select Interpolation Method dialog box, choose the
Inverse Distance Weighting option, and click Next.

courier text

Courier text is used in procedures to identify text that you must

type.
For example:
In the File Name box, type Elevation.grd.

bright blue text

Bright blue text is used to identify a link to another section of

the document. Click the link to view the section.

Menu arrows are used in procedures to identify a sequence of

menu items that you must follow.
For example, if a step reads Choose File Open, you
would click File and then click Open.

<>

Angle brackets are used to identify variables.

For example, if a menu item changes depending on the
chosen unit of measurement, the menu structure would
appear as Display <unit of measurement>.

Icons

Throughout this documentation, icons are used to identify text that requires
special attention.
This icon identifies a workflow summary, which explains a series of
actions that you will need to carry out in the specified order to
complete a complex task.

This icon identifies a cautionary statement, which contains

information required to avoid potential loss of data, time, or
resources.
This icon identifies a tip, which contains shortcut information,
alternative ways of performing a task, or methods that save time or
resources.
This icon identifies a note, which highlights important information or
provides information that is useful but not essential.

Introduction
Installation Guide

Documentation library
Mentum Planet comes with an extensive library of User Guides in PDF
format. The following table provides details about the documentation
supplied with Mentum Planet.
Additional documents, including Application Notes and Technical
Notes, are available on the Mentum Web site: http://www.mentum.com.

10

Document

Enables you to

Mentum Planet User Guide

Plan and analyze simulated wireless

communication networks.

Grid Analysis User Guide

Perform operations on spatial data that is stored

in grids, and display, analyze, and export digital
elevation models (DEM) and other grid-based
data.

Indoor/Outdoor Integration User

Guide

Integrate indoor networks into Mentum Planet

and learn how to view, edit, and manage indoor
projects.

TDMA/FDMA User Guide

Plan and analyze TDMA/FDMA networks.

CDMA User Guide

Plan and analyze W-CDMA (UMTS) and

cdma2000 networks.

Data Manager User Guide

Learn how to use the Data Manager.

The Data Manager enables users to work with
centralized Mentum Planet data stored in an
Oracle or Microsoft SQL Server database.

Data Manager Server

Administrator Guide

Learn how to install and configure the Data

Manager Server on database and file servers in a
network environment, and how to manage
access to project data.

Installation Guide

Install Wireless Network Planning software.

Glossary

Search for commonly used technical terms.

Release Note

Learn about new features and known issues with

the current release of software.

Introduction
Installation Guide

Document

Enables you to

Data Manager Server Release

Note

Learn about new features and known issues with

the current release of Data Manager Server
software.

MapInfo Professional User

Guide

Learn about the many features of MapInfo

Professional, as well as basic and advanced
mapping concepts.

11

Introduction
Installation Guide

12

1.
This chapter contains the
following section:

General hardware and

software requirements

Chapter 1: System Requirements

System
Requirements
The system requirements outlined in this chapter are
general recommendations only and are based on
typical usage of Mentum Planet software. For more
detailed information on system requirements, contact
Customer Care. See Getting technical support on
page 4.

13

Chapter 1
Installation Guide

General hardware and software requirements

Table 1.1 details the workstation configuration recommended for Mentum
Planet.
For information about system requirements for the Data Manager
Server, see the Data Manager Server Administrator Guide.

Requirements vary depending on the layout of the network, the number

of sites, and the work practices you adopt.

Table 1.1 Recommended system configurations

Recommended configurations
Processor

Workstation: Pentium 4 2.0 GHz or equivalent

Laptop: Centrino 1.7 GHz or equivalent

RAM

2 GB

Display

SVGA (16-bit), 1280x1024

Operating System

Windows XP (English Edition), Windows Vista (English

Edition) or Windows Server 2003 (English Edition)
Some Automatic Updates can cause your computer to
reboot, which may interrupt operations in Mentum Planet.
It is recommended that you modify the Automatic Updates
settings so that they are not done automatically.

Required Software

In order to use the Mentum Planet Import/Export tool, you

must have Microsoft Excel 2000 or greater installed. In
addition, you must have Adobe Reader installed to view
the Mentum Planet user documentation.

An Internet connection is required to validate licenses. If there is no

Internet connection, you can complete the offline registration form and
email it to Customer Care.

To run Mentum Planet, you must be a member of the Power Users

group at a minimum. Regular Users must be granted write access
privileges to the \Program Files\Mentum\Planet\ folder to run Mentum Planet.

14

System Requirements
Installation Guide

Mentum Planet runs on the Microsoft .NET framework (version

2.0.50727.42). If you do not have this software installed on your computer, it
will be installed as part of the Mentum Planet installation.

Configuring .NET Security

In order for Mentum Planet to function properly, the .NET security on
your computer must be set to Full Trust.

Add the Administrative Tools to your Start menu if it is not already

available.

Choose All Programs Administrative Tools Microsoft .NET

Framework Wizards.

In the .NET Wizards dialog box, click Adjust .NET Security.

On the first page of the Security Adjustment Wizard, choose Make

Changes to This Computer and click Next.

Choose My Computer and, in the Choose the Level of Trust For

Assemblies in This Zone section, move the slider to Full Trust.

Click Next.

Click Finish.

15

Chapter 1
Installation Guide

16

2.
This chapter contains the
following sections:

Before installing Mentum

Planet software

Chapter 2: Installing Mentum Planet

Installing Mentum
Planet
After you have downloaded Mentum Planet from the
Web, you simply follow the prompts to install the
software. After you have installed the software, you

Workflow for installing

Mentum Planet software

must register the product to validate your license.

Obtaining a license

This chapter explains how to install Mentum Planet.

Using a commuter license

Migrating Mentum Planet

projects

For information about setting up the License Server

for the floating license installation, see Chapter 3:

Workflow for migrating

Mentum Planet projects

Installing and Managing the License Server on

Upgrading Mentum Planet

software

page 33.

Uninstalling Mentum Planet

software

17

Chapter 2
Installation Guide

Before installing Mentum Planet software

Mentum Planet, a next-generation radio planning and optimization solution, is
integrated with MapInfo Professional 9.0, an industry-standard GIS mapping
engine.
Before you install or uninstall Mentum Planet, it is important to note that you
can:

install stand-alone versions of MapInfo on the same workstation

as Mentum Planet. If you do so, however, it is the last version of
MapInfo installed that will be the default application for .tab
files. For example, if you install MapInfo 8.5 and then install
Mentum Planet 4.5, the default application will be MapInfo 9.0
(which is included with Mentum Planet). For information on
how to change this, see Installing, Configuring, and Starting
MapInfo Professional in the MapInfo Professional User Guide.

install different versions of MapInfo on the same workstation as

Mentum Planet. These installations are independent of Mentum
Planet; however, when you uninstall Mentum Planet or MapInfo
you must repair other versions of Mentum Planet or MapInfo
installed on the workstation.

install Mentum Planet 3.x and Mentum Planet 4.x on the same
workstation.

If a version of MapInfo Professional 9.0 is detected on your workstation

during the installation process, MapInfo Professional 9.0 will be uninstalled
and re-installed in the Mentum Planet folder as part of the installation process.
The license key for MapInfo Professional will be maintained and you will be
able to run MapInfo Professional as a stand-alone application.
Licensing is not supported through virtual private networks (VPN). It
may work under certain configurations but it is not officially supported.

You cannot install multiple versions of Mentum Planet 4.x on the same
workstation. If you try to install a later version of Mentum Planet 4.x
when there is an earlier version of Mentum Planet 4.x already installed on the
workstation, you can upgrade the software but you cannot perform a full
install.

18

Installing Mentum Planet

Installation Guide

Workflow for installing Mentum Planet software

Step 1

Contact Customer Care to obtain the password required to

download the software. You also need a valid product
identification number. See Getting technical support on page 4.

Step 2

Download the software from the download Web page.

Step 3

Install the Mentum Planet software. See To install Mentum

Planet on page 19.

Step 4

Obtain a license. See To obtain a license for Mentum Planet on

page 23.

If you are installing Mentum Planet on a terminal server, follow the

instructions in To install Mentum Planet on a terminal server on
page 22.

To install Mentum Planet

There are two types of installation:

stand-alonelocks the software to a particular computer

floating licenseenables a number of users to share licenses

held on a License Server

The type of installation is determined by the license key. For more

information about the floating license option and the License Server, see
Chapter 3: Installing and Managing the License Server on page 33.
You must have Administrator privileges to install Mentum Planet.

Navigate to the Mentum Planet Product Downloads page at http://

www.mentum.com/customercare/productDownloads.asp. On the Product
Downloads page, enter the Product ID number indicated in the email or
letter sent to you, and click Submit. Type the product password you
received from your Customer Care Center in the box beside the version of
Mentum Planet that you want to download and click Submit. Read the
download instructions and, in the Mentum Planet Installation Files

19

Chapter 2
Installation Guide

table, click the folder icon in the Single column, and download the
program file to a temporary folder on your computer.
2

Double-click the setup.exe.

On the Welcome page of the Installation Wizard, click Next.

Read the license agreement.

If you accept the terms of the agreement, click Yes.

On the Product ID page, type your name, your company name, and your
product ID number, and click Next.
You can find the product ID in the email or letter sent to you.

20

Installing Mentum Planet

Installation Guide

On the Choose Destination Location page, accept the default location, or

click Browse and choose the folder in which you want to install the
software, and then click OK.

Click Next.
There will be a delay while the software installs.

21

Chapter 2
Installation Guide

If you want to view the Release Note, enable the Yes, I Want to View the
Release Note File check box.

10 Click Finish.
11 If prompted, choose the Yes, I want to Restart My Computer Now
option and click OK.
If the Mentum Planet program files become corrupted, you can use the
Repair option in the InstallShield Wizard to reinstall the program and
overwrite the corrupted files. From the Start menu, choose All Programs
Mentum Planet Uninstall-Modify Uninstall-Modify Planet and choose the
Repair option.

If you install Mentum Planet over a network and experience problems,

copy the installation to a local computer and try the installation again.

To install Mentum Planet on a terminal server

To install Mentum Planet software on a terminal server, you must be
logged on as an Admin user.

If you are installing Mentum Planet on a terminal server, you must run
Mentum Planet once, immediately after the installation, in order to register
the software and create user profiles.
1

Install the Mentum Planet software. See To install Mentum Planet on

page 19.

Start Mentum Planet.

In the Product Registration and License Request dialog box, enter your
contact information and click Submit.
If you have problems with the product registration, see Obtaining a
license on page 23.

22

Close Mentum Planet.

Installing Mentum Planet

Installation Guide

Obtaining a license
Every time you start Mentum Planet or use a technology or tool that requires a
license, the software will verify that you have a valid license on your
workstation. If a valid license is not found, you will be prompted to enter your
contact information or contact Mentum. For more information about Mentum
Planet technologies and tools, see the Mentum web site at http://
www.mentum.com.

To obtain a license for Mentum Planet

1

Start Mentum Planet.

In the Product Registration and License Request dialog box, enter your
contact information and click Submit.

The software will connect to the Mentum Planet server, validate your
license request, and install a license on your computer. If the software is
unable to connect to the server, the Offline Registration dialog box opens.

23

Chapter 2
Installation Guide

If you are unable to connect to the Mentum Registration Service, choose

one of the following options:

Offline Registrationdisplays a completed registration form

that you must email to [email protected] in order
to obtain a license string.

Enter License Manuallydisplays the Manual License Entry

dialog box. Enter the license string contained in the Offline
Registration form emailed back to you and click Install.

Retry Online Registrationattempts to reconnect to the

Mentum Registration Service.

Exit and Retry Laterexits the registration process.

If you are installing a stand-alone license, the license key (a file named
lservrc) is installed in the MapInfo installation folder (i.e., in the same
folder as the MapInfow.exe). If you are installing a floating license, a
pointer file (i.e., lshost) is installed in the Documents and Settings\All
Users\Application Data\Planet folder.
To install the software on another computer, you must first uninstall the
software using the Uninstaller, re-install the software on the new
computer, and make a request for a new license. Each license is configured to
work only on the computer from which the license was requested.

The Offline Registration form file is

MentumPlanet_OfflineRegistration.html and is located in the Mentum
Planet program folder.

24

Installing Mentum Planet

Installation Guide

To refresh a license
Every time you use a technology or tool that requires a license, the software
will verify that you have a valid license on your computer. If a valid license is
not found, you will be prompted to contact Mentum. Once you have contacted
Mentum and obtained a license for the tool or technology, you must refresh
your license.
For more information about Mentum Planet technologies and tools, see the
Mentum web site at http://www.mentum.com.
1

Start Mentum Planet.

From the Help menu, choose Licensing License Refresh.

When prompted to confirm the license refresh, click Yes.

From the File menu, choose Exit to close Mentum Planet.

Restart Mentum Planet.

To view license information

1

Choose Help About Mentum Mentum Planet.

In the About dialog box, click the License button.

The License Information dialog box opens.

Using a commuter license

Mentum Planet software installed with the floating license option can also be
used with a commuter license. A commuter license allows you to check out a
floating license (called a commuter license) onto a computer and then work
disconnected from the network. You can check out a commuter license for a
period of up to 30 days. You must check the license back into the pool of
available floating licenses in order to allow others to use this license. The
commuter license is automatically returned to the pool of available licenses
once the checkout period expires (1 to 30 days). You must have a License
Server installed in order to check out a commuter license. For information on
installing the License Server, see Chapter 3: Installing and Managing the
License Server on page 33.
If you are not connected to the License Server, you can obtain a commuter
license for your remote workstation from the License Server Administrator or
from anyone connected to the License Server. See Workflow for using the
Remote Authorization tools on page 41.

25

Chapter 2
Installation Guide

To use a commuter license

1

Do one of the following:

Start Mentum Planet and choose Help Licensing

Commuter License.
Choose Start All Programs Mentum Planet
WCommute.

Click one of the following buttons:

Search Subnetsearch all servers to which you can connect for

available floating licenses.

Single Serversearch a specific server for available floating

licenses. You must use this option if you want to search across
networks.

From the tree view in the Commuter Licensing dialog box, choose the
license that you want to commute.

In the Please Enter the Number of Days Until the Authorization

Expires box, type the number of days before the license expires.

Do one of the following:

Choose the license you want to check out from the list of
available floating licenses and click Check Out.

Choose the license you want to check in from the list of available
floating licenses and click Check In.

In the Commuter Licensing dialog box, choose File Exit.

To work with commuter licenses when you are not running Mentum
Planet, double-click on the WCommute.exe file located in the Program
Files\<software install folder>\LSERVER\Tool folder or choose the Program
from the Start menu, then choose the WCommute command. If no Mentum
Planet licenses appear in the Commuter Licensing dialog box, no licenses are
available.

26

Installing Mentum Planet

Installation Guide

Migrating Mentum Planet projects

Before upgrading your Mentum Planet software, it is important that you
migrate existing projects in order to take advantage of the new features in the
latest release of Mentum Planet.
Changes to the data storage and management architecture in Mentum Planet
require that project data created in previous versions of the software be
migrated in order to make it consistent with the new data schema. The
migration process is largely automated and is carried out when you first open
your project in the current version of Mentum Planet.
Once a legacy project has been opened in the current version of
Mentum Planet, it can no longer be opened in previous versions of
Mentum Planet. It is recommended that you create a complete project backup
prior to opening your project. Project migration has been tested and verified
using Mentum Planet 4.2.2 and greater. Customers using earlier versions are
advised to contact Customer Care for assistance.

Improved data validation

Mentum Planet now uses stringent data validation controls aimed at
preserving data integrity and reducing the chance of error or data corruption.
As a consequence, project data from earlier releases must be free of
inconsistencies to ensure successful migration.
If you are working in a multi-user environment using Data Manager, Mentum
Planet and Data Manager Server must be upgraded to the same version. Data
validation will occur as part of the software upgrade process. Contact your
Data Manager Administrator or Customer Care for further information.

Upgrade paths
The appropriate upgrade procedure depends on the type of installation you
have.
1

If you are using versions prior to Mentum Planet 4.2.2, contact Customer
Care for assistance with project migration.

If you are using Data Manager and working in a multi-user environment,

the software upgrade must be coordinated such that Mentum Planet and
Data Manager Server are both the 4.5 version. In this deployment model,
it is also critical to coordinate data migration from previous versions.

27

Chapter 2
Installation Guide

Contact your Data Manager Administrator or Customer Care to

coordinate the upgrade.
3

If you are working with a stand-alone license and projects are not stored
in Data Manager, see Workflow for migrating Mentum Planet projects
on page 28.

Workflow for migrating Mentum Planet projects

Step 1

Run Data Inspector on your local project to identify any issues

prior to installing Mentum Planet. If errors appear in the Project
Status message window, contact Customer Care for assistance.
See Getting technical support on page 4.

Step 2

Back up all local project data.

Step 3

Uninstall Mentum Planet 4.x (4.x and 4.5 cannot co-exist on the
same computer and 4.5 does not install as an upgrade).

Step 4

Install Mentum Planet 4.5. See To install Mentum Planet on

page 19.

Step 5

Replace or edit the mapinfow.exe.config file as required based on

corporate preferences. Ensure that all modifications are based on
a 4.5 version of the configuration file.

Step 6

Open your project in Mentum Planet 4.5.

Step 7

Run Data Inspector on your local project to identify any known

issues. The Data Inspector shipped with Mentum Planet 4.5 may
identify issues that are not detectable in previous versions of the
tool. If errors appear in the Project Status message window,
contact Customer Care for assistance.

To run Data Inspector, choose Start Run. Type C:\Program

Files\Mentum\Planet\DataInspector.exe" /expert and choose Open.

If you have any questions or concerns about the migration process,

contact Customer Care.

28

Installing Mentum Planet

Installation Guide

Upgrading Mentum Planet software

You can easily upgrade Mentum Planet software to take advantage of new
features. If you are upgrading any version of Mentum Planet 3.x to the latest
version of Mentum Planet 4.x, you must first uninstall Mentum Planet 3.x.
See Uninstalling Mentum Planet software on page 29.
If you want both the 3.x version and the 4.x version of Mentum Planet
on the same workstation, you must install each version in its own folder.

To upgrade Mentum Planet software

1

Navigate to the Mentum Planet Product Downloads page at http://

www.mentum.com/products/support/planet/planet.asp. On the Product
Downloads page, enter the Product Identification Number indicated in
the email or letter sent to you, and click Submit. On the Download page,
choose the download option that best suits your circumstances and
download the program file or files to a temporary folder on your
computer.

Double-click the setup.exe file and extract the files to a temporary

location.
The Installation Wizard opens automatically.

Click Yes.

On the Welcome screen, click Next.

There will be a delay while the files are copied to your computer.

On the Install Wizard Complete page, choose the Yes, I want to

Restart My Computer Now option, and click Finish.

Uninstalling Mentum Planet software

Before you uninstall Mentum Planet, check in all commuter licenses. See
Using a commuter license on page 25.
1

Choose Start All Programs Mentum Planet Uninstall-Modify

Uninstall-Modify Mentum Planet.
The Welcome page appears.

29

Chapter 2
Installation Guide

30

Choose Remove and click Next.

Click Yes to confirm that you want to remove Mentum Planet.

When prompted to create a backup of the mapinfo.exe.config file, located

in the <Mentum Planet installation>\MapInfo folder, do one of the
following:

If you have not modified the mapinfo.exe.config file, click No.

If you have modified the mapinfo.exe.config file with

customized settings that you want to retain, click Yes. A backup
copy of the mapinfo.exe.config file will be created in the
<Mentum Planet installation>\setting_backup folder. After you
have installed the new version of Mentum Planet, you must use a
text editor to manually copy any customized settings from the
backup copy of the mapinfo.exe.config file to the <Mentum
Planet installation>\mapinfo.exe.config file installed with the
new version of Mentum Planet. Due to syntax changes in the
mapinfo.exe.config file, you cannot simply replace the new file
with the backup copy.

Installing Mentum Planet

Installation Guide

On the Maintenance Complete page, choose one of the following

options:

Yes, I want to restart my computer now

No, I will restart my computer later

To complete the uninstall, you must restart your computer.

6

Click Finish.

31

Chapter 2
Installation Guide

32

3.
This chapter contains the
following sections:

Determining the best

installation for your
organization
Understanding the License
Server

Chapter 3: Installing and Managing the License

Server

Installing and
Managing the
License Server
If you are installing Mentum Planet software for use
in a multi-user environment, you need to install a
License Server in order to distribute licenses to users.
This chapter explains how the License Server works
and describes how to install it. It also explains how to

System requirements

troubleshoot problems with the License Server and

Workflow for installing the

License Server and
distributing licenses

how to provide license authorizations to remote

Using the License Server

Management tool

Workflow for using the

Remote Authorization tools

Troubleshooting

Mentum Planet users.

33

Chapter 3
Installation Guide

Determining the best installation for your organization

Mentum Planet uses a software-based security system to prevent unauthorized
use of the software. Two types of license are available.

A stand-alone license is used to lock the software to a particular

computer. This is the type of installation to use if you plan to use
the product on only one computer. No License Server is required
for this type of installation.

A floating license is used when there are a number of users who

all need to use the software to share licenses. The License Server
handles the task of distributing the licenses to the running
instances of the software. You only need to install one License
Server. Use of a network is required for this type of installation.

The Mentum Planet license that you were given determines the type of
installation you can do. Depending on the type of license you have, there are
several deployment models from which you can choose including:

You could choose to install a stand-alone license where a single

user installs Mentum Planet on a workstation with no connection
to a database or network. This model is best suited for
independent projects where multi-user collaboration is not
necessary.

You could choose to install a floating license using the License

Server where typically multiple installations of Mentum Planet
are installed on individual workstations and users collaborate
using the Data Manager.

You could choose to install a floating license using the License

Server where only one version of Mentum Planet is installed on
a terminal server. In this case, users each run an instance of
Mentum Planet on the terminal server. Local and remote users
work with Mentum Planet from a workstation that is essentially
a display terminal with a keyboard and mouse.

These different Mentum Planet deployment methods can co-exist in a single

implementation.

34

Installing and Managing the License Server

Installation Guide

Understanding the License Server

The License Server is a software program that validates and distributes
software licenses to users. Each time a user launches Mentum Planet, the
License Server is contacted by the workstation and validates the software
license. The License Server allows users to access a license from a pool of
floating licenses located on the server. A floating license is ideal in a multiuser environment when there are several users working with Mentum Planet.
While a floating license is in use, no other user can use it. When all floating
licenses are in use, no other users can work with the software.
The License Server also allows a user to check out a commuter license from a
pool of floating licenses for use on a computer that is not connected to the
network. The commuter license is not released back into the floating license
pool until either the user checks it back in or the commuter license expires.

How the License Server issues licenses

After you install the License Server, you must register the software and
validate the floating licenses that can be distributed. Once your licence
request has been validated, the license key numbers are recorded in the license
file (i.e., lservrc) that is installed in the \Mentum\License Manager
Server\WinNT folder within the Program Files folder.
When a user launches Mentum Planet with a floating license, the software
locates and identifies the License Server and issues a request for a license.
When the License Server finds the appropriate license key, it sends back an
authorization to the workstation, and the user can work with the software.

System requirements
Not only is the License Server contacted each time a user starts an instance of
Mentum Planet but it is also contacted periodically throughout the Mentum
Planet session. As a result, it is important to choose a computer that will
always be available to serve the licenses. Ideally, the License Server should be
installed on a file or DNS server because these computers are always online.
Static, fixed IP addresses give the best performance. However, you can install
the License Server on any computer with Windows Server 2003,
Windows XP, or Windows Vista installed, because the resources required to
serve the licenses are minimal (5 MB free disk space).

35

Chapter 3
Installation Guide

An Internet connection is required to validate licenses. If there is no

Internet connection, contact Customer Care. See Getting technical
support on page 4.

Workflow for installing the License Server and distributing

licenses

36

Step 1

Contact Customer Care to obtain the password required to

download the software. You also need a valid product
identification number. See Getting technical support on page 4.

Step 2

Download the software from the download Web page.

Step 3

Choose a computer to be the License Server.

Step 4

Verify that the server and workstations meet the system

requirements. See System Requirements on page 13 for
workstations and System requirements on page 35 for the
License Server.

Step 5

Ensure that the workstations have network access to the server

where the License Server will be installed by verifying the
network protocol. See Check the Network Protocol in the
Sentinel LM System Administrator online Help (Sentinel.chm)
available in the Mentum\Planet\Help folder.

Step 6

Install the License Server on the chosen computer. See To install

the License Server.

Step 7

Obtain a valid license from the Registration Service. See To

obtain a license for Mentum Planet on page 23.

Step 8

Navigate to the Program Files\LServer folder and double-click the

loadls.exe file to enable the License Server service. See loadls Install the License Server as an NT/2000 Service in the Sentinel
LM System Administrator online Help (Sentinel.chm) available in
the Mentum\Planet\Help folder.

Installing and Managing the License Server

Installation Guide

Step 9

Run the License Server Management tool to verify that the

License Server has been installed correctly. See Using the
License Server Management tool on page 40.

Step 10

Install a floating license version of the Mentum Planet software on

individual workstations or on a terminal server. See Workflow for
installing Mentum Planet software on page 19 and To install
Mentum Planet on a terminal server on page 22.

If you are upgrading the License Server for use with

Mentum Planet 4.5, you should copy the lservrc file from the
c:\Program Files\License Manager Server\English folder to the
c:\Program Files\License Manager Server\WinNT folder.

To install the License Server

It is recommended that you install the latest version of the License Server.
You do not need to install Mentum Planet on the License Server in order for
the License Server to validate and distribute licenses.
1

Navigate to the Mentum Planet Product Downloads page at http://

www.mentum.com/customercare/productsDownloads.asp. On the
Product Downloads page, enter the Product ID number indicated in the
email or letter sent to you, and click Submit. Type the product password
you received from your Customer Care Center in the box beside the
version of Planet that you want to download and click Submit. Read the
download instructions and save file or files to a temporary folder on your
computer.

Double-click the LMServer.exe file and save the file to a temporary

location.

On the Welcome page, click Next.

Read the license agreement.

If you accept the terms of the agreement, click Yes.

37

Chapter 3
Installation Guide

Accept the default folder as the folder where the License Server will be
installed and click Next.
There will be a delay while the software installs.

In the Product ID Entry dialog box, type the product ID for each license
you want to add to the License Server and click Add.
Each product ID you add is listed in the Product ID Entry dialog box.

38

When you have finished adding the product IDs, click OK.

Installing and Managing the License Server

Installation Guide

In the Product Registration and License Request dialog box, enter your
contact information and click Submit.
Once the product IDs have been validated, the licenses will be installed
on the server. If you are unable to connect to the Registration Service, you
will need to obtain a license from the Customer Care Center. For more
information, see Obtaining a license on page 23.

10 To enable the License Server service, navigate to the Program

Files\License Manager Server\WinNT folder, double-click the loadls.exe
file, and click Add.
11 Run the License Server Management tool (WlmAdmin.exe) to verify that
the License Server is running and that the licenses have been correctly
installed. See To use the License Server Management tool on page 40.

To uninstall the License Server

1

Choose Start Control Panel.

Double-click Add or Remove Programs.

In the Currently Installed Programs list, choose License Manager

Server.

Click Remove.

In the License Manager Server dialog box, choose Remove, and click
Next.

To the question, Do you want to completely remove the selected

application and all of its features?, click Yes.

In the Confirm File Deletion dialog box, click OK.

In the Maintenance Complete dialog box, click Finish.

In the License Manager Server Maintenance Complete dialog box,

click Finish.

39

Chapter 3
Installation Guide

Using the License Server Management tool

The License Server Management tool (WlmAdmin.exe) enables you to verify
the status of licenses and monitor license activity. Using this tool, you can
obtain information on licenses such as the type of license, the feature and
version of a license, and the license expiry date. You can also verify how
many users are currently using a license and how many licenses are available.
For more detailed information, see the Sentinel LM System Administrator
online Help (Sentinel.chm) available in the Mentum Planet\Help folder.

To use the License Server Management tool

1

Navigate to the Program Files\License Manager Server\Tool folder.

Double-click the WlmAdmin.exe file.

In the WlmAdmin dialog box, do one of the following:

40

Expand the Subnet Servers node in the tree view to locate all
License Servers available on the defined subnet.
Choose Edit Defined Server List and, in the Server box,
type the name of computer where the License Server is found,
click Add, then click OK.

Expand the node next to a License Server to view the list of installed
product licenses.

Expand the node next to a product to see who is currently using a license.

Choose a product or a user name to view statistics on the licenses in the

right-hand pane.

Choose File Exit to close the WlmAdmin dialog box.

Installing and Managing the License Server

Installation Guide

Workflow for using the Remote Authorization tools

Remote Mentum Planet users can commute a license without being connected
to the License Server by installing a commuter authorization code obtained
from the License Server administrator or a Mentum Planet user connected to
the License Server.

Step 1

The remote Mentum Planet user obtains a commuter locking

code for the remote workstation and sends it to the License
Server Administrator or a Mentum Planet user connected to the
License Server. To obtain the commuter locking code on
page 41.

Step 2

The License Server Administrator, or Mentum Planet user with

access to the License Server, checks out a commuter license and
authorization code for the remote workstation and emails it to the
remote Mentum Planet user. See To check out a remote
commuter license on page 42.

Step 3

The remote Mentum Planet user installs the authorization code

on the remote workstation. See To install the remote
authorization code on page 43.

To obtain the commuter locking code

The remote Mentum Planet user must obtain a locking code and send it to the
License Server Administrator or to a user connected to the License Server.
1

Navigate to the Mentum Planet/lserver/Tool folder and double-click

WRCommute.exe.

Click the Get Locking Code tab.

The commuter license code for the current computer is displayed in the
Locking Code String for the Current Machine box.

Do one of the following:

In the Current Locking Code String section, click the Save

Lock Code String to a File button to save the locking code to a
file, and then send the file to the Mentum Planet user with access
to the License Server.

In the Send as E-Mail section, type the email address of a

Mentum Planet user with access to the License Server and click
Send.

41

Chapter 3
Installation Guide

To check out a remote commuter license

Remote commuter licenses cannot be checked in and will remain
checked out until the end of the authorization period.

Do one of the following:

Start the Mentum Planet software and choose Help Licensing

Commuter License.
Choose Start All Programs Mentum Planet
WCommute.

Click one of the following buttons:

Search Subnetsearch all servers to which you can connect for

available floating licenses.

Single Serversearch a specific server for available floating

licenses. You must use this option if you want to search across
networks.

From the tree view in the Commuter Licensing dialog box, choose the
license that you want to commute.

Enable the Check Out Authorization for Remote Machine check box.

In the Please Enter the Number of Days Until the Authorization

Expires box, type the number of days before the license expires.
Remote commuter licenses cannot be checked in and will remain checked
out until the end of the authorization period.

Click Check Out.

In the Locking Code for Remote Machine dialog box, choose one of the
following options:

Enter the Locking Code String for Remote Machineto type

the license string or paste it from the clipboard.

Get Locking Code String for Remote Machine From Fileto

specify a file containing the license string.

Click OK.

In the Remote Commuter Licensing dialog box, click the Save button.

10 Type a name for the file in the File Name box and click Save.

42

Installing and Managing the License Server

Installation Guide

11 In the Mail the Remote Commuter Authorization to Recipient in

Email section, type the email of the remote Mentum Planet user.
12 Click OK.
13 In the Commuter Licensing dialog box, choose File Exit.
To work with commuter licenses when you are not running the software,
double-click on the WCommute.exe file located in the Program
Files\mentum\Planet\lserver\Tool folder or choose the Program from the Start
menu, then choose the WCommute command. If no licenses appear in the
Commuter Licensing dialog box, no licenses are available.

For detailed information about license server management utilities

(e.g., WCommute and WlmAdmin), see the Sentinel.chm online Help
located in the Program Files\Mentum\Mentum Planet\help folder.

To install the remote authorization code

The remote Mentum Planet user must install the commuter authorization code
obtained from the License Server Administrator or from a user connected to
the License Server on the remote workstation.
1

Navigate to the Mentum Planet/lserver/Tool folder and double-click

WRCommute.exe.

Click the Install Remote Authorization Code tab.

Choose one of the following options:

Enter Remote Authorization Codeto type or paste the code

into the box.

Get Remote Authorization Code From Fileto specify a file

containing the authorization code.

Click Install.

In the confirmation dialog box, click OK.

43

Chapter 3
Installation Guide

Troubleshooting
You may receive the following error message when launching Mentum
Planet:
No license available to run <program>.

If you receive this message, the cause is likely one of the items listed in
Table 3.1. The items are listed in order of probability. Start with the first item,
and work through the list until the problem is corrected.
If you have additional troubleshooting content or have comments on the
user documentation, send it to the Technical Publications Manager at
[email protected].

Issue

Resolution

No licenses are available.

Check whether licenses are available. See Using the

License Server Management tool on page 40.

The License Server is not

working and therefore not
serving licenses.

See Using the License Server Management tool on

page 40.

There is a problem with the

license key.

See If the license key does not work on page 45.

Table 3.1 License Server Issues and resolutions

If the Licence Server is not working

44

Verify that the License Server service is running using the Windows
Services menu.

Do one of the following:

If the License Server is running, you need to restart it. Stop the
service and restart the server.

If the License Server is not running, navigate to the

Program Files\License Manager Server\WinNT folder and
double-click the loadls.exe file. Verify that the service has been
installed and then restart the server. See loadls - Install the
License Server as an NT/2000 Service in the Sentinel LM
System Administrator online Help (Sentinel.chm) available in
the Mentum\Planet\Help folder.

Installing and Managing the License Server

Installation Guide

If the license key does not work

1

Navigate to the Program Files\License Manager Server folder and verify

that the lservrc file has no extension.

Launch Notepad, open the lservrc file, verify the expiry date, and check
that the software licenses are in the lservrc file.

Navigate to the Program Files\License Manager Server\Tool folder and

double-click the WlmAdmin.exe file. Verify that the License Server is
running and determine how many licenses there are on the server.

45

Chapter 3
Installation Guide

46

A.

Appendix A: Citrix Troubleshooting

Citrix
Troubleshooting

Mentum Planet can be deployed within a Citrix environment. Citrix Presentation Server is
a thin-client operating system that runs on Microsoft Windows Server and UNIX
operating systems. Using Citrix Presentation Server, Mentum Planet can be easily
deployed to all users across an organization.
This appendix contains information to help you troubleshoot issues that may arise when
using Mentum Planet with Citrix.
The content of this appendix is intended to provide supplemental information to the
material contained in the documentation provided for Citrix. Mentum does not
extensively test Mentum Planet within a Citrix environment. These guidelines were drawn
from on-site work using Citrix Presentation Server, version 4 and may not apply to other
versions of Citrix.

47

Appendix A
Installation Guide

Troubleshooting
The guidelines listed in this section were drawn from our experiences working on
customer sites.
If you have additional troubleshooting content or have comments on the user
documentation, send it to the Technical Publications Manager at
[email protected].

Table A.1 Citrix troubleshooting issues and resolutions

Issue

Resolution

Mentum Planet
performance is slow

If you are deploying Mentum Planet on many workstations, you

should disable sound on Citrix sessions. Sound is a source of
bandwidth consumption and can contribute to the slow performance
of Mentum Planet.

Recurring GDI errors

GDI errors are commonly associated with inadequate video RAM. In

general, Mentum Planet users work with high-resolution data. As a
result, 8 MB of video memory is recommended and the color quality
setting should not exceed 16 bit.

Unable to connect to
Mentum Planet

If you are currently using ICA Keep-Alives, you should ensure that
these applications are turned on and configured to run at 60-second
intervals. The ICA Keep-Alive application alerts the server of broken
sessions resulting from periodic network instabilities. Servers may
not be aware of broken sessions occurring due to network-related
factors. This prevents the session from entering a disconnected
state. A reconnecting user, in such a case, is granted a new session
instead of rejoining the broken one or the user may be denied
access to the Mentum Planet session.

48

Index

Index
Symbols

.NET security 15

Installation 35, 36, 44, 45

problems 44
strategy 34
Installing
License Server 37
on terminal server 22
Planet software 19

About licenses 25
Admin Tool
for License Server 40
C

Citrix
using 47
Commuter codes 41
Commuter licenses
checking in and checking out 25
remote 41
searching for 25
D

Deploying
wireless network planning software 36
F

Files
lservrc 45
Floating License Server 37
Floating licenses 34
H

Hardware requirements 14
Help
accessing 7
for Sentinel LM 40
getting technical support 4

License keys
distributing 35
offline registration 24
troubleshooting 45
License Server
description 35
distributing licenses 36
installing 37
requirements 35
troubleshooting 44
uninstall 39
utilities 40
License Server Management tools 37, 40
WCommute 43
WlmAdmin 43
Licenses
about 25
monitoring 40
obtaining 23
refreshing 25

49

Index
Installation Guide

lservrc 24, 35, 45

M

Management tools 40
Mentum products 1
Migrating
projects 27
Migrating projects
data validation 27
workflow 28
Monitoring licenses 40
O

Online Help 7
Operating system requirements 14

Stand-alone licenses 34
System requirements
Data Manager Server 6
License Server 35
Planet software 14
T

Technical support 4
Terminal server
installing 22
Thin-client environments 47
Tools
authorization 41
Troubleshooting 44
U

Planet software
installing 19
uninstalling 29
upgrading 29
Products
Mentum 1
Projects
migrating 27
R

Refreshing licenses 25
Remote authorization codes 40, 41
Requirements 14
S

Searching
for commuter licenses 25
Security
.NET 15
Sentinel LM online Help 40
Software
installing 19
uninstalling 29
upgrading 29

50

Uninstalling
License Server 39
Planet software 29
Upgrade paths 27
Upgrading
Planet software 29
Utilities
for License Server 40
loadls.exe 36
WlmAdmin.exe 37, 40
W

WCommute 43
WlmAdmin tool 40