dnastar lasergene€¦ · dnastar® lasergene® 12 network / client installation guide . for...

DNASTAR® Lasergene® 12 Network / Client Installation Guide

For Windows® and Macintosh®

DNASTAR, Inc. 2014

2 Lasergene Network / Client Installation Guide

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

Lasergene Network / Client Installation Guide 3

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


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.

mailto:[email protected]

http://www.dnastar.com/t-about-legal.aspx#trademarks


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.

mailto:[email protected]?subject=Transferring%20a%20license%20to%20another%20computer

mailto:[email protected]?subject=Transferring%20a%20license%20to%20another%20computer


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.

https://www.dnastar.com/signin.aspx

http://www.dnastar.com/t-sub-support-technical-reqs-DNASTAR-License-Server.aspx


Windows Installation Instructions


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.


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.


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.


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.


Macintosh Installation Instructions


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.


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

4) Click Agree to accept the agreement.


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


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.


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


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.


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:


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


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.

http://www.dnastar.com/t-sub-support-technical-reqs-lasergene.aspx

http://www.dnastar.com/t-sub-support-technical-reqs-arraystar.aspx

http://www.dnastar.com/t-sub-support-technical-reqs-qseq.aspx

http://www.dnastar.com/t-sub-support-technical-reqs-seqman-ngen.aspx


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.


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.


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.


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.


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.


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.


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.


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


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.


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.


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


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.


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.


File Locations The following file names use ‘x’ to represent the version number.

File Category Application Path

Application2

Lasergene Core Suite (SeqBuilder, SeqMan Pro, Protean 3D, GeneQuest, Protean, MegAlign, MegAlign Pro, PrimerSelect, EditSeq, GenVision Standalone, GenVision Utility, SeqNinja)

Windows: C:\Program Files\DNASTAR\Lasergene x Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x

ArrayStar Windows: C:\Program Files\DNASTAR\ArrayStar x

Navigator Windows: C:\Program Files\DNASTAR\Navigator x Macintosh: Hard Drive:Applications:DNASTAR:Navigator x

GenVision Plug-In

Windows (installed location for plug-in): C:\Program Files\DNASTAR\Lasergene x 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

Data Manager2 (DMx, DMx.exe)

Lasergene Core Suite (SeqBuilder, Protean 3D, GeneQuest, Protean, MegAlign, MegAlign Pro, PrimerSelect)

Windows: C:\Program Files\DNASTAR\Lasergene x Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x

Data Manager State File

Lasergene Core Suite (SeqBuilder, Protean 3D, GeneQuest, Protean, MegAlign, MegAlign Pro, PrimerSelect)

Windows 7 & Windows 8: C:\Program Data\DNASTAR\DataManager Windows XP: C:\Documents and Settings\All Users\Application Data\DNASTAR\DataManager, C:\Documents and Settings\<username>\Application Data\DNASTAR Macintosh: HD:Library:Application Support:DNASTAR:DataManager HD:Library:Preferences:DNASTAR:DataManager,


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



License Manager2 All Windows XP 32bit, Windows 7 or higher: C:\Program Files\DNASTAR\License Manager Macintosh: Hard Drive:Applications:DNASTAR: License Manager

Server License File (lservrc), Server License Manager 2 (DNASTARServerLicenseManagerx), Server Executables (lserv, lservnt.exe)

All Windows: C:\Program Files\DNASTAR-License Server\Server Macintosh: Hard Drive:Library: DNASTAR-License Server

Standalone & Trial Licenses (*.license), License Server Client License (*.lshost), Key Server Client License (*.keyhost)

All

Windows 7 & Windows 8: C:\Program Data\DNASTAR\Licenses Windows XP: C:\Documents and Settings\All Users\Application Data\DNASTAR\Licenses Macintosh: Hard Drive:Library:Application Support:DNASTAR:Licenses

Demo Data Files

Lasergene Core Suite (SeqBuilder, SeqMan, Protean 3D, GeneQuest, Protean, MegAlign, MegAlign Pro, PrimerSelect, EditSeq, GenVision, SeqNinja)

Windows 7 & Windows 8: C:\Users\Public\Public Documents\DNASTAR\Lasergene x Data\Demo Data (and Demo [ApplicationName]) Windows XP: C:\Documents and Settings\All Users\Documents\DNASTAR\Lasergene x Data\Demo Data (and Demo [ApplicationName]) Macintosh: Hard Drive:Applications:DNASTAR:Lasergene x Data:Demo Data (and Demo [ApplicationName])



Preferences

Most of the Lasergene Core Suite (SeqBuilder, SeqMan, GeneQuest, Protean, MegAlign, MegAlign Pro, PrimerSelect, EditSeq)

Windows 7 & Windows 8: C:\Users\<User>\AppData\Local\DNASTAR\ Windows XP: C:\Documents and Settings\<User>\Local Settings\Application Data\DNASTAR\ Macintosh: Hard Drive:Users:<User>:Library:Preferences

Protean 3D, Navigator, SeqNinja

Windows 7 & Windows 8: C:\Users\<User>\DNASTAR\Protean3D (or Navigator, or SeqNinja) Windows XP: C:\Documents and Settings\<User>\DNASTAR\Protean3D (or Navigator, or SeqNinja) Macintosh: Hard Drive:Users:<User>:DNASTAR:Protean3D (or Navigator, or SeqNinja)

ArrayStar

Windows 7 & Windows 8: C:\Users\<User>\AppData\Roaming\DNASTAR\ArrayStar\2.0 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.


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:


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.


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:


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.


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.


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.


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.

http://windows.microsoft.com/en-US/windows-8/windows-firewall-from-start-to-finish

http://windows.microsoft.com/en-US/windows7/Allow-a-program-to-communicate-through-Windows-Firewall

http://support.microsoft.com/kb/875357

http://support.apple.com/kb/PH11121

http://support.apple.com/kb/PH4275


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.


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.


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

http://www.dnastar.com/t-sub-support-technical-reqs-DNASTAR-License-Server.aspx


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.

http://www.dnastar.com/t-about-contact.aspx

http://www.dnastar.com/t-about-contact.aspx


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.


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.


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


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?


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:

mailto:[email protected]


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.


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:


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