LinkScan Startup Guide for Windows Systems


 Help   Reference   HowTo   Card 


This document is intended to help new users install and configure LinkScan on Windows systems.

Unix users should see the LinkScan Startup Guide for Unix Systems. Additional information is available in the LinkScan Reference Manual.

This document covers the following topics:

Before Installation

To successfully install and configure LinkScan on a Windows system you must have:

  1. ActivePerl Build 522 or later, installed on your computer. Users running 64-bit Windows can install a later (64-bit) version of ActivePerl. Perl is free of charge and for download instructions see:

  2. A copy of the LinkScan setup file, linkscan.exe, and a LinkScan License Key. Both are available from:

Concerning Perl

Perl, the Practical Extraction and Report Language, is a highly portable programming environment developed by Larry Wall. It has become the premier scripting language of the Web. The standard Perl implementation for Windows, ActivePerl is maintained and distributed by ActiveState Tool Corp.

Installation of ActivePerl on a Windows system is a straightforward matter. Although several options are provided during the installation procedure, we recommend that new users accept the automatic defaults.

LinkScan Installation

Once Perl has been installed, simply execute linkscan.exe, the self-extracting archive, which will start the familiar InstallShield wizard. You may select a target installation folder for LinkScan but we suggest you accept the default: C:\LinkScan10\.

Start LinkScan by double-clicking the LinkScan icon created on your desktop during installation. The first time you execute LinkScan it will automatically start the LinkScan Setup Wizard:

LinkScan First Time Setup [Click for larger image]

  1. If you do not yet installed Perl or have not received a License Key, please return to the top of this document for guidance. You may exit LinkScan for now and restart the program later.

  2. Enter your LinkScan License Number and Key.

  3. LinkScan will automatically attempt to locate the Perl executable on your computer; it is typically located at C:\Perl\bin\perl.exe. If LinkScan is unable to find Perl, you must enter the pathname manually. Click the Find button to activate the familiar File Open Dialog Box to browse your computer.

  4. Enter the URL of the website you wish to scan and click Finish.

You should now see the main LinkScan Window:

Main LinkScan Window [Click for larger image]

Proxy Servers and Firewalls

Depending on your network environment, LinkScan may need to know about any Proxy Servers that are required to access computers on the private and/or public networks. On the Main LinkScan Window, click the Options button and select the Proxies tab. Enter the correct name (or IP Address) of your Proxy Server and the Port Number. Note that the correct format for the Proxy Server address is, for example, or Do not enter a URL address.

Configure Dialog [Click for larger image]

You may optionally specify a list of local hosts/domains for which the Proxy is not to be used. If you are unsure about these settings, please look at your existing browser proxy configuration and/or contact your network administrator.

Planning a LinkScan Project

LinkScan allows you to create and maintain multiple configurations or Projects. A single Project called default is created during installation. Use the New and Remove buttons to add or delete LinkScan Projects.

Projects are configured by selecting the Project of interest and clicking the Plan button. The Project Planning dialog box includes many options but initially, we suggest you simply accept the defaults:

Edit Project Dialog [Click for larger image]

Scanning the Website

To initiate a complete analysis of your website, select a Project and click the Scan button. A new Scanning tab will be added to the main window and activated so that you may monitor the progress of the scan.

Scanning Window [Click for larger image]

Please follow these instructions if you see an Invalid License Key error.

On completion of the scan, the Cancel button will change to an OK button and the system will beep. Press the OK button to dismiss the Scanning Dialog box. At this point, LinkScan has generated a comprehensive database containing the results of the analysis.

Examining the Results

From the main LinkScan Window, select an existing Project from the displayed list of Projects and click Exam. This will activate the LinkScan Browser and send it to:

The first time you access the results, you will be presented with the LinkScan Login and Preferences Menu. Simply click Login Now. No username is required unless you later decide to enable various LinkScan security features. You may return to this menu later to modify certain options and preferences but initially we suggest you accept the defaults.

Once you have logged in, you will be presented with the LinkScan Main Menu.

Report Selection

You must select one of the individual Reports and submit the form by pressing Select Report.

A help page is available for each type of LinkScan Report. You may view the appropriate help page at any time by using the Help option on the context-sensitive LinkScan Toolbar. You may also use the [?] links on the LinkScan Main Menu, or the links provided in the summary table below.

The most frequently used reports have been organized in the left hand column; we suggest new users start there. Also, many of the reports incorporate hyperlinks to other reports. This means you can use a drill-down paradigm to view more detail associated with a specific problem or document. For example, some users may never explicitly select a LinkScan/QuickCheck Report. But they will likely view reports of that type by following the [Src] links from other reports.

Summary of Available Reports

Project Summary Report
Summary statistics for the current project
Summary of All Projects Report
Summary statistics for all configured projects
Problem Documents Report
List documents containing potential problems
Selected Status Codes Report
List errors of specific types
Document Detail Report
List all/selected documents
All Pages Linking To ... Report
Find pages that link to...
Critical Errors Report
List most critical errors
Orphaned Files Report
List orphaned files
Detailed Errors Report
List all/selected errors
External History Report
View history of an external link
Changed Documents Report
Compare two scans of the current project
Redirections Report
List a summary of redirections
Search Documents Report
Ad hoc searching: document-centric
System Configuration Report
Display current LinkScan configuration settings
Search Links Report
Ad hoc searching: link-centric
View source code and detailed analysis of a document
SiteMap Report
Display LinkScan SiteMap
Display LinkScan TapMap

Owner Selection

The LinkScan Main Menu may include an Owner Selection Box. If enabled, this option will allow you to select a sub-set of the website to which subsequent reports will apply.

In a default configuration, the Owner Selection Box will include entries for each top-level directory scanned, in addition to the special entry "All". This will be the default selection and subsequent reports will apply to the entire website scanned.

Note however, that the LinkScan Administrator may configure and customize the manner in which Owners are created. Hence your installation may appear and behave somewhat differently from that described herein.

SubMenu Selection

In many cases, when you submit the form by pressing Select Report you will be presented with a second menu of options. Initially, we suggest you accept the default options which have been carefully designed to produce excellent results in the vast majority of situations. However, to learn more, you may use the context-sensitive Help button on the LinkScan Toolbar at any time.

LinkScan Toolbar

Each of the LinkScan Menus and Reports includes a common LinkScan Toolbar. It contains a number of links:

 Main Menu   Preferences   Advanced   Help   Reference   HowTo   Card 

The Main Menu link will always return you to the LinkScan Main Menu.

The Preferences link will always take you to the LinkScan Login and Preferences Menu.

The Advanced link appears when appropriate and it will cause the current menu to be redrawn with additional options.

The Help link will display an appropriate section of the LinkScan Documentation depending upon the current context.

The Reference link will display the table of contents for the LinkScan Reference Manual.

The HowTo link will display a brief How To Guide with instructions for completing certain Common Tasks.

The Card link will display the LinkScan Quick Reference Card.

Common Questions

Invalid License Key

If an attempt to scan a site produces the error: "The LinkScan License Key is Invalid" please follow these steps:

  1. A detailed error message will be displayed in a popup box. Copy the error message to the clipboard by clicking the red icon, and e-mail the error message to Our customer service personnel will send you a new License Key, typically in less than an hour.

  2. When you receive the new License Key, from the main LinkScan Window, press the Options button. Paste the new Key into the dialog box. Click OK to save the new Key and then click the Scan button.

Other Difficulties

If you are experiencing difficulties, please:

Uninstalling LinkScan

Removing LinkScan is clean and simple; we have taken enormous care to minimize the impact of LinkScan on your System DLL's and Windows Registry.

To completely remove LinkScan from your system, open the Windows Control Panel and use the Add/Remove Programs option. You may wish to manually inspect the LinkScan folder and delete any residual and unwanted files using the Windows Explorer or File Manager.

LinkScan Startup Guide for Windows Systems
LinkScan Version 12.4
© Copyright 1997-2013 Electronic Software Publishing Corporation (Elsop)
LinkScan™ and Elsop™ are Trademarks of Electronic Software Publishing Corporation

 Help   Reference   HowTo   Card