Scrutinizer Upgrade Instructions
This guide contains three sets of Scrutinizer upgrade instructions to help guide you in upgrading
to the latest Scrutinizer release. Please follow the section that applies to your current upgrade
path. The three upgrade paths are as follows:
- v8.x to v8.x
- v7.x to v8.x
- v6.x to v8.x
Scrutinizer v8.x to v8.6.1 Upgrade Instructions
The Scrutinizer v8.x to v8.6.1 upgrade has been designed to be an over the top upgrade so users can run
the latest installer on the server and be upgraded to the latest release.
Before upgrading a backup is strongly recommended, but not required.
The files and folders to be backed up are in the following instructions.
What should I verify before upgrading?
Does the Scrutinizer server meet the system requirements?
http://www.plixer.com/products/netflow-sflow/scrutinizer-system-requirements.php
Instructions for upgrading Scrutinizer on the same server:
1) Download the latest installer: http://www.plixer.com/support/availableUpdates.php
2) Make a database backup; if you don’t need a backup, skip to step 7.
3) Stop the plixer_mysql and dependent services
4) Copy the “\scrutinizer\mysql\data\scrut_*” folders to a backup folder
5) Copy the “\scrutinizer\mysql\data\plixer” folder to a backup folder
6) Start the plixer_mysql service
7) Run Scrutinizer-windows-installer.exe
Instructions for upgrading and moving Scrutinizer to a different server:
The Scrutinizer database on the old server has to be upgraded before it can be migrated to a new server,
so you will need to follow the instructions for upgrading Scrutinizer on the same server that are listed
above, and then continue with the instructions below.
IMPORTANT NOTE: These instructions assume the new server will have the same IP address that the old
server had. If the new server will have a different IP address you will need to contact Plixer Technical
Support 207-324-8805 x4 with the new IP address to get a new license key.
1) Follow the instructions for upgrading Scrutinizer on the same server that are listed above
2) Using the same installer that upgraded the old server, install v8.6.1 on the new server
3) Old server: stop the plixer_mysql and dependent services
4) New server: stop the plixer_mysql and dependent services
5) New server: copy the “[homedir]\scrutinizer\mysql\data\plixer” folder to a backup location
6) Old server: copy the “[homedir]\scrutinizer\mysql\data\scrut_*” folders to the same location on
the new server
7) Old server: copy the “[homedir]\scrutinizer\mysql\data\plixer” folder to the same location on
the new server
8) New server: start the plixer_mysql and dependent services
9) Change the sever IP addresses, so the new server has the IP address that’s tied to the Scrutinizer
license key.
Scrutinizer v7.x to v8.x Upgrade Instructions
The Scrutinizer v7 to v8 upgrade has been designed to be an over the top upgrade so users can run the
latest installer on the server and be upgraded to the latest release.
Before upgrading a backup is recommended, but not required.
The files and folders to be backed up are in the following instructions.
What should I verify before upgrading?
-
Does the Scrutinizer server meet the system requirements?
http://www.plixer.com/products/netflow-sflow/scrutinizer-system-requirements.php
-
Verify your “\scrutinizer\mysql\my.ini” contains the tmpdir parameter. If it does not contain
tmpdir you must add it by doing the following:
1) Stop the plixer_mysql and dependent services
2) Navigate to the “\scrutinizer\mysql” folder and create a ‘tmp’ directory
3) Open the “\scrutinizer\mysql\my.ini” file and add the path to the ‘tmp’ directory you just
created. You must use forward slashes in the path instead of back slashes:
a. Example: tmpdir=”C:/Program Files/Scrutinizer/mysql/tmp/”
4) Start the plixer_mysql service
a. If the plixer_mysql service does not start then the tmpdir was not created correctly.
The upgrade will not bring over any host names resolved by DNS. If you want to import the custom host
names from v7.x into v8.x they can be imported after the upgrade.
Instructions for upgrading Scrutinizer on the same server:
8) Download the latest installer: http://www.plixer.com/support/availableUpdates.php
9) Verify your my.ini file contains the tmpdir if you have not already (see above)
10) Stop the plixer_mysql and dependent services
11) Copy the “\scrutinizer\mysql\data\scrut_*” folders to a backup folder
12) Copy the “\scrutinizer\mysql\data\plixer” folder to a backup folder
13) Start the plixer_mysql service
14) Run Scrutinizer-windows-installer.exe
15) If you’re not importing custom host names from v7.x then the upgrade has been completed
How to import custom host names from v7.x:
16) From the command line, navigate to “\scrutinizer\bin” and run “scrut_util –hostmigrate”
Instructions for upgrading and moving Scrutinizer to a different server:
The Scrutinizer database on the old server has to be upgraded before it can be migrated to a new server,
so you will need to follow the instructions for upgrading Scrutinizer on the same server that are listed
above, and then continue with the instructions below.
IMPORTANT NOTE: These instructions assume the new server will have the same IP address that the old
server had. If the new server will have a different IP address you will need to contact Plixer Technical
Support 207-324-8805 x4 with the new IP address to get a new license key.
10) Follow the instructions for upgrading Scrutinizer on the same server that are listed above
11) Using the same installer that upgraded the old server, install v8.x on the new server
12) Old server: stop the plixer_mysql and dependent services
13) New server: stop the plixer_mysql and dependent services
14) New server: copy the “\scrutinizer\mysql\data\plixer” folder to a backup location
15) Old server: copy the “\scrutinizer\mysql\data\scrut_*” folders to the same location on the new
server
16) Old server: copy the “\scrutinizer\mysql\data\plixer” folder to the same location on the new
server
17) New server: start the plixer_mysql and dependent services
Scrutinizer v.6 to v.8.x Upgrade Instructions
The Scrutinizer upgrade including historical data is conducted in 2 phases. The application upgrade does
not automatically bring forward historical data or configurations. The decision is left up to the
administrator whether or not the historical and configuration data will be brought forward. The
application must first be upgraded by running the Scrutinizer installer downloaded from plixer.com
After the application upgrade is complete, the user can then choose to bring forward the configurations
and historical data to the new version. This process is done by running a utility that creates new
databases that work with the new Scrutinizer schema by copying data from the old ones.
This is designed to be an optional process because converting hundreds of GBs of data can take a
substantial amount of time to complete. The time involved to complete also depends on whether
existing 1 minute data points are to be included or not.
What exactly is carried over with the historical data upgrade?
This utility will migrate Scrutinizer v6.x data to v8.x data. The following
information will be imported from v6:
- Historical Flow Data
- Maps / Groups
- Denika Connections
- SNMP Credentials
- Custom Device Names
- Custom Interface Names and Speeds
The following will not be imported due to the enhancements to v8:
- Existing Alarms
- User accounts
- Custom Applications
- Custom Reports and Scheduled Reports
- System Configuration (Admin Preferences)
- 3rd party integration
- Flow Analytic Configurations
- Mail Server Information
- syslog server
- Gadgets
- License Information
What should I backup prior to the upgrade?
Any important information needed from the list of items not imported by the historical data upgrade
should be documented. This will make the process much easier.
The files and folders to be backed up are in the following instructions.
Configuration and Historical Data Migration of Scrutinizer v6.x to v8.x
The following instructions are for those who wish to migrate historical data and configurations on the
same server (Not moving Scrutinizer to a different server). If Scrutinizer is to be moved to a different
server, see instructions for the remote database migration further in the document.
You must have at least 3 times hard drive space used by the Scrutinizer database available for a
successful data upgrade.
**You cannot upgrade a 6.x Scrutinizer installation if Denika/Logalot are installed on the same server
unless you are willing to put Scrutinizer on a different server.**
* Internet Explorer 6 is not supported in Scrutinizer v8 – Use firefox or later version of Internet Explorer
for best results*
Instructions for Configuration and Data upgrade on the same server
1) Stop scrutinizer_MySQL and dependent services on v6 server
2) Move (ie not copy)"\scrutinizer\mysql\data\scrutinizer_*" folder to a backup folder
3) copy the "\scrutinizer\mysql\data\scrutinizer" folder to a backup folder
4) copy the "\scrutinizer\html\gadgets\" folder to a backup folder
5) copy the "\scrutinizer\html\conf.cgi" file to a backup folder
6) Uninstall Flow Analytics for Scrutinizer Netflow Analyzer (if installed)
7) Uninstall Scrutinizer Netflow Analyzer
8) Make sure the v6 services and install folder were removed
A) If some Scrutinizer services remain, such as Scrutinizer collector, filer, or watcher service,
read this forum post for removal instructions: http://forums.plixer.com/viewtopic.php?f=15&t=1472
sc delete scrutinizer
sc delete scrutinizer_filed
sc delete scrut_nba_watcher
sc delete scrut_nba_domains
sc delete scrutinizer_mysql
sc delete scrutinizer_apache2
9) Reboot
10) Download and Install Scrutinizer v8.x
A) Download from: http://www.plixer.com/support/availableUpdates.php
11) Enter licensing information and edit data history settings
A) This information is in the conf.cgi file backed up in step 5.
B) The v6 license key will work in v8. To enter the license in v8, go to Admin->Settings>Licensing, and enter the key in the Flow Analytics license key field.
12) Stop plixer_MySQL service (and dependent services)
13) Move backed up "scrutinizer" and "scrutinizer_*" folders to new \scrutinizer\mysql\data\ folder
14) Start plixer_MySQL, plixer_flow_collector,plixer_watcher,plixer_domain services
15) From an administrative command prompt in the [homedir]\scrutinizer\bin\ folder, run: (including
the one minute data is not necessary and does speed up the process)
(Make sure Flow Analytics is turned off prior to running migrate.exe)
A) If not migrating one minute data:
"migrate --migrate"
B) To include one minute data in the migration:
"migrate --migrate --oneMin"
16) keep the command prompt open until it returns to the command line and then it’s ok to close the
prompt and celebrate. – You’re done.
******** If the data migration fails to come to normal completion, the following command must be
run prior to restarting the migration:
"migrate --retreat"
After correcting whatever caused the migration to fail initially, and running "retreat", then the migration
can be restarted. *******
Instructions for Migrating V.6 Configurations and Historical Data to a remote V.8 Scrutinizer
Installation
**** Before you stop exporting flows to the version 6.0.x Scrutinizer server, stop the Scrutinizer
collector, filer and watcher services ****
1) Install 8.x on new server
2) Enter licensing information and edit data history settings
3) Enable remote access to the v6 mysql database:
1. Open a DOS command prompt on the Scrutinizer v6 server.
2. Run the following command from the ~\SCRUTINIZER\mysql\bin directory:
mysql -u root --password=
3. A mysql> prompt should be displayed.
4. To create a remote user account with root privileges, run the following commands:
GRANT ALL PRIVILEGES ON *.* TO 'USERNAME'@'IP' IDENTIFIED BY 'PASSWORD';
'USERNAME' is the username to be created.
'IP' is the public IP address of the remote connection.
'PASSWORD' is the password to be assigned for this username.
(IP can be replaced with % to allow this user to logon from any host or IP)
mysql> FLUSH PRIVILEGES;
mysql> exit;
4) Make sure all flows sent to v6 are being sent to v8
5) From an administrative command prompt in the \scrutinizer\bin\ folder, run:
(Make sure Flow Analytics is turned off prior to running migrate.exe)
migrate --migrate --v6user MYSQL_REMOTE_USER --v6pass MYSQL_REMOTE_PASS --v6host V6_IP
'MYSQL_REMOTE_USER' is the remote user you created in step 3
'MYSQL_REMOTE_PASS' is the remote password you created for the remote user in step 3
'V6_IP' is the ip address of the v6 server
FAQ
Q) During the upgrade I got an, “Error unpacking archive” and the installer has stopped. What do I do
now?
A) DO NOT abort the install as it will leave Scrutinizer in a non-working state. This is a result of not
being able to overwrite the file the installer has errored on. Call Plixer Technical Support 207-3248805 x4.