Вы находитесь на странице: 1из 97

NetMaster Installation Guide

Table Of Contents
Version.................................................................................................................... 1
Copyright ......................................................................................................... 1
NetMaster installation on Windows ......................................................................... 2
NetMaster Server pre installation for Windows.................................................... 2
NetMaster installation for Windows ..................................................................... 3
New installation................................................................................................ 3
Upgrade installation ....................................................................................... 14
Maintenance installation ................................................................................ 15
System Manager installation on Database Server............................................. 17
Installation...................................................................................................... 18
Configuration ................................................................................................. 27
Uninstall NetMaster for Windows ...................................................................... 30
NetMaster installation on Solaris........................................................................... 32
NetMaster Server pre installation for Solaris ..................................................... 32
NetMaster Server installation for Solaris ........................................................... 34
New installation.............................................................................................. 35
Register NetMaster services.......................................................................... 35
NetMaster Client installation for Solaris............................................................. 37
Pre installation steps...................................................................................... 37
Installation steps ............................................................................................ 37
Uninstall NetMaster for Solaris .......................................................................... 39
Post Installation..................................................................................................... 40
NetMaster Server post installation..................................................................... 40
System Manager............................................................................................ 40
NetMaster Heap Size configuration ............................................................... 40
Firewall settings ............................................................................................. 41
NetMaster GUI Client..................................................................................... 42
NetMaster license .......................................................................................... 43
Database administrator user privileges.......................................................... 43
Maintenance issues ....................................................................................... 44
Database Installation ............................................................................................ 46
NetMaster Database.......................................................................................... 46
Oracle................................................................................................................ 48
How to Install Oracle...................................................................................... 48
Oracle 10G Installation Procedure ................................................................. 48
Oracle 11G Release 1 Installation Procedure................................................ 55
Oracle 11G Release 2 Installation Procedure................................................ 63
PostgreSQL....................................................................................................... 78
How to Install PostgreSQL............................................................................. 78
Installer walkthrough ...................................................................................... 78
PostgreSQL post installation.......................................................................... 87
PostgreSQL database upgrade (version 8.3 - 9.1) ........................................ 90
External Documents.............................................................................................. 92
System Requirements ....................................................................................... 92
Technical Description ........................................................................................ 93

iii

NetMaster Installation
Version
NetMaster document version R13A00.
For availability of features described, please refer to the Product Roadmap.

Copyright
All the contents of this document is subject to the terms stated in the NetMaster
license terms, located in the in the NetMaster installation directory, which was
explicitly accepted during NetMaster first time installation.
Product names mentioned in this document may be trademarks of their respective
companies, and they are mentioned for identification purposes only.

NetMaster Installation Guide

NetMaster installation on Windows


NetMaster Server pre installation for Windows
Prepare database

NetMaster Server requires a database to work. Make sure that a database server is
installed and reachable from the computer on which you want to install NetMaster
Server.
The database server can be, but does not have to be, installed on the same
computer as the NetMaster Server, ref. the NetMaster System Requirements
document for guidance.
If the database server is running on a different computer than the NetMaster Server,
the firewall settings on the database server may have to be modified (i.e. open the
port used for communication with the database server).
Oracle and PostgreSQL database servers are supported, see the NetMaster system
requirements document for information about supported database editions.
See How to install PostgreSQL or How to install Oracle if you need to install a
database server from scratch.
If NetMaster is currently using a PostgreSQL version older than PostgreSQL 9.1.3
see PostgreSQL database upgrade on how to upgrade to the 9.1.3 version.
Note that these pre-installation steps are not required for NetMaster Client or the
Northbound SNMP Agent installations.
Proceed with the steps for NetMaster installation for Windows.

NetMaster Installation

NetMaster installation for Windows


The following chapter guides you through NetMaster installation on Windows
platform.
This guide requires that the steps for NetMaster Server Pre-Installation for Windows
already has been completed.
NetMaster Install Sets

NetMaster allows you to install any of the following install units:


Install Unit
Client

Server
System
Manager
SNMP Agent

Explanation
NetMaster Client. Can be installed on a separate machine. Also
available for Solaris platform, see NetMaster Client installation
for Sun Solaris for details.
NetMaster Server.
Configuration and maintenance tool for NetMaster Server.
System Manager must be installed on both the NetMaster
Server and the database server.
Northbound interface to higher-order network management
systems

All install sets:


Install Set
Client
Server
System
Manager
Custom

Explanation
NetMaster Client only.
NetMaster Client, NetMaster Server, Snmp Agent and System
Manager.
System Manager only. Intended for stand-alone database
server installation.
Pick one or more of all available install units.

Install Modes

There are three modes of installation:


1. New Installation
2. Upgrade Installation
3. Maintenance Installation
The NetMaster installer looks for existing NetMaster installations on your installation
server in order to determine correct install mode.

New installation

NetMaster Installation Guide


If no existing NetMaster installation is detected on the computer, the installer will run
in New Installation mode.
You may cancel the installation at any step until the wizard starts installing the files.
Insert the CD into the desired drive and run the Setup.exe file to launch the
NetMaster Installer home page.

Press the Install NetMaster button to initiate NetMaster installation.


Internet Explorer needs to be told to run the installer:

Press Run button to continue installation.


Internet Explorer needs to know that you trust the installer:

Press Run to continue installation.

NetMaster Installation
The Installer is preparing to start:

Proceed by following the NetMaster Installation wizard as follows:

NetMaster Installation wizard in New installation mode

1. The Introduction step displays some general information about the installation
process

NetMaster Installation Guide


Press Next to continue the wizard.
2. Read the license agreement.

If you accept the agreement, select the Accept option and then Next to
continue.
3. Choose Install Set step. Note that the NetMaster Server install set includes
Server, System Manager, Client and Northbound SNMP Agent.

NetMaster Installation

Press Next to continue.


4. Choose Install Set step - Custom. This step is only displayed if the "custom"
install set is selected in the previous step.
In this step you can select each component individually. See the Description
field for information about the selected component.

NetMaster Installation Guide

Press Next to continue.


5. Choose Install Folder step.
In this step you can choose where on the file system to install the software

NetMaster Installation

Press Next to continue.


6. Choose Shortcut Folder step.
In this step you can choose where to place product icons/shortcuts. Note that
there is an option for creating icons for all Users.

NetMaster Installation Guide

Press Next to continue.


7. Pre Installation Summary step
This step gives an overview of the current selections.

10

NetMaster Installation

8. Installing step
Watch the product features being presented during the installation progress.

11

NetMaster Installation Guide

9. Install Complete step.


If there were any problems encountered during the installation, see the
installation log file located in the installation destination folder for details.

12

NetMaster Installation

Press Done to finish the wizard.


10. The installation wizard configures the system when completing the wizard.
If included in the installation set, System Manager can be opened at the end of
installation:

13

NetMaster Installation Guide

Press Yes to open System Manager, and complete configuration of


NetMaster, including importing a license, connecting NetMaster to a database,
scheduling database backup and setup mail parameters.
If NetMaster Server is installed, the server will be installed as an automatic
Windows Service, with its own Server monitor in the systray. The NetMaster
Server monitor starts when installation is completed, and you are prompted
whether to start the NetMaster Server. If you don't want the NetMaster Server
to start automatically upon computer reboot, you can set the mode of the
NetMaster Service to manual in the Services applet in the Control Panel.

Proceed with the NetMaster Post installation steps.


Upgrade installation
If the installer detects an older version of NetMaster installed on the computer, the
installer will run in Upgrade mode. In this mode you will be able to upgrade the
existing components and also to reselect which components to be installed on the
computer. The existing installation will be uninstalled and replaced with the
components selected in this maintenance installation. Note that existing components
not selected will be uninstalled.
NetMaster System Manager can be launched after the NetMaster software
installation and gives options to upgrade or reset the NetMaster database.

14

NetMaster Installation

Note:

Action permissions for new functionality are default disabled for all user
groups; these must be specifically granted for user groups needing access.
If this is an upgrade from NetMaster R10J or older, using PostgreSQL 8.2, the
PostgreSQL database must be upgraded to version 8.3 for the maintenance
tasks to work properly. See PostgreSQL database upgrade.
The netmaster_environment.cmd file will be generated however the database
administration user and password will be left empty.

Most of the installation steps are identical to the New Installation mode.
1. The Introduction step describes that a previous version of NetMaster is
detected, and displays some information about the detected installation.
2. The License Agreement step is omitted in upgrade installations.
3. Choose Install Items step. This step initially displays the components detected
in the existing NetMaster installation. In this step you can select which
components to be installed on the computer. Note that if you deselect existing
components, those will be uninstalled.
4. The Choose Install Folder and Choose Shortcut Folder steps are omitted in
upgrade installations. The installer will use the folders detected from the
previous installation.
5. The Pre Install Summary step gives an overview of the current selections.
6. Installing step. Watch the product features being presented during the
installation progress.
7. Installation Summary. Same as in new installations.

Proceed with the NetMaster Post installation steps.

Maintenance installation
If the installer detects an existing NetMaster installation with the same version, the
installer will run in Maintenance mode. In this mode you will be able to reselect which
components to be installed on the computer. The existing installation will be
uninstalled and replaced with the components selected in this maintenance
installation. Existing components not selected will be uninstalled.
NetMaster System Manager can be launched after the NetMaster software
installation and gives the option to reinitialize the NetMaster database.
Most of the installation steps are identical to the New Installation mode.
1. The Introduction step describes that an existing installation is detected, and
displays some information about the detected installation.

15

NetMaster Installation Guide


2. Choose Install Items step. This step initially displays the components detected
in the existing NetMaster installation. In this step you can select which
components to be installed on the computer. Note that if you deselect existing
components, those will be uninstalled.
3. Installation Summary. Same as in new installations.
4. Installing step. The existing NetMaster installation will be uninstalled before
this installer installs the selected components. (This step requires no user
interaction)
5. Pre Install Summary step
This step gives an overview of the current selections.
6. Installing step. Watch the product features being presented during the
installation progress.
7. Install Complete step. This step is the same as in new installations.
Proceed with the NetMaster Post installation steps.

16

NetMaster Installation

System Manager installation on Database Server


The System Manager tool is installed together with the NetMaster Server and
provides the NetMaster operators an easier and more flexible way to deal with some
NetMaster administrative tasks:

Set up NetMaster database connection


Upgrade old NetMaster database to a new version
Backup/restore database (requires System Manager on database server)
Schedule database backup and database maintenance tasks
Configure email notification
Start and stop of NetMaster Server

As database backup and restore operations MUST be run on the actual database
server, you have to install System Manager as a standalone application on your
database server if you want System Manager to handle database backup and restore
for you.

A database export will then work like this:


1. User logs on to System Manager on the NetMaster server and requests a
database backup. (Or a periodic database backup job has just started.)
2. A request is sent to System Manager on the database server that runs a
database backup job and stores the export file in the default folder
C:\NetMaster\Backup\Database on the database server.

17

NetMaster Installation Guide


3. System Manager on the NetMaster server then copies the newly created
database export file from the database server and places it in the location
specified in the Database view available from the System Manager Settings
menu. The default location is C:\NetMaster\Backup\Database on the
NetMaster server.
If System Manager is not installed on the database server, the database backup and
restore feature in System Manager is not available.
Installation
If no existing System Manager installation is detected on the database server, the
installer will run in New Installation mode.
You may cancel the installation at any step until the wizard starts installing the files.
Insert the CD into the desired drive and run the Setup.exe file to launch the
NetMaster Installer home page
Press the Install NetMaster button to initiate System Manager installation.
Internet Explorer needs to be told to run the installer:

Press Run button to continue installation.


Internet Explorer needs to know that you trust the installer:

18

NetMaster Installation

Press Run to continue installation.


The Installer is preparing to start:

Proceed to install NetMaster by running the NetMaster Installation wizard as follows:


1. The Introduction step displays some general information about the installation
process

19

NetMaster Installation Guide

Press Next to continue the wizard.


2. Read the license agreement.

20

NetMaster Installation

If you accept the agreement, select the Accept option and then Next to
continue.
3. Choose Install Set step. Select the NetMaster Database Server only. This is in
fact System Manager in standalone mode.

21

NetMaster Installation Guide

Press Next to continue.


4. Choose Install Folder step.
In this step you can choose where on the file system to install the software

22

NetMaster Installation

Press Next to continue.

5. Choose Shortcut Folder step.


In this step you can choose where to place product icons/shortcuts. Note that
there is an option for creating icons for all Users.

23

NetMaster Installation Guide

Press Next to continue.


6. Pre Installation Summary step.
This step gives an overview of the current selections.

24

NetMaster Installation

Press Install to continue the wizard.


7. Installing step
Watch the product features being presented during the installation progress.

25

NetMaster Installation Guide

8. Install Complete step.


If there were any problems encountered during the installation, see the
installation log file located in the installation destination folder for details.

26

NetMaster Installation

Press Done to finish the wizard.

Configuration
If you open System Manager on the database server the following information is
shown:

27

NetMaster Installation Guide

All configuration should in general take place using the System Manager that is
installed on the NetMaster server, and not on the Database Server.
However, please note that database backups will by default be saved in a folder on
the same drive as the database installation folder. As the database backups occupies
too large amounts of space on the storage drive, it might be helpful to change the
database folder to a location on a different drive. On a system with standalone
Database Server, this must be done manually.
How to change folder for backups on a standalone Database Server

If you want to change the folder for backups on a standalone Database Server, do
the following:
1. On the database server, go to the folder:
<NetMaster_installation>/SystemManager/conf/system/

28

NetMaster Installation
2. Open the file:
string@DatabaseBackupPath.xml
3. Change the path to another existing location and save the file

29

NetMaster Installation Guide

Uninstall NetMaster for Windows


To uninstall NetMaster, run Uninstall NetMaster from the NetMaster program folder.
You can also locate NetMaster in the Add or Remove Programs folder in the Control
Panel and click the Change/Remove button.
1. Run the NetMaster Uninstaller wizard:

Press Uninstall to continue the wizard.


2. A confirmation dialog appears:

30

NetMaster Installation
Press Yes to confirm NetMaster removal.
3. NetMaster is now uninstalled:

Press Done to exit the NetMaster Uninstaller wizard.

31

NetMaster Installation Guide

NetMaster installation on Solaris


NetMaster Server pre installation for Solaris
Register NetMaster Server at DNS

To establish connection between NetMaster Client and NetMaster Server, it is


required that the NetMaster Server host is registered in DNS.
Prepare database

NetMaster Server requires a database to work. Make sure that a database server is
installed and reachable from the computer on which you want to install NetMaster
Server.
Please note that Database Server is not officially supported on a Solaris platform, ref.
the NetMaster System Requirements document for guidance. We recommend
installing stand alone database on Windows Server 2008 64bit platform instead,
using the procedure System Manager Installation on Database Server.
If the database server is running on a different computer than the NetMaster Server,
the firewall settings on the database server may have to be modified (i.e. open the
port used for communication with the database server).
Oracle database servers are supported, see the NetMaster system requirements
document for information about supported database editions.
See How to install Oracle if you need to install a database server from scratch.
Prepare Java

1. Ensure that a Java JDK 64 bit, version 1.6 is installed on the Solaris machine.
Installation Instructions can be found at
http://java.sun.com/javase/6/webnotes/install/jdk/install-solaris-64.html
2. Ensure that the java binary directory is in PATH
java -version
3. If version is not 1.6, do (assuming you have version 1.6.0.20):
cd /usr
rm java
ln -s /usr/jdk/jdk1.6.0_20 java
Prepare Apache Ant

32

NetMaster Installation
1. Ensure that Apache Ant of version at least 1.8.1 is installed on the Solaris
machine.
If not installed:
a. Install ant (unpack the archive from folder /ant on installation media) on
a filesystem with enough space.
b. Create a symbolic link:
ln -s <Ant install folder>/apache-ant-1.8.1/bin/ant /usr/bin/ant
Proceed with the steps for NetMaster Server installation for Solaris

33

NetMaster Installation Guide

NetMaster Server installation for Solaris


The following chapter guides you through NetMaster Server, System Manager and
SNMP Agent installation on Solaris platform.
This guide requires that the steps for Pre Installation for Solaris already has been
completed.
NetMaster Server is supported on SUN Solaris 10 operating system and SPARC
platform.
If you want to install NetMaster Client on Solaris 9 platform, use the manual
procedure for NetMaster Client installation for Solaris. Client is also available for
Windows platform, see NetMaster installation for Windows for details.
NetMaster install sets

NetMaster allows you to install any of the following install units:


Install Unit
Server
System
Manager
SNMP Agent

Explanation
NetMaster Server.
Configuration and maintenance tool for NetMaster Server.
System Manager must be installed on both the NetMaster
Server and the database server.
Northbound interface to higher-order network management
systems

All install sets:


Install Set
Server
System
Manager

Explanation
NetMaster Server, SNMP Agent and System Manager.
System Manager only, intended for stand-alone database
server installation.

Custom

Please note that System Manager on stand alone database


server is not supported for Solaris, we recommend installing
database on Windows Server 2008 64bit instead, using the
procedure System Manager Installation on Database Server.
Pick one or more of all available install units

Install modes

For Solaris platform, this version of the installer only supports New installation. (No
Upgrade/Maintenance). This means that you must uninstall the current version before
installation.

34

NetMaster Installation
Please note that the installation of NetMaster on Solaris is less automated compared
to Windows installer, and some steps needs to be done manually.
New installation
Execute the installer as root
1. If installing from CD, insert the CD into the desired drive and do the following:
cd <folder mounted to CD drive>/Disk1/InstData/NoVM/
sh Setup.bin
If installing from zip-file, unpack the NetMaster installer netmaster-sol_R****.zip
to a temporary folder and do the following:
cd <temporary folder>/Disk1/InstData/NoVM/
sh Setup.bin
2. When choosing installation directory in the installer, ensure that the folder has
enough free space, and is within the boot partition. This is to make sure that
the services will start automatically after a reboot of the machine.
3. Complete the installation wizard. The steps in the installation for Solaris are
basically the same as in New Installation for Windows, except that Client is not
an option in Solaris version.
If the Installer reports that the installation succeeded with some errors, you can
search for ERROR in
<install-dir>/NetMaster_InstallLog.log
If the only errors relates to Modify Text File and Create Link, then everything is OK.
Register NetMaster services
When installation wizard is completed, register services by executing:
cd <install-dir>
ant
Check Service Status

If you want to check the status of the NetMaster services:


svcs sysman netmaster nifservice
If you installed NetMaster Server (netmaster), System Manager (sysman) and SNMP
Agent (nifservice), the result should be something like this:
STATE

STIME

FMRI

35

NetMaster Installation Guide


disabled
disabled
online

10:48:42 svc:/application/netmaster:default
10:48:44 svc:/application/nifservice:default
10:48:51 svc:/application/sysman:default

Start a System Manager web browser session

From a Windows PC, open an Internet Explorer web browser on:


http://<NetMaster server address>:18080/SystemManager/main?dialog=setup
where
<NetMaster server address> = address of the server where System Manager is
running.
Proceed with the NetMaster Post installation steps and run NetMaster Initial Setup
wizard to set up NetMaster Server with a database schema.

36

NetMaster Installation

NetMaster Client installation for Solaris


The following chapter guides you through NetMaster Client installation on Solaris
platform.
NetMaster Client is supported on SUN Solaris 10 operating system and SPARC
platform.
Please note that this guide for manual installation of NetMaster Client is the only
supported installation procedure for Solaris.
Pre installation steps
Prepare Java

1. Ensure that a Java 2 Standard Edition JRE (or JDK), version 1.6 is installed on
the Solaris machine. Select 32-bit or 64-bit depending on your system
configuration.
Java Runtime Environment (JRE) can be downloaded free of charge from
http://www.java.com/download. Installation Instructions can be found at
http://java.sun.com/javase/6/webnotes/install/jre/install-solaris.html.
2. Ensure that the java binary directory is in PATH
java -version
3. If version is not 1.6, do (example with 1.6.0.20 JRE installed at /usr/jre):
cd /usr
rm java
ln -s /usr/jre/jre1.6.0_20 java
Installation steps

1. Insert the NetMaster CD into the desired drive and locate the directory Solaris.
2. Unzip the file netmaster.client.solaris.gtk.sparc.zip or net_0001.zip from CD
into a directory where you want NetMaster client to be installed (example
/usr/NetMaster/GUI Client/).
3. The following file structure will appear in the NetMaster client directory:

37

NetMaster Installation Guide

4. The NetMaster Client can now be started by running the NetMaster


executable.
See the chapter on NetMaster GUI Client for more details.

38

NetMaster Installation

Uninstall NetMaster for Solaris


Please note that the uninstallation of NetMaster on Solaris less automated compared
to the Windows version.
1. Run uninstaller:
sh <install-dir>/Uninstall\ NetMaster/Uninstall_NetMaster
2. Remove files:
rm -r <install-dir>
rm -r /var/svc/manifest/application/

39

NetMaster Installation Guide

Post Installation
NetMaster Server post installation
This section describes post installation steps for a NetMaster Server installation.
This guide requires that the steps for NetMaster Installation on Windows or
NetMaster Installation on Solaris already has been completed.
Note that for a new and upgrade installation, NetMaster is not ready to run until
System Manager's NetMaster Initial Setup wizard is completed.
Windows only: Windows Services and Server Monitor

At the end of an installation on Windows platform, the NetMaster Server is installed


as a Windows service and a Server Monitor application is automatically started (look
). If you don't want the NetMaster Server to start automatically
for the systray icon
upon computer reboot, you can set the mode of the NetMaster Service to manual in
the Services applet in the Control Panel.
System Manager
The System Manager tool contains database related tasks and also general
NetMaster maintenance tasks intended to ease NetMaster configuration. After
closing the NetMaster Installer you will be prompted to start the System Manager to
complete the NetMaster configuration (this is only valid for Windows platform - for
Solaris platform, System Manager must be launched manually)
Log in using System Manager administrator user. System Manager will if needed
automatically launch the NetMaster Initial Setup wizard that will help you through the
necessary setup pages.
The initial authentication credentials for the System Manager administrator are:
User name: root
Password: pw
Note: It is strongly recommended to change the password of the root account as
soon as possible to prevent unauthorized access. To change the password, open the
System Manager Settings view.
See System Manager online help or PDF document on install media for more
information.
NetMaster Heap Size configuration
NetMaster is predefined with a Maximum Heap Size of 768 MB. However this
parameter should be tuned on servers where the number of managed network

40

NetMaster Installation
elements is expected to increase above 100. The maximum allowed heap size is
highly dependent on available memory on the server.
1. In the NetMaster System Manager: open the Settings menu and click
NetMaster Server
2. Change the default value for Maximum Heap Size to a new value. i.e. 1400.
3. Restart NetMaster Server
4. If the server:
a. fails to start: Repeat step 2, but use a lower value than the one
suggested.
b. starts successfully: Leave the server running or increase the value even
further till server start fails. Then use the last value it successfully
started with.
5. Server should now have an optimal Heap Size
Firewall settings
If connecting any remote GUI clients to the server, and the computers firewall is
enabled, it is necessary to configure the firewall to allow these ports to be opened:
Port
TCP port 1098
TCP port 1099
TCP port 8089
TCP port 3387
TCP port 4446

Description
Java RMI Activation Port. TCP port at which the activation system
(rmid) listens
Java RMI Registry Port.
NetMaster's report feature
JBoss EJB 3 socket based invoker layer
JBoss EJB3 remote method invocation

In order for NetMaster server to act as a FTP server the following ports must be
opened:
Port
TCP port 20
TCP port 21

Description
FTP - File Transfer [default data]
FTP - File Transfer [Control]

In order for the NetMaster server to receive traps from network elements, the
following port must be opened:
Port
UDP port 162,
or any other
user defined
port

Description
SNMP trap port.
Default port is 162, but can be set to a different port
in the Snmp Trap Port Number field in NetMaster
Server system manager view

If the SNMP agent is installed the following port must be open:


Port
UDP port 161

Description
SNMP get/set port

41

NetMaster Installation Guide

Ports to be opened at the machine where the Database is installed:


Port
Description
TCP Port 1521 Oracle Database server
TCP Port 5432 postgres SQL Database server
Ports to be opened at the machine where the System Manager is installed:
Port
TCP port 18005
TCP port 18010
TCP port 18080
TCP port 18443

Description
Shutdown port
AJP connector port
Connector port
Redirect port

Ports to be opened at the machine where Northbound SNMP manager is installed:


Port
UDP port 162

Description
Northbound SNMP Trap Port

For Windows Firewall, these ports to be opened this way:


1. Open the Windows Firewall in the Windows Control Panel
2. In the General tab, make sure that On (recommended) is selected and that
Dont allow exceptions is not checked.
3. In the Exceptions tab, click the Add Port button. Repeat for all ports to allow.
a. Type the name, i.e. NetMaster JNDI Port
b. Type the port number, i.e. 1098
c. Make sure that TCP is selected
d. If you want to limit the IP addresses that is allowed to connect using this
port, click the Change scope button:
i. Select Custom list and specify the IP-addresses of all GUI Client
computers, or
ii. Select My network (subnet) only to only allow GUI Clients within
your local subnet.
iii.
Click OK
e. Click OK
4. In the Advanced tab, make sure that the network connection your computer is
using is enabled (checked) in the Network Connection Settings list.
For other firewalls, different procedures may be required.

NetMaster GUI Client

42

NetMaster Installation
Start the NetMaster Client from the program shortcut folder selected during the
installation process. A Login window will be displayed where the authentication
credentials and the server host name must be entered.
The authentication credentials for the root administrator are:
User name: root
Password: pw
Note: It is strongly recommended to change the password of the root account
immediately after the first login to prevent unauthorized access. To change the
password, open the User Settings preferences menu.
See NetMaster Login dialog section for more information.
The next step is now to discover your network. See the How to discover and manage
an NE section for more information.

NetMaster license
In order to run NetMaster, it is necessary to have a license and this can be activated
with a file (sw-nms.key)
If this key file was not available when performing the installation the license can
easily be activated when you receive this from Customer Support. Unzip the .zip file
you received from Customer Support.
Use the System Manager or Server Monitor application to activate the license.
If you do not have a NetMaster license, contact us by making a Technical Support
request or contact your sales representative for an offer.
After the activation of the license, take note that this is only a temporary license and
that it is necessary to make a permanent license.

Database administrator user privileges


In order to be able to run the wizards that can be found in the Database Task view in
the NetMaster System Manager on an Oracle database, you need to create database
users with sufficient privileges to perform the tasks:

In order to do initial setup and create and delete user/schema, you need to
have a Database administrator user with similar privileges as a SYSTEM user.

In order to do set active and analyze user/schema, you need to have a


Database administrator user with at least CONNECT, RESOURCE, and
SELECT on SYS.USER$ privileges.

43

NetMaster Installation Guide

In order to do backup user/schema, you need to have a Database


administrator user with at least CONNECT, RESOURCE, SELECT on
SYS.USER$, SELECT on V_$INSTANCE privileges.

In order to do restore and reinitialize user/schema, you need to have


CONNECT, RESOURCE, SELECT on SYS.USER$, SELECT on
V_$INSTANCE , SELECT on V_$SESSION, SELECT on V_$TRANSACTION
and SELECT on V_$ROLLNAME privileges.

In order to upgrade user/schema, you need to have a Database administrator


user CONNECT, RESOURCE, SELECT on SYS.USER$, SELECT on
V_$SESSION, SELECT on V_$TRANSACTION and SELECT on
V_$ROLLNAME, SELECT on V_$PARAMETER, SELECT on V_$INSTANCE
privileges.

For an Oracle 11G Release 2 database, in order to do backup and restore


user/schema, the Database administrator user must have in addition CREATE
ANY DIRECTORY privileges.

Maintenance issues
NetMaster Server generates different log files. These files tend to grow large when
managing networks with many elements and heavy traffic.
Delete old server log files

Locate your NetMaster log file directory and remove all files older than three months:
Installation directory:
<NetMaster installation>\ Server\JBoss-4.2.3\server\NetMaster\log
Example for Windows:
C:\Program Files\NetMaster\Server\JBoss-4.2.3\server\NetMaster\log

Backup important files and folders

A full system recovery is likely to take less time if these files and folders are backed
up regularly:
1. License file for NetMaster:
<NetMaster installation>\Server\JBoss-4.2.3\server\NetMaster\license\*.key
2. Database server connection parameters and other settings (also copy sub
folders):
<NetMaster installation>\SystemManager\conf\*
3. Database backup files. Can be stored on user configurable folders. Default
folder for Windows is:
C:\NetMaster\Backup\Database

44

NetMaster Installation
4. NetMaster Client parameters for external applications. The local application
path for the external applications is stored on each respective windows user
profiles and NetMaster username on the NetMaster clients:
C:\Documents and Settings\<Windows user name>\.NetMaster\.<NetMaster
username>\.metadata\.plugins\org.eclipse.core.runtime\.settings\no.nera.netw
orks.ngnms.richclient.configuration.prefs

45

NetMaster Installation Guide

Database Installation
NetMaster Database
NetMaster requires an Oracle or PostgreSQL database to be installed and available
for NetMaster use. Installation guides for how to install Oracle and PostgreSQL on
Windows platform are provided.
Please note that NetMaster System Manager must be installed on the database
server. Installation of System Manager is only supported for Windows and Solaris
platform. Even though it might be possible to connect NetMaster to a database on a
unsupported platform, some essential features, like backup of database using
NetMaster System Manager, is not supported. We recommend using a system
supporting use of NetMaster System Manager, but if that is not possible, you should
set up backup routines for the database manually.
Database Availability Strategies

Different databases provide different availability strategies for failure and upgrade.
However some considerations are equal and independent of database solution.
General considerations:
1. Ensure that the backup is moved to another drive than where the
data/database is located. Ideally it should be copied directly to another
computer.
2. Always test your strategy. This implies taking a backup and performing a
restore.
3. What is acceptable down-time if a restore is needed?
4. What is maximum loss of data accepted if the database server crashes?
5. Ensure that required configuration and license files are covered by the backup
procedure.
Oracle Backup and Availability Introduction

Oracle provides two different backup strategies that are relevant if you cannot use
NetMaster System Manager:
1. Export / Import of database: Logical database backup, which includes full
table structure and data. Exports can be run on a nightly basis such that a
possible restore of the database will never lose data older than 24 hours. This
strategy is used by the standard backup/restore in NetMaster System
Manager.
2. Offline / Cold backups: Database is required to be shut down before taking a
full backup. This allows backup of all data, including log and control files. This
can be achieved by using RMAN.
PostgreSQL Backup and Availability Introduction

46

NetMaster Installation
PostgreSQL provides three different backup strategies that are relevant if you cannot
use NetMaster System Manager:
1. Export / Import of database: Logical database backup, which can include full
table structure and data. Exports can be run on a nightly basis such that a
restore of the database will never lose data older than 24 hours. This strategy
is used by the standard backup/restore in NetMaster System Manager.
2. Offline backup: Database is required to be shut down before taking a full
backup. This allows backup of all data and can be performed by copying the
actual data files.
3. Online backup: Requires that database is available and running WAL
archiving. With this option one can guarantee 24-hour data recoverability.
Please consult www.postgresql.org if you need more information about how to
install and/or configure PostgreSQL.

47

NetMaster Installation Guide

Oracle
How to Install Oracle
This section describes the installation steps for different editions of the Oracle
Database Server:
Installing Standard Edition One, Standard Edition and Enterprise Edition
Standard Edition One, Standard Edition and Enterprise Edition

This installation guide describes the steps of installing version 10g, 11g Release1
and 11g Release2 of the Oracle Database Server. Note that other versions of Oracle
may have a slightly different installation procedure, but the basic choices are the
same. The installation wizard contains a good Help function, thus the various options
will not be explained in detail in this guide.
Important: It is recommended to use fixed IP address on the computer running
Oracle Database Server. If you need to use DHCP, you have to do some additional
pre-installation steps:
If you plan to install Oracle Database Server and NetMaster Server on the
same computer and want to connect from remote NetMaster Clients, you must
use fixed IP address (DHCP will not work)
If you are using a separate computer for Oracle and NetMaster Server, you
can use DHCP on the Oracle computer, but only if you configure a Microsoft
Loopback Adapter on the computer before installing Oracle.
If you plan to install Oracle Database Server, NetMaster Server and NetMaster
Client on the same computer and will not use NetMaster Clients from other
computers, you can use DHCP on the computer, but only if you configure a
Microsoft Loopback Adapter on the computer before installing Oracle.
See section Installing on DHCP computers for more information.
See the following links on how to install Oracle 10G , how to install Oracle 11G
Release1 and how to install Oracle 11G Release2. If you want to upgrade your
Oracle version, please read Oracle Database Version Upgrade first.
Oracle 10G Installation Procedure
The installation Wizard will guide you through the installation. You may cancel the
installation at any step until the wizard starts installing the files.
The database server must have been configured with fixed IP before you proceed,
see subchapter about Installing a loopback adapter.
1. Insert the CD into the desired drive and run the Setup.exe file to launch the
installation wizard. For the Basic Installation, select the Installation Type, enter
the Global Database Name and password for the administrative user
accounts.
The Global Database Name must be a unique name in your LAN. A suggested
approach is to use a dot notation to compose a unique name from a local

48

NetMaster Installation
database name and the computer name. The local database name is called
System Identifier (SID). The name before the first . is then automatically
assigned as the SID name.
Note: The SID and password for the SYSTEM user must be used later in the
Oracle Connection Info step during the NetMaster Server installation, so you
really need to remember what you enter here. Press Next to continue. In
addition the password has become case sensitive as from Oracle 11G when
enhanced security settings are enabled.

2. Product-Specific Prerequisite Checks. Checks whether all hardware and


software requirements are met. If there are any problems reported you should
read the summary carefully. Note that there are some pre-install actions to
perform if you are using DHCP, the computer is not connected, or there are
multiple network connections installed.
Press Next to continue.

49

NetMaster Installation Guide

3. Summary. Displays a summary of the selections made above. Press Install to


continue.

50

NetMaster Installation

4. Installation. Displays the installation progress. Press Next to continue.

51

NetMaster Installation Guide

5. Configuration Assistant. Creates your database server instance and


configures it according to your selections above.

52

NetMaster Installation

53

NetMaster Installation Guide


The Password Management dialog lets you configure the default user accounts.
Since youve already provided a password for the administrator accounts you
dont need to do any changes here. Press OK to continue.

6. End of Installation. The installation is completed. Press Exit to close the


installer, and confirm in the message box that pops up.

54

NetMaster Installation

Oracle 11G Release 1 Installation Procedure


The installation Wizard will guide you through the installation. You may cancel the
installation at any step until the wizard starts installing the files.
The database server must have been configured with fixed IP before you proceed,
see subchapter about Installing a loopback adapter.
1. Insert the CD into the desired drive and run the Setup.exe file to launch the
installation wizard. For the Basic Installation, select the Installation Type, enter
the Global Database Name and password for the administrative user
accounts.

55

NetMaster Installation Guide


The Global Database Name must be a unique name in your LAN. A suggested
approach is to use a dot notation to compose a unique name from a local
database name and the computer name. The local database name is called
System Identifier (SID). The name before the first . is then automatically
assigned as the SID name.
Note: The SID and password for the SYSTEM user must be used later in the
Oracle Connection Info step during the NetMaster Server installation, so you
really need to remember what you enter here. Press Next to continue. In
addition the password has become case sensitive as from Oracle 11G when
enhanced security settings is enabled.

2. Product-Specific Prerequisite Checks. Checks whether all hardware and


software requirements are met. If there are any problems reported you should
read the summary carefully. Note that there are some pre-install actions to
perform if you are using DHCP, the computer is not connected, or there are
multiple network connections installed.
Press Next to continue.

56

NetMaster Installation

3. Oracle Configuration Manager Registration, click Next to continue.

57

NetMaster Installation Guide

4. Summary. Displays a summary of the selections made above. Press Install to


continue.

58

NetMaster Installation

5. Installation. Displays the installation progress. Press Next to continue.

59

NetMaster Installation Guide

6. Configuration Assistant. Creates your database server instance and


configures it according to your selections above.

60

NetMaster Installation

The Password Management dialog lets you configure the default user accounts.
Since youve already provided a password for the administrator accounts you
dont need to do any changes here. Press OK to continue.
61

NetMaster Installation Guide

7. End of Installation. The installation is completed. Press Exit to close the


installer, and confirm in the message box that pops up.

62

NetMaster Installation

Oracle 11G Release 2 Installation Procedure


The installation Wizard will guide you through the installation. You may cancel the
installation at any step until the wizard starts installing the files.
The database server must have been configured with fixed IP before you proceed,
see subchapter about Installing a loopback adapter.

First insert the CD into the desired drive and run the Setup.exe file to launch the
installation wizard.

1. Configure Security Updates. Select email information if desired.

63

NetMaster Installation Guide

Press Next to continue.


2. Installation Option. Select Create and configure a database.

64

NetMaster Installation

Press Next to continue.


3. System Class. Select according to the class of system hosting oracle
database.

Press Next to continue.


4. Grid Installation Options. Select according to the system hosting oracle
database

65

NetMaster Installation Guide

Press Next to continue.


5. Install Type. Select Advanced Install if you want additional configuration during
install.

66

NetMaster Installation

Press Next to continue.


6. Select the Database Edition and enter the Global Database Name and
password for the administrative user accounts.
The Global Database Name must be a unique name in your LAN. A suggested
approach is to use a dot notation to compose a unique name from a local
database name and the computer name. The local database name is called
System Identifier (SID). The name before the first . is then automatically
assigned as the SID name.
Note: The SID and password for the SYSTEM user must be used later in the
Oracle Connection Info step during the NetMaster Server installation, so you
really need to remember what you enter here. Press Next to continue. In
addition the password has become case sensitive as from Oracle 11G when
enhanced security settings is enabled.

67

NetMaster Installation Guide

Press Next to continue.

7. Prerequisite Checks. Checks whether all hardware and software requirements


are met. If there are any problems reported you should read the summary
carefully. Note that there are some pre-install actions to perform if you are
using DHCP, the computer is not connected, or there are multiple network
connections installed

68

NetMaster Installation

Wait for checks to complete.


8. Summary. Displays a summary of the selections made above. Please verify
settings and Database information, including SID

69

NetMaster Installation Guide

Press Finish to start installation.


9. Installation Product. Displays the installation progress.

70

NetMaster Installation

Wait for installation to complete.


10. Database Configuration Assistant. Creates your database server instance and
configures it according to your selections above

Wait for database creation to complete.


11. Database creation complete.
The Password Management dialog lets you configure the default user
accounts. Since youve already provided a password for the administrator
accounts you dont need to do any changes here.

71

NetMaster Installation Guide

Press OK to continue.
12. Finish Installation. The installation is completed.

72

NetMaster Installation

Press Close to exit the installer.

Prevent Oracle password expiry

Please be aware that Oracle 11G sets password expiry by default to 180 days. To
avoid that NetMaster server stops due to expired password, set password life time to
unlimited:
1. Log into i.e. SQLPLUS with SYSDBA priveligies. (sqlplus / as SYSDBA)
2. Run the sql commands below which will prevent that password will expire:
ALTER PROFILE DEFAULT LIMIT FAILED_LOGIN_ATTEMPTS UNLIMITED
PASSWORD_LIFE_TIME UNLIMITED;
commit;

Installing on DHCP computers

If installing Oracle Database onto a computer that uses the DHCP protocol or a
computer that is not connected to the network at installation time, it is necessary first
to install a loopback adapter and to assign a local IP address to that computer.
Installing a loopback adapter on Windows XP/Windows 2003

73

NetMaster Installation Guide


When installing a loopback adapter, the loopback adapter assigns a local IP for the
computer. After installing a loopback adapter on the computer, there are at least two
network adapters on the computer: the computer's own network adapter and the
loopback adapter. Oracle Database needs to have Windows using the loopback
adapter as the primary adapter.
The primary adapter is determined by the order in which the adapters are installed : it
is the last adapter installed. If installing additional network adapters after installing the
loopback adapter, it is necessary to uninstall the loopback adapter and reinstall it.
1.
2.
3.
4.

Open the Windows Control Panel.


Double-click Add Hardware to start the Add Hardware wizard.
In the Welcome window, click Next.
Is the hardware connected? window, select Yes, I have already connected the
hardware, and click Next.
5. If the following hardware is already installed on your computer window, in the
list of installed hardware, select Add a new hardware device, and click Next.
6. The wizard can help you install other hardware window, select Install the
hardware that I manually select from a list, and click Next.
7. From the list of hardware types, select the type of hardware you are installing
window, select Network adapters, and click Next.
8. In the Select Network Adapter window, make the following selections:
a. Manufacturer: Select Microsoft.
b. Network Adapter: Select Microsoft Loopback Adapter.
9. Click Next.
10. The wizard is ready to install your hardware window, click Next.
11. In the Completing the Add Hardware Wizard window, click Finish.
12. If using Windows 2003, restart the computer.
13. Right-click My Network Places on the desktop and choose Properties. This
displays the Network Connections Control Panel.
14. Right-click the connection that was just created. This is usually named "Local
Area Connection 2". Choose Properties.
15. On the General tab, select Internet Protocol (TCP/IP), and click Properties.
16. In the Properties dialog box, click Use the following IP address and do the
following:
a. IP Address: Enter a non-routable IP for the loopback adapter. Oracle
recommends the following non-routable addresses:
192.168.x.x (x is any value between 0 and 255)
10.10.10.10
b. Subnet mask: Enter 255.255.255.0.
c. Record the values entered, which will be need later in this procedure.
d. Leave all other fields empty.
e. Click OK.
17. Click OK.
18. Close Network Connections.
19. Restart the computer.
20. Add a line to the SYSTEM_DRIVE:\WINDOWS\system32\drivers\etc\hosts file
with the following format, after the localhost line:
IP_address hostname.domainname hostname

74

NetMaster Installation

where:
IP_address is the non-routable IP address you entered in step 16.
hostname is the name of the computer.
domainname is the name of the domain.
For example:
10.10.10.10 mycomputer.mydomain.com mycomputer
21. Check the network configuration:
a. Open System in the Control Panel, and select the Computer Name tab.
In Full computer name, make sure the host name and the domain name
is visible, for example, sales.us.mycompany.com.
b. Click Change. In Computer name, you should see the hostname, and in
Full computer name, you should see the host name and domain name.
Using the previous example, the host name would be sales and the
domain would be us.mycompany.com.
c. Click More. In Primary DNS suffix of this computer, you should see the
domain name, for example, us.mycompany.com.

Installing on multihomed computers

Oracle Database can be installed on a computer that is associated with multiple IP


addresses (typically achieved by having multiple network cards on the computer).
Each IP address is associated with a host name; additionally, aliases can be set up
for the host name. By default, Oracle Universal Installer uses the
ORACLE_HOSTNAME environment variable setting to find the host name. If
ORACLE_HOSTNAME is not set and you are installing on a computer that has
multiple network cards, Oracle Universal Installer determines the host name by using
the first name in the hosts file, typically located in
SYSTEM_DRIVE:\WINDOWS\system32\drivers\etc on Windows 2003 and Windows
XP, or SYSTEM_DRIVE:\WINNT\system32\drivers\etc on Windows 2000.
Clients must be able to access the computer using this host name, or using aliases
for this host name. To check, ping the host name from the client computers using the
short name (host name only) and the full name (host name and domain name). Both
must work.
Setting the ORACLE_HOSTNAME Environment Variable

To set the ORACLE_HOSTNAME environment variable:


1. Display System in the Windows Control Panel.
2. In the System Properties dialog box, click Advanced.
3. In the Advanced tab, click Environment Variables.
4. In the Environment Variables dialog box, under System Variables, click New.
5. In the New System Variable dialog box, enter the following information:
a. Variable name: ORACLE_HOSTNAME
b. Variable value: The host name of the computer that you want to use.
6. Click OK, then in the Environment Variables dialog box, click OK.
7. Click OK in the Environment Variables dialog box, then in the System
Properties dialog box, click OK.
Install NetMaster without Oracle SYSTEM credentials

75

NetMaster Installation Guide


A new NetMaster installation requires the user to enter database administration
username and password when installing. This procedure may however conflict with
an organisations security policy. In order to overcome this follow the steps below to
avoid using the database administration credentials during the NetMaster installation.
1. Create the oracle user manually by following the steps below:
a. Log into ie. SQLPLUS with SYSTEM privileges. (sqlplus
SYSTEM/password@sid)
b. Run the sql commands below which will create the NetMaster user:
CREATE USER NetMaster IDENTIFIED BY nmspassword ACCOUNT
UNLOCK;
GRANT UNLIMITED TABLESPACE TO NetMaster;
GRANT CONNECT TO NetMaster;
GRANT RESOURCE TO NetMaster;
commit;
2. Start the NetMaster installation
3. Reinitialize existing (overwrite): The installer will delete the content of the
existing database schema and reinitialize it.
4. Continue the installation.
Oracle Database Version Upgrade

This section describes how to upgrade from previous Oracle versions to a newer
Oracle version. Note that this is only one of several Oracle database upgrade
strategies.
This procedure applies to upgrade between these versions
Oracle 10g --> Oracle 11g Release 1
Oralce 10g --> Oracle 11g Release 2
Oracle 11g Release 1 --> Oracle 11G Release 2
Precondition:
Ensure that NetMaster Server already has been upgraded to the newest version
before running this procedure. Do NOT attempt to upgrade both Oracle database
version and NetMaster server version simultaneously, as this may cause an
inconsistent database.
1. Use System Manager to perform a backup of the database schemas/users to
keep.
2. Stop NetMaster Server if running
3. Uninstall current version of Oracle by running the Oracle installer and select to
uninstall all components.
Ensure to remove all Oracle application files in the Oracle installation folder.
(Restart of the server could be required for removing all files)
4. Install the new version of Oracle. (See Oracle installation procedure for Oracle
11g Release 1 or Oracle 11g Release 2)
5. Use System Manager to perform a restore of the previous database schemas
exported in step 1 in this upgrade guide.

76

NetMaster Installation
If the "Global Database Name" (SID), "system user name" or "password" was
changed during installation of new Oracle version, ensure to update database
connection parameters in the Restore Wizard step 2/4.
Ensure to use the "Select Database Path" button in the Restore Wizard step
4/4. This will update the "Database installation path" to the new Oracle
version.
6. Use System Manager to remove all scheduled backup tasks.
7. If the Global Database Name (SID), system user name or password was
changed during installation of new Oracle version, then use System Manager
to set the new User/Schema active.
Ensure to use the "Database connection parameters" created in step 5 in this
upgrade guide (the new "Database connection parameters", can now be found
by clicking the "Select Existing Parameters" button in the Set Active
User/Schema wizard).
8. Use System Manager to create new scheduled backup tasks as desired.

77

NetMaster Installation Guide

PostgreSQL
How to Install PostgreSQL
PostgreSQL is a powerful, open source relational database system. It has more than
15 years of active development and a proven architecture that has earned it a strong
reputation for reliability, data integrity, and correctness.
NetMaster is compatible with PostgreSQL version 9.1.3. PostgreSQL can be
downloaded free of charge from www.postgresql.org. For your convenience we have
embedded PostgreSQL version 9.1.3 Windows x64 as well as PostgreSQL
documentation on the NetMaster installation CD. You will find it in the PostgreSQL
directory.
The installer walkthrough chapter is an excerpt from
http://www.enterprisedb.com/resources-community/pginst-guide. Please consult
www.postgresql.org if you need more information about how to install and/or
configure PostgreSQL.

Note that you have to perform some post-installation steps to make PostgreSQL work
with NetMaster. Please see the PostgreSQL Post Installation chapter for more
information.
Installer walkthrough
The installer (postgresql-9.1.3-1-windows-x64) may be started from an Explorer
window simply by double-clicking it.
The PostgreSQL installer is based on Windows Installer, so it should be familiar to
most Windows users. Following is a quick walkthrough of the installer steps.
1. Introduction screen

Introduction message. Click Next to get started.

78

NetMaster Installation

2. Installation Directory

Select the installation directory. You can change the directory by selecting Browse to
pick the new directory. Click Next to continue.

79

NetMaster Installation Guide

3. Data Directory

Select the directory under which data will be stored. Note that the 'Data Directory'
option may only be installed on an NTFS partition. If you wish to install the data
directory on any other partition type, you will need to run initdb.exe manually after
installation.

80

NetMaster Installation

4. Password

Enter and confirm the password to be used for the superuser account (postgres) in
the database cluster. This password is also used for the service account and must
match the current password if the account already exists. You can change the
superuser password independently of the service account password at any time
following the installation.

81

NetMaster Installation Guide

Note: The Superuser name and password entered in this dialog must later be used
to access the PostgreSQL database when installing NetMaster and if accessing the
database through the PostgreSQL database administration tool pgAdmin III.
Note: If a dialog indicating that the "Administrator User Group" contains "Interactive
Users", remove the Interactive user from the Administrators group and add your user
to it instead. See further instructions below:
a. Open the windows user management window: Start | Control Panel | User
Accounts. Select the tab advance and furthermore click on Advanced button in the
middle of the dialog.
b. Select Groups and doubleclick on the Administrators group on the right side of the
dialog. Remove the NT AUTHORITY\INTERACTIVE user from Administrators group
and add the current user to the same group.
c. Continue the installation with PostgreSQL
5. Port

Select the port that the server will listen on. You may specify a non-default port
number to run the server on (If you change the default port, please make a note of it,
as you will need it while installing the NetMaster server)
If you plan to run NetMaster server and the PostgreSQL server on separate
machines, you will also need to enable access in the host based authentication
configuration (pg_hba.conf) to allow remote users to connect to the server. This is
covered in the chapter on PostgreSQL Post Installation.

82

NetMaster Installation

6. Advanced Options

Choose the locale that the cluster will be initialized with. By default the locale is
selected as "default locale", from the drop down select "C".
This will initialize the database with ISO C locale and UTF-8 encoding.

83

NetMaster Installation Guide

7. Ready to install

Click Next to start the actual installation.

84

NetMaster Installation

8. Installing

A progress bar is shown during the installation.


On some versions of Windows (notably Windows XP before Service Pack 2 and
Windows 2003 before Service Pack 1 - see Microsoft Knowledge Base article
Q818858) a Command Prompt window will appear during the "Initializing database
cluster" step. Don't close this window - it will automatically close once the operation is
complete.

85

NetMaster Installation Guide

9. Finished

Unselect the option Launch Stack Builder at exit .Installation is complete. You can
now go ahead and test your installation.

86

NetMaster Installation

PostgreSQL post installation


After installation of PostgreSQL you will have to make some changes in parameter
settings to make it work optimal with NetMaster.

1. Start the pgAdmin tool. You will find it in Start | All programs | PostgreSQL 9.1
| pgAdmin III. Connect to your PostgreSQL database server.

87

NetMaster Installation Guide

2. Expand the following in the left window: PostgreSQL Database Server ->
Databases -> Postgres.

3. Choose Tools | Server Configuration | postgresql.conf. Locate setting name


max_prepared_transactions, double-click on it and change its value to 150 (or
to a value that is equal to or higher than the max_connections setting listed in
Table 1 below). Also select the Enabled check box. Press OK.

88

NetMaster Installation

The table below contains required minimum values for running NetMaster with
PostgreSQL:
Parameter name
Required Default
100
max_prepared_transactions 150
100
max_connections
150
16MB
maintenance_work_mem
32MB
32MB
shared_buffers
64MB
8MB
temp_buffers
16MB
1MB
work_mem
4MB
3
checkpoint_segments
12

4. In the pgAdmin tool choose File | Save.

6. If you plan to install the NetMaster server on a different server than the
PostgreSQL server, you have to enable access in the host based
authentication configuration.

Choose Tools | Server configuration | pg_hba.conf. Add an entry with IPaddress and subnet mask of the client that shall be allowed access to the
database server.

89

NetMaster Installation Guide

More details on this is given in the PostgreSQL online help.

7. In the pgAdmin tool choose File | Save.

8. To make the change take effect the PostgreSQL server will have to reload the
configuration files. From the Windows Start menu choose All Programs |
PostgreSQL 9.1 | Reload Configuration. In the displayed command window
press Return.
NOTE: If the configured changes do not take effect modify the (Postgres
installation dir)/data/pg_hba.conf manually.

PostgreSQL database upgrade (version 8.3 - 9.1)


This section describes how to upgrade from previous PostgreSQL versions to
PostgreSQL 9.1.3.
Procedure for migrating to a newer database version

1. Stop NetMaster Server


2. Upgrade NetMaster Server and NetMaster System Manager to latest release
3. Cancel wizard for upgrading database after upgrading NetMaster and System
Manager.
4. Perform a backup of current PostgreSQL database by starting the Backup
Active User/Schema wizard from the Administration | Database Tasks view in
System Manager.
5. Uninstall current version of PostgreSQL. Start ? Control Panel ? Add Remove
Programs. Select PostgreSQL 8.3 and click Remove. Follow the instructions.
6. If the directory C:\Program Files\PostgreSQL\8.3 still exists, it can now be
removed, since it is not in use anymore
7. Install PostgreSQL 9.1. See the Installer walkthrough. Remember to do the
post installation steps for PostgreSQL as described in the PostgreSQL Post
Installation chapter

90

NetMaster Installation
8. Perform a database restore on the PostgreSQL database by starting the
Restore Active User/Schema wizard from the Administration | Database Tasks
view in System Manager.
NOTE: Use same user/schema parameters as in original database export and
update Database install Path according to new PostgreSQL installation.
9. Upgrade database by starting the Upgrade User/Schema wizard from the
Administration->Database Tasks view in System Manager.
10. Start NetMaster Server
Postconditional state:
- NetMaster server should be upgraded to latest release and running on PostgreSQL
9.1.

PostgreSQL license

PostgreSQL is released under the PostgreSQL License, a liberal Open Source


license, similar to the BSD or MIT licenses.
PostgreSQL Database Management System
(formerly known as Postgres, then as Postgres95)
Portions Copyright (c) 1996-2012, The PostgreSQL Global Development Group
Portions Copyright (c) 1994, The Regents of the University of California
Permission to use, copy, modify, and distribute this software and its documentation
for any purpose, without fee, and without a written agreement is hereby granted,
provided that the above copyright notice and this paragraph and the following two
paragraphs appear in all copies.
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY
PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS
SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE
UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE
MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

91

NetMaster Installation Guide

External Documents
System Requirements
System requirements for NetMaster are described in the document NetMaster
System Requirements.pdf.

92

NetMaster Installation

Technical Description
For information about NetMaster architecture see the document NetMaster Technical
Description.pdf.

93