Installation Guide

Cover Page

Installation Guide

for version 4.5.1

Copyright © 2009Mentum 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

ContentsContents

MENTUM PRODUCTS

List of products 2

CONTACTING MENTUM

Getting technical support 4Send us your comments 4

INTRODUCTION Components of Mentum Planet 6Using this Installation Guide 6Using this documentation 6

Online Help 7Notational conventions 8Documentation library 10

CHAPTER 1System Requirements

General hardware and software requirements 14Configuring .NET Security 15

CHAPTER 2Installing Mentum Planet

Before installing Mentum Planet software 18Workflow for installing Mentum Planet software 19

To install Mentum Planet 19To install Mentum Planet on a terminal server 22

Obtaining a license 23To obtain a license for Mentum Planet 23To refresh a license 25To view license information 25

Using a commuter license 25To use a commuter license 26

Migrating Mentum Planet projects 27Improved data validation 27Upgrade paths 27

Workflow for migrating Mentum Planet projects 28Upgrading Mentum Planet software 29

i

ContentsInstallation Guide

To upgrade Mentum Planet software 29Uninstalling Mentum Planet software 29

CHAPTER 3Installing and Managing the License Server

Determining the best installation for your organization 34Understanding the License Server 35

How the License Server issues licenses 35System requirements 35Workflow for installing the License Server and distributing licenses 36

To install the License Server 37To uninstall the License Server 39

Using the License Server Management tool 40To use the License Server Management tool 40

Workflow for using the Remote Authorization tools 41To obtain the commuter locking code 41To check out a remote commuter license 42To install the remote authorization code 43

Troubleshooting 44If the Licence Server is not working 44If the license key does not work 45

APPENDIX A 47Citrix Troubleshooting

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.

1

http://www.mentum.com

Mentum ProductsInstallation Guide

2

List of productsThe 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/FDMA—GSM (including GPRS and EGPRS), IS-136, AMPS,

NAMPS, and iDEN■ CDMA—W-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 RF-vu 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 cost-effective convergence towards a 'best network' configuration.

http://www.mentum.com/mentum/products.php

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.

3

Contacting MentumInstallation Guide

4

Getting technical supportYou 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 AmericaPhone: +1 866 921-9219 (toll free), +1 819 483-7094 Fax: +1 819 483-7050Email: [email protected]: 8am – 8pm EST/EDT (Monday-Friday, excluding local holidays)

Europe, Middle East, and AfricaPhone: +33 1 39264642Fax: +33 1 39264601Email: [email protected]: 9am – 6pm CET/CEST (Monday-Friday, excluding local holidays)

Asia PacificPhone: +852 2824 8874Fax: +852 2824 8358Email: [email protected]: 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 commentsFeedback 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]

http://www.mentum.com/index.php?page=customer-care&hl=en_US

http://www.mentum.com/index.php?page=customer-care&hl=en_US

mailto:[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.

5

IntroductionInstallation Guide

Components of Mentum PlanetThe 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.

Using this Installation GuideThe 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 documentationBefore 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

Software Components

Mentum Planet

■ Mentum Planet software—offers a complete network design solution allowing you to design and optimize wireless networks.

■ Data Manager—enables you to centralize data and gives you the ability to share projects and files.

■ Data Manager Server—works 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 set—comprises 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 software—enables you to take advantage of the spatial analysis capabilities of MapInfo.

6



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 HelpFrom 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 RoadmapWhen 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.

PrintingYou 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.

7

http://reference.mapinfo.com/#mi_pro


Library SearchYou 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.

Frequently Asked QuestionsThe 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.

“What’s This?” Help“What’s This?” Help provides detailed explanations of all dialog boxes.

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

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

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

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.

8


IconsThroughout this documentation, icons are used to identify text that requires special attention.

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>.

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.

9


Documentation libraryMentum 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.

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.

10



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.

Document Enables you to

11


12

Chapter 1: System Requirements

1.
System Requirements
This chapter contains the following section:■ General hardware and

software 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 1Installation Guide

General hardware and software requirementsTable 1.1 details the workstation configuration recommended for Mentum Planet.

Table 1.1 Recommended system configurations

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.

Recommended configurations

Processor Workstation: Pentium 4 2.0 GHz or equivalentLaptop: 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 RequirementsInstallation 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

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

2 Choose All Programs ➤ Administrative Tools ➤ Microsoft .NET Framework Wizards.

3 In the .NET Wizards dialog box, click Adjust .NET Security.4 On the first page of the Security Adjustment Wizard, choose Make

Changes to This Computer and click Next.5 Choose My Computer and, in the Choose the Level of Trust For

Assemblies in This Zone section, move the slider to Full Trust.6 Click Next.7 Click Finish.

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

15


16

Chapter 2: Installing Mentum Planet

2.
Installing Mentum Planet
This chapter contains the following sections:■ Before installing Mentum

Planet software■ Workflow for installing

Mentum Planet software■ Obtaining a license■ Using a commuter license■ Migrating Mentum Planet

projects■ Workflow for migrating

Mentum Planet projects■ Upgrading Mentum Planet

software■ Uninstalling Mentum Planet

software

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

must register the product to validate your license.

This chapter explains how to install Mentum Planet.

For information about setting up the License Server

for the floating license installation, see “Chapter 3:

Installing and Managing the License Server” on

page 33.

17


Before installing Mentum Planet softwareMentum 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 PlanetInstallation Guide

Workflow for installing Mentum Planet softwareStep 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.

To install Mentum PlanetThere are two types of installation:

■ stand-alone—locks the software to a particular computer■ floating license—enables a number of users to share licenses

held on a License ServerThe 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.

1 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

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.

You must have Administrator privileges to install Mentum Planet.

19

http://www.mentum.com/customercare/productsDownloads.asp


http://www.mentum.com/customercare/customercare.asp


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.3 On the Welcome page of the Installation Wizard, click Next.4 Read the license agreement.5 If you accept the terms of the agreement, click Yes.

6 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


7 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.

8 Click Next.

There will be a delay while the software installs.

21


9 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.

To install Mentum Planet on a terminal server

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.

2 Start Mentum Planet.3 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.

4 Close Mentum Planet.

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 software on a terminal server, you must be logged on as an Admin user.

22


Obtaining a licenseEvery 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 Planet1 Start Mentum Planet.2 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




3 If you are unable to connect to the Mentum Registration Service, choose one of the following options:■ Offline Registration—displays a completed registration form

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

■ Enter License Manually—displays 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 Registration—attempts to reconnect to the Mentum Registration Service.

■ Exit and Retry Later—exits 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


To refresh a licenseEvery 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.2 From the Help menu, choose Licensing ➤ License Refresh.3 When prompted to confirm the license refresh, click Yes.4 From the File menu, choose Exit to close Mentum Planet.5 Restart Mentum Planet.

To view license information1 Choose Help ➤ About Mentum Mentum Planet.2 In the About dialog box, click the License button.

The License Information dialog box opens.

Using a commuter licenseMentum 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

www.mentum.com


To use a commuter license1 Do one of the following:

■ Start Mentum Planet and choose Help ➤ Licensing ➤ Commuter License.

■ Choose Start ➤ All Programs ➤ Mentum Planet ➤ WCommute.

2 Click one of the following buttons:■ Search Subnet—search all servers to which you can connect for

available floating licenses.■ Single Server—search a specific server for available floating

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

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

4 In the Please Enter the Number of Days Until the Authorization Expires box, type the number of days before the license expires.

5 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.

6 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


Migrating Mentum Planet projectsBefore 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.

Improved data validationMentum 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 pathsThe 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.

2 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.

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.

27


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 projectsStep 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

http://www.mentum.com/mentum/customercare.php



Upgrading Mentum Planet softwareYou 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.

To upgrade Mentum Planet software1 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.

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

The Installation Wizard opens automatically.

3 Click Yes.4 On the Welcome screen, click Next.

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

5 On the Install Wizard Complete page, choose the Yes, I want to Restart My Computer Now option, and click Finish.

Uninstalling Mentum Planet softwareBefore 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.

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.

29

http://www.mentum.com/products/support/planet/planet.asp

http://www.mentum.com/products/support/planet/planet.asp


2 Choose Remove and click Next.3 Click Yes to confirm that you want to remove Mentum Planet.4 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.

30


5 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


32

Chapter 3: Installing and Managing the License Server

3.
Installing and Managing the License Server
This chapter contains the following sections:■ Determining the best

installation for your organization

■ Understanding the License Server

■ System requirements■ Workflow for installing the

License Server and distributing licenses

■ Using the License Server Management tool

■ Workflow for using the Remote Authorization tools

■ Troubleshooting

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

troubleshoot problems with the License Server and

how to provide license authorizations to remote

Mentum Planet users.

33


Determining the best installation for your organizationMentum 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 ServerInstallation Guide

Understanding the License ServerThe 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 multi-user 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 licensesAfter 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 requirementsNot 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


Workflow for installing the License Server and distributing licenses

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.

An Internet connection is required to validate licenses. If there is no Internet connection, contact Customer Care. See “Getting technical

support” on page 4.

36


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.

To install the License ServerIt 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.

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

3 On the Welcome page, click Next.4 Read the license agreement.5 If you accept the terms of the agreement, click Yes.

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.

37





6 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.

7 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.

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

38


9 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 Server1 Choose Start ➤ Control Panel.2 Double-click Add or Remove Programs.3 In the Currently Installed Programs list, choose License Manager

Server.4 Click Remove.5 In the License Manager Server dialog box, choose Remove, and click

Next.6 To the question, “Do you want to completely remove the selected

application and all of its features?”, click Yes.7 In the Confirm File Deletion dialog box, click OK.8 In the Maintenance Complete dialog box, click Finish.9 In the License Manager Server Maintenance Complete dialog box,

click Finish.

39


Using the License Server Management toolThe 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 tool1 Navigate to the Program Files\License Manager Server\Tool folder.2 Double-click the WlmAdmin.exe file.3 In the WlmAdmin dialog box, do one of the following:

■ 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.

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

5 Expand the node next to a product to see who is currently using a license.6 Choose a product or a user name to view statistics on the licenses in the

right-hand pane.7 Choose File ➤ Exit to close the WlmAdmin dialog box.

40


Workflow for using the Remote Authorization toolsRemote 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 codeThe 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.

2 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.

3 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


To check out a remote commuter license

1 Do one of the following:■ Start the Mentum Planet software and choose Help ➤ Licensing

➤ Commuter License.■ Choose Start ➤ All Programs ➤ Mentum Planet ➤

WCommute.2 Click one of the following buttons:

■ Search Subnet—search all servers to which you can connect for available floating licenses.

■ Single Server—search a specific server for available floating licenses. You must use this option if you want to search across networks.

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

4 Enable the Check Out Authorization for Remote Machine check box. 5 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.

6 Click Check Out.7 In the Locking Code for Remote Machine dialog box, choose one of the

following options:■ Enter the Locking Code String for Remote Machine—to type

the license string or paste it from the clipboard.■ Get Locking Code String for Remote Machine From File—to

specify a file containing the license string.8 Click OK.9 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.

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

42


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 install the remote authorization codeThe 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.

2 Click the Install Remote Authorization Code tab. 3 Choose one of the following options:

■ Enter Remote Authorization Code—to type or paste the code into the box.

■ Get Remote Authorization Code From File—to specify a file containing the authorization code.

4 Click Install.5 In the confirmation dialog box, click OK.

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.

43


TroubleshootingYou 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.

Table 3.1 License Server Issues and resolutions

If the Licence Server is not working1 Verify that the License Server service is running using the Windows

Services menu.2 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.

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.

44


If the license key does not work1 Navigate to the Program Files\License Manager Server folder and verify

that the lservrc file has no extension.2 Launch Notepad, open the lservrc file, verify the expiry date, and check

that the software licenses are in the lservrc file.3 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


46

Appendix A: Citrix Troubleshooting

A.
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 AInstallation Guide

TroubleshootingThe guidelines listed in this section were drawn from our experiences working on customer sites.

Table A.1 Citrix troubleshooting issues and resolutions

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

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
AAbout licenses 25Admin Tool

for License Server 40

CCitrix

using 47Commuter codes 41Commuter licenses

checking in and checking out 25remote 41searching for 25

DDeploying

wireless network planning software 36

FFiles

lservrc 45Floating License Server 37Floating licenses 34

HHardware requirements 14Help

accessing 7for Sentinel LM 40getting technical support 4

IInstallation 35, 36, 44, 45

problems 44strategy 34

InstallingLicense Server 37on terminal server 22Planet software 19

LLicense keys

distributing 35offline registration 24troubleshooting 45

License Serverdescription 35distributing licenses 36installing 37requirements 35troubleshooting 44uninstall 39utilities 40

License Server Management tools 37, 40WCommute 43WlmAdmin 43

Licensesabout 25monitoring 40obtaining 23refreshing 25

49

IndexInstallation Guide

lservrc 24, 35, 45

MManagement tools 40Mentum products 1Migrating

projects 27Migrating projects

data validation 27workflow 28

Monitoring licenses 40

OOnline Help 7Operating system requirements 14

PPlanet software

installing 19uninstalling 29upgrading 29

ProductsMentum 1

Projectsmigrating 27

RRefreshing licenses 25Remote authorization codes 40, 41Requirements 14

SSearching

for commuter licenses 25Security

.NET 15Sentinel LM online Help 40Software

installing 19uninstalling 29upgrading 29

Stand-alone licenses 34System requirements

Data Manager Server 6License Server 35Planet software 14

TTechnical support 4Terminal server

installing 22Thin-client environments 47Tools

authorization 41Troubleshooting 44

UUninstalling

License Server 39Planet software 29

Upgrade paths 27Upgrading

Planet software 29Utilities

for License Server 40loadls.exe 36WlmAdmin.exe 37, 40

WWCommute 43WlmAdmin tool 40

50

Installation Guide

Documents

Transcript of Installation Guide