to Salsa 8.1 VF4 - Ipanema Technical Support Portal

How to upgrade the Ipanema Solution
from Salsa 7.1 (or higher) to Salsa 8.1
VF4
Windows 2008 R2 Server 64 bits
V2
www.ipanematech.com | Beyond the Network…
Support Team
+33 1 55 52 15 22
+1 617 862 0033
support@ipanematech.com
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
TN XXYYYYY-ZZ
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
REVISION HISTORY
Version
1.0
Date
29/07/2015
Changes / Comments
Added details for VF4 – Title changed – New automatical VistaViews
process with ipreporter setup.
COMPATIBILITY
System
ip|boss
Revision
7.1 or
higher
all
7.1 or
higher
All
Infovista release
-
OS
Windows
Version
ip|reporter
ip|agent
ip|reporter
web
ip|export
7.1 or higher
-
-
-
all
-
-
-
PREREQUISITE
Technical Note
TN-0100173-11
TN-0100200-14
Title
How to backup and restore Salsa 7.1
How to backup and restore Salsa 8
www.ipanematech.com
2
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Contents
1.
INTRODUCTION ............................................................................................................ 4
2.
UPGRADE SALSA TO THE 8.1 VERSION .................................................................... 4
3.
4.
2.1.
Prerequisites ........................................................................................................... 4
2.2.
Install ip|boss 8.1 .................................................................................................... 5
UPDATING INFOVISTA ................................................................................................13
3.1.
Infovista server upgrade .........................................................................................13
3.2.
Infovista libraries upgrade ......................................................................................13
3.2.1.
– Automatic installation (using ipreporter_setup) .............................................13
3.2.1.
Automatic installation (using ipreporter_setup) on the ip|boss server ..............16
3.2.2.
– Manual installation (using IVreport) ..............................................................16
UPGRADING IP|REPORTER WEB...............................................................................19
4.1.
Upgrading VistaPortal ............................................................................................19
4.2.
Upgrading ip|reporter WEB ....................................................................................23
5.
REENABLE THE NEW DOMAIN AND VERIFY CONFIGURATION ..............................27
6.
KNOWN ISSUES ..........................................................................................................28
www.ipanematech.com
3
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
1. INTRODUCTION
This document details step by step what must be done to upgrade your Ipanema Solution from
a Salsa v7.1 or 8.0GA to the v8.1 version in VF0 (VistaFoundation components update if lower
than 4.3 out of the scope of this document).
The upgrade will generate holes in the reporting, but services activated on the ip|engines
(optimization, acceleration, compression) will remain active.
For a full list of changes and new features, please refer to the Salsa v8.1 release note. The
Ipanema System v8.1 user manual explains how to use the new features.
2. UPGRADE SALSA TO THE 8.1 VERSION
2.1. Prerequisites

We advise you to backup your ip|boss configuration and Infovista databases
before beginning the upgrade:
How to backup and restore Salsa 7.1 or 8.0GA:
-
https://support.ipanematech.com/kb/25/116
https://support.ipanematech.com/kb/25/963
-
How to backup and restore ip|reporter :
https://support.ipanematech.com/kb/25/250

You will need to prepare the following files to perform the upgrade :
- Extract / Copy the “ipboss v8.1.x windows.zip” file on your ipboss server.
- Extract / Copy the “ipreporter v8.1.x.zip” file on both ipboss and ipreporter servers
(if they are hosted on two distinct servers).
- Extract / Copy the “ipreporter-web v8.1.x.zip” on your VistaPortal server.
- With SALSA 8.1, you need VistaPortalSE v4.4 and last hotfix. Extract / Copy
“VistaPortalSE 4.4 windows” and the last “Hotfix VPSE” on your VistaPortal
server.
www.ipanematech.com
4
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
2.2. Install ip|boss 8.1
First, launch the ip|boss setup. The following window will appear. Click on “Next”.
www.ipanematech.com
5
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
The following window will be displayed:
www.ipanematech.com
6
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
www.ipanematech.com
7
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
You can find more information about this part on the Support website :
https://support.ipanematech.com/kb/34/1459
www.ipanematech.com
8
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Double-check the settings and click on “Next”:
www.ipanematech.com
9
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Installation then proceeds:
www.ipanematech.com
10
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click on “Next”:
www.ipanematech.com
11
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click on “Done”. The ip|boss installation is complete.
www.ipanematech.com
12
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
3. UPDATING INFOVISTA
3.1. Infovista server upgrade
Warning – If you upgraded an existing Salsa v7.1 or v8.0GA installation and you are
currently running Infovista v4.2, it must be updated to v4.3.
Ask Ipanema support team to provide you a new Infovista License, with the MAC address of
the new Windows 2008 server.
You will then be able to upgrade your Infovista installation to 4.3 or v4.4.
3.2. Infovista libraries upgrade
There are two ways to install the Ipanema VistaViews: automatically, using
ipreporter_setup.exe executable file, or manually, using IVreport (InfoVista rich client).
The manual procedure is only helpful to perform a remote installation. Otherwise, follow the
automatic procedure.
3.2.1. – Automatic installation (using ipreporter_setup)
Launch ipreporter_setup.exe. This setup must be run on both ip|boss and ip|reporter
servers. If these components are hosted on separate servers, the setup must be launched
on both.
www.ipanematech.com
13
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click Next. In the next window, accept the terms of the license and click Next:
In the next window, there are two check boxes, one for ip|boss and one for InfoVista:
www.ipanematech.com
14
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
As you are on the VistaMart server, only the “InfoVista server” box is checked, by default: leave
it as it is.
The installation then proceeds. Click Next when finished:
A message tells you that the installation tasks were successful; click Next:
Click Done to finish the installation:
www.ipanematech.com
15
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
3.2.1. Automatic installation (using ipreporter_setup) on the ip|boss
server
In order to upgrade the reports description, you must run ipreporter_setup.exe on the ip|boss
server.
Installation remains the same as for the VistaMart, except for step 3, the “ip|boss Server” box
is checked by default.
Verify that the ip|boss installation directory is correct then click “Next”.
The installation proceeds.
3.2.2. – Manual installation (using IVreport)
This procedure should not be required, normally. It is only applicable in VF0 mode.
Start IVreport (InfoVista rich client).
Go to the menu File > Install VistaView.
Select all libraries located in the directory “IVL” (InfoVista Libraries) on ip|reporter DVDROM.
The installer window will list the new libraries to be updated listed in bold as well as the
new version number :
www.ipanematech.com
16
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click on the Install button.
www.ipanematech.com
17
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Once installation completes, the version installed on server will match the version of the
library in the install folder :
Purge the Trash Libraries and close IVreport.
The new versions of VistaViews are NOT automatically updated. To avoid holes in report
graphs at critical times, we recommended you perform the upgrade in off-peak hours.
Copy over the new reports_desc.ipmsys file, located in the “ipboss” folder of the
ip|reporter directory on the DVD, to \Program Files\salsa\ipboss\server\conf\ on the
new server
www.ipanematech.com
18
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
4. UPGRADING IP|REPORTER WEB
4.1.
Upgrading VistaPortal
With SALSA 8.1.x, you must run a VP 4.4 and its last hotfixes. If your VP is already running
in 4.4, you can skip this section.
Launch setup.exe in the VistaPortal 4.4 windows ~ \Disk1\InstData\Windows\VM
The following window will appear :
Click on Next. Accept the user license agreement and click Next.
We recommend taking time to look at the InfoVista readme file appearing in the next step,
then continue the installation by clicking Next :
www.ipanematech.com
19
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
www.ipanematech.com
20
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
We do not recommend changing default setting. The value of choice will directly depend
on platform design, expected simultaneous users connecting to the reporting portal and
availability of server resources, depending on if it is shared with other components.
On the next window, confirm the VPUSER password.
Installation should proceed. Click done, installation process is complete.
www.ipanematech.com
21
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Your VistaPortal is now running in 4.4. You must now install the last hotfixes.
The following article details the procedure to follow in order to perform the hotfix installation :
https://support.ipanematech.com/kb/19/834
www.ipanematech.com
22
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
4.2.
Upgrading ip|reporter WEB
Launch ipreporterweb_setup.exe.
The following window will appear :
www.ipanematech.com
23
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click on Next.
www.ipanematech.com
24
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
Click on Next. The sub-directory must be the directory where you installed VistaPortal :
www.ipanematech.com
25
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
The setup program then stops VP, installs the necessary files and starts VP. Installation is
completed :
www.ipanematech.com
26
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
5. REENABLE THE NEW DOMAIN AND VERIFY
CONFIGURATION
Enable the newly created domain and check that it has a green LED in ip|uniboss
Stop the Salsa services on the former ip|boss server
Log in to ip|boss and enable the ip|engines in system activation
Once the Server and Database LED turn green, initiate a Force Synchronize :
www.ipanematech.com
27
How to upgrade the Ipanema Solution from Salsa 7.1 (or higher) to Salsa 8.1 VF4
6. KNOWN ISSUES
Issue
Solution
KB
The scale reports is not
correct after ip|boss
upgrade from 7.1 to 8.1
Upgrade the InfoVista libraries
to 8.1 using the ip|reporter tool
on the VistaMart server (VF4) or
on the ip|reporter server (VF0).
https://support.ipanematech.com/kb/22/1367
Wrong password used for
VPSE/VP
https://support.ipanematech.com/kb/22/1366
IE8 is not supported
https://support.ipanematech.com/kb/22/993
Install ip|reporter web
https://support.ipanematech.com/kb/22/1443
"Failed to import
vistaview packages"
error during the
ip|reporter installation
I do not see the
Dashboard tab since my
upgrade to Salsa 8
I do not have access to
ip|reporter web since I
installed the last VPSE
Hotfix
www.ipanematech.com
28
www.ipanematech.com | Beyond the Network…
ABOUT IPANEMA TECHNOLOGIES
The Ipanema System enables any large enterprise to have full control and optimization of
their global networks; private cloud, public cloud or both. It unifies performance across
disparate networks. It dynamically adapts to whatever is happening in these networks and
guarantees constant control of critical applications. It is the only system with a central
management and reporting platform that scales to the levels required by Telcos and large
enterprises.
For more information www.ipanematech.com
Copyright © 2011, Ipanema Technologies - All rights reserved. Ipanema and the
Ipanema logo are registered trademarks of Ipanema Technologies. The other registered
trademarks and product names mentioned in this document are the property of their
respective owners.