Documente Academic
Documente Profesional
Documente Cultură
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 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
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
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
New installation
NetMaster Installation
The Installer is preparing to start:
1. The Introduction step displays some general information about the installation
process
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
NetMaster Installation
10
NetMaster Installation
8. Installing step
Watch the product features being presented during the installation progress.
11
12
NetMaster Installation
13
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.
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
16
NetMaster Installation
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.
17
18
NetMaster Installation
19
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
22
NetMaster Installation
23
24
NetMaster Installation
25
26
NetMaster Installation
Configuration
If you open System Manager on the database server the following information is
shown:
27
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
30
NetMaster Installation
Press Yes to confirm NetMaster removal.
3. NetMaster is now uninstalled:
31
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
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
Explanation
NetMaster Server, SNMP Agent and System Manager.
System Manager only, intended for stand-alone database
server installation.
Custom
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
STIME
FMRI
35
10:48:42 svc:/application/netmaster:default
10:48:44 svc:/application/nifservice:default
10:48:51 svc:/application/sysman:default
36
NetMaster Installation
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
38
NetMaster Installation
39
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
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
Description
SNMP get/set port
41
Description
Shutdown port
AJP connector port
Connector port
Redirect port
Description
Northbound SNMP Trap Port
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.
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.
43
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
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
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
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.
49
50
NetMaster Installation
51
52
NetMaster Installation
53
54
NetMaster Installation
55
56
NetMaster Installation
57
58
NetMaster Installation
59
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
62
NetMaster Installation
First insert the CD into the desired drive and run the Setup.exe file to launch the
installation wizard.
63
64
NetMaster Installation
65
66
NetMaster Installation
67
68
NetMaster Installation
69
70
NetMaster Installation
71
Press OK to continue.
12. Finish Installation. The installation is completed.
72
NetMaster Installation
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;
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
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.
75
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
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
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
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
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
7. Ready to install
84
NetMaster Installation
8. Installing
85
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
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
2. Expand the following in the left window: PostgreSQL Database Server ->
Databases -> Postgres.
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
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
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.
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
91
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