Silo - Tips - Dnastar Lasergene 12 Network Client Installation Guide For Windows and Macintosh

Download as pdf or txt
Download as pdf or txt
You are on page 1of 55

® ®

DNASTAR Lasergene 12
Network / Client Installation Guide

For Windows® and Macintosh®

DNASTAR, Inc. 2014


Contents
Contents ..........................................................................................................................................2

Before You Begin ...........................................................................................................................4

Quick-Start Guide..........................................................................................................................5

Downloading Installation Software ..............................................................................................6

Network License Server Installation ............................................................................................6

Technical Requirements.........................................................................................................6

Windows Installation Instructions .........................................................................................7

Macintosh Installation Instructions ......................................................................................11

License Server Authorization ..............................................................................................16

Network Client Installation.........................................................................................................19

Technical Requirements.......................................................................................................19

Windows Installation Instructions .......................................................................................19

Macintosh Installation Instructions ......................................................................................23

Network Client Authorization ....................................................................................................28

Installations that Include the GenVision Plug-In .................................................................31

Installations that Include SeqMan NGen or SeqNinja .........................................................31

Advanced Network Client Installation.......................................................................................32

File Locations ...............................................................................................................................33

Trouble-Shooting .........................................................................................................................37

License Server Authorization ..............................................................................................37

Client Software Authorization .............................................................................................41

2 Lasergene Network / Client Installation Guide


Changes to Your License Server’s IP Address ....................................................................41

Verifying License Server Status ..........................................................................................41

Restarting the License Server ..............................................................................................42

Handling a Firewall on the Server Machine ........................................................................43

Frequently Asked Questions .......................................................................................................44

Installation............................................................................................................................44

Licensing/Authorization ......................................................................................................46

General Networking .............................................................................................................47

Network Installation.............................................................................................................48

License Server Administration ............................................................................................49

Network Troubleshooting ....................................................................................................52

Lasergene Network / Client Installation Guide 3


Before You Begin
We’re here to help! If you have any difficulties with or questions about installation, please
contact a DNASTAR support representative:

• E-mail: [email protected]

• Phone (Madison, WI, USA): 608-258-7420

• In the USA and Canada, call toll free: 1-866-511-5090

• In the UK, call free on: 0-808-234-1643

• In Germany, call free on: 0-800-182-4747

This document pertains to Lasergene® version 12 and was last updated on September 15, 2014.

For copyright and trademark information, please see the Legal Information page of our website.

Note regarding 64-bit Windows computers: Most Windows paths shown in this guide apply to
both 32- and 64-bit machines. An exception is that files shown as being located in C:\Program
Files are located in C:\Program Files (x86) on 64-bit machines.

4 Lasergene Network / Client Installation Guide


Quick-Start Guide
For users with past experience installing DNASTAR network software, the following steps give
very basic instructions for upgrading your network:

1) Download the DNASTAR Lasergene License Server for Windows or Macintosh from your
web account onto the computer that is currently running your Lasergene license server. If
you need to install the license server software on a different computer, please contact our
support staff for help facilitating the transfer.

2) Run the installer on the computer acting as the license server for the Lasergene network.
After the installation finishes, you will be asked to enter a product key for authorization. You
can find your key under the License Details tab while logged into your DNASTAR web
account.

3) Once authorized, a new LasergeneClient’x’ folder (where ‘x’ is the version number) will be
placed on your server’s desktop. This folder will contain a text file with your server’s IP
address, several *.lshost files (needed only for advanced installations), and an HTML file
with client installation instructions.

Note: The LasergeneClient’x’ folder is no longer the installation folder for local installations.
Now, the end-user simply needs a Lasergene Client installer plus the server IP address in
order to access the Lasergene network.

4) If the server machine uses a firewall, follow the instructions in Handling a Firewall on the
Server Machine.

5) Download the DNASTAR Lasergene ‘x’ Client Installer for Windows or Macintosh onto the
client machine.

Note: We recommend saving a copy of this in the LasergeneClient’x’ folder in case you need
it in the future.

6) Run the client installer and accept all defaults. When prompted, type in the IP address for the
license server computer. For deployment, simply provide the local access points/installations
with the appropriate installers, and the correct IP address of the license server computer listed
in the new LasergeneClient’x’ folder.

For detailed installation instructions, please refer to the remainder of this Installation Guide,
beginning with Downloading Installation Software.

Lasergene Network / Client Installation Guide 5


Downloading Installation Software
If you do not have an installation USB drive, your purchased DNASTAR software may be
downloaded from our website.

1) Go to the sign-in page of the DNASTAR website. After signing in, you will be transferred to
your Account pages. Click on the Installers tab:

2) Click a link or a globe icon ( ) to download the software. Network installation requires
download of both License Server software and Windows/Macintosh Client software. You
may download the software to any location on your computer, but downloading to the
desktop is usually most convenient.

Network License Server Installation


This section explains how to install and authorize the DNASTAR License Server software on a
computer designated as a server. See Network Client Installation for information about installing
the Lasergene software on individual user machines. These instructions apply to all DNASTAR
products: Lasergene Core Suite, Navigator, SeqMan NGen, ArrayStar and QSeq.

Note: Administrator privileges are required to perform License Server installation.

Technical Requirements
For a list of technical requirements related to the network license server, please refer to our
DNASTAR License Server Technical Requirements web page.

6 Lasergene Network / Client Installation Guide


Windows Installation Instructions
Note: Administrator privileges are required to perform License Server installation.

1) If you are using downloaded software, double-click on the DNASTAR Lasergene License
Server Installer executable (*.exe) file to initiate installation.

If using a USB drive, insert the LASERGENE‘x’ USB drive (where ‘x’ is the version
number) into any USB port. Browse to the USB drive and double-click on the executable.

2) In the Welcome dialog, read the instructions, and then click Next.

3) This installation requires the server machine to have a static IP address manually configured
in the TCP/IP setting. If your machine instead has a dynamic IP address, you will see the
Important Notes dialog. Follow the on-screen instructions and click Next.

If you do not see the dialog below, skip to the next step.

Lasergene Network / Client Installation Guide 7


4) In the License Agreement dialog, click Yes to accept the agreement.

5) In the Choose Destination Directory dialog, observe that the Space Required and Space
Available for installation is displayed in the bottom right corner of the dialog.

8 Lasergene Network / Client Installation Guide


Note: Though we strongly recommend installing in the default location (C:\Program
Files\DNASTAR-LicenseServer or C:\Program Files (x86)\DNASTAR-LicenseServer, for 64-
bit machines), you may click Browse to install in a custom location.

If you are upgrading from a previous Lasergene Network License Server, the new version
should be installed in the same directory as the previous version. Once the new version of the
License Server is installed, you will still be able to run previous network client versions
during your client upgrade process. After choosing a location, click Continue.

Click Next.

6) In the Choose Components dialog, you can highlight a component to see information about it
in the Description pane. Leave both Components boxes checked and click Next.

Lasergene Network / Client Installation Guide 9


7) In the Complete the Installation dialog, click Next.

You will see a progress bar, and a new folder named LasergeneClient‘x’ will appear on the
desktop.

Please proceed to License Server Authorization for information on authorizing the license server.

10 Lasergene Network / Client Installation Guide


Macintosh Installation Instructions
Note: Administrator privileges are required to perform License Server installation.

1) Using a downloaded file or the LASERGENE‘x’ USB drive (where ‘x’ is the version
number), double-click on the Lasergene License Server Mac Install package (*.pkg) file to
initiate installation.

2) In the Welcome dialog, read and follow the instructions, and then click Continue.

7) This installation requires the server machine to have a static IP address manually configured
in the TCP/IP setting. If your machine instead has a dynamic IP address, you will see the
Important Notes dialog. Follow the on-screen instructions and click Continue.

If you do not see the dialog below, skip to the next step.

Lasergene Network / Client Installation Guide 11


3) In the Software License Agreement dialog, read the agreement and click Continue.

4) Click Agree to accept the agreement.

12 Lasergene Network / Client Installation Guide


5) The Standard Install on “Macintosh HD” dialog displays the amount of space required for
installation.

Lasergene Network / Client Installation Guide 13


Note: Though we strongly recommend installing in the default location (Library
DNASTARLicenseServer), you may click Change Installation Location to install in a
custom location. After clicking, the Select a Destination dialog appears with information
about free disk space, total disk space and installation requirements.

If you are upgrading from a previous Lasergene Network License Server, the new version
should be installed in the same directory as the previous version. Once the new version of the
License Server is installed, you will still be able to run previous network client versions
during your client upgrade process. After choosing a location, click Continue.

Click Install to initiate installation.

6) When prompted, type in your Macintosh password. You will see a progress bar.

7) The final dialog will display the following message: “The installation was completed
successfully.” Click Close.

14 Lasergene Network / Client Installation Guide


Please proceed to License Server Authorization for information on authorizing the license server.

Lasergene Network / Client Installation Guide 15


License Server Authorization
After completing Windows or Macintosh installation, the License Server Authorization dialog
appears.

1) Uncheck boxes for software you do not want to associate with the License Server, if any.

2) Click Next to display a second License Server Authorization dialog.

16 Lasergene Network / Client Installation Guide


3) Enter your 15-digit alphanumeric License (product key) and then click Authorize.

Note: If you do not have this information, follow the procedure below:

a) Click Find to go to the License Details page of your DNASTAR account. If not already
logged in, you will be prompted to do so.

b) From the License Details page, copy the appropriate Product Key to your clipboard.

c) Returning to the License Server Authorization dialog, paste the text into the License
field, then click Authorize.

You will see a progress bar, followed by the Licensed Applications dialog:

This dialog displays the applications (or suites) associated with this License Server
authorization, and the number of user licenses for each. Applications (or suites) that are not
associated with this authorization are shown as “unavailable.”

4) Click OK to complete the authorization.

5) After authorizing the software, the following events will occur:

Lasergene Network / Client Installation Guide 17


• A new folder named LasergeneClient‘x’ (where ‘x’ is the version number) will appear on
the desktop and may open automatically. The detected IP Address of the server computer,
required for network client installation, can be found in this folder as a file named IP
Address [x.x.x.x].txt.

• A browser window entitled Installing Lasergene Software on Client Computers may


open. This page provides information and links for installing the DNASTAR Lasergene
network client. The page can be re-opened later from the LasergeneClient‘x’ directory by
double-clicking on Lasergene Installation.html.

Proceed to Network Client Installation for information on installing Lasergene software on


individual client machines.

18 Lasergene Network / Client Installation Guide


Network Client Installation
This section explains how to install DNASTAR Lasergene as a network client working in
tandem with a DNASTAR License Server. These instructions apply to all DNASTAR products:
Lasergene Core Suite, Navigator, SeqMan NGen, ArrayStar and QSeq.

Note: Before installing a network client, all steps for the Network License Server Installation
must already have been completed.

Technical Requirements
For lists of technical requirements related to the network client, please refer to the web pages
below:

• Lasergene Core Suite Technical Requirements

• ArrayStar Technical Requirements

• QSeq Technical Requirements

• SeqMan NGen Technical Requirements

Windows Installation Instructions


Note: Administrator privileges are required to perform this installation. Close all existing
DNASTAR software before beginning installation.

1) If you are using downloaded software, double-click on the DNASTAR Lasergene Installer
executable (*.exe) file to initiate installation. If using a USB drive, insert the
LASERGENE‘x’ USB drive (where ‘x’ is the version number) into any USB port. Browse
to the USB drive and double-click on the executable.

You will see a progress bar, followed by the Welcome dialog.

Lasergene Network / Client Installation Guide 19


2) Read and follow the Welcome message instructions, and then click Next.

2) In the Lasergene Software License Agreement dialog, read the agreement, and then click Yes
to accept.

20 Lasergene Network / Client Installation Guide


3) The Select Components dialog lets you choose which applications to install.

Check the components you want to install and uncheck those you do not want to install. To
verify that your computer has enough disk space for the selected applications, review the
Space Required and Space Available (in KB) displays in the bottom right corner of the
dialog. Click Next.

4) In the Installation Options dialog, we recommend that you select Run Installation Silently.
This choice will install the software in the default location: C:\Program Files\DNASTAR (or
C:\Program Files (x86)\DNASTAR for 64-bit machines). For custom installations, choose
Display Installation Dialogs.

Lasergene Network / Client Installation Guide 21


Click Next.

• If you selected Run Installation Silently, you will see one or more progress bars in
sequence, one for each component you selected:

When prompted, click Close to complete the setup.

• If you instead selected Display Installation Dialogs, you will see the first progress bar,
followed by a Welcome dialog (as in Step 1). Follow the instructions in the installer
dialogs. If you would like to choose a custom installation location (optional), use the
Browse button. The default Windows installation location is C:\Program
Files\DNASTAR\[ApplicationName] (or C:\Program Files
(x86)\DNASTAR\[ApplicationName] for 64-bit machines).

Click Close or Finish to complete the setup. You will be prompted to repeat the steps in
this "bullet-point" again for each component that you are installing.

During installation, you will be prompted to authorize the software. For detailed information
about the authorization procedure, see Network Client Authorization.

22 Lasergene Network / Client Installation Guide


Macintosh Installation Instructions
1) If you are using downloaded software, skip to the next step. If you are using a USB drive,
insert the LASERGENE‘x’ USB drive (where ‘x’ is the version number) in any USB port.
Copy the installer from the USB drive to your computer.

2) Double-click on the DNASTAR Lasergene Installer disk image (*.dmg) file and enter your
Macintosh password when prompted.

3) The Introduction dialog opens. Click Continue.

4) In the License dialog, read the agreement, then click Continue.

Lasergene Network / Client Installation Guide 23


5) Click Agree in the ensuing pop-up window to accept the agreement.

6) In the Installation Type dialog make sure that the items you wish to install are checked. If not
already expanded, click the expand arrow to the left of "DNASTAR Lasergene" to reveal all
available applications. Check the components you want to install and uncheck those you do
not want to install. To check all applications, click Select All.

Note: You must have Parallels Desktop installed to run ArrayStar and QSeq.

24 Lasergene Network / Client Installation Guide


To verify that your computer has enough disk space for the selected applications review the
Disk space available and Approximate disk space needed (in MB) displays at the bottom
of the dialog.

To read a brief description of an application and to see its size in MB, click the question

mark ( ) icon to its right. Then click OK to return to the Installation dialog.

Lasergene Network / Client Installation Guide 25


Once back in the Installation dialog, click Install to initiate installation of the selected
components. You will see one or more progress bars, and multiple DNASTAR Application
folders may open.

7) After installation has finished, the Finish Up dialog will appear. Click Quit to complete the
setup.

26 Lasergene Network / Client Installation Guide


During installation, you will be prompted to authorize the software. For detailed information
about the authorization procedure, see Network Client Authorization.

Lasergene Network / Client Installation Guide 27


Network Client Authorization
During installation, the DNASTAR Lasergene Authorization dialog may open automatically.

Note: If you installed Lasergene from a folder with the correct *.lshost files present, you will not
be prompted to authorize, as authorization is not necessary in this case.

1) Read the message carefully. Check or uncheck boxes, as desired, and click Next.

28 Lasergene Network / Client Installation Guide


2) Enter the required information in the Lasergene Authorization dialog. For DNASTAR
License Type, select Network.

Then enter the Network License Server’s Hostname or IP address. If you don’t have this
information, contact your IT administrator.

Click the Authorize button.

Note 1: To open the authorization dialog at a later time, you may do so from the Navigator.
If the Navigator is not already open, launch it from the Start menu. Click on the License
Manager button in the bottom-right corner to open the authorization dialog.

Note 2: If you receive an Unable to authorize error message, consult If You Have Trouble
Authorizing the Client Software.

3) If prompted, choose whether or not you wish to share anonymous platform and usage
statistics with DNASTAR.

4) If it is not already open, launch the DNASTAR Navigator from the Start Menu or
Applications folder.

Lasergene Network / Client Installation Guide 29


The installed Lasergene applications can now be accessed via the DNASTAR Navigator, the
DNASTAR folders in the Start menu (Windows) or the Applications:DNASTAR folder
(Macintosh).

30 Lasergene Network / Client Installation Guide


Installations that Include the GenVision Plug-In
If your installation will include the GenVision plug-in for Adobe Illustrator, you must close
Illustrator before you begin.

After installation and authorization are complete, you then need to manually move the file
GenVision.aip into the Adobe Illustrator Plug-ins folder.

Installations that Include SeqMan NGen or SeqNinja


After installing SeqMan NGen and/or SeqNinja, they can be run from the Start menu or the
Navigator without restarting the client machine.

However, if the installation included one or both of these applications and you wish to launch
them directly through the command line, then you will need to restart the client machine before
launching the application.

Note: The installer will not prompt you to restart the machine.

Lasergene Network / Client Installation Guide 31


Advanced Network Client Installation
Normal network client installation requires following the steps in the Network Client Installation
for each client machine.

Advanced installation lets you distribute a folder containing a preconfigured Lasergene


installation to computers on your network, allowing quick installation on multiple machines.

1) Windows: Double-click on the DNASTAR Lasergene Windows Installer executable (*.exe)


file to extract it into a folder called DNASTAR Lasergene ‘x’ (where ‘x’ is the version
number). This folder contains a subfolder named Contents.

Macintosh: Double-click on the DNASTAR Lasergene Macintosh Installer disk image


(*.dmg) file. This mounts the DNASTAR Lasergene ‘x’ disk, which contains a subfolder
named Contents.

2) Open the LasergeneClient‘x’ folder and copy the three files with the extension *.lshost into
DNASTAR Lasergene ‘x’\Contents folder:

• Lasergene Core Suite: LG‘x’.lshost

• SeqMan NGen: NG‘x’.lshost

• ArrayStar (with QSeq): AS‘x’.lshost

3) Copy the entire DNASTAR Lasergene ‘x’ folder to a USB drive or a shared network drive
that can be accessed by each client.

4) You may now run the DNASTAR Lasergene Installer for Macintosh or Windows on each of
the client machines. Be sure to run the installer from the modified DNASTAR Lasergene ‘x’
folder to ensure that the *.lshost files are automatically recognized by the installer.

32 Lasergene Network / Client Installation Guide


File Locations
The following file names use ‘x’ to represent the version number.
File Category Application Path
Lasergene Core Suite
(SeqBuilder, SeqMan Pro,
Protean 3D, GeneQuest,
Windows: C:\Program Files\DNASTAR\Lasergene x
Protean, MegAlign, MegAlign
Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x
Pro, PrimerSelect, EditSeq,
GenVision Standalone,
GenVision Utility, SeqNinja)
Application2 ArrayStar Windows: C:\Program Files\DNASTAR\ArrayStar x
Windows: C:\Program Files\DNASTAR\Navigator x
Navigator
Macintosh: Hard Drive:Applications:DNASTAR:Navigator x
Windows (installed location for plug-in): C:\Program Files\DNASTAR\Lasergene
x
GenVision Plug-In Windows (working location for plug-in): C:\Program Files\Adobe\Adobe Illustrator
CSx\Plug-ins
Macintosh (plug-in): Hard Drive:Applications:Adobe Illustrator CSx:Plug-ins
Lasergene Core Suite
Data
(SeqBuilder, Protean 3D,
Manager2 Windows: C:\Program Files\DNASTAR\Lasergene x
GeneQuest, Protean,
(DMx, Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x
MegAlign, MegAlign Pro,
DMx.exe)
PrimerSelect)
Windows 7 & Windows 8: C:\Program Data\DNASTAR\DataManager
Lasergene Core Suite
Windows XP: C:\Documents and Settings\All Users\Application
(SeqBuilder, Protean 3D,
Data Manager Data\DNASTAR\DataManager, C:\Documents and
GeneQuest, Protean,
State File Settings\<username>\Application Data\DNASTAR
MegAlign, MegAlign Pro,
Macintosh: HD:Library:Application Support:DNASTAR:DataManager
PrimerSelect)
HD:Library:Preferences:DNASTAR:DataManager,

Lasergene Network / Client Installation Guide 33


File Category Application Path
HD:Library:Users:<username>:Library:Preferences:DNASTAR:DataManager

34 Lasergene Network / Client Installation Guide


File Category Application Path
Windows XP 32bit, Windows 7 or higher: C:\Program
License Manager2 All Files\DNASTAR\License Manager
Macintosh: Hard Drive:Applications:DNASTAR: License Manager
Server License File (lservrc), Server
License Manager 2
Windows: C:\Program Files\DNASTAR-License Server\Server
(DNASTARServerLicenseManagerx), All
Macintosh: Hard Drive:Library: DNASTAR-License Server
Server Executables (lserv,
lservnt.exe)
Windows 7 & Windows 8: C:\Program Data\DNASTAR\Licenses
Standalone & Trial Licenses
Windows XP: C:\Documents and Settings\All Users\Application
(*.license), License Server Client
All Data\DNASTAR\Licenses
License (*.lshost), Key Server Client
Macintosh: Hard Drive:Library:Application
License (*.keyhost)
Support:DNASTAR:Licenses
Windows 7 & Windows 8: C:\Users\Public\Public
Lasergene Core Suite
Documents\DNASTAR\Lasergene x Data\Demo Data (and Demo
(SeqBuilder, SeqMan,
[ApplicationName])
Protean 3D, GeneQuest,
Windows XP: C:\Documents and Settings\All
Demo Data Files Protean, MegAlign,
Users\Documents\DNASTAR\Lasergene x Data\Demo Data (and
MegAlign Pro,
Demo [ApplicationName])
PrimerSelect, EditSeq,
Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x
GenVision, SeqNinja)
Data:Demo Data (and Demo [ApplicationName])

Lasergene Network / Client Installation Guide 35


File
Application Path
Category
Most of the Lasergene Core Suite Windows 7 & Windows 8: C:\Users\<User>\AppData\Local\DNASTAR\
(SeqBuilder, SeqMan, GeneQuest, Protean, Windows XP: C:\Documents and Settings\<User>\Local
MegAlign, MegAlign Pro, PrimerSelect, Settings\Application Data\DNASTAR\
EditSeq) Macintosh: Hard Drive:Users:<User>:Library:Preferences
Windows 7 & Windows 8: C:\Users\<User>\DNASTAR\Protean3D (or
Navigator, or SeqNinja)
Windows XP: C:\Documents and
Preferences Protean 3D, Navigator, SeqNinja
Settings\<User>\DNASTAR\Protean3D (or Navigator, or SeqNinja)
Macintosh: Hard Drive:Users:<User>:DNASTAR:Protean3D (or
Navigator, or SeqNinja)
Windows 7 & Windows 8:
C:\Users\<User>\AppData\Roaming\DNASTAR\ArrayStar\2.0
ArrayStar
Windows XP: C:\Documents and Settings\<User>Application
Data\DNASTAR\ArrayStar\2.0

Note 1: AppData is a hidden folder in Windows 7 and higher. To unhide the folder, go to Organize > Folder and Search Options >
View > Show Hidden files and folders.

Note 2: Files shown as being located in C:\Program Files are located in C:\Program Files (x86) on 64-bit machines.

36 Lasergene Network / Client Installation Guide


Trouble-Shooting

License Server Authorization


After Network License Server Installation, you will be prompted to authorize the License Server
software using this dialog:

If you enter unrecognized information and click Authorize, you may receive one of the error
messages shown in the table below. To address the issue, click the OK button in the error
message. This returns you to an enhanced version of the original authorization dialog:

Lasergene Network / Client Installation Guide 37


Correct your earlier entry using the solution in the table below, then again click Authorize.

If you received this error message… …try this solution:

If authorizing the License Server,


ensure you are using the License
Server License Manager located in
the C:\Program Files\DNASTAR-
LicenseServer\Server folder.

If authorizing the Client, verify that


you are using the Client License
Manager available through the
Navigator or in the C:\Program
Files\DNASTAR\License Manager
directory.

Check that you have entered the


Product Key correctly, and that it is
the appropriate key and type
(Standalone/Client vs. Network) for
the Lasergene application and
version that you are installing.

If you receive the error message again, you may wish to perform a manual authorization.

Note: Manual authorization is only for the License Server and Standalone versions of Lasergene,
and does not apply to Client installations.

1) From the enhanced version of the License Server Authorization dialog, click the Manual
button. This will initiate a four-step process.

2) In the “Step 1 of 4” dialog, click the Copy Computer ID button to copy the unique ID
number to your computer’s clipboard. Then click Next.

38 Lasergene Network / Client Installation Guide


3) In the “Step 2 of 4” dialog, click the Launch Browser button to view the DNASTAR
License Server Authorization web page.

The browser opens to the following page:

Lasergene Network / Client Installation Guide 39


4) Click Network License Server to view the page below:

5) Make selections and enter information into the fields as follows:

• Choose the Product you wish to authorize.

• Paste your clipboard contents into the Your Computer ID field by using Ctrl/Cmd+V
or by right-clicking and choosing Paste.

• Manually type your key in the Product Key field.

6) Click Submit. A page with your authorization keys will load in the browser.

7) Highlight all the text below the term "Keys:" and copy the text onto your clipboard.

8) Go back to the Manual DNASTAR License Server Authorization dialog and click Next.

9) Click Paste Key to paste the copied text into the Key field.

10) Click Finish.

40 Lasergene Network / Client Installation Guide


Client Software Authorization
The authorization key for Lasergene network client software is the IP address of the license
server computer. If you are the end user, please contact your system administrator for this
information.

If you are the system administrator, you can find the license server's IP address by opening the
LasergeneClient‘x’ folder (where ‘x’ is the version number) located on the desktop. The number
in the file name IP Address [x.x.x.x].txt is the authorization key for the network clients.

Changes to Your License Server’s IP Address


If you have performed a network installation and the IP address of the license server changes,
you will need to update the IP address on the client machines.

1) Launch DNASTAR Navigator and click on the License Manager application.

2) Enter your server’s new IP Address or Hostname and click Authorize.

Verifying License Server Status


On Windows:

1) Launch WlmAdmin.exe from C:\Program Files\DNASTAR-LicenseServer\Admin\.

2) Choose Edit>Defined Server List, add the IP address of your Server, and click OK. Then
click the plus sign (+) next to Defined servers.

3) In the ensuing list, click the plus sign (+) next to your server.

4) Click on any of the modules listed, then look on the right side of the dialog to find the
Feature Information section (under Statistics).

5) Confirm that the “Total” column contains the correct number of uses. Confirm this with all
the modules, including Lasergene 6.

Note: “6” is part of the feature name, which is the same for all versions, and does not reflect
what version you are running. For example, versions 9 and later clients can be run from a
version 6 server.

Lasergene Network / Client Installation Guide 41


6) Navigate to Control Panel > Administrative Tools > Services.

7) Find “DNASTARLicenseServer” on the list and make sure it is Started.

On Macintosh:

1) Go to Hard Drive:Library:DNASTARLicenseServer.

2) Drag and drop lsmon into Terminal (usually located in Hard Drive:Applications:Utilities).

3) Type a space followed by the IP address of the License Server computer. Then click Enter.
A string of text will appear, broken into sections based on the total number of modules plus
one. Lasergene will be one of these sections. Each section will list the module and the “Max
concurrent user(s).”

4) Verify that all the correct modules and correct number of uses appear on the list.

5) Navigate to Applications > Utilities > Activity Monitor. Look at “All Processes” to verify
that lserv is running.

Restarting the License Server


On Windows:

1) Navigate to Control Panel > Administrative Tools > Services.

2) On the list, right-click on “DNASTARLicenseServer” and choose Restart.

3) After restarting, check WlmAdmin to confirm the server is running with the correct
number of modules and licenses.

On Macintosh:

1) Navigate to Hard Drive:Library:DNASTARLicenseServer.

2) Launch lsrelaunch.command to bring up a Terminal screen.

3) Enter your Administrator password to restart the service.

4) Run lsmon to confirm that the server is now running with the correct number of modules
and licenses.

42 Lasergene Network / Client Installation Guide


Alternately, you may restart the service manually by opening a Terminal session, and issuing the
following two commands:

• sudo launchctl stop com.dnastar.license-server

• sudo launchctl start com.dnastar.license-server

Handling a Firewall on the Server Machine


If the server computer’s firewall is “on,” you will need to allow an exception for the DNASTAR
lserv (Macintosh) or lservnt.exe (Windows) file.

On Windows:

1) Determine whether a firewall is present by navigating to Control Panel (Classic View) >
Windows Firewall. Check whether the firewall is on or off.

2) If a firewall is present, allow an exception for the lservnt.exe file. Click Windows 8,
Windows 7, or Windows XP & Windows Server 2003 for instructions.

3) When prompted to choose a program path, browse to C:\Program Files\DNASTAR-


LicenseServer\Server\lservnt.exe.

4) If prompted, make sure that Domain, Private, and Public are all selected.

On Macintosh:

1) Determine whether a firewall is present by navigating to System Preferences > Security.


Click the “Firewall” tab and note whether the firewall is on or off. On OS X 10.6, if
Allow all incoming connections is selected, the firewall is off.

2) If a firewall is present, make sure that lserv is set to Allow incoming connections. See
OS X Mountain Lion or OS X Lion for details.

Lasergene Network / Client Installation Guide 43


Frequently Asked Questions

Installation
After installing DNASTAR software on Windows Vista, Windows 7 or
Windows 8, I receive the message "This program might not have installed
correctly." What should I do?

A notification like the one below appears occasionally after installing DNASTAR software on
Windows Vista, Windows 7 or Windows 8:

(The name of the .exe file varies according to the application you are installing). This message
can be safely ignored. Simply click on This program installed correctly and proceed with
using the software.

44 Lasergene Network / Client Installation Guide


I installed ArrayStar on my Macintosh with Parallels Desktop. Why is the
ArrayStar application still grayed out in Navigator?

In order for Navigator to locate ArrayStar on a Macintosh running Parallels Desktop, Parallel
Tools must first be installed. To do this, open Parallels Desktop and select Virtual Machine >
Install Parallels Tools from the menu bar. The next time you open Navigator, you will be able
to launch ArrayStar from the console.

When I initiate installation of ArrayStar with QSeq 4 or higher on my


Macintosh, why does my text editor open instead?

Before installing ArrayStar with QSeq 4 or higher, the *.exe file extension must first be
associated with Windows Explorer. By default, Macintosh associates the *.exe extension with its
own Text Edit application. When you install Parallels Desktop, the association is usually
changed to Windows Explorer. If Parallels Desktop did not change the association, this can be
done manually as follows:

Open the Contents folder of the DNASTAR Lasergene 9 (or higher) disk image or installer,
right-click on ArrayStar 4 (or higher) Installer.exe and choose Get Info. Expand the Open With
section and choose Windows Explorer from the drop down menu. ArrayStar with QSeq can
now be installed by double-clicking on its *.exe file.

Why can't I install a DNASTAR application on my Mac after downloading it


in Parallels Desktop or VMware Fusion?

Macintosh programs downloaded on Parallels Desktop or VMware Fusion may not install
properly after moving them to the Mac side of the machine. You may receive an error message
such as: "Assertion failed!" This is because the Windows operating system does not support
certain Mac resources during file download.

To fix this issue, download the software on the Macintosh side rather than on the Windows side
of your Mac machine.

Lasergene Network / Client Installation Guide 45


Licensing/Authorization
I purchased a perpetual license from DNASTAR. What rights do I have and
what obligations does DNASTAR have under this license?

In the normal course of business, DNASTAR frequently grants the user of our software a
perpetual license for the use of such software. A perpetual license is defined as the use of the
license for the software version purchased, for an unlimited period of time. A perpetual license
does not permit users to place DNASTAR's software on more computers than were licensed for
use in the initial purchase.

DNASTAR is not under any obligation to provide users of the software with support or
additional copies of the original version of software purchased for backup, upgrades to new
computers, or for any other purpose. In addition, DNASTAR is under no obligation to update its
software for new computer operating systems, hardware configurations or for any other reason
after initial purchase of the license by the customer. Users may continue to use a particular
software version after DNASTAR support has been discontinued as long as the use of such
software is not in conflict with any more recent license agreement agreed upon by the customer
and only on the number of computers originally covered in the purchase agreement with
DNASTAR or one of its distributors or agents.

I want a DNASTAR program on several computers, what options are


available?

Lasergene, SeqMan NGen, and ArrayStar are sold as standalone systems, networked systems or
site licenses. GenVision is available as standalone systems or site licenses only.

Standalone systems: Purchasing a standalone system allows you to install your DNASTAR
applications on a single computer. Buying a standalone system allows you to install the
applications on a computer and always have access to the programs.

Networked systems: Purchasing a network system allows you to install a License Server on any
Macintosh or Windows computer. (See our technical requirements for details). The License
Server limits the number of simultaneous uses to the number of systems you purchased.
Therefore, you can install the client software on an unlimited number of Macintosh or Windows
same network as the License Server. This computer must be running constantly so that all client
machines will always have access to the client software. Also, the server computer must have a
static IP address, manually configured in the TCP/IP settings of the network card on that server.
In addition, if one computer is running two or more applications this computer would count for

46 Lasergene Network / Client Installation Guide


only one simultaneous use. Therefore, if you had a 3 system network, you would have 2 more
uses left.

Site Licenses: Via a negotiated agreement, organizations can request a large number or an
unlimited amount of Lasergene, SeqMan NGen, or ArrayStar systems. Please contact your
DNASTAR representative for more information.

General Networking
Can I run a DNASTAR network if I already have a SentinelLM network
running for another program?

Yes. If you already have a SentinelLM network running on the same server where you want to
install the DNASTAR License Server, you will simply need to combine the license files for both
programs.

Do I need separate License Servers if I have both Macintosh and Windows


clients?

The DNASTAR Network License Server can be either a Macintosh or Windows computer and
can serve any combination of Macintosh and Window client machines up to your license limit.

What if we need to purchase additional uses or more modules?

After contacting your DNASTAR representative and placing the order, you will need to
reauthorize the server. (No changes will be required for the client machines). To reauthorize the
server, launch the LicenseManager application from the following directory:

Windows: C:\Program Files\DNASTAR-LicenseServer\Server

Macintosh: Hard Drive:Library:DNASTARLicenseServer

Enter the Product Key provided by your DNASTAR representative. After successful
authorization, restart the service (see How do I restart the DNASTAR License Server service?) to
ensure the changes are in effect.

Lasergene Network / Client Installation Guide 47


What is a commuter license and do I have control over who uses it?

A Commuter License Manager is installed on each client machine in the same directory as the
Lasergene or ArrayStar applications. A user can use the Commuter License Manager to check
out one simultaneous use of a license for up to 30 days. This checked out license decrements the
overall available licenses for all users.

Once a license is checked out, this client computer can be disconnected from the network and the
client applications will continue to function. A commuter license is useful if someone has
Lasergene or ArrayStar on a laptop and checks out a license to use the laptop in a remote
location. By policy, the user should check the license back in when returning so that others can
utilize that license.

You may change the percent of licenses that can be checked out as commuter licenses. By
default, 100% of all licenses are available to be checked out by commuter licenses, if they are
not in use. For more information on changing the percentage of available commuter licenses, see
How do I change the percent of licenses that can be checked out as commuter licenses?

Network Installation
Do I need to install my DNASTAR Network License Server on a Windows or
Macintosh machine?

You may install your License Server on a Windows computer (Windows Server 2003, Windows
Server 2008, Windows Server 2012, Windows XP [32-bit only], Windows Vista, Windows 7 or
Windows 8), or a Macintosh computer (Mac OS X 10.6 or higher [64 bit] with Intel processor),
but you can only install on one. Therefore, choose a machine that will always be turned on,
accessible from your network, and which has a static IP address.

How do I uninstall the License Server on Macintosh?

The Lasergene network installer for Macintosh places an uninstall utility in the following
location: /Library/Application Support/DNASTAR/License Server/uninstall_ls.command.

To uninstall the network software, double-click on the file uninstall_ls.command. You will be
prompted to log in as an Administrator before the uninstallation commences.

48 Lasergene Network / Client Installation Guide


License Server Administration
Can I get an audit report about Lasergene, ArrayStar, or SeqMan NGen
usage?

DNASTAR has set the configurations such that a log file is automatically created upon
installation of the License Server. For information on log file maintenance, see What do I need to
do to maintain the log file?

To display the information into a readable table:

On Windows, the log file dnals.log can be found at C:\Program Files\Common


Files\DNASTAR-LicenseServer. Open a command window by doing the following:

Windows XP/Windows 2003: Go to the Start Menu, select Run and type in cmd.

Windows Vista/Windows 7/Windows 8/Windows Server 2008/Windows Server 2012: Go to


the Start Menu and type "command" in the Search field. Then, click (or double-click) on
Command Prompt shown in the list provided. Enter the following command:
d:\Progra~1\DNASTAR-LicenseServer\Admin\lsusage.exe -l d:\Progra~1\Common
Files\DNASTAR-LicenseServer\dnals.log

On Macintosh, the log file DNASTARLicenseServer.log is located in Hard Drive:Library:Logs.


Open the Terminal, usually found at Hard Drive:Applications:Utilities. Enter the following
command: sudo /Library/DNASTARLicenseServer/lsusage -l
/Library/Logs/DNASTARLicenseServer.log

The Usage Summary report can be limited using other variables such as a date range. See the file
documentation.html installed with your License Server for more information.

On Windows: Navigate to C:\Program Files\DNASTAR-LicenseServer\Documentation and


open documentation.html. Select the topic About the Sentinel RMS Utilities>lsusage.

On Macintosh: Navigate to Hard Drive:Library:DNASTARLicenseServer and open


documentation.html. Select the topic Administrator Commands>lsusage-Display the
Sentinel RMS Development Kit Usage Log File.

Lasergene Network / Client Installation Guide 49


How do I change the percent of licenses that can be checked out as commuter
licenses?

Commuter licenses can be checked out for an extended period of time. Therefore you may want
to limit how many licenses can be checked out as commuter licenses. You will need to indicate a
certain percentage that can be used as commuter licenses in environment variables.

For Windows XP/Windows 2003:

1) Open the Control Panel (Classic View) and go to System.

2) Select the Advanced tab.

3) Click on the Environmental Variables button.

For Windows Vista/Windows 7/Window 8/Windows Server 2008/Windows Server 2012:

1) Open the Control Panel and go to the category System and Maintenance (or System
and Security) > System.

2) Select Advanced System Settings and then click on the Environmental Variables
button.

3) Double click on LSERVOPTS in the System variables list. This variable value will
contain -l followed by the path to the log file.

4) After the path, enter a space, then -com, followed by another space, then a 2-digit number
indicating the percent. For example, -com 50 would indicate 50% of all licenses can be
used by commuter licenses.

5) Restart the computer for the change to take effect.

For Macintosh:

1) Locate the file Hard Drive:Library:DNASTARLicenseServer:com.dnastar.license-


server.plist.

2) Drag the com.dnastar.license-server.plist script file onto a text editor icon such as
TextEdit or BBEdit.

3) Locate the line: /Library/Logs/DNASTARLicenseServer.log

50 Lasergene Network / Client Installation Guide


4) After the path, enter a space, then -com, followed by another space, then a 2-digit number
indicating the percent. For example, -com 50 would indicate 50% of all licenses can be
used by commuter licenses: /Library/Logs/DNASTARLicenseServer.log -com 50

5) Save the file back as a plain text file (not rich-format).

6) Restart the computer for the change to take effect.

How do I monitor who is using the licenses and how many are checked out?

On the server itself, you can get a snapshot of who is currently using the licenses and how many
are checked out.

From the Windows Start menu, find and select DNASTAR License Server>WlmAdmin under
All Programs. Open WlmAdmin and find your server in the list on the left side. The right side
of the window will provide information about your license and who is using the software at that
instant. Use View>Refresh to get updated information.

On Macintosh, the utilities are located in Hard Drive:Library:DNASTARLicenseServer. The


utility lsmon provides similar information to WlmAdmin.exe. On Macintosh, drag and drop
lsmon into Terminal (usually located in Hard Drive:Applications:Utilities), enter a space, then
type localhost to find all of the information about the server. Or enter the following command:

sudo /Library/DNASTARLicenseServer/lsmon localhost

Note that for Lasergene, each application will appear followed by the number 6 (e.g. GeneQuest
6), however this does not reflect the version of Lasergene you are running. For additional
information, see I've installed the latest version of the DNASTAR License Server, but the feature
list continues to display Lasergene 6. Why?.

What do I need to do to maintain the log file?

A usage log file is automatically created by the DNASTAR Network License Server installer. By
default, the maximum size of the usage log file is 1 megabyte. Also by default, once the
maximum size of the file is reached, the license server will create a backup log file. The
maximum number of backup files is 99.

For more information regarding viewing the log file, see Can I get an audit report about
Lasergene, ArrayStar of SeqMan NGen usage?

Lasergene Network / Client Installation Guide 51


What should I do if I want more administrative tools for managing my
network?

For existing KeyServer customers, DNASTAR offers KeyServer-compatible versions of


Lasergene, ArrayStar, and SeqMan NGen. For details, please contact DNASTAR Support at
[email protected].

Network Troubleshooting
What should I do if clients receive the message "All licenses are in use" but I know that some
licenses are available?

Licenses may not be released if a client shuts down or reboots their computer without closing a
DNASTAR application, or if an application crashes. There is a two hour timeout period before
these 'inactive' licenses are released by the server. To release the license before this timeout
period is over, either restart the application on the client and close the application properly or
restart the DNASTAR License Server service. For information on restarting the service, see How
do I restart the DNASTAR License Server service?

I've installed the latest version of the DNASTAR License Server, but the
feature list continues to display Lasergene 6. Why?

In order to allow companies to run previous network client versions during the client upgrade
process, we retained the original license server feature names of Lasergene 6, SeqBuilder 6,
SeqMan 6, etc. As a result, you will always see "Lasergene 6" in the feature list on the server. A
quick way to verify you have installed the most recent version of Lasergene is to open the
LasergeneClientx folder (where 'x' is a number) and look at the version numbers of the *.lshost
files.

What can I do if a firewall is preventing the connection between my clients


and the DNASTAR Network License Server?

On Windows systems, you may need to add an exception to the firewall. On Macintosh, the
lserv service should be added to the Firewall settings on the server. For directions, see
below:

On Windows 7, Windows 8, Windows Server 2003, Windows Server 2008 and Windows
Server 2012:

52 Lasergene Network / Client Installation Guide


1) Open the Control Panel and select Windows Firewall.

2) Click on Advanced Settings.

3) Click on Inbound Rules from the upper left corner of the window.

4) Select New Rule from the upper right corner of the window.
5. From the New Inbound Rule Wizard, click the radio button next to Program, and
then click Next.

5) Click the radio button next to This program path: and then browse to C:\Program
Files (x86)\DNASTAR-LicenseServer\Server\lservnt.exe. Click Next.

6) On the Action page of the wizard, click the radio button next to Allow the
connection, and then click Next.

7) On the Profile page of the wizard, make sure Domain, Private, and Public are all
selected, and then click Next.

8) Name the new rule DNASTAR, and enter a description, if desired.

9) Finally, click Finish to save the new rule.

On Windows XP and Windows Vista:


1) Open the Control Panel.

2) Select Windows Firewall in the Classic View.

3) Click on the Exceptions tab.

4) Click on Add Program.

5) Browse to C:\Program Files (x86)\DNASTAR-LicenseServer\Server.

6) Click on lservnt.exe and add this to the exceptions list.

7) Finally, click OK to save the changes and close the dialog.

Lasergene Network / Client Installation Guide 53


On Macintosh 10.6 and higher:
1) Open System Preferences and select Security or Security & Privacy.

2) Select the Firewall tab.

3) Click the Advanced button, then click the plus sign icon.

4) Navigate to Hard Drive:Library:DNASTARLicenseServer and select lserv.

5) Click the Add button, and verify that lserv service is set to "Allow incoming
connections."

6) Click the lock icon to prevent further changes.

7) Click OK.

What if the applications on the client machine can no longer access the
server?

If clients get the message "Cannot connect to license server" it is likely being caused by one of
the following:

• The client machine is no longer connected to the network. To verify, try launching a web
browser and connect to an external website or use a different application to open a file
that is on your network.

• The License Server machine is down or the service is not working. To remedy, restart the
license server machine.

• A new security patch or firewall prevents the machine from locating the license server.
For information on allowing clients to access the server through a firewall, see What can
I do if a firewall is preventing the connection between my clients and the DNASTAR
Network License Server?

• The License Server machine does not have the same IP address or name. If the IP address
or name has changed, this information will need to be changed in the lshost file for every
client machine. lshost is a text file that can be opened and modified with a text editor like
Notepad or TextEdit. For Lasergene clients, the filename is LG10.lshost. For ArrayStar
clients, the filename is AS5.lshost. These files are located in the following directory:

54 Lasergene Network / Client Installation Guide


o Windows XP: C:\Documents and Settings\All Users\Application
Data\DNASTAR\Licenses

o Windows Vista/Windows 7/Windows 8: C:\ProgramData\DNASTAR\Licenses

o Macintosh: Hard Drive:Library:Application Support:DNASTAR:Licenses

Lasergene Network / Client Installation Guide 55

You might also like