Vous êtes sur la page 1sur 17

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


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.1 Overview

1.2 Requirements
These are mainly dictated by SQL Express:
Processor Framework 600 MHz Pentium III-compatible or faster processor; 1GHz or faster processor recommended Before installing SQL Server 2005 Express Edition, you must install the .NET Framework 2.0; this occurs automatically in the standard Actix installation. 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 Hard Disk 192 megabytes (MB) of RAM or more; 512 MB or more recommended 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

Operating System

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
If you have difficulties with installing the database for example, when you see this screen:

2.1 Forwarding logs to Actix Technical Support

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


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.1 Overview

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