Actix Software

Installation Guide
December 2006

Actix Software Installation Guide

Copyright Actix 2006.
All rights reserved. All trademarks are hereby acknowledged.
Actix and the Actix logo are the trademarks of Actix Limited. Similar restrictions to use of our
company and product names may apply elsewhere.
The content of this manual is provided for information only, is subject to change without notice, and
should not be construed as a commitment by Actix. Actix assumes no responsibility or liability for
any errors or inaccuracies that appear in this documentation.
Microsoft and Microsoft SQL Server 2005 Express Edition are either registered trademarks or
trademarks of Microsoft Corporation in the United States and/or other countries.
The license management portion of this Licensee Application is based on:
SentinelLM*
1989-2004 SafeNet, Inc.
All rights reserved
Sentinel is a registered* trademark of SafeNet, Inc.

Actix Software Installation Guide

December 2006

Contents
1 INSTALLING ACTIX SOFTWARE........................................................................4
1.1
1.2
1.3
1.4
1.5
1.6
1.7

OVERVIEW ......................................................................................................................... 4
REQUIREMENTS ................................................................................................................. 4
BEFORE PROCEEDING WITH THE INSTALLATION ..................................................................... 5
INSTALLING THE FULL RELEASE ............................................................................................ 5
UPGRADING FROM PREVIOUS VERSIONS ............................................................................... 6
INSTALLING SQL EXPRESS ................................................................................................. 6
INSTALLING ACTIX SOFTWARE VIA THE COMMAND LINE........................................................... 8
1.7.1
1.7.2
1.7.3
1.7.4
1.7.5
1.7.6
1.7.7

Overview ........................................................................................................................................... 8
Using the Setup command ................................................................................................................ 8
Run the Msi ....................................................................................................................................... 8
Command line parameters ................................................................................................................ 9
Installation requires computer reboots .............................................................................................. 9
Disabling the Desktop shortcut........................................................................................................ 10
Preventing installation of Web update functionality......................................................................... 10

2 TROUBLESHOOTING ........................................................................................11
2.1 FORWARDING LOGS TO ACTIX TECHNICAL SUPPORT ............................................................11
2.2 ADDING AND REMOVING PROGRAMS ....................................................................................12
2.3 INSTALLATION ISSUES ........................................................................................................13
2.3.1
2.3.2
2.3.3
2.3.4
2.3.5
2.3.6
2.3.7
2.3.8
2.3.9
2.3.10

Untested on Microsoft Vista ............................................................................................................ 13

Problem message on installation .................................................................................................... 13
Installation source required on first launch of application after installation or web update.............. 13
Shortcuts fail to launch Actix Software ............................................................................................ 13
SMS Package definition file contains incorrect parameter .............................................................. 13
Migrating from Wise legacy installation to MSI installation via SMS ............................................... 14
Old Actix shortcuts remain after upgrading from Wise legacy Analyzer installation........................ 14
Actix Software fails on startup after installation or upgrade ............................................................ 14
SQL Native Client already installed................................................................................................. 14
Slow response from SQL Express .................................................................................................. 15

2.4 ACTIX SOFTWARE ISSUES ..................................................................................................16

2.4.1 Incorrect trace symbols used on map ............................................................................................. 16
2.4.2 GeoDict.DCT could not be located.................................................................................................. 16

3 ABOUT MICROSOFT SQL SERVER 2005 EXPRESS ......................................17

3.1 OVERVIEW ........................................................................................................................17
3.2 COMPONENTS ...................................................................................................................17
3.3 LIMITATIONS .....................................................................................................................17

Actix Software Installation Guide

December 2006

Installing Actix Software

1.1 Overview
This document describes the installation process for Actix Software using
the Analyzer platform. Other Actix products such as CellOpt and
Radioplan are not covered here.
The Actix Software installation is constructed using Windows Installer
(MSI), which is an integral part of the Microsoft Windows operating
system and is able to assist in the installation and management of
Windows Applications.
Actix Software can be installed locally, or deployed to multiple client
machines using Microsoft Systems Management Server (SMS).

1.2 Requirements
These are mainly dictated by SQL Express:
Processor

600 MHz Pentium III-compatible or faster processor; 1GHz or

faster processor recommended

Framework

Before installing SQL Server 2005 Express Edition, you must

install the .NET Framework 2.0; this occurs automatically in the
standard Actix installation.

Operating
System

Windows XP with Service Pack 2 or later

Microsoft Windows 2000 Professional with SP4
Microsoft Windows 2000 Server with Service Pack 4 or later
Windows Server 2003 Standard, Enterprise, or Datacenter
editions with Service Pack 1 or later
Windows Server 2003 Web Edition SP1
Windows Small Business Server 2003 with SP1 or later

Memory

192 megabytes (MB) of RAM or more; 512 MB or more

recommended

Hard Disk

Approximately 350 MB of available hard-disk space for the

recommended installation
Approximately 425 MB of additional available hard-disk space
for SQL Server Books Online, SQL Server Mobile Books
Online, and sample databases

Actix Software Installation Guide

December 2006

Other
Requirements

Microsoft Internet Explorer 6.0 SP1 or later

Microsoft Office 2000 or above (required by Actix Software)

For more information on SQL Express system requirements, see:

http://www.microsoft.com/sql/editions/express/sysreqs.mspx.

1.3 Before proceeding with the installation

Ensure that:

You have administrator rights

The target PC meets the minimum specification for Actix Software

and SQL Express.

1.4 Installing the full release

If the Windows CD Autorun feature is enabled, the Actix autorun.exe will
display the welcome screen (shown below) when the Actix Software CD
is inserted in an appropriate drive.
Select the Install Actix Software option (or manually run setup.exe), then
follow the instructions on the screen.

Actix Software Installation Guide

December 2006

1.5 Upgrading from previous versions

Upgrading from an earlier version of Actix Software might result in the
automatic un-installation of the old software before installing the new
software. Only files that were installed during the original installation
process will be removed.

1.6 Installing SQL Express

Note that you cannot install to network locations.
If you were previously using MSDE, we recommend that you remove it,
for example by using Control Panel > Add/Remove Programs. Note
that, to be usable by SQL Express, any existing repository projects will
need to be recreated using the original data, once the Actix Software
installation has completed.
Run the file Setup.exe.
If you do not have SQL Express installed on your PC, you will see this
message:

Actix Software Installation Guide

December 2006

You should see this screen as the SQL Express installation process
continues, installing the various components:

Click on a link to see the

installation log for that component.

If the Status column shows a problem with any of the components, you
should stop the installation, use Add/Remove Programs to remove the
component in question, reboot the PC and restart the installation process.
Once the SQL Express installation is complete, the Actix Software
installation begins. Follow the instructions on the screen.
When the ActixDatabase installation has completed successfully, you may
need to restart your PC.

Actix Software Installation Guide

December 2006

1.7 Installing Actix Software via the command line

1.7.1 Overview
There are two methods for performing a command line installation. Each
command will execute the same msi.

1.7.2 Using the Setup command

The setup.exe is a wrapper which will also install the dependencies of the
main installation.
From a command prompt, execute the following command:
Setup
1.7.3 Run the Msi
As an alternative to running Setup, you can run the msi directly.
These dependencies must previously have been installed:
Windows Installer 3.1
Microsoft .NET Framework 1.1
Microsoft .NET Framework 1.1 SP1
Microsoft .NET Framework 2.0
Microsoft Data Access Components (MDAC) 2.8
Microsoft SQL Server 2005 Express SP1
The following set of instructions explains how to install SQL Express on
its own. Note that the D:\ drive is taken to be your CD drive in the
examples given below.
From the command prompt, change to the D drive:
C:\> D:
Change directory to the SQL Express installation folder:
D:\> cd \db\ISSetupPrerequisites\Microsoft SQL
Server 2005 Express
From here you can run the .bat file to execute the SQL Express installer
without going through the Actix Software installation process:
D:\> runinstall.bat

Actix Software Installation Guide

December 2006

by executing
msiexec /i AtxInst.msi
1.7.4 Command line parameters
The setup exe fully supports msi command line parameters which can be
passed to msiexec by using
Setup /V<msiexec commands>

For example, to use logging, the respective commands would be

msiexec /i AtxInst.msi /l*v c:\logfile.log
setup /Vl*v c:\logfile.log

Due to restrictions placed on the Microsoft .NET framework, a license

agreement will always be displayed if the setup exe is used and .NET is
being installed, and even if a silent install has been selected for the Actix
part of the installation.
In the Support\MSI directory of the Actix Software Installation CD
there is a script called diagsetup.bat that will carry out a full installation
of the Actix Software (as the command line above does). It will also
generate full installation logging that can be used to assist diagnosing
installation problems. The log file produced, AtxInst.log, will be written
to the root drive where your windows operating system is held.
1.7.5 Installation requires computer reboots
The installation may require a reboot during or at the end of the
installation phase. To suppress as many reboots as possible during the
installation, add the following property to the msiexec command line (in
the SMS package definition):
REBOOOT=ReallySuppress
If you do plan to suppress reboots, we recommend that the installation is
first deployed into a test deployment environment to determine whether
the initial reboot will need to be suppressed.

Actix Software Installation Guide

December 2006

1.7.6 Disabling the Desktop shortcut

The installation creates an optional desktop shortcut which can be disabled
though the install UI. Creation of the desktop shortcut can also be disabled
by adding the following property to the msiexec command line:
DESKTOPSHORTCUT=0
1.7.7 Preventing installation of Web update functionality
The Actix Software installation allows for product updates to be
automatically downloaded and installed over the web. This may be an
undesirable feature for organizations that require greater control over the
software installed on the user's machine. In light of this, it is possible to
instruct the setup not to install any web setup functionality onto the user's
machine during the initial installation of the software. This is done by
setting the NOWEBUPDATE property on the msiexec command line
interface as follows:
msiexec /I AtxInst.msi NOWEBUPDATE=1
The same can be achieved by using setup as follows:
setup /vNOWEBUPDATE=1

Actix Software Installation Guide

December 2006

10

Troubleshooting

2.1 Forwarding logs to Actix Technical Support

If you have difficulties with installing the database for example, when
you see this screen:

or with the operation of the database, please can you raise a case in
MyActix. You should include, from the folder:
\Actix\Analyzer\Database\Scripts\
this file:
RunSQL.log
and also logfiles from this folder:
\Program Files\MS SQL Server\MSSQL.1\MSSQL\LOG\
There may be various instances of SQL Express, each with its own 4GBlimit database. Each subsequent installation will have its own folder, for
example, MSSQL.2, MSSQL.3 etc. Note that with several installations of
SQL Express, you may find it difficult to isolate which database contains
the error.
Note that Actix Support do not need a copy of the SQLERROR.log file.

Actix Software Installation Guide

December 2006

11

2.2 Adding and removing programs

Note that, in the Add/Remove Programs dialog, it shows Actix Software
and a series of SQL Express components:

This component division makes it easier for Microsoft updates to work for
SQL Express.
If you want to remove the database engine, you will need to remove all the
MS SQL Express-installed programs shown in the above screenshot.
Using the Actix Software uninstall routine by running Setup again will
only remove the Actix Software program, so you will need to remove the
SQL Express components manually.
Note that .NET 2.0 must be on the PC before you can successfully remove
SQL Express.

Actix Software Installation Guide

December 2006

12

2.3 Installation issues

2.3.1 Untested on Microsoft Vista
The tasks listed in this Installation Guide have not been performed on the
new operating system Microsoft Vista.
2.3.2 Problem message on installation
If you have not already installed SQL Server Express, you will see this
message when you start the installation process:

You can find setup.exe in the root of the installation CD.

2.3.3 Installation source required on first launch of application after installation
or web update.
The MSI installation appears to finish and displays a message to reboot the
machine, but does not instruct the user to stay connected to the network
throughout and after the reboot. Failure to remain connected to the
network when one first launches the software may result in an incomplete
installation as the installer cannot find the original installation source. It is
advised that after installing the software or obtaining web updates, one
actually launches software to ensure installation has fully completed.
2.3.4 Shortcuts fail to launch Actix Software
If the Actix shortcuts displayed in the Windows Start menu fail, reboot
your PC. This will allow the installation to complete correctly, and the
shortcuts should now work.
2.3.5 SMS Package definition file contains incorrect parameter
In the AtxInst.pdf file, the name of the MIF file also includes the ".mif"
extension. This can cause SMS rollouts of the software to fail. To correct
this, edit the PDF file and remove the ".mif" (keep the quotes) extension:
/m "AtxInst.mif" becomes /m "AtxInst"

Actix Software Installation Guide

December 2006

13

2.3.6 Migrating from Wise legacy installation to MSI installation via SMS
In order to upgrade your Wise installation to the new MSI installation via
SMS, you are instructed to push out (deploy from the central server) the
installation twice.
The first push will start the upgrade process, in which the Analyzer
directory is backed up before being completely removed in preparation for
the new install.
The second push will cause the actual installation to occur. Any user files
will be migrated from the old installation to the new, apart from old
stateform (*.axv) and event files (*.evt) which will not be migrated over.
We recommend that for these files, users upgrade to the new file format.
2.3.7 Old Actix shortcuts remain after upgrading from Wise legacy Analyzer
installation
After the MSI installation has finished upgrading from your legacy Wise
installation, you need to manually delete the old Actix Start menu
shortcuts from your personal Start menu.
To do this, right-click on the Windows Start button and select the Explore
option, which by default displays the personal Start menu. Now delete the
old Actix shortcuts.
(The new installation's shortcuts are placed into the 'All Users' Start menu,
and you can view these by selecting Explore All Users.)
2.3.8 Actix Software fails on startup after installation or upgrade
Actix Software can fail to start correctly if you perform one of these
actions:

Double-click on Analyzer.exe from Windows Explorer

Launch from a previously created shortcut that points directly to

the Analyzer.exe.

To prevent such problems from occurring, always launch Actix Software

using the shortcut provided in the Windows Start menu.
If the problem persists, attempt to repair the application using the Settings
> Control Panel > Add/Remove Programs option before contacting Actix
Support.
2.3.9 SQL Native Client already installed
If this is already installed (probably because of a previous failed SQL
Express install), the Actix SQL Express install may fail with the error
show below. This is a common failure and is caused by a known issue in
the MS SQL Express install. The solution is to uninstall the SQL Native
Client using Add/Remove Programs (ARP).
Actix Software Installation Guide

December 2006

14

2.3.10 Slow response from SQL Express

The database part of the install has to establish a connection with SQL
Express so that it can set everything up. If the machine or network is
running slowly, this can take longer than the maximum time allowed for
process. This will be shown in runsql.log as:
Error description: Timeout expired.
This may simply be due to the possibility that the machine is below the
minimum specification required to run Analyzer. If the machine has lots of
applications running, it may be possible to fix this by simply closing
applications (a restart may help), or by trying again later if you are
experiencing high network traffic.

Actix Software Installation Guide

December 2006

15

2.4 Actix Software issues

2.4.1 Incorrect trace symbols used on map
After installing Analyzer and opening a map, the trace symbols being used
may not be correct (ie. # rather than a solid circle will be used). If this
occurs, restart Windows to allow the MapInfo fonts to be properly
registered with Windows.
2.4.2 GeoDict.DCT could not be located
The software displays this message:
"The geodictionary file C:\Program Files\Mapinfo
Mapx\4.0\GeoDict.DCT could not be located"
This problem can occur as a result of uninstalling MapInfo Professional
after having installed Actix Software. This problem can result in no longer
being able to display attributes on the map.
To correct this problem, from the Control Panel's Add/Remove Programs
option, select the Repair option for Actix Software.

Actix Software Installation Guide

December 2006

16

About Microsoft SQL Server 2005 Express

3.1 Overview
Microsoft SQL Server 2005 Express Edition is an easy-to-use, lightweight
version of SQL Server 2005. SQL Express is a key component in Actix
Software, and is normally installed seamlessly as part of the Actix
Software installation.

3.2 Components
The Actix Database installation is made up of several components:
Microsoft SQL Server 2005
Microsoft SQL Server Native Client
Microsoft SQL Server Setup Support Files
Microsoft SQL Server VSS Writer
MSXML6 Parser
Microsoft .NET Framework 2.0
All these components are installed by using the Actix Software installer,
although Administrators and advanced users may be interested to know
that the complete, freely available Microsoft database installation is
available, and may be used to install the Microsoft database software if
required on another PC in a non-Actix context.

3.3 Limitations
Note that you are restricted to a maximum database size of 4GB of
processed data. However, if you attempt to load data that would exceed
the internal size limit threshold, Analyzer will display a message saying
that the data load cannot proceed as the size limit would be exceeded.

Actix Software Installation Guide

December 2006

17