Professional Documents
Culture Documents
911-431/02A0120
Issue 1, March 2009
The information in this document is subject to change without notice and describes only the product defined in the introduction of this
documentation. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement
under which the document is submitted, and no part of it may be used, reproduced, modified or transmitted in any form or means without the
prior written permission of Nokia Siemens Networks. The documentation has been prepared to be used by professional and properly trained
personnel, and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes customer comments as part of
the process of continuous development and improvement of the documentation.
The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or
software products are given "as is" and all liability arising in connection with such hardware or software products shall be defined conclusively
and finally in a separate agreement between Nokia Siemens Networks and the customer. However, Nokia Siemens Networks has made all
reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Nokia
Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which may not be covered by the document.
Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO EVENT WILL NOKIA SIEMENS NETWORKS
BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT,
INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES,SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE,
BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE
INFORMATION IN IT.
This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to
the applicable laws.
The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark of Nokia Corporation. Siemens is a registered
trademark of Siemens AG.
Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification
purposes only.
Copyright Nokia Siemens Networks 2009. All rights reserved.
STATUS OF MANUAL
STATUS OF MANUAL
Current:
Previous:
This issue describes the installation and the configuration of the NA-NV Connector V1.2
software application.
R-1
LA
PA
STATUS OF MANUAL
R-2
INDEX
INDEX
STATUS OF MANUAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .R.1
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I.1
LIST OF ILLUSTRATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I.3
1.2
1.2.1
1.2.1.1
1.2.1.2
1.2.2
1.2.3
1.2.3.1
1.2.3.2
1.2.3.3
1.2.3.4
1.2.3.5
1.2.3.6
1.2.3.7
1.3
1.3.1
1.3.2
1.4
1.5
1.6
1.7
1.8
1.9
Network configuration for the remote management of the NetViewer GUI . . . . . . . . . . . . . . 1.8
1.10
1.11
1.11.1
1.11.2
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1
2.2
2.2.1
2.2.2
2.2.3
2.3
I-1
INDEX
2.3.1
2.3.2
I-2
Foreword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1
4.2
4.2.1
4.2.1.1
4.2.1.2
4.2.1.3
4.2.2
4.2.2.1
4.2.2.2
4.2.2.3
4.3
4.3.1
4.3.2
4.3.2.1
4.3.2.2
4.3.3
4.3.4
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Access to Windows Terminal Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Access to Citrix Presentation Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selection of the users with rights of execution of the applications . . . . . . . . . . . . . . . . . . .
Configuration of ICA protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Login to NetViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuration of the access to DB of NetViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.13
4.13
4.13
4.13
4.13
4.14
4.14
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A.1
A.2
A.3
A.4
A.5
A.5.1
A.5.2
LIST OF ILLUSTRATIONS
LIST OF ILLUSTRATIONS
Fig. 1.1
Fig. 1.2
Fig. 2.1
Fig. 2.2
Fig. 2.3
Fig. 2.4
Fig. 2.5
Fig. 2.6
Fig. 2.7
Fig. 2.8
Fig. 2.9
Fig. 2.10
Fig. 2.11
Fig. 2.12
Fig. 4.1
Fig. 4.2
Fig. 4.3
Fig. 4.4
Fig. 4.5
Fig. 4.6
Fig. 4.7
Fig. 4.8
Fig. 4.9
Fig. 4.10
Fig. 4.11
Fig. 4.12
Fig. 4.13
Fig. 4.14
Fig. 4.15
Fig. 4.16
Fig. 4.17
Fig. 4.18
Fig. 4.19
Fig. A.1
Fig. A.2
Fig. A.3
Fig. A.4
Fig. A.5
Fig. A.6
Fig. A.7
Fig. A.8
Fig. A.9
Fig. A.10
Fig. A.11
Fig. A.12
Fig. A.13
Fig. A.14
Fig. A.15
I-3
LIST OF ILLUSTRATIONS
I-4
1 - GENERAL INFORMATION
1 GENERAL INFORMATION
1.1 Purpose and Subject of the Manual
This Manual provides the information for the installation, the configuration and the use
of the NetAct-NetViewer Connector software application (from now on called NA-NV
Connector).
NA-NV Connector is an optional software package that allows the integration of
NetViewer into NetAct and, then, the management of the supported radio Network
Elements.
The use of Citrix Presentation Server framework allows the remotization of the GUI of
NetViewer on the Client PCs of NetAct (Screen Level Integration).
It is forbidden, unless after written authorization, to divulge the content of this
Manual to third parties. A copy of this Manual can be required, mentioning its
code (present on the frontispiece).
NetAct
NetAct is a network and service management framework that addresses the operator's
challenges to handle more network elements, larger networks, greater complexity and
explosive growth in traffic and data expected in future networks.
NetAct can manage both the network and services in a centralised manner, meaning
that the operator can view all network element failures, service quality indicators and
traffic from one single screen.
The ability to collect, integrate and utilise the information about the status and the
performance of all network elements and services is the cornerstone of NetAct. Fluent
alarm handling, reporting capabilities as well as network optimisation functionality
minimise the network downtime and congestion, optimise the network capacity and
create the basis for efficient network operations.
NetAct is a total OSS package including common network functionalities as well as
sophisticated tools for service assurance and optimisation.
Key drivers in the NetAct solution:
One single system for monitoring, measuring and configuring the network and
services
High scalability that meets the growth of network and services and technology
lifecycle requirements
Wide support for customer specific extensions to adapt NetAct to the business
processes and needs of individual organisations.
1-1
1 - GENERAL INFORMATION
1.2.1.1
1.2.1.2
1.2.2
On NetViewer element name change, the element with old name will be removed
from NetAct and a new element (with different Distinguish Name) will be added.
On NetViewer element version change, the element with the old date will be
removed from NetAct and the same element (with same Distinguish Name) will be
re-added with new data.
NetViewer
NetViewer Server is the Element Manager of all the radio NE: it collects all the
information coming from the NE such as fault and performance and enables to configure
the radio equipments. To get more information about NetViewer refer to the
NetViewer Technical Customer Documentation.
1.2.3
NA-NV Connector
NetAct-NetViewer Connector implements the Mediation layer to interface
NetViewer towards NetAct.
The main functionalities of the application are:
Fault Management
The project NA-NV Connector 1.2 provides also the EMS GUI remote lauch feature.
1-2
1 - GENERAL INFORMATION
This is a separate feature of the same integration, not provided by the Connector module
itself, but provided via Citrix Presentation Server framework.
1.2.3.1
1.2.3.2
Fault Management
All alarms managed by NetViewer, except the alarms/events with TEST severity, are
forwarded to NetAct and will be managed into NetAct as all the other NetAct alarms.
It is possible to present alarms from a NetAct view containing NetViewer managed
object by right-clicking the object and selecting "Alarm Monitor". Moreover it is
possible, on the icon, to select the "Alarm History" functionality.
It is important underline that NetAct does not present in the Alarm List the alarms with
severity warning, but they will be logged in the Alarm History.
Another topic to underline is the station alarms behaviour that in NetViewer have
the Indeterminate severity. This kind of Severity is not foreseen in NetAct so the station
alarms severity is mapped into the Minor severity in the NetAct system. Moreover
Station Alarms have in NetAct as Specific Problem the value "Station Alarm", but
NetViewer can customise the description string. So in NetAct is visible "Station Alarm x"
while in NetViewer a specific description as "door open" is shown.
1.2.3.3
Performance Management
This optional fragment manage the Network elements performance collection.
For further details see Appendix A.
1.2.3.4
1-3
1 - GENERAL INFORMATION
If the same user log-in at another terminal, the previous session (in the previous
terminal) will be closed, and the NetViewer GUI will be displayed at the new
terminal.
1.2.3.5
Configuration supported
This release of the connector supports only the NetViewer Single Server configuration.
The Connector is installed on the same host of NetViewer and manages only the NE's
managed by that NetViewer.
1.2.3.6
Firewall
The following cases are possible:
1.2.3.7
NetViewer Interface
used for implementing north bound IF of NetViewer
NA-NV Connector
used to convert NetViewer proprietary model in the correspondent O&M Agent.
Together with the setup of NA-NV Connector, also the O&M Agent component is
installed, providing the NE3S fully compliant north bound interface of the NA-NV
Connector product.
This allow the exchange of requests and informations between NMS and EMS.
1-4
1 - GENERAL INFORMATION
Fig. 1.1
Architectural design
NetAct
NA-NV Connector
NA NV Connector
NetViewer Interface
NetViewer Server
Radio NE
1.3.1
Radio NE
Radio NE
NetViewer Interface
The NetViewer Interface module is an interface between the NetViewer server and the
NA-NV Connector. Its main purpose is to collect and manage with specific criteria all the
information coming from NetViewer Server and to send it towards upper layer interfaces.
Its basic operations can be resumed in the following points:
Create a Managed Element structure, which contains the physical and functional
representation of a single Network Element.
Manage all the network element event-alarms and send them to the interested
interfaces.
For these purposes, NetViewerInterface loads all the alarm information available
in the NetViewer TVX/TVD/TVF format files and gives an interface for query the alarms
information for a given NE.
NetViewer Interface is a component of the NetViewer Advanced Update Pack
service of NetViewer, and is included in the NA-NV Connector setup.
1.3.2
NA-NV Connector
The NA-NV Connector component has been implemented to provide the mapping
between the NetViewerInterface event/alarms modelization and the O&M Agent
proprietary format (NE3S style).
For this purpose, a set of interfaces has been implemented in order to manage the data
coming from NetViewerInterface and going towards O&M Agent layer. In particular two
1-5
1 - GENERAL INFORMATION
1-6
1 - GENERAL INFORMATION
1-7
1 - GENERAL INFORMATION
Client PC:
Operating System: Microsoft Windows, UNIX (Solaris, HP), Linux
Citrix ICA Client (from 7.0)
supported Web Browser.
1-8
1 - GENERAL INFORMATION
Fig. 1.2
Windows Server
SQL Server
NetViewer Server
NA-NV Connector 1.1 (Core engine) (**)
DCN
NetViewer
Server PC
Citrix
Server PC
WAN
Router
NE
192.168.24.244 (*)
Router
NE
Firewall
LAN
Operating System
Citrix ICA Client
NA-NV Connector 1.1 (Client) (**)
NetAct Client PC
NetAct PC
Operating System
Citrix ICA Client
NA-NV Connector 1.1 (Client) (**)
NetAct Client PC
Assumption: no firewall present between Citrix server (and NetViewer GUI) and
NetViewer Server.
1.11.1
1-9
1 - GENERAL INFORMATION
1.11.2
1-10
LA
PA
1 - GENERAL INFORMATION
1-11
1 - GENERAL INFORMATION
1-12
2 - SOFTWARE INSTALLATION
2 SOFTWARE INSTALLATION
2.1 Requirements
NA-NV Connector setup must be executed on the NetViewer Server PC and on the
Client PCs (PCs with Citrix ICA Client).
In the first case the core engine is installed, while in the second case only the client
component is installed.
In both cases, the selection of the installation modality is transparent for the operator.
NA-NV Connector must be installed on each Server PC of NetViewer.
The procedure for the installation of NA-NV Connector is the following one:
CD-ROM
of
NA-NV
Connector
(file:
2-1
2 - SOFTWARE INSTALLATION
It is always possible, until the end of the setup, to stop the procedure, clicking on
Cancel.
The License Agreement window is displayed. Accept the conditions of the license
for the use of the software. The Next> button becomes active (Fig. 2.3). Click on
Next> to continue or on <Back to return to the previous window.
The Ready to Install the Program window is displayed (Fig. 2.4). Click on Install
to continue the installation or on <Back o return to the previous window.
At the end of the installation, the window of installation complete (Fig. 2.5) is
displayed. Click on Finish to end and exit from the setup.
2-2
Fig. 2.1
Fig. 2.2
2 - SOFTWARE INSTALLATION
Fig. 2.3
Fig. 2.4
Fig. 2.5
2-3
2 - SOFTWARE INSTALLATION
2.2.2
CD-ROM
of
NA-NV
Connector
(file:
The starting Welcome window is displayed (Fig. 2.2). Click on Next> to continue.
It is always possible, until the end of the setup, to stop the procedure, clicking on
Cancel.
The License Agreement window is displayed. Accept the conditions of the license
for the use of the software. The Next> button becomes active (Fig. 2.3). Click on
Next> to continue or on <Back to return to the previous window.
The Ready to Install the Program window is displayed (Fig. 2.4). Click on Install
to continue the installation or on <Back o return to the previous window.
At the end of the installation, the window of installation complete (Fig. 2.5) is
displayed. Click on Finish to end and exit from the setup.
2.2.3
Maintenance procedure
The following options for the NA-NV Connector maintenance are available:
It is possible to run the NA-NV Connector maintenance also using the typical
adding/removing mode of the application programs in Microsoft Windows
("Add/Remove Programs" command in Control Panel).
2-4
2 - SOFTWARE INSTALLATION
It is suggested to confirm always if the system asks, in the final window, for the restart
of the machine.
NetViewer Interface
NA-NV Connector
Both the modules, together with O&M Agent component, are installed, with the setup,
as services of NetViewer AUP and, then, can be managed from the Services
Management window of NetBuilder, which can be opened by the Services command
of Configuration menu.
For information on the use of the tool for the management of the services of
NetBuilder, refer to the Operating Manual of NetViewer.
In the Services Management window (Fig. 2.6) are displayed, in format of table, the
services managed by NetViewer Services. For each service, it is possible:
Fig. 2.6
2.3.1
Execute the command to stop the service (if the service is operating)
Execute the command to start the service (if the service is not operating)
2-5
2 - SOFTWARE INSTALLATION
Fig. 2.7
Fig. 2.8
NetViewer AUP
The stop command determines the stop both of NetViewer AUP and of the linked
services.
A confirmation for the execution of the stop command is required (Fig. 2.8).
2-6
NetViewer Server
The stop command determines the stop of all NetViewer services and close the
Services Management window.
A confirmation for the execution of the stop command is required (Fig. 2.7).
[ver . x.x (Build 00000)]: univocally points out the installed release
O&M Agent: provides the NE3S fully compliant north bound interface of the
NA-NV Connector product
Selecting the O&M Agent item or NA-NV Connector item a command panel is
shown:
Stop/Start button: execute the command to stop the NA-NV Connector (if the
service is running) or to star the NA-NV Connector (if the service is not
running).
2 - SOFTWARE INSTALLATION
Fig. 2.9
2.3.2
Select the O&M Agent component, click on the button O&M Agent General
Configuration that opens the Global Configuration window (Fig. 2.11).
The Fault Management button, that controls the reporting of fault events,
shows the current service state and can be Active or Inactive
2-7
2 - SOFTWARE INSTALLATION
General Configuration: this panel report the configuration of some O&M Agent
general parameters (the Apply button confirm the changes):
Community: this string is the community used by the O&M Agent SNMP
operation. The default value is esymac.
O&M Agent port: local port used by ESYMAC (not modified by default). The
value is 9998
Prefix Path: path that identifies the local installation, provided by NetAct; the
set value is PLMN-PLMN
The O&M Agent port may be changed, if it isnt available due to settings of the
host PC (ex.: local firewall).
Click the button O&M Agent Specific Configuration that opens the Specific
Configuration window (Fig. 2.12) (the apply button confirm all configurations).
Remote User: username for the access to the manager side of the FTP
connection (nx2suser with NetAct use).
Remote Pwd: password for the access to the manager side of the FTP
connection.
Remote export dir: path of the destination folder of the query of the
manager, starting from the source folder of FTP. Use default.
Fault settings: this panel shows the settings for Fault Management:
Click the button Start in order to start the O&M Agent application.
2-8
2 - SOFTWARE INSTALLATION
Fig. 2.10
Fig. 2.11
Fig. 2.12
2-9
2 - SOFTWARE INSTALLATION
2-10
3 - EQUIPMENT MANAGEMENT
3 EQUIPMENT MANAGEMENT
3.1 Supported equipment
Currently, the SRA 4 4.8/4.10 equipment is supported and is represented in the GUI of
NetAct by a specific icon:
All the other equipment are represented in the GUI of NetAct by an icon of generic NE:
3.1.1
Sra4
The SRA 4 radio system, designed for MAN (Metropolitan Area Network) and WAN
(Wide Area Network) applications, is a broadband wireless point-to-point system.
The SRA 4 radio system has been developed for the transmission of the following
signals:
SDH (STM-1)
SONET (OC-3)
ATM on SDH
ATM on SONET
System Types:
electrical
optical
Management interfaces:
two Ethernet interfaces (one 10baseT and the other 10/100baseT), reserved
for the connection to NetViewer and/or other TMN supervision centers (e.g.:
EM-OS, Access Integrator) and for the transmission of the supervision
information among the system controllers of the same station
3-1
3 - EQUIPMENT MANAGEMENT
3-2
4 NETWORK CONFIGURATION TO
REMOTIZE THE GUI OF NETVIEWER
4.1 Foreword
Scope of this chapter is to define a network configuration suitable to screen level
integration functionality of NetAct - NetViewer Connector, release 1.21.2.
The screen level integration consists in the possibility to have the NetViewer Graphical
User Interface [GUI] at NetAct GUI terminal, where the system user operates.
First integration foresees:
In the following, we assume that on the network PCs have been installed and configured
the following components:
4-1
A maximum of 10 remote GUI clients are managed by a single Citrix Server PC.
It's a Citrix Server performance issue, and a Citrix Server host performance issue.
If more NetViewer GUI clients are needed, additional Citrix Server hosts must be
added.
A maximum of 20 NetViewer GUI clients can be connected to a NetViewer Server.
It's a NetViewer Server performance issue.
For more information on the network architecture, refer to the OMN Manual of
NetViewer.
Fig. 4.1
Windows Server
SQL Server
NetViewer Server
NA-NV Connector 1.1 (Core engine)
DCN
NetViewer
Server PC
Citrix
Server PC
WAN
Router
NE
Router
NE
Firewall
LAN
Operating System
Citrix ICA Client
NA-NV Connector 1.1 (Client)
NetAct Client PC
NetAct PC
4-2
Operating System
Citrix ICA Client
NA-NV Connector 1.1 (Client)
NetAct Client PC
4.2.1
4.2.1.1
From Citrix Server PC, publishing the applications you wish to make available to
all the users who can connect (even via Web).
Click on the Action > New > Published Application menu (Fig. 4.2)
The Publish Application window opens (Fig. 4.3) where entering the information
of the published application:
In the Application Type box, select the radio button corresponding to the
publication type (in case of NetViewer, it is an application):
In the following window, leave the default setting and click Next.
Specify the size of the window and the quantity of color as in Fig. 4.5. Click on
Next.
In the Specify Client Requirments window, leave the default setting and click on
Next.
In the Specify Application Limits window, leave the default setting and click on
Next.
4-3
In the Configure Access control window, leave the default setting and click on
Next.
In the Specify Servers (Fig. 4.6) window, select the server containing the
application and click on Add. Click on Next.
In the Specify Users (Fig. 4.7) window, select the users with the right to launch the
application.
It is possible to select the users among which present in the Look in field
containing the users configured on the Server of the Farm (e.g.: netviewertest) or
add to the list a valid user through Add List of Names."(e.g.:
NVSERVER1\netviewertest).
Selecting the Allow Anonymous Connections check box, when ICA Client is
launched, an authentication window of the Server will open.
Click on Next.
4-4
In the Specify file type associations window, leave the default settings. Click on
Finish to finish.
Fig. 4.2
Fig. 4.3
Fig. 4.4
Fig. 4.5
Fig. 4.6
Fig. 4.7
4-5
4.2.1.2
Isolation Environment
Isolation Environment, from now on identified by IE, allows isolating an application or
more applications published by Citrix Presentation Server, protects possible resources
shared with the operating system, for example configuration files, database, etc.
avoiding conflicts and incompatibility with the rest of the environment.
IE creates a copy of the system resources which can be modified by the application
published both runtime and during an installation, this ensures not only the correct
operation of the application but avoids also the collision with the rest of the system.
Furthermore, IE implements the mechanism of "Virtual Mapping" consisting in the
mapping of those resources that can be modified in some measure by the published
application itself. The steps to follow are:
Fig. 4.8
Fig. 4.9
4-6
Type the name of the new Isolation Environment and then click on OK.
The new IE is put in the list of the IEs available on the server.
Fig. 4.10
Fig. 4.11
Open the properties of the just created IE (in the example of the previous figure
Isolation test).
The window moves to Applications, click on Add button and select the application
you wish to isolate (in the example, NetViewer_8_0_SP2), confirm with OK.
Select the Roots item, where can be specified the directories and, is possible, the
register where the user can modify keys or files inside the virtual folders. Leave the
default settings.
Select the Rules item, where it is specified what will be explicitly isolated or what
can be ignored.
Select Default file system isolate rule and ckick on Modify; the Rule Type
window opens (Fig. 4.12).
4-7
Fig. 4.12
Fig. 4.13
Fig. 4.14
4-8
Leave unchanged the options in Action and Object; click on Next; the Isolate
Files window opens (Fig. 4.13).
Click on Add, in the Choose path window, click on Browse and choose the
folders, objects, files, etc you wish to isolate. Confirm with OK and then click on
Next; the Isolation Type window opens (Fig. 4.14).
Select the Per user radio button and click on Next, and then Finish.
4.2.1.3
Configuration of NetViewer
When publishing the NetViewer application by means of the Isolation Environment
technique, it is necessary to configure the application (on Citrix Presentation Server
side) in the following way:
Fig. 4.15
1.
2.
Select the published application and make sure that, in the Application Location
list, the characteristics of the application are:
Command Line:
"<JVM installation path>\javaw.exe" -Xverify:none -Xms256m -Xmx256m
-Xincgc -XX:MaxNewSize=96M - XX:NewSize=96M -Djava.ext.dirs=.;jar;appl
-jar "<NV GUI installation path>\Nvc.jar" /sa <NV server IP address> /norec
Working Directory:
<directory>:\Program Files\Radio Management\NetViewer
3.
Open the installation folder of NetViewer and control that, in the nvcStart.ini file, the
keys jarParams and mutexmode are the following:
MutexMode=0
4-9
4.2.2
4.2.2.1
Configuration of Client PC
Configuration of Client with application published on Citrix Server
The launch of the GUI of NetViewer from command line foresees the creation, on the
NetAct terminal with ICA Client installed, of a file "<file name>.ica" which must contain:
Here follows an example of ".ica" file, used for launching the remote NetViewer GUI.
The interesting parameters are at the end.
[ApplicationServers]
NetViewer 8_0_SP2=
[NetViewer 8_0_ SP2]
Address=NetViewer 8_0_SP2 (1)
DesiredHRES=1024
DesiredVRES=768
DesiredColor=4
TWIMode=On
ClientAudio=On
TransportDriver=TCP/IP
WinStationDriver=ICA 3.0
InitialProgram=#NetViewer 8_0_SP2 (2)
Password=0005e99f138914 (3)
Domain=NVSERVER1 (4)
Username=test (5)
(1)
It specifies the address of the target Citrix server. This can be the DNS name of a
MetaFrame server, the IP address of a MetaFrame server, or the name of a published
application (as in the example). Usually it will be the IP address of the Citrix Server.
(2) Name of the published application, plus "#"
(3)
Encrypted password to Citrix Server
(4)
Citrix Server domain
(5) Citrix Server user ID
Valid credentials must be inserted in the file, in order to connect to the Citrix Server. The
valid credentials are set at Citrix Server, when configuring the system and publishing the
application.
4-10
4.2.2.2
In case of direct launch of the GUI of NetViewer from Citrix Client, without the
previous publishing of the application on the Server Citrix, the Isolation
Environment functionality (par. 4.2.1.2) is not available.
4-11
4.2.2.3
If there is the need to pass parameters, without inserting them in the command line of
the published application, the command line published at Citrix Server will contain also
the %* tag, which indicates the position where to insert the command line parameters
passed when launching the ICA client, with the
"-param <...>" option.
When there will be the need to pass parameters, the command line will be:
<ICA client path>/wfica <file name>.ica -param "<parameters passed to NV GUI>"
The following table details the possible parameters.
Tab. 4.1
Example
Notes
NV Server IP Address
NV Server port
/sp 3686
Optional.
If the default port is used, there is no need
to redefine it; it can anyway be
preconfigured inside the published
application.
User ID
/ln username
Optional.
If not inserted and not predefined in the
published application, user will be
prompted to insert it.
Not foreseen for first integration, user will
insert manually the credentials at
NetViewer GUI.
User password
/lp password
NE name
/ip SouthMilan
TBD
Still TBD
An example is:
<ICA client path>/wfica nvc.ica -param "/sa 192.168.0.1 /ln username /lp password".
4-12
4.3 Security
There are three levels of access to the system for the launch of the GUI of NetViewer:
4.3.1
4.3.2
4.3.2.1
4.3.2.2
4-13
Fig. 4.16
4.3.3
Login to NetViewer
At the opening of the GUI of NetViewer the credentials are required for the access to
NetViewer. These credentials must be manually installed and are defined and managed
in NetViewer server with the NetBuilder tool.
4.3.4
In MS SQL Server appears the IUSR user of domain. From Start -> Programs ->
Microsoft SQL Server -> Enterprise Manager. In the "Security" folder, select the
"Logins" item. Control that the user <Domain Name>\IUSR_<Machine Name> is
among the users.
2.
IIS uses the IUSR user of domain as Anonymous Account for the access for the
access to DB. From Control Panel > Administrative Tools select IIS Manager.
By means of the right button of the mouse, select Properties of NetViewer folder.
Select the Directory Security tab. Click on the Edit button in the Authentication
and Access Control box. Verify that the User Name box reports the IUSR user
of domain.
If these users are noy used by SQL Server or by IIS, act as follows:
1.
4-14
From Control Panel > Administrative Tools select IIS Manager. By means of the
right button of the mouse, select Properties of the NetViewer folder.
Fig. 4.17
2.
Fig. 4.18
Select the Directory Security tab. Click on Edit button in the Authentication and
Access Control box.
Through the Browse key, select the IUSR user created before. Verify that the
Enable anonymous access e Integrated Windows authentication check boxes
are selected.
4-15
Fig. 4.19
From Start -> Programs -> Microsoft SQL Server -> Enterprise Manager, under the
Security folder, select the Logins item. Clicking the right button of the mouse, select
the item New Login. On the General panel, at item Name, through the Browse button,
select the domain and the IUSR user just defined and, in the Database field, select the
DB of NetViewer. In Database Access panel, select the database (NetViewer), which
the user must access to, and specify the role which this user has on the database (select
public, db_datareader).
4-16
A.1 Overview
This addendum describes how to configure the Performance Management fragment of
the NE3S O&M Agent north bound interface included into NetViewer.
The contents scope is the limited to the O&M Agent 2.3 included into NA-NV Connector
1.2.
The NA-NV Connector SW includes the following management fragments:
Topology Upload
Fault Management
Performance Management
The default installation setting does not include the Performance Management
activation and it has to be performed after the first installation.
Some configurations can be performed during the run-time in order to align the Agent
side with the Manager setup (i.e.: NE instances that have to transfer PM Data files).
The contents of this addendum apply to the following configuration:
OSS 4.x/5.x
A-1
CD-ROM
of
NA-NV
Connector
PM
(file:
It is always possible, until the end of the setup, to stop the procedure, clicking on
Cancel.
The License Agreement window is displayed. Accept the conditions of the license
for the use of the software. The Next> button becomes active (Fig. A.3). Click on
Next> to continue or on <Back to return to the previous window.
The Ready to Install the Program window is displayed (Fig. A.4). Click on Install
to continue the installation or on <Back o return to the previous window.
At the end of the installation, the window of installation complete (Fig. A.5) is
displayed. Click on Finish to end and exit from the setup.
A-2
Fig. A.1
Fig. A.2
Fig. A.3
Fig. A.4
Fig. A.5
A-3
A-4
Select Home Directory tab and configure the properties as shown in the following
snapshot:
Fig. A.8
A-5
The Service state of the Performance Management (left side panel) must be set
Active. If Service State is set to Inactive please proceed pushing the button to activate
the option.
A-6
The PM Fragment configuration is reported on the right side of the O&M Agent Specific
Configuration window.
The meaning of the specific parameter is reported here below:
Destination address
IP address of the server hosting the manager application (FTP client role) for PM
data.
Destination port
The availability of the PM is notified via SNMP trap. The PM data file name and its
location are embedded in the trap and the manager application has to be informed.
The IP Address is set via Destination Address parameter; the destination port of
the notification is set via Destination Port parameter. Default value is 162. It is fully
configurable and depends on the Manager/Agent agreement.
Max NE x PM file
Max number of network element for which data are potentially stored in a single
performance file. Default is 100. It is suggested to maintain this value under 100.
The data transferred via PM file may refer to a number of real NEs lesser than the
configured value because the PM data file size is the most important limitation
concerning the file transfer.
A-7
A-8
Network Element relevant information is reported for each item in the list:
Full collection: both 15m and 24h PM data collection is enabled [Default]
The specific granularity period collection enabling doesnt ensure real data
collection and transfer because it depends on the NE capability to provide PM
data for the selected granularity period.
On Windows right side two panels are available. They allow the operator to configure
the collection type for a single NE (Specific NE Configuration) or for all the managed
network elements (Global Configuration).
A.5.1
Global Configuration
In order to configure the collection for all the Network Elements is necessary to choose
the collection mode from Global Configuration panel as reported herebelow.
Fig. A.14
Appling the setting via Apply to All button causes the change of the Collection Mode
for every item in the list.
A-9
A.5.2
Specific Configuration
In order to configure the collection for a specific network element is necessary to find the
NE in the list and select the related list item.
In Specific NE Configuration panel the NetAct NE nickname appears and it is possible
to choose and apply the wanted Collection Mode.
Fig. A.15
A-10
PRINTED in ITALY
911-431/02A0120
D.45
D.55
911-431/02A0120
D.25
D.30
D.20
911-431/02A0120