Actix One V211 To V30 Upgrade Manual USAEnglish Edn 4

ActixOne
Upgrade Manual
Upgrading ActixOne
from V2.1.1 to V3.0
www.actix.com
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.
Copyright © Actix 2010. All rights reserved. All trademarks are hereby acknowledged.
Edition 4 9 April 2010 www.actix.com

Contents
THIS MANUAL ............................................................................................... 4
INTENDED READERSHIP............................................................................................. 4
REFERENCES ......................................................................................................... 4
BEFORE YOU START ........................................................................................ 5
UPGRADE OVERVIEW ....................................................................................... 6

SUMMARY ............................................................................................................ 6
BACK UP AND RECORD DETAILS OF THE CURRENT INSTALLATION ................................... 7

REVIEW CUSTOMER-SPECIFIC CONFIGURATIONS ................................................................ 7
BACK UP THE DATABASE ............................................................................................ 8
BACK UP SPOTLIGHT AND THE PROCESSING NODE SETTINGS ................................................. 8
RECORD THE ACTIXONE WEB PLATFORM SETUP ................................................................ 8
BACK UP CUSTOMER-SPECIFIC SETTINGS ........................................................................ 8
SHUT DOWN ACTIXONE ................................................................................. 10
UPGRADE THE DATABASE ................................................................................ 12
UPGRADE THE JBOSS-BASED MIDDLEWARE .......................................................... 13
UPGRADE THE APACHE-BASED MIDDLEWARE ......................................................... 16
UPGRADE CITRIX-HOSTED SPOTLIGHT ................................................................ 17
UPGRADE SURVEY DATA PROCESSING NODES ........................................................ 18
UPGRADE QUERIES AND KPIS .......................................................................... 19
TRANSFER REPORTING SETTINGS ...................................................................... 20
UPGRADE THE NETWORK DATA ETL ................................................................... 21
UPGRADE ACTIXONE CLIENT SETTINGS ............................................................... 22
IF THE UPGRADE FAILS .................................................................................. 23

Upgrading ActixOne from V2.1.1 to V3.0 4
This manual
This manual explains how to upgrade ActixOne from Version 2.1.1 to Version 3.0.
Intended readership
This manual is intended to be read by members of the Actix PSO team.
References
The following Actix publications supplement this upgrade manual:
ActixOne Installation Manual
ActixOne Administration Manual
ActixOne Database Housekeeping Guide
ActixOne Database Release Bulletin
ActixOne Database Schema Installation Guide
ActixOne Network Data ETL Manual
ActixOne Core Technology Pack
ActixOne Core Ericsson OSS Technology Pack

Before you start

Discuss, with Chris Haines of the Hammersmith office, how you intend to
deploy the upgrade.
Read the PSO upgrade notes specific to the customer.
Be prepared to restore the database to the previous version if any part of

the upgrade process fails.

Upgrade overview
This manual covers upgrading from ActixOne Version 2.1.1 to Version 3.0. If you
want to upgrade from a version earlier than 2.1.1, refer to the previous upgrade
manuals.
Database migration is likely to take two to four hours, during which time the
system will be unavailable. Other components may be installed and configured
during the database migration.
Database migration is followed by a staged system re-start and sanity check. The
system is then brought back on line.
Summary
Use the following table for quick access to important topics about upgrading from
ActixOne Version 2.1.1 to ActixOne Version 3.0. You must upgrade the various
parts of ActixOne in the order listed in the table.
To learn about See

Capturing details of the current Back up and record details of the current
installation installation on page 7.
Shutting down ActixOne Shut down ActixOne on page 10
Upgrading the database Upgrade the database on page 12
Upgrading the JBoss-based Upgrade the JBoss-based middleware on
middleware page 13
Upgrading the Apache-based Upgrade the Apache-based middleware on
middleware page 16
Upgrading the ActixOne client Upgrade ActixOne client settings on
settings page 22
Installing and setting up Spotlight Upgrade Citrix-hosted Spotlight on page 17
Installing the survey data Upgrade survey data processing nodes on
processing node or nodes page 18
Upgrading queries and KPIs and Upgrade queries and KPIs on page 19
checking for duplicated Spotlight
query sets
Transferring files used to Transfer reporting settings on page 20
generate reports
Upgrading the network data ETL Upgrade the network data ETL on page 21

Back up and record details of the current

installation
You must back up the following:
The database
The processing node settings
Spotlight settings, if Citrix-hosted Spotlight is used
Customer-specific configuration files for the Jboss-based and Apache-based

middleware
Although you will create disc images of each host computer, you will save a lot of
time if you also take note of—and back up—crucial configurations and settings.
Review customer-specific configurations

1 Look out for customer-specific settings, such as:
 Authentication, simple or using LDAP
 Connection, basic or SSL
 Load-balancing
 ActixOne IP ports
 Customized settings files accessed by pipelines
 JBoss settings from the client

(using the Admin > Settings Editor page)
2 Determine whether all or some host computers use 32-bit or 64-bit
operating systems.
3 Note changes made to files—for example, httpd.
4 If the customer uses Citrix-hosted Spotlight, make a note of any non-
default data retention times. You will need these to verify that the upgrade
did not change any of the data retentions times. The default value is 1095
days. A procedure for examining retention times is set out as part of step 3
on page 17.
5 The network data ETL uses customer-specific scripts. Ensure that you can
use the Version 2.1.1 scripts with ActixOne Version 3.0.
6 Note the schedule times for the network data ETL file router.

Back up the database

Back up all database schemas prior to starting this upgrade.
Normally a routine backup can be used rather than making a special backup—
liaise with the database or system administrator.
Note Recovery from a backup is the only supported

way to reverse a database upgrade.
Back up Spotlight and the processing node settings

1 Create a backup directory in a location not influenced by the upgrade.
2 From the computers hosting both Spotlight and the survey data processing
node or nodes, copy the following file to the backup directory:
C:\Documents and Settings\All Users\ 
Application Data\Actix\
Record the ActixOne Web platform setup

On the computer hosting the Apache-based middleware, record the contents of
the Actix One – Web Platform Set Up page.
You can access the page from a Web browser on the computer hosting the
Apache-based middleware. Use the URI:
http://127.0.0.1:8081/deployhtml/setup.php
Back up customer-specific settings

1 Back up the file context.ini.
context.ini is located here:
C:\ActixOne\apps\config
2 Back up the file config.xml.
By default, context.ini is located here:
C:\ActixOne\apps\config\analysisconfig
config.xml is located in a directory determined by the
AnalysisConfigFile parameter in context.ini.
3 Make a note of the WMS Server, and Map Layer Configuration under
Benchmarking (see the relevant Admin pages).
4 Back up the files listed in the following table:
File Located here

.keystore (if used) C:\jboss\server\
default
ActixOne-roles.properties C:\jboss\server\
default\conf\props
ActixOne-users.properties C:\jboss\server\
(if used) default\conf\props

File Located here

catalog.xml C:\jboss\server\
default\data\geoserver
jboss-beans.xml C:\jboss\server\
default\deploy\
jbossws.sar\
jbossws.beans\META-INF
jboss-log4j.xml (if user access C:\jboss\server\
is logged or you changed default\conf\
a logging level threshold)
ldap.truststore (if used) C:\jboss\server\
default\conf
login-config.xml C:\jboss\server\
default\conf
oracle-aq-service.xml C:\jboss\server\
default\deploy\ActixOne
oracle-ds.xml C:\jboss\server\
properties-service.xml C:\jboss\server\
default\deploy
Reports C:\jboss\server\
(Copy and user configured reports) default\deploy\ActixOne
StaticContent.war\
contents\reports
reverseconfig.xml C:\jboss\server\
default\conf
server.xml C:\jboss\server\
default\deploy\
jboss-web.deployer
wrapper.conf C:\jboss\server\
default\wrapper

Shut down ActixOne

Before you start the upgrade, perform the following initial procedures:
1 Ensure that any pending survey data has been loaded into ActixOne.
2 Ensure that any required network data sources are loaded.
3 Stop the network data ETL file router. See Stopping the file router in the
ActixOne Network data ETL Manual.
4 Make a note of all active pipelines and system nodes—you will need to
reactivate them after the upgrade.
5 Deactivate all active pipelines.
6 Deactivate all system nodes.
7 On the processing node computer(s), open Windows Task manager and
locate all processingNode.exe processes. If a processingNode.exe
process is running and the CPU column shows 00, select the process and
click End Process.
8 Shut down the processing nodes:
 On the processing node computer(s), open Services. (Start 

Administrative Tools  Computer Management  Services
and Applications  Services).
 Locate and stop AxaWatchDog.
 Open Windows Task Manager.
 Locate all Analyzer.exe and axaWatchDog.exe processes. If any

are running, select the process and click End Process.
9 Stop access to Citrix:
 Have all current users log off Citrix.
 Temporarily set up Citrix to disallow all logon attempts.

You will need to permit logon attempts after the upgrade.
10 Stop the drive test loading service (orchestrator).
Allow up to 20 minutes for PHP script processes to finish.
11 Stop database jobs.
During the upgrade, inhibit any scheduled database jobs, or backups.

Note You must analyze the implications of inhibiting

scheduled jobs and plan appropriate action. For
example, if you disable the end-of-week partitioning
job, you must manually run the job after you restore
the database. If you disable a job scheduled to run
nightly, you may decide to manually run the job after
the upgrade in the knowledge that the next night’s
scheduled run will fail with no ill effect.
12 Stop the JBoss-based and Apache-based middleware. From the command

prompt, run:
 net stop actixonejboss

 net stop actixone
13 Create a disc image of each computer hosting:
 The Network Data ETL
 The JBoss-based middleware
 The Apache-based middleware
 The survey data processing node or nodes.
 Citrix-hosted Spotlight
Do not include large data files or log file repositories in the images.
14 Remove the ActixOne JBoss service using the command:
 %JBOSS_HOME%\bin\wrapper.exe –r 
%JBOSS_HOME%\server\YOURCONFIG\wrapper\wrapper.conf

Upgrade the database

To upgrade the database, follow these steps:
1 If the middle tier is running during the upgrade, prevent remote access to
the listener by adding the following lines to Oracle configuration file
sqlnet.ora on the database host:
# sqlnet.ora
# the following prevents remote access via the
# listener
# use "lsnrctl reload" to refresh the listener
TCP.VALIDNODE_CHECKING=yes
TCP.INVITED_NODES=(localhost)
2 Follow the procedure set out in Upgrading an existing database in the

ActixOne Database Release Bulletin.
3 Apply the technology pack patches as required for the customer. For more
information, see the ActixOne Core Technology Pack and the ActixOne
Ericsson Core Technology Pack documents.
4 For at least one week after completion of the upgrade, monitor the
database housekeeping event log to verify that scheduled database
management tasks actually run. To learn about scheduled database tasks
and the event log, see Database scheduling and Monitoring in the ActixOne
Database Housekeeping Guide.

Upgrade the JBoss-based middleware

Before attempting an upgrade, you should be familiar with the directory structure
and backup policy for each release.
Version Directory
V2.0 \jboss-4.2
V2.1 \jboss-4.2 (kept as backup)
\jboss (new directory)
V2.1.1 \jboss-backup (rename \jboss as backup)
\jboss (new directory)
V3.0 \jboss
To upgrade the JBoss-based middleware, follow these steps:

1 Rename the \jboss directory as \jboss-backup.
2 Remove the existing version of Java SDK.
3 Install JDK 6 Update 14 and its operating system environment variable.
See Java SDK in the ActixOne Installation Manual.
4 Install the JBoss-based middleware for ActixOne Version 3.0.
See Obtaining and installing the JBoss-based middleware in the ActixOne
Installation Manual.
5 Review the contents of each of the files you backed up at step 3 on page 8
and compare them with the contents of the files listed in the following
table. Edit the Version 3.0 files as required.
Note All of these files have new settings or a new

build number and so cannot simply be replaced. Any
necessary changes must be made in the new file.
File Located here

.keystore C:\jboss\server\
(Delete this file before doing default
anything else, then replace it or
create a new file – for more
information, see the ActixOne
Installation Manual.)
ActixOne-roles.properties C:\jboss\server\
(If used; also, if using the default\conf\props
reporting tool, add the report
settings.)

File Located here

ActixOne-users.properties C:\jboss\server\
(If used; also, if using the default\conf\props
reporting tool, add the report
settings.)
catalog.xml C:\jboss\server\
(Add the database details.) default\data\geoserver
jboss-beans.xml C:\jboss\server\
default\deploy\
jbossws.sar\jbossws.beans\
META-INF
jboss-log4j.xml C:\jboss\server\
(If user access is logged or you default\conf\
changed a logging level
threshold.)
ldap.truststore C:\jboss\server\
(If you use secure access to default\conf
LDAP; now replace the file or
create a new file – for more
information, see the ActixOne
Installation Manual.)
login-config.xml C:\jboss\server\
(Different in 2.1.1 to that used in default\conf
2.1, you must use the latest
version. Add the LDAP settings.)
oracle-aq-service.xml C:\jboss\server\
oracle-ds.xml C:\jboss\server\
properties-service.xml C:\jboss\server\default\
deploy
Reports – place the user C:\jboss\server\
configured reports here. default\deploy\ActixOne\
StaticContent.war\content
reverseconfig.xml C:\jboss\server\
default\conf
server.xml C:\jboss\server\
default\deploy\
jboss-web.deployer
wrapper.conf C:\jboss\server\
default\wrapper
6 If the customer uses load balancing, see Load balancing in the ActixOne

7 Add the logon username and password for the ActixOne JBoss service (the
username is as defined in setup.php). Also, ensure the service has access
to both Apache and JBoss folders.
8 Start JBoss. See Starting the ActixOne JBoss service in the ActixOne
9 If you are migrating from 32 bit to 64 bit, you need to copy wrapper.exe
(see the Installation Manual for details).

Upgrade the Apache-based middleware

To upgrade the Apache-based middleware, follow these steps:
1 Uninstall the Apache-based middleware. (Start  Control Panel  Add or
Remove programs  ActixOne Apache Middleware  Remove).
2 Rename the old ActixOne folder.
3 Ensure the permissions are set on the ActixOne folder.
See Survey data middleware in the ActixOne Installation Manual.
 Refer to your record of the Actix One - Web Platform Set Up page.
See Record the ActixOne Web platform setup on page 8.
 Review the settings of config.xml used with Version 2.1.1 and edit
the Version 3.0 file as required. You can find config.xml here:
4 Install the Version 3.0 Apache-based middleware.
See Survey data middleware in the ActixOne Installation Manual.
 Refer to your record of the Actix One - Web Platform Set Up page.
See Record the ActixOne Web platform setup on page 8.
 Review the settings of config.xml used with Version 2.1.1 and edit
the Version 3.0 file as required. You can find config.xml here:

Upgrade Citrix-hosted Spotlight

If your installation includes Citrix-hosted Spotlight, you must upgrade it.
On the computer hosting Citrix, follow these steps:
1 Uninstall Spotlight (Start  Control Panel  Add or Remove programs
 Actix Software  Remove).
2 Install the replacement version of Spotlight.

Follow the procedure set out in the installation manual. See Citrix-hosted
spotlight in the ActixOne Installation Manual.
3 Check that previously-set data retention times are still in place.
To check the retention time, follow these steps.
 In an ActixOne client, from the administration menu, click Survey

Data  Manage Data  Query Tables and Data Retention.
Query Tables and Data Retention opens.
 In the Retention (Days) column, verify that the value shown on each
line has not changed from the value set in ActixOne Version 2.1.
4 Verify that the Spotlight purge job is disabled from OEM.

Upgrade survey data processing nodes

On each computer hosting a survey data processing node, follow these steps:
1 Uninstall the survey data processing node. (Start  Control Panel  Add
or Remove programs  Actix Drive Test Loading Agent  Remove).
2 Install the replacement survey data processing node.
See Survey data processing node in the ActixOne Installation Manual.
Note If a user has defined a customized settings file

to be accessed by a pipeline, the file must be
available after the upgrade.

Upgrade queries and KPIs

If there are any changes to the queries and KPI, you will need to follow the
procedure described in this section. You need to upgrade queries and KPIs before
loading any new data.
To upgrade queries and KPIs, follow these steps:
Caution You must follow the steps in the order

listed. If you change the order or miss a step, the
data may be left in an ambiguous state.
1 Take a database snapshot.

2 Re-boot the computer hosting the Apache-based middleware and restart
the JBoss wrapper.
3 Open an ActixOne client as administrator.
4 Verify that:
 All nodes are deactivated.
 All pipelines are deactivated.

5 Update queries and KPIs. See the Release Notes for details.
See Updating a query set in the list in the ActixOne Administration Manual.
6 If any GPEH queries need updating, perform the additional steps shown
below. Otherwise, proceed to step 7.
 Delete the existing GPEH Analysis Query and GPEH_Actixcore KPI

(deleting a query will delete all the related tables).
 Add the v3.0 version of GPEH Query and KPI.
 Activate and reprocess the files in GPEH Stage 1. GPEH Stage 2

pipelines will automatically be reprocessed, as the auto reprocessing
node setting has been added.
7 Activate a single survey data processing node. Do not activate more than
one. If you have other survey data processing nodes, activate them later.
See Survey data processing nodes in the ActixOne Administration Manual.
8 Activate nodes and pipelines.
9 In the ActixOne client, monitor the node’s Get Query Definitions job.
10 Once the next data load has taken place, validate the table updates.

Transfer reporting settings

If external applications like Excel were used to run reports from ActixOne, you
must transfer the files used to generate these reports to ActixOne Version 3.0.
To transfer the files, follow these steps:
1 Copy all XLS report files from the following backed-up directory:
C:\jboss-4.2\server\default\deploy\ActixOne\
StaticContent.war\content\reports
2 On the computer that hosts the JBoss server, paste the XLS files to:
C:\jboss\server\default\deploy\ActixOne\
StaticContent.war\content\reports
3 Follow the procedure set out in Setting up ActixOne to run external
applications in the ActixOne Administration Manual.

Upgrade the network data ETL

To upgrade the network data ETL, follow these steps:
1 On the computer hosting the network data ETL, delete directory C:\pdi
and all of its subdirectories.
Note There is a newer version of ETL that needs to

be installed.
2 Install the replacement network data ETL. See Installing Pentaho data
integration in the ActixOne Network Data ETL Manual.
Note Scripts used to manipulate network data are

customer-specific. You must check the scripts to
verify that they are compatible with the customer’s
database schemata.
3 After the network data ETL has been installed, set up a file router schedule.
See Setting up a file router schedule in the ActixOne Network Data ETL
Manual.
Note See the Tech Pack documents for information

on how the tech packs affect ETL.

Upgrade ActixOne client settings

To upgrade ActixOne client settings, follow these steps:
1 Create a directory:
C:\source\settings
2 Into this directory, copy:
upgrade.txt
At the time this manual was prepared, this file was available from the
ActixOne Parts List. Follow the link to both files from part Settings File.
You can find the parts list here:
http://santacruz.actix.com:8081/JSPWiki/
Wiki.jsp?page=ActixOnepartslist_3_*_*
3 Import upgrade.txt into ActixOne.
To learn about importing a settings file see Configuring a client in the
ActixOne Installation Manual.
After an upgrade, the style cache in the database will be out of sync with
Geoserver, so you need to empty the style cache by performing the
following steps:
4 Configure the WMS Server - select Admin > WMS Server (the WMS
Server preferences should have been saved earlier – see page 8).
5 Click Save.
6 From the client, select Admin > Benchmarking > Map Layer
Configuration.
7 Click Save.
8 Configure the NSM Dashboard – select Admin > NSM Dashboard.
9 Click Save.
10 If you had benchmarking tasks before the upgrade, these will have been
invalidated. To use these tasks in the new version, go to Admin >
Benchmarking > Campaign Status. Select the invalidated period and
click the Continue button. Repeat for each period.

If the upgrade fails

If some part of the upgrade process fails and you cannot find out why, revert to
ActixOne Version 2.1.1. Follow these steps:
1 Shut down all application services.
2 Restrict database access.
3 Restore the database.
4 Restore the application server backup.
5 Uninstall the JBoss-based and Apache-based middleware.
6 Restore the Apache-based middleware from the image made at step 13 on
page 11.
7 Uninstall all survey data processing nodes.
8 Restore all survey data processing nodes from the image made at step 13
on page 11.
9 Disable the Network Data ETL.
10 Restore the Network Data ETL from the image made at step 13 on
page 11.
11 Uninstall Spotlight.
12 Restore Spotlight from the image made at step 13 on page 11.
13 Remove the database access restriction.
14 Start all ActixOne services.

Upgrading ActixOne from V2.1.1 to V3.0 Upgrade Manual 24
If the upgrade fails
Americas
T +1 703 707 4777
F +1 703 707 4778
Australia
T +61 3 9225 5042
F +61 2 9501 0770
China
T +86 10 6310 2386
F +86 10 6310 786
Germany
T + 49 351 40429 0
F +49 351 40429-50
Japan
T +81 (3) 6860 8262
F +81 (3) 6860 8201
Singapore
T +65 6333 7428
F +65 6333 5540
UK
T +44 (0)20 8735 6300
F +44 (0)20 8735 6301

Actix One V211 To V30 Upgrade Manual USAEnglish Edn 4

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Actix One V211 To V30 Upgrade Manual USAEnglish Edn 4

Hochgeladen von

Copyright:

Verfügbare Formate

ActixOne

Edition 4 9 April 2010 www.actix.com

BEFORE YOU START ........................................................................................ 5

UPGRADE OVERVIEW ....................................................................................... 6

BACK UP AND RECORD DETAILS OF THE CURRENT INSTALLATION ................................... 7

SHUT DOWN ACTIXONE ................................................................................. 10

UPGRADE THE DATABASE ................................................................................ 12

UPGRADE THE JBOSS-BASED MIDDLEWARE .......................................................... 13

UPGRADE THE APACHE-BASED MIDDLEWARE ......................................................... 16

UPGRADE CITRIX-HOSTED SPOTLIGHT ................................................................ 17

UPGRADE SURVEY DATA PROCESSING NODES ........................................................ 18

UPGRADE QUERIES AND KPIS .......................................................................... 19

TRANSFER REPORTING SETTINGS ...................................................................... 20

UPGRADE THE NETWORK DATA ETL ................................................................... 21

UPGRADE ACTIXONE CLIENT SETTINGS ............................................................... 22

IF THE UPGRADE FAILS .................................................................................. 23

Edition 4 9 April 2010 www.actix.com

Edition 4 9 April 2010 www.actix.com

Before you start

Read the PSO upgrade notes specific to the customer.

Be prepared to restore the database to the previous version if any part of

Edition 4 9 April 2010 www.actix.com

To learn about See

Edition 4 9 April 2010 www.actix.com

Back up and record details of the current

The processing node settings

Spotlight settings, if Citrix-hosted Spotlight is used

Customer-specific configuration files for the Jboss-based and Apache-based

Review customer-specific configurations

 Authentication, simple or using LDAP

 Connection, basic or SSL

 Customized settings files accessed by pipelines

 JBoss settings from the client

Edition 4 9 April 2010 www.actix.com

Back up the database

Note Recovery from a backup is the only supported

Back up Spotlight and the processing node settings

Record the ActixOne Web platform setup

Back up customer-specific settings

File Located here

Edition 4 9 April 2010 www.actix.com

File Located here

Edition 4 9 April 2010 www.actix.com

Shut down ActixOne

 On the processing node computer(s), open Services. (Start 

 Locate and stop AxaWatchDog.

 Open Windows Task Manager.

 Locate all Analyzer.exe and axaWatchDog.exe processes. If any

 Have all current users log off Citrix.

 Temporarily set up Citrix to disallow all logon attempts.

Edition 4 9 April 2010 www.actix.com

Note You must analyze the implications of inhibiting

12 Stop the JBoss-based and Apache-based middleware. From the command

 net stop actixonejboss

 The Network Data ETL

 The JBoss-based middleware

 The Apache-based middleware

 The survey data processing node or nodes.

Edition 4 9 April 2010 www.actix.com

Upgrade the database

2 Follow the procedure set out in Upgrading an existing database in the

Edition 4 9 April 2010 www.actix.com

Upgrade the JBoss-based middleware