VAF (For UNMS) - Installation Manual (1.0.4.066)

GSS-000647-001
VALUE
ADDED
FUNCTION
FOR UNMS
INSTALLATION MANUAL
NEC Corporation 7-1, Shiba 5-Chome, Minato-Ku, Tokyo 108-8001, Japan

Revision History
Version Author Amendment Details
16/02/2016 1.0.0.001 Gazi AYCIL First Draft

24/02/2016 1.0.0.002 Gazi AYCIL Update for chapter 2
28/02/2016 1.0.0.003 Gazi AYCIL Update for chapter 1 and 2
04/03/2016 1.0.0.004 Gazi AYCIL Updates for chapter 1.3
16/03/2016 1.0.0.005 Gazi Aycıl Updates for Chapter 1
Updates for Chapter 2
Adding Chapter 3
Adding Chapter 4
22/03/2016 1.0.0.006 Gazi Aycıl Re-desing the chapters’ order
Adding Chapter 1.2
28/03/2016 1.0.0.007 Gazi AYCIL Controls
11/04/2016 1.0.0.008 Gazi AYCIL Updates for Chapter 1
Adding Chapter 3.3
14/04/2016 1.0.1.009 Gazi AYCIL Updates for Chapter 1
Adding Chapter 6
17/04/2016 1.0.1.011 Gazi AYCIL Updates for Chapter 3.1
25/04/2016 1.0.1.014 Gazi AYCIL Updates for chapter 1.1.3
14/08/2016 1.0.1.022 Gazi AYCIL Updates for Chapter 1.2.2
01/12/2016 1.0.3.046 Filiz BOĞUCU Controls
Updates for Chapter 1.1
Updates for Chapter 5.1.2
Updates for Chapter 5.1.3
21/12/2016 1.0.4.053 Orhan KESER Controls
06/01/2017 1.0.4.057 Özge Çolakoğlu Updates for Chapter 3.1
10/01/2017 1.0.4.058 Özge Çolakoğlu Controls
1
1. Installation ....................................................................................................................................... 3
1.1. VAF Server Installation ............................................................................................................ 3
1.1.1. Installing .Net Framework ............................................................................................... 4
1.1.2. Installing of VAF Server.................................................................................................... 4
1.1.3. Appling License VAF Server ............................................................................................. 9
1.2. VAF Agent Installation ........................................................................................................... 11
1.2.1. Installing .Net Framework ............................................................................................. 11
1.2.2. Installing VAF Agent....................................................................................................... 11
1.2.3. Appling License VAF Agent ............................................................................................ 16
1.3. VAF Client Installation ........................................................................................................... 17
1.3.1. Installing .Net Framework ............................................................................................. 17
1.3.2. Installing VAF Client ....................................................................................................... 17
2. Uninstallation ................................................................................................................................ 23
2.1. VAF Server Uninstallation ...................................................................................................... 23
2.2. VAF Client Uninstallation ....................................................................................................... 26
2.3. VAF Agent Uninstallation ...................................................................................................... 28
3. Upgrading VAF Application............................................................................................................ 31
3.1. Upgrade For VAF Server ........................................................................................................ 31
3.2. Upgrade For VAF Client ......................................................................................................... 33
3.3. Upgrade For VAF Agent ......................................................................................................... 33
4. Appendix A: Data Flow Diagrams for VAF Installation ............................................................... 34
4.1. Installing VAF Server:............................................................................................................. 34
4.2. Applying License: ................................................................................................................... 35
5. Appendix B: Installing Microsoft .NET Framework ................................................................... 36
5.1. Windows 7 ............................................................................................................................. 36
5.1.1. Installation of .NET Framework 3.5 ............................................................................... 36
5.2. Windows Server 2008 ........................................................................................................... 41
2
5.2.3. Installasstion of .NET Framework 4.5 ............................................................................ 45
6. Appendix C- Compatible Operating Systems ............................................................................... 47
1.1. VAF Server Installation

VAF Applicaiton server works as a service on UNMS server machine.Value Added Function for UNMS
application’ server software should install the UNMS Server machine and it will work as a
subapplication of UNMS.
START
Change the user

Is user administrator? NO
priviliges
YES
Double click the Setup.exe from

Installation folder
Install VAF Server
Apply license
Start Value Added Function for

UNMS Service from the service list
END
Figure 1: VAF Server Installation diagram
3
NOTE 1:
If Microsoft .NET Framework is not installed internet connection is required to install the .NET
Framework.
NOTE 2:
To be able to get the traps from the PNMSj+ servers user needs to set the Upper SNMP Registration
and Group-level trap target of NE on PNMSj+ servers for Nortbound Interface of VAF Server.
Attention!!!
Windows OS language must be “English”, this is a mandatory condition.
1.1.1. Installing .Net Framework

Before installation of VAF Server, please check whether the .Net Framework 4.0 and/or 4.5 are
installed on the server or not.
Windows Server 2012 OS, there is no necessity to install framework since the.Net Framework
4.5 has been installed together with the Operation System (only .NET Framework 4.5 will be
enough for this version of operation system). Otherwise the .NET Framework 4.5 is required to
be installed to the server individually.
1.1.2. Installing of VAF Server

Step 1:
As a first step please insert the VAF application installation CD or open VAF Application folder as
shown in figure 2 and double click on ‘setup.exe’.
Figure 2: Server Folder
Step 2:
Once the file is started an installation wizard will appear as shown in figure 3.
4
Figure 3: Installation wizard step 1
Step 3:
To proceed to the installation, please press ‘Next’. Select the location where the software will be
installed. By default the software will be attempted under Program Files\NEC folder. This can be
manually changed. (As shown in figure 4)
Figure 4: Select installation path
The radio button will be defined the software to be installed for every user or only the current active
user on the server pc.
NOTE:
The ‘Disk Cost’ button displays the disk space that will be occupied by the VAF Application. However,
the value will display the only the space used by the software.
VAF Client and VAFFunctionMenu installation paths have been arranged according to paths that
comes from after installation of UNMS defined with [MNIS] tag in IntegratedMonitoring.properties
5
file placed under folder of C:\ProgramData\NEC\UNMS\im\config:
 ClientApplicationPath=C:\Program Files\NEC\VAF.Client\VAF.Client.exe
 MnisFunctionMenuPath=C:\Program Files\NEC\VAF\Config\VAFFunctionMenu.ini
NOTE :
After installing VAF Server and VAF Client user need to remove the # remark from the
IntegratedMonitoring.properties (As shown in figure 5) file which is located under UNMS\im\config
then restart the UNMS Server.
Figure 5: IntegratedMonitoring.properties file
Step 4:
On the next window the confirmation screen will be displayed as shown in figure 6.
6
Figure 6: Installation wizard step 3.
Step 5:
After clicking the ‘Next’ button the installation will start as shown in figure 7.
7
Step 6:
Once the installation is completed the window below will be displayed as shown in figure 8.
Figure 8: Last step in Installation wizard.
Click “Close” button to complete installation.
Step 7:
Once the installation is completed user should apply the license. To apply license please refer to
“1.1.3 Applying License VAF Server” part of this document.
After applying license user should run the “Value Added Functions Service” from the services then
user can launch the VAF Application as shown in figure 9.
Figure 9: Service list
8
1.1.3. Appling License VAF Server
Step 1:
To apply the license, open the command window on VAF folder and type “VAF.Client.exe –
LoadLicense” command on window (As shown in Figure 10).
NOTE:
To apply the license, command window must be run as administrator.
Figure 10: Load License by using command window.
Step 2:
This command will redirect the user to browse for license folder as shown in figure 11.
Figure 11: Select license folder window.
From this folder user should select license file to be registered. After then user can start the VAF
Server.
When the license installation finished, a file will be created named “VAFFunctionMenu” under
Program Files\NEC\VAF\Config folder (As shown in Figure 12) and the user can check the Modules
in the License with this file. Also the user can see the PNMSj+ IPs and modules by using
ShowLicense.exe command on VAF command prompt.
9
Figure 12: Modules in the License
Ending of VAF Server Installation.

NOTE1:
If the license needs to be changed, all clients should have logged out from system and the service
must be stopped.
NOTE2:
If the user needs get traps from PNMSj(s), VAF user needs to set Trap Port=10162 from the
Upper.pdt file which is located under PNMSj \config folder and user needs to register the VAF
server as Upper SNMP manager and the NEs should be added to Upper SNMP group on to related
PNMSj+ and restart is needed for PNMSj
10
1.2. VAF Agent Installation
VAF Agent is a sub-application for VAF Service. To be able to get additional information of the NEs
VAF Agent must be running on PNMSj+ server machine.

To able to install the VAF Agent on Windows OS .NET Framework versions must be installed on
the PNMSj+ Server pc.
For Windows Server 2008 user need to install the .NET Framework 4.0/4.5, if none of them not
exist in the server machine installer of the VAF Agent will ask for download the .NET Framework
in this case the server pc should be opened to internet. If the server pc cannot connect the
internet user need to download manually and install manually. For installation details please
refer to chapter 5.2 of this document.
1.2.2. Installing VAF Agent

To start the installation for VAF Agent, please insert the VAF Agent Installation CD/folder into the
PNMSj+ server machine, and double click on ‘setup.exe’ file placed under Agent folder in the VAF
Application Installation CD/folder. Once the file is started an installation wizard will appear as shown
in Figure 13.
Figure 13: Installation wizard
To proceed to the installation, please press ‘Next’.
Select the location where the software will be installed. By default the software will be attempted
under Program Files folder. This can be manually changed.
11
NOTE 1:
If the installation directory differs from the default folder, the software update must be in the same
folder where the software was installed.
NOTE 2:
The VAF Agent sub-application must be installed in the PNMSj+ server machine otherwise VAF Agent
will not provide its duty for some features of VAF Application.
NOTE 3:
The ‘Disk Cost’ button displays the disk space that will be occupied by the VAF Application. However,
the value will display the only the space used by the software.
On the next window the confirmation screen will be displayed (As shown in figure 15).
12
After clicking the ‘Next’ button the installation will start (As shown in figure 16).
13
Once the installation is completed the window below will be displayed (As shown in Figure 17).
Figure 17: Last step in Installation wizard.
Click “Close” button to complete installation.
14
NOTE:
"If PNMSj installed path is different from default drive (C:\PNMSj), please run VAF.Agent.exe then
modify the path on General Setting window." (As shown in Figure 18).
Figure 18: General Setting Window
After installation user should apply the license for VAF Agent. For more information, please refer to
“1.2.3 Applying License VAF Agent”
15
1.2.3. Appling License VAF Agent
To apply the license, open the command window and type “VAF.Agent.exe –LoadLicense”
command on window (As shown in figure 19). User should apply the same license with VAF
Server.
NOTE:
To apply the license, command window must be run as administrator.
Figure 19: Load License by using command window.
This command will redirect the user to browse window to select the license from the computer.
NOTE:
The IP address which is registered for license must be same with the Ethernet port’s IP address
which is applied for connection between VAF Server and VAF Agent.
Then user need to open VAF Agent console and configure the related fields.
After applying license and configure by using the VAF Agent console, user need to run the VAF
Agent Service (as shown in figure 20) from the services to be able to use some feature of VAF
module.
16
Figure 20: VAF Agent Service
1.3. VAF Client Installation

Before installation of VAF Client, please check whether the.Net Framework 4.0 and/or 4.5 are
installed on the client pc or not. Please note that the required Framework version is different
according to operating system versions.
If the operating systems are Windows 7 or older version, the .Net Framework 4.0/4.5 are
required as mandatory and those can be found from the VAF Application Installation CD (it’s
placed under the ‘Framework’ folder). For detailed instructions please refer Microsoft©
documentation. For more information about Framework installation please refer to the
Appendix B.
1.3.2. Installing VAF Client

Step 1:
To start the installation for VAF Client, please insert the VAF Application Installation CD into the
client pc or open VAF Application installation folder, and double click on ‘setup.exe’ file placed
under the ‘Client’ folder as shown in figure 21.
17
Figure 21: Client Folder
Step 2:
Once the file is started an installation wizard will appear as shown in figure 22.
Step 3:
To proceed to the installation, please press ‘Next’. Select the location where the software will be
installed. By default the software will be attempted under Program Files\NEC folder. This can be
manually changed. (As shown in figure 23)
18
The check will define the software to be installed for every user or only the current active user.
NOTE 1:
If the installation directory differs from the default folder, user needs to modify the properties file
of UNMS from C:\ProgramData\NEC\UNMS\im\config\ IntegratedMonitoring.properties (as
shown in figure 24) and change the ClientApplicationPath with new path which is shown in
figure 25.
Figure 24: IntegratedMonitoring.properties file
19
Figure 25: VAF Client Path
NOTE 2:
The ‘Disk Cost’ button displays the disk space that will be occupied by the VAF Application.
However, the value will display the only the space used by the software.
Step 4:
On the next window the confirmation screen will be displayed (As shown in figure 26).
20
Step 5:
On the next window the confirmation screen will be displayed. Click ‘Next’ to continue (As
shown in figure 27).
Step 6:
Once the installation is completed, the confirmation window will be displayed (As shown in
Figure 28).
21
Figure 28: Last step in installation wizard
Click close button to complete installation.

After closing the wizard user can run the VAF Client from the UNMS Client. VAF Client cannot
run in a pc alone; it needs to be installed in UNMS Client pc.
To start VAF client application, use UNMS client then select VAF menu. If it is first use of VAF
client VAF will as the Server IP Address with a popup as shown in figure 29. After specifying the
Server IP Address, VAF Client will be able to run.
Figure 29: Server IP Address pop-up
22
2.1. VAF Server Uninstallation
Step 1:
At first, user needs to stop the Value Added Function services from the service list window as shown
in figure 30.
Figure 30: Service List
Step 2:
Click Programs and Features from the Control Panel window as shown in figure 31.
Figure 31: Control Panel>Programs and Features
23
Step 3:
Select VAF.Server and click Uninstall in the Programs and Features window as shown in figure 32.
Figure 32: Uninstalling the VAF Server
Step 4:
Uninstall process will be prepared.
Figure 33: Uninstall pop-up
24
Step 5:
If Value Added Function Service is already started, a window will be displayed and it will want to close
the Value Added Function Service. If the user wants to stop the Value Added Function Service
Automatically click “OK” button.
Figure 34: Confirmation window
Step 6:
After Uninstall process, delete the VAF folder from the server computer (C\Program Files\NEC\VAF).
25
2.2. VAF Client Uninstallation
Step 1:
Click Programs and Features from the Control Panel window.
Figure 35: Control Panel window
Step 2:
Select VAF Client and click Uninstall in the Programs and Features window.
Figure 36: Uninstalling the VAF Client
26
Step 3: Click “Yes” to uninstall. If user clicks the “No” it will cancel.
Figure 37: Confirmation message
Step 4:
After clicking “Yes” Windows Installer popup will appear and uninstall the VAF client.
Figure 38: Uninstall process
Step 5:
After Uninstall process, delete the VAF Client folder from computer.
27
2.3.VAF Agent Uninstallation
The uninstallation process is explained below step by step.
Step 1:
As a first step VAF Agent Service should be stopped from the service list of windows as shown in
figure 39.
Figure 39: Service list
Step 2:
After stopping service user should open Programs and Features from the control panel of the
computer as shown in figure 40.
Figure 40: Programs and Features
28
Step 3:
Select VAF Agent and click Uninstall button as shown in figure 41.
Figure 41: Uninstall
Step 4:
Confirmation message will appear as shown in figure 42.
Figure 42: Confirmation message
Step 5:
After clicking Yes from the confirmation message which is shown figure above, Windows installer will
remove the VAF Agent from the computer (As shown in figure 43 and figure 44).
Figure 43: Process preparing
29
Figure 44: Uninstall process
End of uninstalling VAF Agent.
30
3.1. Upgrade For VAF Server
Upgrading procedure for VAF Server is explained below step by step.
Step 1:
As a first step user need to stop the VAF Service as shown in figure 45.
Figure 45: Services
Step 2:
After stopping service, if user wants to use old data with newer version of VAF Application user
should get backup for demanded data folders file (Data, Pmon, Rmon, Provision, Inventory folders
etc…).
Note:
If the user wants to keep the related configurations, the user should get backup .ini file and after
install newer version of VAF Application, the user should be copied the backup .ini fiile before applying
license of VAF Application.
Attention Please!!!:
After upgrading, below parameters’ values will be changed to default values. Old values will be lost
for these parameters.
 Topology Data Send Interval

 Alarm Log Send Interval
 PMON/RMON Actual Data Send Interval
 MeterCollInterval
31
Step 3:
Uninstall the VAF Server from the Control Panel>Programs and Features. For more information about
the uninstallation process please refer chapter 3 of this document.
Step 4:
Delete VAF folder from the C\Program Files\NEC\VAF.
Step 5:
Install the newer version. To install the newer version please refer to chapter 1.2 of this document.
Step 6:
Please copy the backup folders taken at Step2 (Data, Inventory, Logs, Metering, Pmon, Rmon,
Provision) to VAF Server installed folder.
32
3.2. Upgrade For VAF Client
Upgrading procedure for VAF Client is explained below step by step.
Step 1:
As a first step user need to close the VAF Client.
Step 2:
After closing VAF Client, if user wants to use old data with newer version of VAF Client Application
user should get backup for demanded data folders (Data, Logs etc…).
Step 3:
Uninstall the VAF Client. For more information please refer to chapter 4 in this document.
Step 4:
Delete VAF.Client folder from the computer.
Step 5:
3.3. Upgrade For VAF Agent

Upgrading procedure for VAF Agent is explained below step by step.
Step 1:
As a first step user need to close the VAF Agent.
Step 2:
After stopping service, if user wants to use old data with newer version of VAF Application user
should get backup for demanded data folders file (Data, Pmon, Rmon, Provision, Inventory folders
etc…).
Step 3:
Uninstall the VAF Agent. For more information, please refer to chapter 2.3 in this document.
Step 4:
Delete VAF.Agent folder from the computer.
Step 5:
Step 6:
Please copy the backup folders taken at Step2 (Data, Inventory, Logs, Metering, Pmon, Rmon,
Provision) to VAF Agent installed folder.
33
4.1. Installing VAF Server:
Figure 46: VAF Server Installation-DFD
NOTE:
Please notice that if port 2007 is not allowed for VAF Application, user cannot connect to the server.
Be sure before installing the application about the permission of the port 2007.
34
4.2. Applying License:
Figure 47: Applying License-DFD
35
5.1. Windows 7
5.1.1. Installation of .NET Framework 3.5
“.NET Framework 3.5.1” is installed as default in Windows 7. If it’s not installed it can be installed
from “Control Panel > Programs and Features > Turn Windows features on or off”.
From above window you can install or uninstall “.NET Framework 3.5.1” to Windows 7.
36
To install “.NET Framework 4.0” you need to use standalone installer which is stored in installation cd
of VAF.
Double click the file named as “dotNetFx40_Full_x86_x64.exe” from installation cd of VAF. Below
installation wizard window will be appeared in display.
In this windows first of all the check box must be selected to accept the license terms. After that The
Install button will be enabled and the installation can be continued.
When the Install button is pressed the installation will be started and completed automatically.
37
After completion of the installation the above window will be appeared on the display as figure
below. And by clicking the Finish button installation of “.NET Framework 4.0” will be completed.
After completion of the installation you can easily install VAF Client on the Windows server.
38
To install “.NET Framework 4.5” you need to use standalone installer which is stored in installation cd
of VAF.
Double click the file named as “NDP451-KB2858728-x86-x64-AllOS-ENU.exe” from installation cd of

VAF. Below installation wizard window will be appeared in display.
39
After completion of the installation you can easily install VAF Client on the Windows server.
40
5.2. Windows Server 2008
Double click the file named downloaded file. Below installation wizard window will be appeared in
display.
41
After completion of the installation you can easily install VAF Server/Client/Agent on the Windows
server.
42
display.
43
server.
44
5.2.3. Installasstion of .NET Framework 4.5
display.
45
server.
46
VAF Application Operating System
VAF Server Windows Server 2012 R2
VAF Agent Windows Server 2008
Windows Server 2012 R2
VAF Client Windows 7 x64
47

VAF (For UNMS) - Installation Manual (1.0.4.066)

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

VAF (For UNMS) - Installation Manual (1.0.4.066)

Uploaded by

Copyright:

Available Formats

GSS-000647-001

NEC Corporation 7-1, Shiba 5-Chome, Minato-Ku, Tokyo 108-8001, Japan

16/02/2016 1.0.0.001 Gazi AYCIL First Draft

1.1. VAF Server Installation

Change the user

Double click the Setup.exe from

Install VAF Server

Start Value Added Function for

Figure 1: VAF Server Installation diagram

Windows OS language must be “English”, this is a mandatory condition.

1.1.1. Installing .Net Framework

1.1.2. Installing of VAF Server

Figure 2: Server Folder

Figure 4: Select installation path

Figure 5: IntegratedMonitoring.properties file

Figure 7: Installation wizard step 4.

Figure 8: Last step in Installation wizard.

Click “Close” button to complete installation.

Figure 9: Service list

Figure 10: Load License by using command window.

Figure 11: Select license folder window.

Ending of VAF Server Installation.

1.2.1. Installing .Net Framework

1.2.2. Installing VAF Agent

Figure 13: Installation wizard

To proceed to the installation, please press ‘Next’.

Figure 16: Installation wizard step 4.

Figure 17: Last step in Installation wizard.

Click “Close” button to complete installation.

Figure 18: General Setting Window

Figure 19: Load License by using command window.

1.3. VAF Client Installation

1.3.2. Installing VAF Client

Figure 22: Installation wizard step 1.

Figure 24: IntegratedMonitoring.properties file

Figure 27: Installation wizard step 3.

Click close button to complete installation.

Figure 29: Server IP Address pop-up

Figure 30: Service List

Figure 31: Control Panel>Programs and Features

Figure 32: Uninstalling the VAF Server

Uninstall process will be prepared.

Figure 33: Uninstall pop-up

Figure 34: Confirmation window

Click Programs and Features from the Control Panel window.

Figure 35: Control Panel window

Figure 36: Uninstalling the VAF Client

Figure 37: Confirmation message

Figure 38: Uninstall process

Figure 39: Service list

Figure 40: Programs and Features

Figure 41: Uninstall

Confirmation message will appear as shown in figure 42.

Figure 42: Confirmation message

Figure 43: Process preparing

End of uninstalling VAF Agent.

Figure 45: Services

 Topology Data Send Interval

As a first step user need to close the VAF Client.

Delete VAF.Client folder from the computer.

3.3. Upgrade For VAF Agent

As a first step user need to close the VAF Agent.

Delete VAF.Agent folder from the computer.