OpenLNS Server

License Guide

078-0498-01A
 Echelon, LON, LONWORKS, LonTalk, Neuron,
LONMARK, 3120, 3150, LNS, and the Echelon
logo are trademarks of Echelon Corporation
registered in the United States and other
countries. LonSupport is a trademark of
Echelon Corporation.

Other brand and product names are trademarks or

registered trademarks of their respective holders.

Smart Transceivers, Neuron Chips, and other OEM

Products were not designed for use in equipment or
systems which involve danger to human health or safety
or a risk of property damage and Echelon assumes no
responsibility or liability for use of the Neuron Chips in
such applications.

Parts manufactured by vendors other than Echelon and

referenced in this document have been described for
illustrative purposes only, and may not have been tested
by Echelon. It is the responsibility of the customer to
determine the suitability of these parts for each
application.

ECHELON MAKES NO REPRESENTATION, WARRANTY, OR

CONDITION OF ANY KIND, EXPRESS, IMPLIED, STATUTORY,
OR OTHERWISE OR IN ANY COMMUNICATION WITH YOU,
INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED
WARRANTIES OF MERCHANTABILITY, SATISFACTORY
QUALITY, FITNESS FOR ANY PARTICULAR PURPOSE,
NONINFRINGEMENT, AND THEIR EQUIVALENTS.

No part of this publication may be reproduced, stored in

a retrieval system, or transmitted, in any form or by any
means, electronic, mechanical, photocopying,
recording, or otherwise, without the prior written
permission of Echelon Corporation.

Printed in the United States of America.

Copyright © 2013 Echelon Corporation.
Echelon Corporation
www.echelon.com

ii Preface
Table of Contents
Table of Contents ............................................................................................ iii
Preface ...................................................................................................iv
Purpose ........................................................................................................... v
Audience .......................................................................................................... v
System Requirements ..................................................................................... v
For More Information and Technical Support .................................................. v
1 Installing an OpenLNS Server..........................................................7
Downloading the OpenLNS Server ................................................................. 8
Acquiring the OpenLNS Server Activation Key ............................................... 8
Installing the OpenLNS Server ........................................................................ 8
Manually Activating OpenLNS Server or OpenLNS CT .................................. 8
2 Transferring the OpenLNS Server Licenses ................................15
Transferring OpenLNS Server Licenses ....................................................... 16
3 Recovering an OpenLNS Server License ......................................19
Recovering OpenLNS Server Licenses ......................................................... 20

OpenLNS Server License Guide iii

 Preface

The OpenLNS Server network operating system allows LONWORKS network tools to
interoperate with one another and interact with the managed LONWORKS network.
OpenLNS brings the power of client-server architecture and object-oriented
component-based software into control networks. This enables OpenLNS tools to
work together to install, maintain, monitor, and control LONWORKS networks. In
addition, it provides the fastest, most efficient way to bring control on-line with all
your other information systems.

iv Preface
Purpose
This guide explains how to obtain and activate a license for the OpenLNS Server product.

Audience
This guide is intended for system designers and integrators using OpenLNS Server.

System Requirements
System requirements for running the OpenLNS Server are as follows:
 Microsoft Windows® 8 (64-bit and 32-bit), Windows 7 (64-bit and 32-bit), Windows Server 2008
SR2 64-bit, Windows Vista® with Service Pack (SP) 1, or Windows XP with SP3 (32-bit).
 500 MHz processor or faster. 2 GHz processor recommended.
 2 GB or more of free disk space.
 512 MB RAM. 2 GB RAM recommended.
 1,024 MB page file minimum. 2,048 page file recommended.
 1,024 x 768 or higher-resolution display with at least 256 colors.
 Mouse or compatible pointing device
 DVD-ROM drive.
 OpenLDV 4.0-compatible local, remote, or IP-852 network interface.
o Compatible local network interfaces include the U10/U20 USB network interface; PCC-10,
PCLTA-20, or PCLTA-21 network interface cards; and the SLTA-10 Serial LonTalk Adapter.
The PCC/PCLTA and SLTA-10 network interfaces are compatible with 32-bit versions of
Windows only.
o Compatible remote network interfaces include the SmartServer, i.LON 100 Internet Server,
i.LON 600 IP-852 Router, and i.LON 10 Ethernet Adapter.
o Compatible IP-852 network interfaces include the SmartServer (with IP-852 routing option),
i.LON 100 Internet Server (with IP-852 routing option), and i.LON 600 IP-852 Router.

For More Information and Technical Support

If you have technical questions that are not answered by this document, you can contact Echelon
technical support. There is no charge for software installation-related questions during the first 30
days after you download the OpenLNS Server or purchase an OpenLNS Server activation key. To
receive technical support from Echelon, you must purchase support services from Echelon or an
Echelon support partner. See www.echelon.com/support for more information on Echelon support.
Your OpenLNS distributor may also provide customer support.
You can obtain technical support via phone, fax, or e-mail from your closest Echelon support center.
The contact information is as follows:

OpenLNS Server License Guide v

 Region Languages Supported Contact Information
The Americas English Echelon Corporation
Japanese Attn. Customer Support
550 Meridian Avenue
San Jose, CA 95126
Phone (toll-free):
1.800-258-4LON (258-4566)
Phone: +1.408-938-5200
Fax: +1.408-790-3801
[email protected]
Europe English Echelon Europe Ltd.
German Suite 12
French Building 6
Italian Croxley Green Business Park
Hatters Lane
Watford
Hertfordshire WD18 8YH
United Kingdom
Phone: +44 (0)1923 430200
Fax: +44 (0)1923 430300
[email protected]
Japan Japanese Echelon Japan
Holland Hills Mori Tower, 18F
5-11.2 Toranomon, Minato-ku
Tokyo 105-0001
Japan
Phone: +81.3-5733-3320
Fax: +81.3-5733-3321
[email protected]
China Chinese Echelon Greater China
English Rm. 1007-1008, IBM Tower
Pacific Century Place
2A Gong Ti Bei Lu
Chaoyang District
Beijing 100027, China
Phone: +86-10-6539-3750
Fax: +86-10-6539-3754
[email protected]
Other Regions English Phone: +1.408-938-5200
Japanese Fax: +1.408-328-3801
[email protected]

vi Preface
 1

Installing an OpenLNS Server

This chapter provides the information to install your OpenLNS Server.

OpenLNS Server License Guide 7

Downloading the OpenLNS Server
Echelon’s OpenLNS Server is available from the downloads tab of the OpenLNS Web page at
http://www.echelon.com/products/tools/integration/openlns-server. The OpenLNS Server is included
with other products, including the OpenLNS Commissioning Tool.
Once you download your OpenLNS Server product from the Echelon Web site you can install and
activate them as described in the next section.

Acquiring the OpenLNS Server Activation Key

The OpenLNS Server requires an activation key to install the software. An Activation Key comes with
one or more product licenses. Each license may be used on only one PC at a time. You can acquire
this key with any of the following methods.
1. Request a free OpenLNS Server Trial Activation Key. This provides a trial license for one
computer.
2. Request a free OpenLNS Commissioning Tool Trial Activation Key, which includes a trial license
for both the OpenLNS Commissioning Tool and the OpenLNS Server. You will receive a trial
license for one computer.
3. Purchase an OpenLNS Sever Standard Activation Key. One computer can use this license.
4. Purchase the OpenLNS Commissioning Tool Professional or Standard Edition, or purchase the
OpenLNS Commissioning Tool Professional or Standard Activation Key. These products all
include an OpenLNS CT Activation Key that provides up to two OpenLNS Server licenses.
5. Purchase another product that includes an OpenLNS Server Activation Key. This provides a
license for one computer.

WARNING: Do not use the same Activation Key to create a license on more than one PC. If
you use the same key to activate the OpenLNS Server on multiple computers, the licenses will be
deactivated on the old PC when the Echelon License Server detects the duplicate activations.

Installing the OpenLNS Server

When you install the OpenLNS Server, it attempts to communicate with the Echelon license server to
automatically activate your software. If your computer does not communicate with the Echelon
license server, you will need to manually activate the OpenLNS Server. For the OpenLNS
Commissioning Tool (CT), you will need to manually activate both the OpenLNS Server license and
the OpenLNS CT license. The following section describes manual activation.

Manually Activating OpenLNS Server

If your computer was not attached to the Internet (or if the automatic installation failed) when you
installed the OpenLNS Server, you can use the Echelon License Wizard to activate OpenLNS
Server (and OpenLNS CT if purchased together) after you complete the software installation. You
can activate your software via the Internet if your computer is now online, or you can manually
activate your software via e-mail or phone if your computer is still offline. To use the License
Wizard to activate your OpenLNS software, follow these steps:

8 Installing an OpenLNS Server

 1. Open the Echelon License Wizard. Click Start, click Programs, point to Echelon License
Wizard, and then click License Wizard. The Echelon License Wizard opens. Click Next.

2. The Step 1: What would you like to do? dialog opens.

3. To activate your OpenLNS software using the over the Internet or via e-mail, click Activate
Product Licenses and then click Next.
To activate over the phone, click Show Advanced Tasks, Upgrade a Product License over the
Phone, and then follow the instructions in the License Wizard. If your computer is offline,
activate via e-mail if you have e-mail access because activating over the phone requires manually
entering many lengthy alpha-numeric strings. Reading the long license keys over the phone is
error prone due to the length of the keys. To speed up the manual activation process, send
requests via e-mail instead of over the phone.

OpenLNS Server License Guide 9

 4. If your computer is online, the Step 2: What is Your Account Information dialog opens.
Complete the following steps to activate your software (if your computer is still offline, proceed to
step 5):
a. Enter your account information and/or your OpenLNS Server activation key, and then click
Next.
b. The Step 3: Which License Would You Like to Activate? dialog opens.
c. Select Activate from the Action list for OpenLNS Server, and then click Next.
d. The Step 4: Status dialog opens, and the License Wizard activates your licenses.
e. Click Exit to close the License Wizard.
5. If your computer is still offline or if your computer cannot communicate to the Echelon license
server, the Step 2: Which Product Would You Like to Get a License For dialog opens.

6. Enter your OpenLNS Server activation key in the Enter Your Activation Key box and then click
List Products. The License Wizard lists your OpenLNS Server and, if included, your OpenLNS
CT products. Select Activate from the Action list for both OpenLNS Server and OpenLNS CT,
and then click Next.

WARNING: Do not use the same Activation Key to create a license on more than one PC. If
you use the same key to activate the OpenLNS Server on multiple computers, the licenses will be
deactivated on the old PC when the Echelon License Server detects the duplicate activations.

10 Installing an OpenLNS Server

 6. The Step 3: Where Would You Like to Save Your License Requests? dialog opens.

7. In the Request File Name property, enter a full path where a license request file (.elwrq
extension) is to be saved, or click Browse, specify the directory where the license request file is to
be saved, and then enter a name for the file.
Under Authentication Details, enter the Echelon ID (e-mail address) and Password you created
for your Echelon download account (see step 2 if you do not have an Echelon download account).
The Activation Key box displays the 25-character alphanumeric string for the Echelon product to
be activated. Do not modify this property.
Click Next.
8. The Status dialog opens. The License Wizard confirms the creation of the license request file.

OpenLNS Server License Guide 11

 9. Click Send Request to Echelon to e-mail the license request file to Echelon at
[email protected]. Echelon will send you an e-mail message with a license response
(.elwrs extension) file. For faster activation, copy the license request file to an Internet-connected
computer with the License Wizard installed on it and importing it into the License Wizard. The
License Wizard creates the license response file, which you can then copy to the original
computer.
10. Import the license response (.elwrs extension) file into the License Wizard and activate your
OpenLNS Server (and OpenLNS CT license, if applicable) following these steps:
a. Start the Echelon License Wizard.
b. In the Task Selection dialog, click the Show Advanced Topics link, and then click the
Process a License Response File Obtained from Echelon option.

12 Installing an OpenLNS Server

 c. The Import License Request or Response File dialog opens. In the File Name property,
enter the full path of the license response file (.elwrs extension), or click Browse and then
select the file. Click Next.

d. The Check License Response File dialog opens. Confirm that the Echelon product licenses
in the license response file are the ones you want to activate. Click Next. The License Server
installs and activates the licenses in the license response file.

e. The Status dialog opens and confirms that the OpenLNS Server and, if included, OpenLNS
CT licenses, have been successfully activated.

OpenLNS Server License Guide 13

 11. Click Exit to close the License Wizard.

14 Installing an OpenLNS Server

 2

Transferring the OpenLNS

Server Licenses

Your OpenLNS Server license can be moved from one computer to another. This chapter
gives you the steps to transfer a license.

OpenLNS Server License Guide 15

Transferring OpenLNS Server Licenses
You can transfer your OpenLNS Server license (and, if you purchased OpenLNS CT, that license)
from one computer to another using the Echelon License Wizard. Transferring your license lets you
upgrade or switch your OpenLNS Server or OpenLNS CT computer without losing your license. You
cannot use the License Wizard to install one license on multiple computers.
To transfer your license, follow these steps:
1. On the source computer, return the OpenLNS license:
a. Open the Echelon License Wizard. Click Start, click Programs, point to Echelon License
Wizard, and then click License Wizard. The Echelon License Wizard opens. Click Next.
b. The Step 1: What Would You Like to Do? dialog opens. Click Manage Product Licenses
and then click Next.
c. The Step 2: Which License Would You Like to Manage? dialog opens. Select Return
from the Action column of your OpenLNS Server and OpenLNS CT licenses, and then click
Next

d. The Step 3: Enter Customer Information dialog opens. Enter the User ID (e-mail address)
and Password you created for your Echelon download account. If you do not have an Echelon
download account, click the Sign Up for a New Account link, and create one on the Echelon
Web site. If you forgot your password, you can retrieve it by clicking the Forgot Your
Password link. This opens the Echelon Web site, where you can request the password to be
e-mailed to you.
Optionally, you can select the Activation Key check box and enter your product's
25-character alphanumeric string (five groups of five characters) that you received when you
purchased your Echelon software product or products. This associates the product's activation
key with your account, and it identifies all the Echelon products that you purchased in a single
transaction.

16 Transferring the OpenLNS Server

 You can select the Remember Me on this Computer check box to preserve your login
credentials. This check box is selected by default, which means that your credentials will
automatically be entered the next time you start the License Wizard.
If your computer does not have an Internet connection, click Work Offline, and then create a
license request file (.elwrq extension) in the Step 4: Where Would You Like to Save Your
License Requests dialog. After you save your license request, you can activate the license on
the target computer by e-mailing the license request file to Echelon at
[email protected], or by copying it to the target computer (if it has an Internet
connection) and importing it into the License Wizard.

e. Your OpenLNS Server (and OpenLNS CT) licenses are returned to the Echelon License
Server. The Step 4: Status dialog opens and report the results of the license return.

OpenLNS Server License Guide 17

 2. Install OpenLNS Server (and, if included, OpenLNS CT) on the target computer following the
steps described earlier in this document. In the Customer Information window, enter the
activation key you returned in step 1.

18 Transferring the OpenLNS Server

 3

Recovering an OpenLNS
Server License

This chapter provides the steps to recover your OpenLNS Server license.

OpenLNS Server License Guide 19

Recovering OpenLNS Server Licenses
You can recover a license that you lost because of hardware failure, hardware changes, or a BIOS
change on your computer.

WARNING: Do not use the same Activation Key to create a license on more than one PC. If
you use the same key to activate the OpenLNS Server on multiple computers, the licenses will be
deactivated on the old PC when the Echelon License Server detects the duplicate activations.

To recover your license, follow these steps:

1. Open the Echelon License Wizard. Click Start, click Programs, point to Echelon License
Wizard, and then click License Wizard. The Echelon License Wizard opens. Click Next.

2. The Step 1: What Would You Like to Do? dialog opens. Click Manage Product Licenses and
then click Next. Click Show Advanced Tasks at the bottom left of the Step 1 page

20 Recovering an OpenLNS Server License

 3. The advanced tasks are now added to the dialog.

4. Click Recover Licenses Lost on an Inaccessible Computer, and then click Next. The Step 2:
What is your account information? Wizard dialog appears.

OpenLNS Server License Guide 21

 5. Enter your Echelon ID and Password, and then click Next. The Step 3: Which license would you
like to recover? dialog now appears in the License Wizard.

22 Recovering an OpenLNS Server License

 6. Select Recover under Action for each of the licenses to be recovered. This option will only be
available for licenses that you have previously activated.

OpenLNS Server License Guide 23

www.echelon.com