NetMaster Training Manual

7/27/2019 NetMaster Training Manual

1/154

NetMasterNetMaster

ManagementManagementSystemSystem

TrainingTraining

ManualManual

Rev.25.02.2009


2/154 T-Manual Netmaster, slide 1.1

Nera Networks AS

This page is intentionally left blank



Nera Networks AS

Training manual

NetMaster

TABLE OF CONTENTS

1. System Overview and Architecture.

2. Clients and the Graphical User Interface.

3. Fault Management.

4. Performance Management.5. Configuration Management.

6. Security Management.

7. NetMaster Installation and Maintenance.

8. Documents How to.

9. Appendix.

Page 1 of 152



Nera Networks AS


Page 2 of 152



Nera Networks AS

Chapter 1

SYSTEM OVERVIEW AND

ARCHITECTURE.

1. NetMaster Concept.2. Supported Network Elements

3. Available Features

4. Licensing

5. NetMaster Architecture

6. System Redundancy

7. Northbound Interface

Page 3 of 152



Nera Networks AS


Page 4 of 152


7/154

NetMaster

Chapter 01. System Overview and Architecture

Bridging Societies

NetMaster Concept.

Based on the NGOSS principles,

Based on Java technology

Flexible SW components

Platform independent

Scalable HW platform

Client-server architecture

Management of the complete growing and evolving Nera product portfolio.

Page 5 of 152


8/154

NetMaster Concept.

Network status view

Fault management

Configuration management

Performance management

Security/user management

ITU - TMN model

BusinessManagement

NetMasterNetMaster

Evolution Series

InterLink Family

Eltek Smartpack

BG20/BG30

SmartNode A/C

SmartMetro

SmartConnect

CityLink Family NL29x, NL24x & NL18x-A

WiLink I / XL

NetLink & N2N

CompactLink

FlexLink

3rd party products.Eltek

CityLink

InterLink

Evolution Series

SmartNode

Evolution Long Haul

Split

Evolution

Long Haul

Supported Network Elements

Page 6 of 152


9/154

Available features in NetMaster

9Available features in R10J00:9 FCPS

9Up to 2000 elements

9 Up to 20 simultaneous client

9 Network Topology using Perspectives and Domains

9Automatic Network Element Discovery

9 Report generator

9 HW and SW Inventory

9 Software Download jobs

9 Northbound SNMP v2c interface to higher order OSS

9 Redundancy with failover. Database backup. Disasterrecovery

NetMaster licence information.

-Up to 2000 NE.

- Maximum 20 clients in NetMaster

- After installing NetMaster, licence

valid in 30 days must be

imported.Permanente licence is issued

after activiation key from NetMaster pc

is sent to NERA.

- NetMaster software key license is

handled by project leader at NERA orCustomer support directly.

Page 7 of 152


10/154

Flexible SW Components Scalable HW Platform

NetMaster Architecture

Three Main Software

Components:

- Application Server

- Clients (GUI)

- Database Server

One installation CD. Specific software components to be Installed, are selectedwhen running setup: Server, Client or Northbound interface. Database must be

up and running before installing NetMaster.


Client Server Platform

Networks with more than 200 NEs:

Application Server, DB Server and

Client should be in different

Hardware.

In the case of very big networks,

normally with more than 1000 NEs,

it is recommended to haveredundancy in the application server

and DB server.

Client and server are connected by

the TCP/IP network. Communication

between client and server are based

on Java Remote Method Invocation

(Java RMI).

Page 8 of 152


11/154

Client Server Platform

Networks with less than 200 NEs:


Co-Located System.

Application Server, Data Base Server

may be in the same Hardware.

Clients may also be in the same

hardware and/or separated PCs.

Application Server

Runs continuously in the

background as a service.

Manage the interaction of all

NetMaster system components.

Provides communication with all

network elements (SNMP, Nera

Q1).

Designed based on JAVA/J2EEtechnology, hence suitable for

porting to other Operating

systems.

There are not user interface for

the server. All configuration will be

done from clients.


Operating system:

Windows XP / 2003 Server

Page 9 of 152


12/154


Less than 200 NEs. Aplication Server, DB Server and Client

might be in the same Hardware. (Co-Located system)

Between 200 and 1000 NEs. Application Server,

DB Server and Client should be in different

Hardware.

More than 1000 NEs.Application Server, DB Server and Client

should be in different Hardware and it is recommended to have

redundancy.

Application Server. Hardware Recomendations

Clients (GUI)

End-user application.

Handles all user access to

NetMaster.

Rich Client

With License, up to 20 clients

can be logged on to the server

simultaneously.

Can be run in standard PCs.


Operating system:

Windows XP / 2003 Server

Windows Vista

Solaris 9 SUN/SPARC

Note: Windows XP supports and require Service Pack 3

Page 10 of 152


13/154

Clients. The Graphical User Interface

The GUI is built on Rich client platform

Perspectives

Geographical Tree & Maps

Logical Tree & Maps

Data from multiple network elements can be displayed simultaneously

System status are indicated using colours

Graphical maps

Report Generator

Automatic Network Discovery

Configuration & Editing

Software Upgrade Management

Inventory Management

NE Configuration ManagementPtMP Topology with CPE handling

Report Generator



Client/Server bandwidth recommendations are given for management of the

complete network, with all network elements included.

Restricting user access to administrative domains with a limited number of elementswill reduce the amount of bandwidth required.

1098: Java RMI Activation Port.

1099: Java RMI Registry Port.

4444: JBoss RMI Object Port.

TCP ports used in Server/Client connection

Clients (GUI). Hardware Recomendations

Page 11 of 152


14/154


Launching the clientDefault User name: root

Default password: pw

Server: Server IP address in the

network.

Database Server

Application server has contactwith NEs. Information andstatus from the network arestore in the data base.

The database server stores alldata used by the NetMastersystem.

Two supported Data Baseproducts in NetMaster.

Database Server must be upand running before installingNetMaster

Oracle: A commercial,proprietary database SWvendor.

PostgreSQL: A freeware, open-source database SW project.


Page 12 of 152


15/154

Oracle 10g: The following versions of Oracledatabases are supported:

Express Edition (XE), Standard Edition One

(SE1), Standard Edition (SE), EnterpriseEdition (EE)

PostgreSQL versions 8.2.3

Database


Database Feature Summary

Database Server Recommendations


1521: Oracle Database Listener.

2030: Oracle Services for Microsoft Transaction Server.

8081: HTTP Listener.

5432: PostgreSQL 8.2.3.

TCP ports used in Server/Client connection

Page 13 of 152


16/154

DCN

Data Communication Network

Enable data communications

between NetMaster application

Server and NetworksElements.

NetMaster currently support

two different protocols: SNMP

and Nera proprietary Q1.

Management communication

between NetMaster and a

network element is based on

one of the following

communication ports:

SNMP over UDP/IP

Nera Q1 over TCP/IP

Nera Q1 over serial RS-232


DCN. IP Router. Example case. Evolution Series


Page 14 of 152


17/154

DCN SU communication data channel change

according to the radio family:

- Evolution Series: 256 kbps

- InterLink/CityLink/NL29x: DCCr, 192 kbps

- Mux: SmartNode/BG: DCCm, 576 kbps

- Traditional PDH radios: 64 kbps

NEs are represented in the DCN as routers

(Internal in the SU/control unit)

For elements using Q1, each NEs connected to

the DCN will work as a Q1 gateway for the chain

of elements connected behind them.

Big Networks may also need to use external

routers to build DCN backbone.


DCN

A common approach is to use the 2 Mbps

wayside channel in the network to build the

DCN backbone.

To avoid big delays in the polling time for

NEs it is recommended to use 20 as a

maximum network depth.

Networks segments are normally build with

no more that 30 NEs.

A backbone segment of 2 Mbps is suitablefor connecting up to 500 NEs.

Dynamic Routing protocols are available in

the different radio families.

- OSPF

- RIP v2

- Q1 dynamic routing protocol


Page 15 of 152


18/154

System Redundancy

NetMaster redundancy with failover capabilities

NetMaster can be configured for redundancy with failover capabilities, using a database

replication scheme between main and standby NMS sites. This can be applied to both pure

in-house HW redundancy as well as geographical system redundancy for disaster recovery.

Northbound Interface to Higher-order OSS

Northbound Interface

The NetMaster SNMP Agent is an optional feature which requires a separate license.

The agent provides topological information according to the standardized ENTITY-MIB

(RFC 2737), and alarm state of the various network elements through proprietary tables

and variables given in the proprietary NETMASTER-MIB.

State changes are communicated to managers by means of SNMP traps.

The SNMP Agent is a specialized client.

For northbound integration from NetMaster to Nokia NetAct, a separate Nokia NetAct

Bridge application has been provided.

Page 16 of 152


19/154

PM

Feature

System design: NMS Server

+ Optional Features

Minimum system:NetMaster NMS Server

Basic FCPS functionality

Enhancements:

Optional features

Selectable (and priced) one

by one

Security

Featu

re

NetMasterNetMaster

NMS serverBasic FCPS

management

Hierarchical

domains

with maps

FM Feature

Report generator

Redundancy

and

failover

Unix

platform

Northbo

und

SNMP

connectio

n

CM

Feature

FM Feature

PMFeature

Security

Feature

FM

domain

PM

domain

User/S

ecurity

domain

GUI

domain

Platform

domain

C

M

domain

System design

T-Manual Netmaster, slide 1.1

Nera Networks AS


Page 17 of 152



Nera Networks AS

Chapter 2

CLIENTS AND THE GRAPHICAL

USER INTERFACE.

1. NetMaster Architecture - Clients

2. Client Application

3. Workspace

4. Discovering Elements

5. Security Templates

6. Graphical User Interface7. Help facilities

8. Launch External Application

Page 18 of 152



Nera Networks AS


Page 19 of 152


22/154

NetMaster

Chapter 02. Clients and the Graphical User Interface

Bridging Societies

Flexible SW Components Scalable HW Platform

Clients and the GUI

End-user application.

Handles all user access to

NetMaster.

Rich Client

With License, up to 20 clientscan be logged on to the server

simultaneously.

Can be run in standard PCs.

NetMaster Architecture - Clients

Page 20 of 152


23/154

Client Application

Launching the client

Default User name: root


Server: Server IP address in thenetwork.

NetMaster Client Application

NetMaster Server Application:

Running as a Windows Service.

NetMaster Server Application is running

NetMaster Server Application is stopped

Typical workspace.

TopMenu

Perspectivetoolbar

View

toolba

r

Perspect

ive

View

Statusbar

Page 21 of 152


24/154

Workspace definitons

Perspect

iveA perspective is a collection of views which reflects a certain

working-situation.

Perspectivetoolbar The Perspective toolbar displays a list over all currently open

Perspectives.

TopMenu This is a group of dropdown-menus where you can activate

different parts of the application.

Workspace definitons

ViewA view is a "window" within the application which

offers a wide set of functionalities.

Viewtoolbar

The View toolbar is a list of icons. These toolbars will look

differently for each view

The status bar field will always tell you status of the

connection to the server.

Status

bar

Page 22 of 152


25/154

Status bar

User id client

Server name

License info.

Workspace status bar.

Discovering elements

Go to Wiews / Discover

/ Discover settings

Select Mediation

Device,here Q1,then

IP address & subnet

mask

Type name

of search

Page 23 of 152


26/154

Go to Wiews / Discover

/ Unmanaged elements

UnmanagedElement emty

before

Discover

Geen button starts

The dicovering process

4 elements is found


Create

new Domain


Page 24 of 152


27/154


Security Templates

Nes can have different default community names

9Evolution Series

9CityLink Fast Ethernet

9CompactLink

9FlexLink

9NetLink

9Wilink1/Wilink XL

9Smartnode/SmartConnect/SmartMetro

9BG20/30

NERA Network Elements using SNMP is:

SNMP community

Page 25 of 152


28/154

u: adminp: admin

publicu: adminp: admin

WiLink XL

adminprivatepublicadminWiLink1

telnetpublicpublicu: neraci/axxcli

p: neraci/axxcli

SmartConnect

adminadminSmartMetro

adminprivatepublicadminEvolution

privatepublicNetlink

telnetpublicpublicu: neraci/axxcli

p: neraci/axxcli

Smartnode

PRIVATEPUBLICFlexlink

privateprivatepublicCompactlink

admin

adminpasswd

master (read/Write)

private (read Only)

master (read/Write)

public (read Only)

u: admin

p: adminpasswd

Citylink Fast

Ethernet(Etherlink v1)

publicpublicadmin

adminpasswd

Citylink /

Interlink

TelnetSNMP SET

community

SNMP GET

community

Q1

password

(NEW)

HypertermialEquipment

Security Templates

A template for those NE,not using common defaultsetting must be made:9 Go into Views / Configuration / Security Templates

Security Templates

Page 26 of 152


29/154

Template CityLink Fast Ethernet

9 Highlight SNMP / Right click on mouse / create template

9 Type name,description,read and write community

Security Templates

Template FlexLink

Security Templates

Page 27 of 152


30/154

Template SmartNode

Security Templates

Geographical Tree

& Maps

Perspectives

Graphical User Interface

Logical Tree & Maps

Page 28 of 152


31/154

Graphical User Interface

The GUI is built on Rich client platform

Quick access to NE features via context menus

Organize and move windows and dialogs individually

Data from multiple network elements can be displayed

simultaneously System status are indicated using colours

Flexibility to the user

Hierarchical tree structures

Graphical maps

Help functions in NetMaster

Page 29 of 152


32/154

Launch External Application

NE-specific configuration tools

LCT Tools Web browser

Telnet

Etc.

Page 30 of 152



Nera Networks AS

Chapter 3

FAULT MANAGEMENT.

1. Fault Management - Basis

2. Fault Management Tasks

3. Alarms Severities / Colors4. Alarm states.

5. Alarm information on topological objects

6. Report Generator

Page 31 of 152



Nera Networks AS


Page 32 of 152


35/154

NetMaster

Chapter.03 Fault Management

Bridging Societies

Alarm Severity are represented by colors

Alarms can be seen from the Tree view, Map view or from Logical view

To see details, right click on the item, Faultand then Current alarms.

To see previous alarms from the data base, right click on the item, Faultand

then Historical alarms.

Fault Management - Basis

Map view Logical tree view Geographical tree view

Page 33 of 152


36/154

Fault Management Tasks

Alarm acquisition in the form of notificationreception from NEs

Display network alarm status in many differentways

Coloring of graphical objects in the network

views Display new (un-acked) alarms and old (acked)alarms independently.

Propagation of the highest severity levelupwards in the network display hierarchy.

Display alarm summary count

Display current alarms

Alarms acking, unacking and commenting

Audible notifications upon severity levelincrease.

Display historical alarms; specify advancedfilters/queries.

Customize alarms for selected NE types (alarmtext, severity and blocking) for a selection ofNEs through alarm templates.

Alarms Severities / Colors

No alarms or warnings

have been reported from

the network element.

Normal Condition

Gray

Priority 8 in the list of

severities

Page 34 of 152


37/154


A notice from the NE, which

is not connected to any

error situation, e.g. a

confirmation.

Information

White


severities


The network manager cannot determine the severity of an alarm.

Indeterminate Condition

Pink

Priority 6 in the list of severities

When no contact has been made with the network element, NetMAster cannot

determine the correct status of the alarms on the NE, as alarms are currently no

longer being received.

Possible causes:

-Communication Ports

-Managements cables/connections

-SU/Control unit

-Link down, etc.

Example alarm: Lost Contact

Page 35 of 152


38/154


Indicates the detection of apotential or impending fault

that will affect the service,

before any significant effects

have been felt. Action should be

taken to further diagnose and

correct the problem in order to

prevent it from becoming a more

serious fault that will affect the

service.

Warning Condition

Yellow


severities


Indicates the existence of a

condition not affecting the

service, but that requirescorrective action in order to

prevent a more serious

fault.

Minor Alarm

Brown


severities

Page 36 of 152


39/154


Indicates that a condition

affecting the service has

occurred and urgent

corrective

action is required.

Major Alarm

Orange


severities


The most severe alarm. It

signifies that a condition

affecting the service hasoccurred and immediate

corrective action is

required.

Critical Alarm

Red


severities

Page 37 of 152


40/154


Indicates that no contact

has been made with the

network element. The

communication settings

should be checked in order

to obtain contact with the

element.

Loss of Connectivity

Blue


severities

Alarm states.

9 Active: When a clearable alarm is raised for the NE.

9 Acked: When a clearable alarm is being followed up. Its possible toadd a comment to the alarm.

9 New: A clearable alarm which is currently active and has not been

acked is called a "new alarm".

9 Cleared: When the fault condition disappears from the NE the alarmbecomes "cleared" and the NE sends a "clear" signal to NetMaster.The alarm then go to Historical Alarm list in the database.

Page 38 of 152


41/154

Alarm states. View examples

Alarm states. View examples

Page 39 of 152


42/154

Alarm status

Alarm State & Severity -

Directly in GUI

Alarm Summary

Alarm Count

Detailed Alarm List

Historical Alarms

Alarm information on topological objects

Page 40 of 152


43/154

Alarm indication in map view

4 Major alarms+ less severe alarms

coming up.

Alarm indication in map view

4 Major alarms acknowledged

Indicated by outline colour

4 Major alarms

acknowledged

1 minor alarm not acknowledged

+ other less severe alarms

Page 41 of 152


44/154

Report Generator

GUI

ViewerPDF File,

MsOfficedocument

Network Time Synchronization

Enabling

synchronization from

system preferences

Selecting NEs to be

synchronized

Page 42 of 152



Nera Networks AS

Chapter 4

PERFORMANCE MANAGEMENT.

1. Radio Propagation Conditions

2. SDH layers and overhead BIP bytes3. Performance. G.826. Definitions and calculation

4. Availability

5. Performance Measurements

6. Performance Reports

Page 43 of 152



Nera Networks AS


Page 44 of 152


47/154

NetMaster

Chapter 04. Performance Management

Bridging Societies

Radio Normal Propagation Conditions

Receiver

Threshold

Page 45 of 152


48/154

Radio Transmission Rain Attenuation

Nominal

threshold

Receiverthreshold

Applies to high

frequencies

Radio Transmission Mutli-Path Reflections

Nominal

threshold

Receiver

threshold

Applies to all

frequencies

Page 46 of 152


49/154

RSTMSTMSTMST

RST RST RSTRST

RS RSRS RS

MS

RSRSRS

MS

Path layer

Higher order path

VC-3 (34 Mb/s)

VC-4 (140 Mb/s)

Mapped ATM / IP

Section / Path layers in SDH Networks

Lower order path

VC-12 (2Mb/s)

Mapped ATM / IP

J0A2AAA1A1A1 A2 A2 A

B1 E1 F1 N N

D1 D2 D3

H2 H2 H2 H3 H3 H3H1

B2 B2 B2 K1 K2

D4 D5 D6

D7

D10

S1 Z1 Z1 Z2 Z2 M1 E2 N

D9

D12

D8

D11

N

STM-1RSOH

POINTER

STM-1MSOH

H1

A1A1

H1

A1MS

2Mb/s

Media Specificbytes

2 Mb/s asynchronous

.

MS 2

SI

#1 #2 #3

N

MS 3

MS 1

SI : Stuffing for 2Mb/s Wayside

MS 1&2 : Radio Protection Switching

control

MS 3 : RF-Id

Remote reset

ATPC

E/M for bytes; E1, F1, E2

N

SOH - Section Overhead

B1, B2: Parity bytes. Error calculation. BIP

M1: Remote Error Identifier (MS-REI)

Page 47 of 152


50/154

Performance: Definitions and calculation

Block: A block is defined as a group of successive bits that can be allocated to the path

under test. Each bit belong to a single block. Monitoring takes advantage of the

error monitoring equipment built into todays transmission systems such as CRC

(Cycling Redundancy Check) and bit parity techniques. Errors must be detected

with at least 90 % probability, which is met with CRC-4 and BIP-8 (Bit Interleaved

Parity). In SDH one block is defined to be one STM-1 frame (19 512 bits). In PDH

other definitions apply. Refer to ITU-T G.828 for more info.

Principle of radio performance calculations

NE

Evolution: B1/B2/M1 REI RADIOEvolution: B1/B2/M1 REI LINE

Algorithm for

calculating G.826

performance for

15 min. , 1 day and

1 month period using

B1, B2 and M1 bytes

Performance parameters definitions

Errored Block, EB:

A block which one or more bits in error.

Errored Second, ES

A one-second period with one or more errored blocks or at least one defect (path alarm).

Severely Errored Second, SES

A one-second period which contains t 30 % errored blocks or at least one defect (path alarm).

Background Block Error, BBE

An errored block not occurring as part of an SES

Errored second Ratio (ESR)

The ratio of ES to a total seconds in available time during a fixed measurement interval.

Severely Errored Second Ratio (SESR)

The ratio of SES to total seconds in available time during a fixed measurement interval.

Background Block Error Ratio (BBER)

The ratio of Background Block Errors (BBE) to total blocks in available time during a fixed

measurement interval.

Page 48 of 152


51/154

Availability

The Performance Parameters are valid only when the system is in the Availability

state.

Start of availability: At start of time interval consisting of at least ten seconds that are

not severely errored.

End of availability: At start of time interval containing at least ten consecutive SES.

Example

10 sec. 8 sec. 10 sec.

Unavailability detected Availability detected

Unavailable period Available period

Time

Severely Errored Second (SES)

Errored Second (Non SES)Error free Second

Enable Performance

collection from

element menu in GUI

Open Historical

Performance data

from element menu in

GUI

Performance Measurements

Page 49 of 152


52/154

View Performance Measurement Results

Time series

graph

Tabular form

Distribution graph

Configurable graph properties

Error counters

Page 50 of 152


53/154

Threshold Crossing Alerts

Performance Reports

The reporting functionality enables a quick

overview as well as detailed analysis of the

performance of the

managed network.

Two graphical charts aredisplayed

Measurement types over time (x-

axis: time, y-axis: measurement

value)

Measurement types over source

Network Element(x-axis: Network

Elements, y-axis: measurement

value)

Page 51 of 152


54/154

Performance Reports. Examples

Detailed PM report

All collected PM data from all Network Elements matching the

filter is displayed in a tabular form,

Page 52 of 152


55/154

Detailed PM report

All collected PM data from all Network Elements matching the

filter is displayed in a tabular form,


Enabling


system preferences

Selecting NEs to be

synchronized

Page 53 of 152



Nera Networks AS

Chapter 5

Configuration Management.

1. Configuration Management. Summary

2. Configuration Tools

3. Software & Hardware Inventory4. Software Download

5. NE Configuration File Management

6. Report Generator

7. Launch External Application

Page 54 of 152



Nera Networks AS


Page 55 of 152


58/154

NetMaster

Chapter 05. Configuration Management

Bridging Societies

Configuration Management. Summary

Software Inventory

Activation and Reset

Hardware Inventory

PtMP CPE Handling

Software Download Jobs Multiple NEs

Create, Edit, Delete, Start, Cancel

Scheduling planned

NE Configuration File Management Backup/Restore (Evolution elements)

Report Generator

NE Security Templates (SNMP/Q1 remote access)

Launch External Application - NE Configuration

NE Time Synchronization Management

Page 56 of 152


59/154

Configuration on NEs by Launch External Application

Evolution Series

InterLink Family

Eltek SmartpackBG20/BG30

SmartNode A/C

SmartMetro

SmartConnect

CityLink Family

NL29x, NL24x & NL18x-A

WiLink I / XL

NetLink & N2N

CompactLinkFlexLink

3rd party products.

Eltek

CityLink

InterLink

Evolution Series

Evolution Long Haul

Split

Evolution

Long Haul

Configuration Tools

Software & Hardware Inventory

Page 57 of 152


60/154

Managing download of software to the NEs

Software Download

Specify element type and elements to be included in job

Specify files to be downloaded

Start download job

NE Configuration File Management

Evolution elements

Backup from single

NE, domain or

whole network

Restore single

elements

Add config file from local file

system

Save config file to local file

system

Page 58 of 152


61/154

Report Generator

The Inventory report displays

hardware and software inventories

for all the managed elements

within the scope of the report.

Report Generator

The NE Types Overview report

displays a chart indicating how

many elements of each NE

type that is managed by

NetMaster.

It is possible to export the reports to external

formats in order to store the report or print it.

Page 59 of 152


62/154


NE-specific configuration tools

LCT Tools Web browser

Telnet

Etc.


Page 60 of 152


63/154


Enabling


system preferences

Selecting NEs to be

synchronized

Page 61 of 152



Nera Networks AS

Chapter 6

SECURITY MANAGEMENT.

1. User Administration

2. Default user in NetMaster

3. Group and User Administration4. User Audit View

5. NE Security Template & Assignment

Page 62 of 152



Nera Networks AS


Page 63 of 152


66/154

NetMaster

Chapter 06. Security Management

Bridging Societies

User Administration

-Add Users

-Edit Users

-Audit Users

-Users Profiles

Page 64 of 152


67/154

Default user

Launching the client

Default User name: root


Server: Server IP address in thenetwork.

Group and User Administration

User profiles

Group Administration view

User Administration view

User Audit View

Full flexibility (unlimited) security

privileges

Resource Permission

Action Permission

Allocate groups

Allo

cate

permis

sions

User Audit

Page 65 of 152


68/154

Group Administration View

User Administration View

Page 66 of 152


69/154

User Audit View

User/group creations/modifications

Group permission modifications

Users logging in and out

Assign security templates to all selected NE

NE Security Template & Assignment

Page 67 of 152



Nera Networks AS

Chapter 7

NetMaster Installation and

Maintenance.

1. Database Export And Restore

2. Database Cleanup

3. Doc: NetMaster Maintenance Guide

4. Doc: NetMaster Installation Guide

Page 68 of 152



Nera Networks AS


Page 69 of 152


72/154


73/154

T-Manual slide 1.3

Nera Networks AS

Maintenance Tasks info

Database cleanup and export configured as Windows scheduled tasks

to be executed automatically at regular intervals

Disk cleanup and configuration file backup performed manually

Scripts for stored under .../netmaster/tasks folder

Detailed information and scripts provided in

Netmaster Maintenance manual

T-Manual slide 1.4

Nera Networks AS

Maintenance Tasks database cleanup

DATABASE CLEANUP delete old alarms

reduce_state_alarms.cmdbatch file which executes .sql file

reduce_state_alarms.sqlsql file - deletes old alarms in database

scheduled task to run regularly

DATABASE CLEANUP delete old performance data reduce_performance_data.cmd (batch file - executes .sql file)

reduce_performance_data.sql (sql file - deletes old PMdata in database)

scheduled task to run regularly

Page 71 of 152


74/154

T-Manual slide 1.5

Nera Networks AS

Maintenance Tasks practical exercise

DATABASE EXPORT

Open export script

Verify correct connection- and archive parameters

Execute exportscript

Verify export file created

Repeat execution of export script

Verify additional export files created

Configure scheduled task in windows

to perform export every 5 minute

Verify that export is executed automatically every 5 minute

Page 72 of 152


75/154


76/154

NetMasterMaintenanceGuide

2

RevH,01.02.2008

TableResourceList:

Table1ExportOracleDatabaseScript_________________________________________________

5

Table2RestoreOracleDatabaseScript________________________________________________

7

Table3ExportPostgreSQLDatabaseScrip

t____________________________________________

9

Table4OracleBatchScriptreduce_state_alarms.cmd__________________________________1

2

Table5OracleSQLScriptreduce_state_

alarms.cmd___________________________________1

3

Table6PostgreSQLBatchScriptreduce_state_alarms.cmd_____________________________1

4

Table7PostgreSQLSQLScriptreduce_state_alarms.cmd______________________________1

5

Table8OracleBatchScriptreduce_perfo

rmance_

data.cmd_____________________________1

7

Table9OracleSQLScriptreduce_performance_

data.cmd______________________________1

8

Table10PostgreSQLBatchScriptreduce_performance_

data.cmd________________________2

0

Table11PostgreSQLSQLScriptreduce_performance_

data.cmd_________________________2

1

Table12Archivingscript-archive.cmd______________________________________________2

7

Table13CreatenewOracleuser/schemascriptorcl_user_script.cmd______________________2

9


3

RevH,01.02.2008

1

NET

MASTERMAINTENANCEGUIDE

Thisguid

edescribesthenecessarymaintenanceoperationsforaru

nningNetMasterserver.

Thesetas

ksarenecessaryinordertoensureastableoperationofN

etMasterwhenmanaginglarger

networks.

1.1

Overview-MaintenanceTasks

Thesetasksarerecommendedtorunfrequentlyasscheduledtasks:

Ba

ckupofdatabaseshouldberunfrequently(seesection2

).

Historicaldatashouldberemovedperiodicallyfromtheda

tabase(seesection3).

Oldlog-filesshouldbedeletedperiodically(seesection4).

Reviewtherespectivesectionsonhowtoconfigureandsetupthesetasksindividually.

Inadditio

nitismentionedasetofissuestoconsiderforrecoveringNetMasterserverinstallationas

smoothaspossible(seesection6).

1.2

DocumentHistoryandSummaryofChanges

Rev

Date

SummaryofChange

R10H00

11.03.2008

Firstrelease

1.3

References

OracleDatabaseBackupandRecoveryBasics10gRelease2

Online:[http://download.oracle.com/docs/cd/B19306_01/backup.1

02/b14192/toc.htm]

PostgreSQL8.2.6DocumentationBackupandRestore

Online:[http://www.postgresql.org/docs/8.2/interactive/backup.html]

Page 74 of 152


77/154


78/154


79/154


80/154


10

RevH,01.02.2008

2.2.3

PostgreSQLImport

Howtoperformadatabaserestoreprocedure:

1.StopNetMasterServer

2.OpenPGAdminIII,whichcanbefo

undinStartProgramsPostgreSQLPGAdmin

III

3.Rightclickonthedesireddatabase

(ie.Postgres)wherethebackupistoberestoredand

selectRestore.(WARNING:Itisnotpossibletorestoreaschemaifthecurrentdatabase

alreadyhasaschema/userwithsam

ename.Alternativelyrenameordeleteexisting

schema/userbeforerestore.Yetano

theroptionistocreateanewdatabaseinPostgreSQLfor

restore.Ifthelatterstrategyischosen,reinstallNetMasterandsetthenewdatabase

connectionparametersduringthein

stallation.)

4.Locatetheexportedfile0_netmaster_export.backup.(Allbackupfilesareprefixedwithanumbe

r

where0indicatesthenewestbackup).

5.ClickOk

6.Verifythatthefollowingmessagew

asprintedattheendoftherestorelog:Processreturned

exitcode0.Otherwiseexplorethe

logandtrytosolveanyissues.

7.ClickDoneandrestartNetMaster.


11

RevH,01.02.2008

3

DAT

ABASECLEANUPSTRATEGIES

Database

cleanupstrategiesareneededtoavoidanundesiredgrow

thofthedatabase.Thismay

causelackofdiskspaceanditwillalsodecreaseserverperformance.Thissectiondescribeshowto

setuprou

tinesinordertopreventthismatter.

Themotivationfordatabasecleanupstrategiesisto:

-Imp

rovespeed.

-Ens

urethatthedatabasewillnotgrowundesirable.

Note:

Thesestepsshouldbeperformedonthedatabaseserver!

3.1

DeleteOldHistoricalAlarms

ThissectiondescribesaconfigurationwhichdeleteshistoricalAlarmsolderthanagivennumberof

daysfrom

thedatabase.

DeletingoldhistoricalalarmsappliestobothOracleandPostgreSQLdatabases.

3.1.1

O

racleRoutine

ToconfigurearoutinefordeletingoldhistoricalalarmsforOraclerequiresthreesteps.

1.Createbatchfilewhichexecutessqlfile.

2.Createsqlfilewhichisloadedbythebatchfile.

3.CreateScheduledtaskinwindowsenablingthebatchfileto

berunperiodically(seesection

7.1Windows-Addscheduledtask).

Page 78 of 152


81/154


82/154


83/154


84/154


85/154


86/154


22

RevH,01.02.2008

4

DISCCLEANUPSTRATEGIES

NetMasterServergenerateslogfiles.Thesefilestendtogrowlargewhenmanagingnetworkswith

manyelementsandheavytraffic.

4.1

Deleteoldserverlogfiles

Logfiles(.log)maycauseunwanteddiscconsumptionifnotdeletedperiodically.Thismayagain

causeanunstablesystemleadingtounwanteddowntime.

Locateyournetmasterlogfiledirectoryandremovefilesolderthanthreemonths:

Installationdirectory:

\Server\JBoss-4.0.2\server\netmaster\log

Example:

C:\ProgramFiles\Nera\NetMaster\Server\J

Boss-4.0.2\server\netmaster\log


23

RevH,01.02.2008

5

MOV

ENETMASTERDATABASETOADIFFERENTHOST/SERVER

ThissectiondescribestheapproachformovingaNetMasterdatabasetoanotherdatabaseordatabase

server.

5.1

Oracle-MovingNetMastertoNewHost

Premises:

*ExistingNetMasterdatabaseexport.(Seesection2.1.2OracleExportonpage4)

ProcedureformovingaNetMasterdatabasebetweentwoOracled

atabases:

1.Thisisaccomplishedthroughastandardrestorefromadatabaseexport.Seesection2.1.3

OracleRestoreonpage6.

5.2

PostgreSQLMovingNetMastertoNewHost

Premises:

*ExistingNetMasterdatabaseexport.(Seesection2.2.2PostgreSQLExportonpage8)

ProcedureformovingaNetMasterdatabasebetweentwoPostgreS

QLdatabases:

2.Thisisaccomplishedthroughastandardrestorefromadatabaseexport.See2.2.3

PostgreSQLImportatpage10.

Page 84 of 152


87/154


24

RevH,01.02.2008

6

CONFIGURATIONBACKUP

Thissectionisachecklisttoensurethatim

portantconfigurationsarekeptinaplaceforrecovery

situations.Afullsystemrecoveryislikelytotakelesstimeiftheseconfigurationsareavailable.

Considerbackupoftheseconfigurations:

1.LicencefileforNetMasterserver(location:NetMasterServer).

2.Databaseserverconnectionparameters:C:\NetMaster\Server\JBoss-

4.0.2\server\netmaster\deploy\ngnm

s-ds.xml(location:NetMasterServer).


25

RevH,01.02.2008

7

GEN

ERALSETUP

Thissectiondescribeshowtoperformdifferenttasksrelatedtoma

intenanceconfiguration.

7.1

Windows-Addscheduledtask

CreateSc

heduledtaskinwindows:

1.W

indows:Start-->Controlpanel-->ScheduledTasks

2.SelectAddScheduledTask

3.ClickNext

4.ChooseBrowseandselectthefilewhichshouldbeexecute

dperiodically.

5.SelectDailyandclickNext.(Thisstepsuggestshowfreque

ntthetaskshouldberun.Nera

NetworksrecommendsrunningitonaDailybasis.)

6.Setstarttime:01:00andclickNext

7.Enterthedomainuserandpassword(hint:Usethesamedo

mainuserasusedinthe

NetMasterserverinstallation).

8.ClickFinish

9.Thetaskshouldnowappearinscheduledtasks.

7.2

PostgreSQLAddtrusteduser

Allow

localwindowsusertohavetrustedaccess.

Thisisnecessaryinordertoallowautomaticlogontopgsql.

1.StartthepgAdmintool.YouwillfinditinStartAllprog

ramsPostgreSQL8.2

pg

AdminIII.ConnecttoyourPostgreSQLdatabaseserver.

2.ChooseTools\ServerConfiguration\pg_hba.conf

3.Doubleclickonitemwhereipaddressis127.0.0.1/32.(hostallall127.0.0.1/32md5)

4.SetMethodtobetrustandclickOK.(hostallall127.0.0.1/32trust)

5.Re

loadservertoapplyconfigurationchanges.

Page 85 of 152


88/154


89/154


90/154


91/154


92/154

NetMasterInstallationGuide

4

RevH,06.02.2008

2.1

NewInstallation

IfnoexistingNetMasterinstallationisdete

ctedonthecomputer,theinstallerwillruninNew

Installationmode.

Youmaycanceltheinstallationatanystep

untilthewizardstartsinstallingthefiles.

1.InserttheCDintothedesireddrive

andruntheSetup.exefiletolaunchtheinstallation

wizard.

2.Thestartpagedisplayssomegeneralinformationabouttheinstallationprocess.

PressNexttocontinue.


5

RevH,06.02.2008

3.Readthelicenseagreement.

If

youaccepttheagreement,selecttheAcceptoptionandthenNexttocontinue.

4.ChooseInstallSet.NotethattheNetMasterClientwillals

obeinstalledwiththeNetMaster

Server.IfyouwanttoinstalltheNorthboundSNMPAge

nt,youhavetoselecttheCustom

InstallSet.

Pr

essNexttocontinue.

Page 90 of 152


93/154


6

RevH,06.02.2008

5.CustomInstallSet.Ifyouchooseth

eCustomInstallSet,youcanselecteachcomponent

individually.SeetheDescriptionfieldforinformationabouttheselectedcomponent.


6.ChooseInstallFolder.



7

RevH,06.02.2008

7.ChooseShortcutFolder.Notethatthereisanoptionforcre

atingiconsforallUsers.

Pr

essNexttocontinue.

Page 91 of 152


94/154


95/154


10

RevH,06.02.2008

10.EntertheNewDatabaseSchema

ConnectionInfo.(Thisstepisonlyincludedif

NetMasterServercomponentisinstalled).Specifythenameofthedatabaseschematobe

createdforNetMaster.Theinstaller

willcreateandinitializethedatabaseschemaafterthe

Pre-InstallationSummarystep

a.Schema/Username:ThedatabaseschemanametobeusedbytheNetMasterServer.

b.Password:Thepasswordforthenewdatabaseschema/useraccount.



11

RevH,06.02.2008

11.ReviewSummaryofyourinstallationsettings.

Pr

essInstalltostarttheinstallationprocess.

12.Databaseinitialization.IfNetMasterServerisbeinginsta

lled,thenewdatabaseschemawill

be

createdandinitialized.(Requiresnouserinteraction)

Page 93 of 152


96/154


12

RevH,06.02.2008

13.Watchtheproductfeaturesbeingpresentedduringtheinstallationprogress.

14.InstallationCompleted.Iftherewer

eanyproblemsencounteredduringtheinstallation,see

theinstallationlogfilelocatedintheinstallationdestinationfolderfordetails.

PressDonetoexittheWizard.

IfNetMasterServerisinstalled,theserverwillbeinstalledasanautomaticWindowsService,with

itsownServermonitorinthesystray.The

NetMasterServermonitorstartswheninstallationis

completed,andyouarepromptedwhethertostarttheNetMasterServer.Ifyoudon'twantthe


13

RevH,06.02.2008

NetMaste

rServertostartautomaticallyuponcomputerreboot,you

cansetthemodeofthe

NetMaste

rServicetomanualintheServicesappletintheControlPanel.

2.2

Ma

intenanceInstallation

Iftheinst

allerdetectsanexistingNetMasterinstallationwiththesameversion,theinstallerwillrun

inMainte

nancemode.Inthismodeyouwillbeabletoreselectwhichcomponentstobeinstalledon

thecomputer.Theexistinginstallationwillbeuninstalledandreplacedwiththecomponentsselected

inthisma

intenanceinstallation.Notethatexistingcomponentsnotselectedwillbeuninstalled.

YoualsohavetheoptiontoresettheNetMasterdatabaseifyouare

maintainingaNetMasterServer

installatio

n.

MostoftheinstallationstepsareidenticaltotheNewInstallation

Mode.

1.TheIntroductionstepdescribesthatanexistinginstallation

isdetected,anddisplayssome

informationaboutthedetectedinstallation.

2.TheLicenseAgreementstepisomittedinmaintenanceinstallations.

Page 94 of 152


97/154


14

RevH,06.02.2008

3.ChooseInstallSet.Thisstepinitiallydisplaysthecomponentsdetectedintheexisting

NetMasterinstallation.Inthisstepyoucanselectwhichcomponentstobeinstalledonthe

computer.Notethatifyoudeselectexistingcomponents,thosewillbeuninstalled.

4.TheChooseInstallFolderandChoo

seShortcutFolderstepsareomittedinmaintenance

installations.Theinstallerwilluset

hefoldersdetectedfromthepreviousinstallation.


15

RevH,06.02.2008

5.DatabaseMaintenanceOptions.IfyouaremaintainingaNetMasterServerinstallation,you

ha

vethreeoptionsforthedatabaseschema:

Useexisting(nochange):ReusethedatabaseusedwiththepreviousNetMaster

installation.Nochangeswillbemadetothedatabas

eschema.

Reinitializeexisting(overwrite):Theinstallerwilld

eletethecontentoftheexisting

databaseschemaandreinitializeit.

Note:Ifyouchoosethisoptionalldatastoredwiththepreviousinstallationwillbe

lost.T

heinstallerwillalsopromptyoutoconfirmth

atthisisreallywhatyouwantto

do.

Createnew:Theinstallerwillcreateanewdatabase

schema.Ifthisoptionisselected

youwillgettwoadditionalinstallationstepswereyoumustspecifydatabase

connectioninformation.(SamestepsasinNewInstallationMode).Notethatthe

databaseschemausedwiththepreviousinstallation

willnotbedeleted.

6.InstallationSummary.Sameasinnewinstallations.

7.Databaseinitialization.IfCreateneworReinitializeexistingisselectedasdatabase

maintenanceoptionthedatabaseschemawillbeinitialized.(Thissteprequiresnouser

interaction)

Page 95 of 152


98/154


16

RevH,06.02.2008

8.Uninstallpreviousinstallation.The

existingNetMasterinstallationwillbeuninstalledbefore

thisinstallerinstallstheselectedcomponents.(Thissteprequiresnouserinteraction)

9.InstallingandInstallationComplete

stepsarethesameasinnewinstallations.


17

RevH,06.02.2008

2.3

UpgradeInstallation

Iftheinst

allerdetectsanolderversionofNetMasterinstalledonth

ecomputer,theinstallerwillrun

inUpgrad

emode.Inthismodeyouwillbeabletoupgradetheexistingcomponentsandalsoto

reselectw

hichcomponentstobeinstalledonthecomputer.Theexistinginstallationwillbe

uninstalle

dandreplacedwiththecomponentsselectedinthismain

tenanceinstallation.Notethat

existingc

omponentsnotselectedwillbeuninstalled.

YoualsohavetheoptiontoupgradeorresettheNetMasterdatabaseifyouareupgradinga

NetMaste

rServerinstallation.

Mostoftheinstallationstepsareidenticaltothenewinstallationm

ode.

1.TheIntroductionstepdescribesthatapreviousversionofN

etMasterisdetected,anddisplays

so

meinformationaboutthedetectedinstallation.

2.TheLicenseAgreementstepisomittedinupgradeinstallations.

Page 96 of 152


99/154


18

RevH,06.02.2008

3.ChooseInstallSet.Thisstepinitiallydisplaysthecomponentsdetectedintheexisting

NetMasterinstallation.Inthisstepyoucanselectwhichcomponentstobeinstalledonthe

computer.Notethatifyoudeselectexistingcomponents,thosewillbeuninstalled.

4.TheChooseInstallFolderandChoo

seShortcutFolderstepsareomittedinupgrade

installations.Theinstallerwilluset

hefoldersdetectedfromthepreviousinstallation.


19

RevH,06.02.2008

5.DatabaseUpgradeOptions.IfyouareupgradingaNetMasterServerinstallation,youhave

threeoptionsforthedatabaseschema:

Upgradeexisting:Theinstallerwillmodifytheexistingdatabaseschematomakeit

compatiblewiththenewversionofNetMaster.

Note:Ifyouchoosethisoptionitisveryimportantthatyoucreateabackupofyour

databasefirst!Iftheupgradeprocessforsomereasonshouldfailthedatabasemay

becomeinconsistent.T

heinstallerwillalsopromptyoutoconfirmthatyouhave

createdabackup.

Reinitializeexisting(overwrite):Theinstallerwilld

eletethecontentoftheexisting

databaseschemaandreinitializeit.

Note:Ifyouchoosethisoptionalldatastoredwiththepreviousinstallationwillbe

lost.T

heinstallerwillalsopromptyoutoconfirmth

atthisisreallywhatyouwantto

do.

Createnew:Theinstallerwillcreateanewdatabase

schema.Ifthisoptionisselected

youwillgettwoadditionalinstallationstepswereyoumustspecifydatabase

connectioninformation.(Samestepsasinnewinsta

llations).Notethatthedatabase

schemausedwiththepreviousinstallationwillnotbedeleted.

6.InstallationSummary.Sameasinnewinstallations.

7.Databaseinitializationandupgrade.Aprogressdialogwill

bedisplayedwhilethedatabaseis

initializedandupgraded.Notethattheupgradeprocessmaytakesometime,dependingon

theamountofdatapresentinthepreviousdatabaseschema

.(Thissteprequiresnouser

interaction)

Page 97 of 152


100/154


20

RevH,06.02.2008

8.Uninstallpreviousinstallation.The

existingNetMasterinstallationwillbeuninstalledbefore

thisinstallerinstallstheselectedcomponents.(Thissteprequiresnouserinteraction)

9.InstallingandInstallationComplete

stepsarethesameasinnewinstallations.

RestrictionsintheNetMasterupgradetools

:

ItisnotpossibletousetheN

etMasterupgradetomovedatafromonedatabasesystem

toanother.E.g.fromOracle

toPostgreSQL.

Itisnotpossibletoupgrade

fromNetMasterversion10Aor10Bdirectlyto10For

laterversions.Itishowever

possibletoupgradefromversion10Aor10Bto10Eand

thenfrom10Eto10F.


21

RevH,06.02.2008

3

INST

ALLINGNETMASTERCLIENTONSUNSOLARIS

NetMaste

rclientissupportedonSUNSolaris9operatingsystema

ndSPARCplatform.

3.1

Pre

-InstallingSteps

TheclientrequiresJava2StandardEdition(J2SE)RuntimeEngine1.6orhigher.JavaRuntime

Engine(JRE)canbedownloadedfreeofchargefromhttp://www.j

ava.com/download.Select32-bit

or64-bitdependingonyoursystemconfiguration.Detailedinstallationinstructionscanbefoundon

thedownloadpage.

Note!Installinga64-bitJREisatwo-stepprocess.

1.First,installthe32-bitJRE.

2.Se

cond,installthesupplementalfilesfor64-bitsupport

3.2

Ins

tallationSteps

1.InserttheNetMasterCDintothedesireddriveandlocateth

edirectorySolaris.

2.Copythefilenetmaster.client.solaris.motif.sparc.z

ipornet_0001.z

ipfromtheCDtoa

directoryonyoursystem(example/tmp/).

3.Unzipthenetmaster.client.solaris.motif.sparc.z

ipornet_0001.z

ipfileintoadirectorywhere

yo

uwantNetMasterclienttobeinstalled(example/opt/Ne

tMaster).

4..T

hefollowingfilestrucutrewillappearintheNetMasterdirectory:

5.OpenthefileNetMaster.iniinatexteditorandspecifytheJREtousebyinsertingatthetop:

v

m

Pleasenotethatthetheinifilerequiresoneargumentperline.

ExampleNetMaster.ini:

6.Sa

vethefile.

7.Se

ttheexecutepermissionsontheNetMasterbinaryfile:

chmod+xNetMaster

8.TheNetMasterClientcannowbestartedbyrunningtheNetMasterexecutable.See5.3

NetMasterGUIClientformoredetails.

-vm

/export/home/user/jre1.6.0_03/bin

-vmargs

-Xms128m

-Xmx256m

-Dosgi.requiredJavaVersion=1.6

Page 98 of 152


101/154


22

RevH,06.02.2008

4

UNINSTALLINGNETMASTER

IfyouforsomereasonwouldwanttouninstallNetMasterorpartsofNetMaster,youcanfindan

uninstallerintheNetMasterprogramfolder.OryoucanopentheControlPanelandthentheAddor

RemoveProgramsfolderwhereyoucanalsoinitiatetheuninstallationofNetMaster.

1.Theuninstallerisstraight-forward.JustpressNext.


23

RevH,06.02.2008

2.Theuninstallerwillthengiveyoutheoptionofchoosinga

completeuninstallortouninstall

on

lyspecificfeatures.PressNextafterchoosingwhattoun

install.Ifyouchoosetodoa

co

mpleteuninstall,uninstallationwillstartimmediatelywh

enpressingNext.

3.If

youchoosetouninstallspecificfeaturesonly,youhavetospecifywhichfeaturesto

un

install.Uncheckthefeaturesyouwanttouninstallandth

enpressUninstall.Uninstallation

willthenstart.

Page 99 of 152


102/154


103/154


26

RevH,06.02.2008

6

HOWTOINSTALLORACLE

Thissectiondescribestheinstallationsteps

forthetwoinstallersprovidedforthedifferenteditionso

f

theOracleDatabaseServer:

InstallingOracleExpressEdition

InstallingOracleStandardEditionO

ne,StandardEditionandEnterpriseEdition

6.1

InstallingOracleExpressEditio

n

OracleDatabase10gExpressEdition(Or

acleDatabaseXE)isanentry-level,small-footprint

databasebasedontheOracleDatabase10gRelease2codebasethat'sfreetodevelop,deploy,and

distribute;fasttodownload;andsimpletoadminister.

NetMasteriscompatiblewithOracleDatab

ase10gExpressEdition.OracleDatabaseXEcanbe

downloadedfreeofchargefromhttp://www

.oracle.com/technology/products/database/xe/index.html.

AfterdownloadingtheOracleXE.exefile,e

xecuteitandtheinstallationprocesswillstart:

1.Introduction.PressNexttocontinue.


27

RevH,06.02.2008

2.LicenseAgreement.ReadcarefullyandpressAcceptandNexttocontinue.

3.Choose

DestinationLocation.Notethatthedestinationlocationcannotcontainspaces.PressNext

tocontinu

e.

Page 101 of 152


104/154


28

RevH,06.02.2008

4.ChooseHTTPListenerport.Choosethe

listenerportfortheOracleweb-server.Notethatthisstep

isomittedifthedefaultport8080isavailab

le.PressNexttocontinue.

5.SpecifyDatabasePasswords.Enterthep

asswordforthedatabaseadministratoraccounts.Note

thatthispasswordwillbeneededduringtheNetMasterServerinstallation.PressNexttocontinue.


29

RevH,06.02.2008

6.Summary.PressNexttocontinue.

Page 102 of 152


105/154


30

RevH,06.02.2008

7.InstallationComplete.Ifyouselectthe"LaunchtheDatabasehomepage"checkbox,aweb-based

databaseadministratortoolwillbelaunchedinthecomputersdefaultweb-browser.PressFinishto

exit.

ThelimitationsofOracleExpressEditiona

re:

UserDatalimitations:ThemaximumamountofuserdatainOracleExpressdatabaseis4

Gigabytes.Iftheuserdatagrowsbe

yondthatlimit,anORA-12592errorwillappearinthe

serverlog.

CPUlimitations:OracleExpresseditionwilluseprocessingresourcesequivalenttoone

singleCPUeventhoughthecomputerhasmultipleCPUsinstalled.

Memorylimitations:Themaximum

amountofRAMusedbyOracleExpressis1gigabyte.

InstallationandExecutionlimitations.OnlyoneinstanceofOracleExpresscanbeinstalled

andexecutedonasinglecomputer.

HTTPSnotsupported.TheHTTPlistenerbuiltintoOracleExpressdoesnotsupportSSL.


31

RevH,06.02.2008

6.2

ReconfigurationoftheparametersPROCESSESan

dUNDO_RETENTION

InordertomakeOracleExpressEditionworkcorrectlytheconfigurationoftheparameters

PROCESSESandUNDO_

RETENTIONneedtobechanged.

Whenthe

installationiscompletedopenthefileinitXE.ora(f.exin

NotePad):

\oraclexe\app\oracle\product\10.2.0\server\database\in

itXE.ora

Add:

PR

OCESSES=150

UNDO_

RETENTION=0

Savethefile.Restarttheserver.

Inordertoverifytheparameterchanges:

-OpenOracleDatabase10gExpressEdition|GoToDatabaseHo

mePage

-Logina

sdatabaseadministrator:System/.

-SelectAdministration|AboutDatabase|Parameters

-VerifythatPROCESSES=150andUNDO_

RETENTION=0

Page 103 of 152


106/154


107/154


34

RevH,06.02.2008

3.Summary.Displaysasummaryoftheselectionsmadeabove.PressInstalltocontinue.

4.Installation.Displaystheinstallationprogress.PressNexttocontinue.

5.ConfigurationAssistant.Createsyourdatabaseserverinstanceandconfiguresitaccordingto

yourselectionsabove.


35

RevH,06.02.2008

ThePasswordManagementdialogletsyouconfigurethedefaultuseraccounts.Sinceyouve

alreadyprovidedapasswordfortheadministratoraccounts

youdontneedtodoanychanges

he

re.PressOKtocontinue.

Page 105 of 152


108/154


109/154


38

RevH,06.02.2008

a.OpenSystemintheControlPanel,andselecttheComputerNametab.InFull

computername,makesureyouseethehostnameandthedomainname,forexample,

sales.us.mycompany.com.

b.ClickChange.InComputer

name,youshouldseethehostname,andinFullcomputer

name,youshouldseetheho

stnameanddomainname.Usingthepreviousexample,

thehostnamewouldbesale

sandthedomainwouldbeus.mycompany.com.

c.ClickMore.InPrimaryDNSsuffixofthiscomputer,youshouldseethedomain

name,forexample,us.mycompany.com.


39

RevH,06.02.2008

6.5

Ins

tallingonmultihomedcomputers

YoucaninstallOracleDatabaseonacomputerthatisassociatedw

ithmultipleIPaddresses

(typically

achievedbyhavingmultiplenetworkcardsonthecomputer).EachIPaddressisassociated

withahostname;additionally,youcansetupaliasesforthehostn

ame.Bydefault,OracleUniversal

Installeru

sestheORACLE_H

OSTNAMEenvironmentvariablesettingtofindthehostname.If

ORACLE_H

OSTNAMEisnotsetandyouareinstallingonacomputerthathasmultiplenetwork

cards,OracleUniversalInstallerdeterminesthehostnamebyusingthefirstnameinthehostsfile,

typicallylocatedinSYSTEM_D

RIVE:\WINDOWS\system32\drivers\etconWindows2003and

Windows

XP,orSYSTEM_D

RIVE:\WINNT\system32\drivers\etco

nWindows2000.

Clientsm

ustbeabletoaccessthecomputerusingthishostname,o

rusingaliasesforthishostname.

Tocheck,pingthehostnamefromtheclientcomputersusingtheshortname(hostnameonly)and

thefullname(hostnameanddomainname).Bothmustwork.

6.5.1SettingtheORACLE_HOSTNAMEEnvironmentVariable

Tosetthe

ORACLE_H

OSTNAMEenvironmentvariable:

1.DisplaySystemintheWindowsControlPanel.

2.In

theSystemPropertiesdialogbox,clickAdvanced.

3.In

theAdvancedtab,clickEnvironmentVariables.

4.In

theEnvironmentVariablesdialogbox,underSystemVa

riables,clickNew.

5.In

theNewSystemVariabledialogbox,enterthefollowing

information:

a.Variablename:ORACLE_H

OSTNAME

b.Variablevalue:Thehostnameofthecomputerthat

youwanttouse.

6.ClickOK,thenintheEnvironmentVariablesdialogbox,clickOK.

7.ClickOKintheEnvironmentVariablesdialogbox,thenin

theSystemPropertiesdialogbox,

clickOK.

Page 107 of 152


110/154


40

RevH,06.02.2008

7

HOWTOINSTALLPOSTGRESQL

PostgreSQLisapowerful,opensourcerelationaldatabasesystem.I

thasmorethan15yearsof

activedevelopmentandaprovenarchitectu

rethathasearneditastrongreputationforreliability,

dataintegrity,andcorrectness.

NetMasteriscompatiblewithPostgreSQLversion8.1.5andversion8.2.3.PostgreSQLcanbe

downloadedfreeofchargefromhttp://www

.postgresql.org.Foryourconveniencewehave

embeddedPostgreSQLversion8.2.3aswellasPostgreSQLdocumentationontheNetMaster

installationCD.YouwillfinditinthePostgreSQLdirectory.

TheInstallerwalktroughchapterisanexcerptfromhttp://pginstaller.projects.postgresql.org/.Please

consulthttp://www.postgresql.orgifyoune

edmoreinformationabouthowtoinstalland/or

configurePostgreSQL.

Notethatyouhavetoperformsomepost-in

stallationstepstomakePostgreSQLworkwith

NetMaster.PleaseseethePostgreSQLPostInstallationchapterformoreinformation.

7.1

Installerwalkthrough

Firstofallyouwillhavetounpackthezip-

filecontainingthePostgreSQLimage.Youhaveto

unpackallfilesinthezip-filetoatemporar

ydirectory.Theinstaller(postgresql-8.2.msi)maybe

startedfromanExplorerwindowsimplyby

double-clickingit.

ThePostgreSQLinstallerisbasedonWind

owsInstaller,soitshouldbefamiliartomostWindows

users.Followingisaquickwalkthroughof

theinstallersteps.


41

RevH,06.02.2008

1.Languageselection

Se

lectthelanguageyouwanttousefortheinstaller.Thiso

nlysetsthelanguageusedinthe

installwizard-theactualinstalledPostgreSQLcanbeinsta

lledwithorwithoutlanguage

su

pportandhasitsownlanguagechoiceindependentfrom

theinstaller.

Youcanalsoselectifyouwanttheinstallertocreateadeta

iledlogfileoftheinstallation

process.

Notethatthislogfilewillcontainboththeserviceuseranddatabasesuperuser

pa

sswordifcreated.

Page 108 of 152


111/154


42

RevH,06.02.2008

2.Introductionscreen

Introductionmessage.JustclickNexttogetstarted.

3.Welcomemessageandinstruction

s

Asalways,pleasereadthecomplete

instructionsbeforeyoucontinue.


43

RevH,06.02.2008

4.Featureselection

Se

lectwhatyouwanttoinstall.TheserverpartwillonlybeavailableonNTbasedplatforms.

Notethatthe'DataDirectory'optionmayonlybeinstalledonanNTFSpartition.Ifyouwish

to

installthedatadirectoryonanyotherpartitiontype,you

willneedtoruninitdb.exe

manuallyafterinstallation.

Youcanchangethedirectoryoftheentireinstallationbyse

lectingthefeaturePostgreSQL

an

dclickBrowsetopickthenewdirectory.Youcanalsochangethedirectoryofan

individualfeature(suchastheserver,orpgAdmin)byselectingthatfeatureandclicking

Browse.

Page 109 of 152


112/154


44

RevH,06.02.2008

5.Serviceconfiguration

ChoosewhetheryouwantPostgreSQLinstalledasaservice,andifsospecifywhichaccount

shouldbeused.ThisaccountwillbecreatedandgrantedtheLogonOnasaServicerightif

required.


45

RevH,06.02.2008

6.In

itialisedatabase

Th

isdialogisonlyavailableifyouchosetoinstallPostgreSQLasaservice.

Choosewhetheryouwantadatabaseclustertobeinitializedinthedatabase.Ifso,choose

ch

aractersetandencodingforyourdatabase,andspecifylo

gindetailsforthedatabase

su

peruser.Youmayalsospecifyanon-defaultportnumber

toruntheserveron(Ifyou

ch

angethedefaultport,pleasemakeanoteofit,asyouwillneeditwhileinstallingthe

NetMasterserver)

If

youplantorunNetMasterserverandthePostgreSQLserveronseparatemachines,you

willhavetochecktheAcceptconnectiononalladdressesoption.Youwillalsoneedto

en

ableaccessinthehostbasedauthenticationconfiguration

(pg_hba.conf)toallowremote

us

erstoconnecttotheserver.Thisiscoveredin7.2.

Page 110 of 152


113/154


46

RevH,06.02.2008

7.Procedurallanguages

Choosetheprocedurallanguagesyo

uwantactivatedintemplate1.AllPLfilesarealways

installed;thisstepjustactivatesthembydefaultinallyourdatabases.

ThisdialogisonlyavailableifyouchosetoinstallPostgreSQLasaservice,andchoseto

haveadatabaseclusterinitialized.

Onlythelanguageswherethecorrespondingruntimeswerefoundinstalledonthesystemare

availableforselection.

PL/perlrequiresActiveStatePerl5.8tobeinstalled.

PL/pythonrequiresPython2.3tobeinstalled

PL/tclrequiresActiveStateTcl8.4tobeinstalled.

PL/javarequiresavalidSunJavaRuntimeEnvironmenttobeinstalled.


47

RevH,06.02.2008

8.Contribmodules

Se

lectthecontribmodulestoactivateintemplate1.Allcon

tribfilesarealwaysinstalled,this

stepjustactivatesthembydefaultinallyourdatabases.

Th

isdialogisonlyavailableifyouchosetoinstallPostgreSQLasaservice,andchoseto

ha

veadatabaseclusterinitialized.

Note:TheAdmin81moduleisinstalledbydefaultbecause

pgAdminwilluseittoprovide

en

hancedfunctionality.Itmayberemovedifyoudonotwantittobeinstalledinall

da

tabases;pgAdminwillsimplynotoffertheenhancedfun

ctionalityitallows.

Page 111 of 152


114/154


48

RevH,06.02.2008

9.Readytoinstall

JustclickNexttostarttheactualinstallation.


49

RevH,06.02.2008

10.In

stalling

A

progressbarisshownduringtheinstallation.

OnsomeversionsofWindows(notablyWindowsXPbeforeServicePack2andWindows

20

03beforeServicePack1-seeMicrosoftKnowledgeBasearticleQ818858)aCommand

Pr

omptwindowwillappearduringthe"Initializingdatabas

ecluster"step.Don'tclosethis

window-itwillautomaticallycloseoncetheoperationiscomplete.

Page 112 of 152


115/154


50

RevH,06.02.2008

11.Finished

Installationiscomplete.Youcanno

wgoaheadandtestyourinstallationandsubscribetothe

pgsql-announcemailinglisttokeep

uptodate.

IfyouneedtoaddorremoveafeaturefromPostgreSQL,usetheAdd/removeprograms

featureintheControlPanel.


51

RevH,06.02.2008

7.2

PostgreSQLPostInstallation

AfterinstallationofPostgreSQLyouwillhavetomakesomechangesinparametersettingstomake

itworkoptimalwithNetMaster.

1.StartthepgAdmintool.YouwillfinditinStartA

llprog

ramsP

ostgreSQL8.2

pg

AdminIII.ConnecttoyourPostgreSQLdatabaseserver.

2.Expandthefollowingintheleftwindow:PostgreSQLData

baseServerDatabases

Po

stgreornetmaster.

Page 113 of 152


116/154


52

RevH,06.02.2008

3.ChooseToolsS

erverconfigurationp

ostgresql.conf.Locatesettingname

max_c

onnectionsandmakesureiti

senabledandhasthevalue100.(Note:Ifthisisdisabled

ensurethatpreviousstepwasaccom

plished).

4.Locatesettingnamemax_p

repared_t

ransactionsandmakesureitisenabledandhasthe

value100.


53

RevH,06.02.2008

5.Double-clickonthemax_p

repared_transactionssettingandchangeitsvalueto100(ortoa

va

luethatisequaltoorhigherthanthemax_c

onnectionsse

tting).AlsoselecttheEnabled

ch

eckbox.PressOK.

6.In

thepgAdmintoolchooseFileS

ave.

7.If

youplantoinstalltheNetMasterserveronadifferentPC

thanthePostgreSQLserver,you

ha

vetoenableaccessinthehostbasedauthenticationconfigu

ration.

ChooseToolsS

erverconfigurationp

g_hba.conf.AddanentrywithIP-addressand

su

bnetmaskoftheclientthatshallbeallowedaccesstothe

databaseserver.

M

oredetailsonthisisgiveninthePostgreSQLonlinehelp

(Chapter20Client

Authentication)

8.In

thepgAdmintoolchooseFileS

ave.

9.Tomakethechangetakeeffectyouwillhavetorestartthe

PostgreSQLserver.Fromthe

W

indowsStartmenuchooseAllProgramsP

ostgreSQL

8.2S

topServicefollowedby

AllProgramsP

ostgreSQL8.2S

tartService.

Page 114 of 152


117/154


54

RevH,06.02.2008

7.3

PostgreSQLlicense

3RVWJUH64/'DWDEDVH0DQDJHPHQW6\VWHP

IRUPHUO\NQRZQDV3RVWJUHV

WKHQDV3RVWJUHV

3RUWLRQV&RS\ULJKWF

7KH3RVWJUH64/*OREDO

'HYHORSPHQW*URXS

3RUWLRQV&RS\ULJKWF

7KH5HJHQWVRIWKH8QLYHUVLW\

RI&DOLIRUQLD

3HUPLVVLRQWRXVH

FRS\

PRGLI\

DQGGLVWULEXWHWKLVVRIWZD

UHDQGLWVGRFXPHQWDWLRQIRUDQ\SXUSRVH

ZLWKRXWIHH

DQGZLWKRXWDZULWWHQ

DJUHHPHQWLVKHUHE\JUDQWHG

SURYLGHGWKDWWKHDERYHFRS

\ULJKWQRWLFHDQGWKLVSDUDJUDSKDQGWKHIROORZLQJWZRSDUDJUDSKVDSSHDULQDOO

FRSLHV

,112(9(176+$//7+(81,9(56,7