FactoryLink Products

Setup & Utility Program

April 30, 2003

February 2, 2004
This document contains proprietary information of Axisware and is based on information available at the
time of publication. While efforts have been made to be accurate, the information contained herein does
not purport to cover all details or variations in hardware or software, nor to provide for every possible
contingency in connection with installation, operation, or maintenance. Features may be described herein
which are not present in all hardware and software systems. Axisware assumes no obligation of notice to
holders of this document with respect to changes subsequently made. Axisware, L.L.C. makes no
representation or warranty, expressed, implied, or statutory with respect to, and assumes no responsibility
for the accuracy, completeness, sufficiency, or usefulness of the information contained herein. No
warranties of merchantability or fitness for purpose shall apply.

All Trademarks Acknowledged

Copyright © 2000 – 2004, Axisware LLC, TX, USA.

All Rights Reserved
 Software License

Please carefully read the following licensing agreement. By using this Axisware, L.L.C. product, you are
thereby indicating your acceptance of and agreement with all the terms specified and your commitment to
abide by them.

Product Use

Axisware L.L.C. grants to you a non-exclusive license to use the Software programs and related
documentation in this package on a single processing unit. No one other than a current Axisware L.L.C.
employee is permitted to modify or tamper with in any way the computer files(s) associated with this license.
This license applies solely to Axisware L.L.C. software and documentation contained in this package, and does
not apply to any software or documentation provided by other parties which may be required for the proper
operation of this product. You should check the license conditions provided by the originators of software
supplied by others.

Warranty

Except as modified by an in-force written agreement executed by an authorized officer of Axisware L.L.C.,
Axisware L.L.C. expressly disclaims any and all warranties, conditions or representations, either expressed or
implied, with respect to software, other products and any part thereof delivered to Customer hereunder,
including any and all implied warranties or conditions of title, non-infringement, merchantability or fitness or
suitability for any purpose (whether or not Axisware L.L.C. knows, has reason to know, has been advised or is
otherwise in fact aware of any such purpose), whether alleged to arise by law, by reason of custom or usage in
the trade or by course of dealing. In addition, Axisware L.L.C. expressly disclaims any warranty or
representation to any person other than Customer with respect to the software or any part thereof. No written
or oral information or advice given by Axisware L.L.C., its agents or employees shall create any warranty or in
any way increase the scope of the limited warranty set forth in such license agreement and Customer may not
rely on any such information or advice.

Customer’s sole and exclusive remedy for any breach of this Agreement, including any breach of warranty,
shall be, to the exclusion of all other remedies therefor, in contract, tort or otherwise, at Axisware, L.L.C. sole
option, either the return of the price paid for or the correction or replacement of any product that does not meet
the limited warranty, if any, set forth in a written agreement signed by an authorized officer of Axisware,
L.L.C. that is returned to Axisware, L.L.C.. In no event shall Axisware L.L.C. be liable to Customer (nor to
any person claiming rights derived from Customer’s rights) for incidental, consequential, special, punitive or
exemplary damages of any kind, including without limitation lost profits, loss of business or other economic
damage and further including injury to property, as a result of a breach of this agreement, including any breach
of warranty, regardless of whether Axisware, L.L.C. was advised, had other reason to know or in fact knew of
the possibility thereof. In no event shall Axisware, L.L.C. aggregate liability to Customer (including liability to
any person or persons whose claim or claims are based on or derived from a right or rights claimed by
Customer), with respect to any and all claims at any and all times arising from or related to this Agreement, in
contract, tort or otherwise, exceed the aggregate amounts paid to Axisware, L.L.C. by Customer.
 Contacting Axisware

We want your experience with our software to be a pleasant one. If you experience any problems or have
any comments or suggestions to make, please contact us

support@axisware.com
sales@axisware.com

http://www.axisware.com

Axisware LLC
3213 Peppertree Pl.
Plano, TX 75074, USA

+1-(214)-764-1876 (T)
+1-(214)-764-1878 (F)
Table of Contents
1 OVERVIEW............................................................................................................................................................... 1

2 WARNINGS AND RECOMMENDATIONS..........................................................................................................2

2.1 Upgrading FactoryLink............................................................................................................................................. 2
2.2 Installing a Product................................................................................................................................................... 2
3 DISTRIBUTION CD-ROM CONTENTS............................................................................................................... 3
3.1 \Win32i......................................................................................................................................................................3
3.2 \Manuals....................................................................................................................................................................3
3.3 \Samples.................................................................................................................................................................... 3
3.4 \Backup1 & \Backup2............................................................................................................................................... 3
4 SOFTKEY PROTECTION......................................................................................................................................4
4.1 Explanation of Installation, Configuration and Validation Codes............................................................................ 4
4.2 Explanation of Product License Types..................................................................................................................... 4
4.3 Standard License....................................................................................................................................................... 4
4.4 Hot Stand-by License............................................................................................................................................... 4
4.5 Demonstration License..............................................................................................................................................5
4.6 SoftKey Product Installation and Validation............................................................................................................ 5
4.7 The Normal Validation Procedure............................................................................................................................ 5
4.8 Temporary Installations............................................................................................................................................ 5
4.9 Reinstalling a Validated Product...............................................................................................................................5
4.10 Backing up a Validated Product..............................................................................................................................5
5 THE AW-SETUP PROGRAM................................................................................................................................. 7
5.1 Before starting the program...................................................................................................................................... 7
5.2 Starting the program..................................................................................................................................................7
6 AW-SETUP FUNCTIONS........................................................................................................................................ 8
6.1 Install specific product.............................................................................................................................................. 8
6.2 Create an install directory for a specific product...................................................................................................... 8
6.3 Install a demonstration version of a product............................................................................................................. 8
6.4 Restart ‘grace’ period for a product.......................................................................................................................... 8
6.5 Generate configuration sequence for a product.........................................................................................................8
6.6 Enter a validation sequence for a product................................................................................................................. 8
6.7 Display status of all installed protocol modules........................................................................................................8
7 ERROR MESSAGES.................................................................................................................................................9
7.1 File Access Errors..................................................................................................................................................... 9
7.2 Unable to Perform Function Errors...........................................................................................................................9
7.3 Other Errors.............................................................................................................................................................10
8 SOFTKEY RUN-TIME MESSAGES.................................................................................................................... 11

9 PHONETIC ALPHABET....................................................................................................................................... 12
Aw-setup Manual 1

1 Overview

This manual describes how to use the Axisware SetUp program, aw-setup, which is required to
successfully install and license Axisware software products for FactoryLink. The manual contains the
following:

Warnings and Recommendations

Outlines recommended procedures for upgrading and installing

Distribution CD-ROM Contents

Describes the directory structure and files contained on the distribution CD.

SoftKey Protection
Description of SoftKey protection and product validation procedure.

Aw-setup Program
Instructions for and capabilities of this utility

Appendix A
Phonic Alphabetic character codes for suggested use when communicating configuration and validation
sequences by phone.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 2

2 Warnings and Recommendations

We recommend that a multi-platform save of any applications be performed before installing any
FactoryLink related product including Axisware products.

2.1 Upgrading FactoryLink

When upgrading FactoryLink, on a system that contains a 3rd Party driver or other product, perform a
multi-platform or "single save file" save of any applications before installing the new FactoryLink
Software. Always reinstall the 3rd party software before restoring the applications.

2.2 Installing a Product

The following steps are recommended in all cases when installing an Axisware software product. They
may be required when upgrading to a new product version.

1. Shut down FactoryLink, by exiting the Run Manager, Application Editor, Configuration
Manager and any other FactoryLink related activities. If any part does not shutdown
successfully, restart the PC.
2. Perform a multi-platform or “single save file” save of any applications.
3. Run the Axisware setup program, aw-setup, to install the product.
4. Perform any finishing steps as outlined on screen at the end of the installation process, or
detailed in the specific product manual.
5. If the install procedure states that the system must be restarted before the product will
function correctly, restart the PC.
6. Restore the application from the multi-platform or "single save file" save file created in step
2 above. If conversion is required due to a FactoryLink upgrade, do the conversion.
7. Run the Configuration Manager and check the product tables for any additional fields that
may need editing.
8. Run the application.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 3

3 Distribution cd-rom Contents

The distribution cd-rom supplied in the product package contains products, manuals and sample
applications in the following sub-directories:

3.1 \Win32i

This directory contains the product files and the SetUp program executable, aw-setup.exe, for the
Microsoft Windows platform versions (32bit Intel).

3.2 \Manuals

This directory contains PDF versions of the product manuals, and this manual aw-setup.pdf. Each
manual is identified by the letters aw- followed by a product id (listed below) followed by the .pdf file
extension.

Abei Allen-Bradley Ethernet Interface

3.3 \Samples

This directory contains multi-platform or "single save file" save files of the sample applications for each
product. Each application is identified by the product’s 4-character ID followed by the standard .mps
extension. The directory is divided into sub-directories containing the actual files, based on the
FactoryLink version.

Use the FactoryLink Restore Application utility to load the appropriate sample application for your
environment.

3.4 \Backup1 & \Backup2

These directories contain images of the distribution files. If you have problems reading any portion of the
base distribution files from the CD, you can use “X:\Backup1\” or “X:\Backup2\” in place of “X:\” to
access these files. Running the Set Up & Utility program from one of these directories will ensure that
the product files from that directory are accessed.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 4

4 SoftKey Protection

Axisware products require a separate license for each FactoryLink station using the product at run-time
in a non-temporary environment. The demonstration version should be sufficient to handle temporary or
configuration use, and it does not require an individual license. Products are protected against unlicensed
use via SoftKey Protection.

The purpose of SoftKey protection is to make unlicensed use difficult; not to impose problems on
legitimate customers. There are valid reasons for re-installing products to a target which does not
contain the previously validated copy, for example, replacing a bad hard drive or upgrading a PC. In this
case the normal validation procedure must be followed. Axisware maintains a database of validation
sequence requests. If Axisware considers the number of validation requests to be questionable, you may
be asked the reason for the request.

4.1 Explanation of Installation, Configuration and Validation Codes

Installation: This alphanumeric sequence is provided with the product and is required by the Install
specific product function of the Utility program.

Configuration: This alphanumeric sequence is generated by the Generate configuration sequence

function of the Utility program. Send this sequence to Axisware to obtain a validation sequence for
the product. A different configuration sequence will be generated every time the Generate
configuration sequence function is used. The latest sequence (or only) generated from an install will
be sufficient to generate a validation sequence. Re-installing or restarting the grace period will require
a new configuration sequence to be generated.

Validation: This alphanumeric sequence is generated by Axisware from the serial number and
configuration sequence, and sent to the user who enters it using the Validate a specific product option
of the Setup program.

4.2 Explanation of Product License Types

4.3 Standard License

Grace period: 15 days

Normal general purpose, single FactoryLink station. This is the one used most often.

4.4 Hot Stand-by License

Grace period: 15 days

Designed for users who wish to have either a stand-by disk or PC ready to replace or repair a station in
case of a problem. Qualification requirements are:
 At least one Standard License.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 5
 An explanation of stand-by procedure from the End User on company letterhead, that
explains how they will ensure that no more FactoryLink stations are in use than the number
of Standard Licenses.

4.5 Demonstration License

The purpose of this license is for temporary evaluation, demonstration, application development or
support. Demonstration versions are the same as the standard product but will run for three hours each
time they are started. When the time limit is reached the task will allow pending solicited operations to
complete, however; no new operations either solicited or unsolicited will be initiated.

4.6 SoftKey Product Installation and Validation

An installed product must be validated before the grace period expires in order to continue to start
successfully.

4.7 The Normal Validation Procedure

1. Axisware provides an installation sequence and supplies it with the product.
2. The user installs the product using the install sequence, and has the grace period to get the
product functioning.
3. Before the end of the grace period the user generates a configuration sequence and sends it,
with product serial number, to Axisware. This can be done on-line from the product
registration page at www.axisware.com, or by fax or email
4. Axisware produces a validation sequence and sends it to the user.
5. The user enters the validation sequence, using the Validate a specific product option of the
aw-setup program. The product is now completely validated.

4.8 Temporary Installations

If a product is to be installed on a PC other than that intended for final installation, and if the
demonstration version is not sufficient for such use, then install the product on the temporary PC, but do
not validate it. Use the Restart Grace Period facility of the aw-setup program once every fifteen days.

4.9 Reinstalling a Validated Product

The Install specific product function of the aw-setup program looks for an existing copy of the product in
the target location. If a validated copy with the same serial number and of the same or previous version
is found, then the product will be validated during the installation process and a new configuration
sequence will not be needed.

4.10 Backing up a Validated Product

To backup and restore a product after it has been validated, backup and restore the entire FactoryLink

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 6
product directory (%FLINK% environment string).

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 7

5 The aw-setup program

This utility provides the functions to install and maintain the software products.

5.1 Before starting the program

The logged-in user must have administrator privileges. Ensure that the program has write access to the
FactoryLink directory structure (%FLINK% environment string or the directory chosen by the user).

Ensure that the %FLINK% environment string or the FactoryLink product directory chosen by the
operator includes the drive letter as well as the path, e.g. “C:\FLINK” not “\FLINK”.

Ensure that FactoryLink is not running (otherwise files may not be written during the installation and/or
validation).

5.2 Starting the program

Place the distribution CD into a cd-rom drive and use your preferred method to run the program
X:\Win32i\aw-setup.exe (Where X is the drive letter).

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 8

6 aw-setup functions

6.1 Install specific product

This option walks you through the installation of a purchased product.

6.2 Create an install directory for a specific product

Use this option if the target PC for the product does not have a cd-rom drive, or if you want to make a
copy of the product install files on your hard disk. This will build a directory structure similar to the one
on the distribution CD using only the product files for the FactoryLink version selected.

6.3 Install a demonstration version of a product

This option installs a demonstration version of a product from the distribution CD. Please refer to the
SoftKey Protection description in section 4 of this manual for the usage limits imposed on demonstration
versions.
Note: This option will also work from a directory created by Create an install directory for a specific
product , see above.

6.4 Restart ‘grace’ period for a product

This option sets the install date of a previously installed product to the current system date.

6.5 Generate configuration sequence for a product

This option walks you through generating a configuration sequence, which is used in the process of
validating an installed product.

6.6 Enter a validation sequence for a product

This option walks you through the input of a validation sequence which is used in the process of
validating an installed product.

6.7 Display status of all installed protocol modules

This option displays the installed and validation status of Axisware products. It can also be used to
display the serial number of an installed product.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 9

7 Error Messages

Error messages which may appear while running the aw-setup program have the format:

“ERROR: (function : reference) <string>”

where function and reference are internal identifiers and <string> gives a verbal description of the error.
Follow the instructions given below for each message. If the problem remains, contact Axisware
Technical Support, giving the complete error message including the function, reference and string.

7.1 File Access Errors

The Utility program requires read access to the product distribution files, and read/write access to the
FactoryLink program files or target directory. If you are having trouble reading distribution files try one
of the backup directories or recreate the install directory. If you experience open, read or write errors on
files in the target directory, ensure that the Utility program has proper file access and that all FactoryLink
programs are shut down. Typical error messages might be:

Error coping files to <location>

Failure copying product FactoryLink files
File read error: <filename>
File write error: <filename>
Install Failed unable to copy Product files
Install Failed unable to update FactoryLink Files
Install Failed unable to update Product SoftKey Data
Invalid Product Install File
Invalid Validation File
Open Failed on Validation File
Read Failed on Validation File
Unable to Copy Bullet Utilities Program
Unable to open file: <filename>
Unable to open Product Install file
Unable to read Product Install File
Unable to Select/Create <name> sub-directory
Unable to write new install date to file
Write error on validation file

If you are still unable to determine the cause of the problem, contact Axisware Technical Support.

7.2 Unable to Perform Function Errors

Invalid install sequence for current product

The install sequence used is for an earlier version of the product. Please contact Axisware Sales for
information on obtaining an upgrade.

Invalid Validation Sequence

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 10
Please check carefully the validation sequence you are entering and if the error persists contact
Axisware Technical Support.

The install directory for this Version of FactoryLink does not exist

The distribution CD does not contain FactoryLink files for the selected version of FactoryLink. If you
are building an install directory to use in place of the distribution media, ensure that the proper product,
platform, and FactoryLink version are selected. Otherwise please contact Axisware Sales for
information on obtaining this product for the required platform and FactoryLink version.

Protected data does not match: filename

The validation sequence does not match the installed product. Ensure you are using the validation
sequence for the installed product. If so, please contact Axisware Technical Support for assistance.

Unable to determine install directory

The aw-setup program uses relative paths to access data files and it must be able to determine its
location in the computer’s directory structure. It was unable to do so. Change the current drive and
working directory to the directory which contains the aw-setup.exe file, and then re-run the utility
program.

7.3 Other Errors

You should never see these or other messages. If you do, please contact Axisware Technical Support
with complete details.
Duplicate Protected Data Found: filename
Empty input
Install Failed Panic unknown return from
BaseInstall X
Invalid choice
Invalid intermediate data length
Invalid Product Id
Invalid Product Install File
Invalid Validation File for X Product
No Protected Data Found: filename
NULL input
Open Failed on Validation File
Product not found
Serial Numbers do not Match
Unknown distribution type X
Unable to determine Operating System - 95 or NT?
Unable to open file: filename

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 11

8 SoftKey run-time messages

The following messages may appear during run-time execution of the product:

SoftKey: Grace period for validation has expired

The product will not function until validated. Follow the steps outlined above for validating the
product.

SoftKey: Grace period for validation will expire in X days.

Information message.

SoftKey: Improperly installed, please reinstall

The product was either not installed using the Utility program, or an error occurred during installation.
Please use the Utility program to install the product, refer to the appropriate Error message in the Error
Message Section above, or contact Axisware Technical Support for assistance.

Serial #: XXXXXXX Single Processor Run Time License

Normal information message displaying the product name and it’s Serial Number.

Axisware LLC
support@axisware.com www.axisware.com
Aw-setup Manual 12

9 Phonetic Alphabet

Using these names for alphabetic characters reduces the chance of error when obtaining a validation
sequence by phone.

A Alpha
B Bravo
C Charlie
D Delta
E Echo
F Foxtrot
G Golf
H Hotel
I India
J Juliet
K Kilo
L Lima
M Mike
N November
O Oscar
P Poppa
Q Quebec
R Romeo
S Sierra
T Tango
U Uniform
V Victor
W Whiskey
X Xray
Y Yankee
Z Zulu

Axisware LLC
support@axisware.com www.axisware.com