Академический Документы
Профессиональный Документы
Культура Документы
Table Of Contents
Version.................................................................................................................... 1
Copyright ......................................................................................................... 1
NetMaster System Manager ................................................................................... 2
System Manager Logon ...................................................................................... 2
System Manager GUI Components Overview..................................................... 3
Available System Manager views and wizards ................................................ 6
General menu ......................................................................................................... 9
Dashboard View .................................................................................................. 9
Administration menu ............................................................................................. 13
Database Task View.......................................................................................... 13
Database Configurations View .......................................................................... 15
Database Analysis View .................................................................................... 19
NetMaster Initial Setup Wizard .......................................................................... 21
Set Active User/Schema Wizard ....................................................................... 40
Create User/Schema Wizard............................................................................. 47
Reinitialize User/Schema Wizard ...................................................................... 53
Delete User/Schema Wizard ............................................................................. 60
Upgrade User/Schema Wizard.......................................................................... 67
Backup Active User/Schema Wizard ................................................................. 83
Backup User/Schema Wizard............................................................................ 90
Restore User/Schema Wizard ..........................................................................100
Analyze User/Schema Wizard..........................................................................109
License menu.......................................................................................................116
License Administration View.............................................................................116
Import License Wizard......................................................................................118
Settings menu ......................................................................................................122
NetMaster Server View.....................................................................................122
System Manager View......................................................................................125
Email Notification View .....................................................................................126
Database View .................................................................................................129
Other menu ..........................................................................................................133
Task Log View..................................................................................................133
NetMaster Log View .........................................................................................136
Scheduled Tasks View .....................................................................................138
System Manager maintenance ............................................................................140
System Manager maintenance.........................................................................140
Periodic backup cleanup...............................................................................140
Internal cleanup job.......................................................................................140
Log files ........................................................................................................140
System Manager troubleshooting .....................................................................142
Logon window does not appear ....................................................................142
Multiple browser sessions.............................................................................142
System Manager not available......................................................................143
Memory problem ...........................................................................................143
License import problem.................................................................................144
iii
System Manager
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.
System Manager
There are 3 buttons available in the toolbar area at the top left hand corner:
Menu area
The System Manager menu can be exploded and collapsed. Default is collapsed.
System Manager
Collapsed
Partly Collapsed
Exploded
Click on any menu item to open the corresponding view in the main area.
The views are listed in the Available System Manager views section below.
Main area
The System Manager main area is where the different views are displayed. The
default view (which cannot be closed) is the Dashboard. The individual views are
explained in separate pages.
Several views may be open at the same time, but only one view will be visible in the
main area at the time. Click a view tab to make this view visible in the main area.
Example below shows the Scheduled Tasks view. Five open but hidden views are
represented as tabs. Click on any of these tabs to show the associated view.
If you click on a menu item that already is open (but not shown) in the main area, the
existing view will be shown. It is not possible to open several occurrences of the
same view.
The System Manager status bar is always visible in the bottom right hand corner:
Explanation
NetMaster server is started.
NetMaster server is starting or
stopping.
NetMaster server is stopped.
Explanation
Default view in System Manager. This view cannot be closed.
It is designed to give a quick overview of:
Administratrion
Views
Database Tasks
Explanation
A collection of database related wizards to help you set up
and maintain your NetMaster database:
System Manager
Database
Configurations
Database
Analysis
License Views
License
Administration
Explanation
Shows overview of current imported NetMaster license, with
option to run the Import License wizard to import a new
license into NetMaster.
Settings Views
NetMaster
Server
Explanation
NetMaster server related settings. Allows you to:
System Manager
Email
Notification
Database
Others Views
Task Log
Explanation
Shows the list of all Task Logs, with options to refresh list and
inspect Task Log details.
NetMaster Log
Shows the list of all NetMaster server log entries, with options
to refresh list, archive and delete logs.
Scheduled Tasks
System Manager
General menu
Dashboard View
The Dasboard view is designed to give a quick overview of:
This view is always opened when you log into System Manager. The view cannot be
closed from the main area. If it gets hidden by other views and you want to show it
again, you can either:
There are three distinct GUI areas and two links as described below.
NetMaster Server Monitoring area
To ensure that correct status is shown, the current server status is checked every
10th second.
Depending on this status the Start, Stop and Restart NetMaster server buttons may
be disabled.
Change
NetMaster Status
10
Explanation
System Manager
Start NetMaster server. Disabled if server is running.
Stop NetMaster server. Disabled if server is stopped.
Restart NetMaster server. Disabled if server is stopped.
Press
Press
Press
11
There is a direct link open Task Log view to see the full list of task logs:
There is a direct link to open Scheduled Tasks view to see the full list of scheduled
tasks:
12
System Manager
Administration menu
Database Task View
Database Task view consists of a collection of database related wizards to help you
set up and maintain your NetMaster database.
To open this view you can either:
13
Click on any of the links below to open the corresponding wizard help page.
14
System Manager
Use the check box column to select the configurations to be target for operations.
Operation
Explanation
Add a new configuration. Always enabled.
Edit selected configuration. Enabled when exactly one configuration is
selected.
Only the configuration description can be edited for the active
configuration.
Clone selected configuration. Enabled when exactly one configuration
is selected.
Delete selected configuration. Enabled when one or more configurations
are selected.
15
Field explanations:
Name
16
Explanation
System Manager
Description
Database instance
name
Database type
Database server
address
Database server
port
Database
administrator user:
Name
Database
administrator user:
Password
NetMaster
user/schema:
Name
NetMaster
user/schema:
Password
If for instance the NetMaster user/schema password is wrong, you may get the
following dialog:
17
Delete a configuration
If one or more non-active database configurations are selected, you can attempt to
delete them:
18
System Manager
Database Analysis view contains a toolbar, a file list, a link to launch the Analyze
User/Shcema wizard and a file content display area.
Explanation
19
The Database Analysis file list shows all analysis report files:
Report analysis file location is decided on last page of the Analyze User/Schema
wizard.
Click on the Database Analysis link to open the Analyze User/Schema wizard:
The area below the analysis report file list is used to display the selected analysis
report content.
A successful Database Consistency Tests after Upgrade report:
20
System Manager
If System Manager detects that no active NetMaster database has been set, or that
the detected database is of an older version and needs to be updated, the NetMaster
Initial Setup Wizard will start automatically.
21
NetMaster requires a valid license. A new license file is required for all major
NetMaster releases.
22
System Manager
Type in the path and license file name or press Browse to locate your license file:
23
Select the license file and press Open, then press the Import button to import the
license into NetMaster:
You may have to copy the license file to a local disk for the import action to work.
Press Next to continue the NetMaster Initial Setup wizard.
24
System Manager
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to create the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to do the initial setup, you need to have a Database
administrator user with sufficient privileges.
Press Next to continue the NetMaster Initial Setup wizard.
25
Explanation
Name of your NetMaster user/schema.
Password for your NetMaster user/schema.
Confirm the password. This field is hidden when connecting to
an existing NetMaster database.
26
System Manager
It is recommended to back up the NetMaster database at regular intervals. You can
set up periodic backup using System Manager.
The Backup before upgrade section is shown only when the selected NetMaster
database requires upgrade from an older version. The backup is placed in the
location specified in the Database view available from the Settings menu. The default
location is C:\NetMaster\Backup\Database.
The Database Install Path is the database server path to the tools System Manger
needs to run backup and restore operations. The tools in question are exp.exe and
imp.exe for Oracle and pg_dump and pg_restore for Postgres.
Press the Select Database Path to allow System Manager to try to find the Database
Install Path automatically:
27
If System Manager fails to locate the correct path for you, you have to supply the
correct path yourself.
You can check the Skip schedule backup check box if you don't want to set up
periodic backup. You can schedule periodic backup later if desired by using the
Backup Active User/Schema or Backup User/Schema wizards.
To initiate periodic backup, leave the Skip schedule backup check box unchecked
and adjust the start time and backup interval as desired. Be aware that in a 2+0
configuration (NetMaster server and NetMaster database on separate machines) the
backup files will be stored on both servers. The backup files are zipped to reduce
disk space consumption, but you should make sure to select a file system with
enough free disk space to hold the backup files.
It is possible to change the backup file storage location on the NetMaster server. It is
also possible to configure number of days to keep the scheduled database backups.
Both settings are found in the Database settings in System Manager.
If periodic backup is enabled, it is recommended to also enable deletion of old
backup files to prevent the file system from filling up. Note that the deletion of old
backup files in a 2+0 configuration is performed on the database server as well as on
the NetMaster server.
A database backup will be performed prior to database upgrade unless the Skip
backup before upgrade check box is checked.
When the settings are configured as desired, press Next to continue the NetMaster
Initial Setup wizard.
28
System Manager
If System Manager on the database server is not compatible with the System
Manager on the NetMaster server, the backup will be aborted with an error message.
If so, you should upgrade the outdated System Manager, and then rerun the
NetMaster Initial Setup wizard.
Initial Setup Wizard page 6 : Email Parameters
In order to make use of the email notification feature, you need an SMTP server in
your network.
If you don't want to make use of the email notification feature, you can check the Skip
email notification setup check box.
If you want email notification, you need to fill in the following settings:
29
Name
Mail Server
Address
Mail Server
Port
From Address
To Address
Username
Password
Explanation
IP address or hostname to your SMTP server.
SMTP port on your mail server. Default is 25.
The email address that will appear as the email sender.
Be aware that no validation is performed whether this is a real email
address or not.
Email recipient. May be a list of email addresses, separated by comma
or semicolon.
Username for Mail Server Authentication.
Password for Mail Server Authentication.
Press the Send Test Email button to send a test email to verify that the email
notification settings are correct.
Press Next to continue the NetMaster Initial Setup wizard.
Initial Setup Wizard page 7 : NetMaster Initial Setup
30
System Manager
31
Uncheck the Start NetMaster Server check box if you don't want to start the
NetMaster server.
Press Close to complete the NetMaster Initial Setup wizard.
Error situations and recovery - Backup before upgrade fails
32
System Manager
33
Make sure to take a backup of your database manually, then press Setup to continue
upgrade.
Error situations and recovery - Upgrade of database failed
If upgrade process completes with failure, the following page is displayed, giving the
option to restore the possible corrupt database:
34
System Manager
Check the Error detail report to see what caused the upgrade to fail.
An upgrade failure may leave your database in a corrupt state. It is recommended to
restore it to a consistent state. Press the Select Backup File button to select an
existing database backup. If a backup before upgrade was requested and was
successfully performed, it should appear as the newest entry in the backup list:
35
Select a backup file and press OK to return to the NetMaster Initial Setup wizard
page.
Press Restore button to restore the selected database backup:
36
System Manager
If the restore fails as well, you may cancel the wizard or retry the restore operation:
37
38
System Manager
39
Specify the database connection parameters for the NetMaster database you want to
set active.
40
System Manager
41
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user. Saved for later use.
Password for the database system user.
Please notice that in order to set active, you need to have a Database administrator
user with sufficient privileges.
Press Next to continue the Set Active User/Schema wizard.
Specify the Oracle user or Postgres schema you want to set as active NetMaster
database configuration.
42
System Manager
43
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
44
System Manager
When the set active process is complete, the following page is displayed:
45
Uncheck the Start NetMaster Server check box if you don't want to start the
NetMaster server.
Press Close to complete the Set Active User/Schema wizard.
46
System Manager
47
48
System Manager
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to create the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to create, you need to have a Database administrator user
with sufficient privileges.
Press Next to continue the Create User/Schema wizard.
Specify the new Oracle user or Postgres schema name to be created and prepared
for NetMaster use:
49
Explanation
Name of new NetMaster user/schema
Password for the new NetMaster user/schema
Confirm the password
50
System Manager
51
52
System Manager
Specify the database connection parameters for the NetMaster database you want to
reinitialize.
53
54
System Manager
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to reinitialize the NetMaster
user/schema.
Password for the database system user.
.
Press Next to continue the Reinitialize User/Schema wizard.
55
56
System Manager
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
57
58
System Manager
Uncheck the Start NetMaster Server check box if you don't want to start the
NetMaster server.
Press Close to complete the Reinitialize User/Schema wizard.
59
Specify the database connection parameters for the NetMaster database you want to
delete.
60
System Manager
61
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to delete the NetMaster
user/schema.
Password for the database system user.
62
System Manager
63
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
64
System Manager
65
66
System Manager
Specify the database connection parameters for the NetMaster database you want to
upgrade.
67
68
System Manager
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to upgrade the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to upgrade, you need to have a Database administrator
user with sufficient privileges.
Press Next to continue the Upgrade User/Schema wizard.
69
70
System Manager
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
71
The Database Install Path is the database server path to the tools System Manger
needs to run to perform backup and restore operations. The tools in question are
exp.exe and imp.exe for Oracle and pg_dump and pg_restore for Postgres.
Press the Select Database Path to allow System Manager to try to find the Database
Install Path automatically:
72
System Manager
If System Manager fails to locate the correct path for you, you have to supply the
correct path yourself.
You can check the Skip schedule backup check box if you don't want to set up
periodic backup. You can schedule periodic backup later if desired by using the
Backup Active User/Schema or Backup User/Schema wizards.
To initiate periodic backup, leave the Skip schedule backup check box unchecked
and adjust the start time and backup interval as desired. Be aware that in a 2+0
configuration (NetMaster server and NetMaster database on separate machines) the
backup files will be stored on both servers. The backup files are zipped to reduce
disk space consumption, but you should make sure to select a file system with
enough free disk space to hold the backup files.
It is possible to change the backup file storage location on the NetMaster server. It is
also possible to configure number of days to keep the scheduled database backups.
Both settings are found in the Database settings in System Manager.
If periodic backup is enabled, it is recommended to also enable deletion of old
backup files to prevent the file system from filling up. Note that the deletion of old
backup files in a 2+0 configuration is performed on the database server as well as on
the NetMaster server.
A database backup will be performed prior to database upgrade unless the Skip
backup before upgrade check box is checked. The backup is placed in the location
specified in the Database view available from the Settings menu. The default location
is C:\NetMaster\Backup\Database.
73
If the upgrade process completes with success, the following page is displayed:
74
System Manager
75
76
System Manager
Make sure to take a backup of your database manually, then press Upgrade to
continue upgrade.
Error situations and recovery - Upgrade of database failed
If upgrade process completes with failure, the following page is displayed, giving the
option to restore the possible corrupt database:
77
Check the Error detail report to see what caused the upgrade to fail. An upgrade
failure may leave your database in a corrupt state. It is recommended to restore it to
a consistent state.
Press the Select Backup File button to select an existing database backup. If a
backup before upgrade was requested and was successfully performed, it should
appear as the newest entry in the backup list:
78
System Manager
Select a backup file and press OK to return to the Upgrade User/Schema wizard
page.
Press Restore button to restore the selected database backup:
79
If the restore fails as well, you may cancel the wizard or retry a restore operation:
80
System Manager
81
82
System Manager
83
84
System Manager
The Database Install Path is the database server path to the tools System Manger
needs to run backup and restore operations. The tools in question are exp.exe and
imp.exe for Oracle and pg_dump and pg_restore for Postgres.
If the Database Install Path is empty, press the Select Database Path to allow
System Manager to try to find the Database Install Path automatically:
85
If System Manager fails to locate the correct path for you, you have to supply the
correct path yourself.
Be aware that in a 2+0 configuration (NetMaster server and NetMaster database on
separate machines), backup files are stored on both servers. The backup files are
zipped to reduce disk space consumption, but you should make sure to select a file
system with enough free disk space to hold the backup files.
It is possible to change the backup file storage location on the NetMaster server. It is
also possible to configure System Manager to delete backups older than a given
number of days. If enabled, all backup files created by periodic backup jobs will be
targeted for deletion. In a 2+0 configuration old backup files are deleted on the
database server as well as on the NetMaster server. The storage location and old
backup files deletion settings are found in the Database settings in System Manager.
You can select either to take a backup right now, or to initiate periodic backup on the
active NetMaster database.
Take a backup now
Leave the Scheduled backup check box unchecked. If this is checked, System
Manager will initiate periodic backup.
Check the Keep this backup check box if you want this backup to be ignored by the
old backup files deletion job.
Press Backup Active to initiate the backup process causing the following page to
appear:
86
System Manager
To initiate periodic backup, check the Schedule backup check box and adjust the
start time and backup interval as desired. If you specify a start time in the past, the
periodic backup is scheduled and the first periodic backup is taken immediately.
If you enable periodic backup, it is recommended to also enable deletion of old
backup files to prevent the file system from filling up.
Press Schedule to schedule the periodic backup on selected NetMaster database:
87
88
System Manager
89
Specify the database connection parameters for the NetMaster database you want to
backup.
90
System Manager
91
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to backup the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to do backup, you need to have a Database administrator
user with sufficient privileges.
Press Next to continue the Backup User/Schema wizard.
92
System Manager
93
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
94
System Manager
The Database Install Path is the database server path to the tools System Manger
needs to run backup and restore operations. The tools in question are exp.exe and
imp.exe for Oracle and pg_dump and pg_restore for Postgres.
If the Database Install Path is empty, press the Select Database Path to allow
System Manager to try to find the Database Install Path automatically:
95
If System Manager fails to locate the correct path for you, you have to supply the
correct path yourself.
Be aware that in a 2+0 configuration (NetMaster server and NetMaster database on
separate machines), backup files are stored on both servers. The backup files are
zipped to reduce disk space consumption, but you should make sure to select a file
system with enough free disk space to hold the backup files.
It is possible to change the backup file storage location on the NetMaster server. It is
also possible to configure System Manager to delete backups older than a given
number of days. If enabled, all backup files created by periodic backup jobs will be
targeted for deletion. In a 2+0 configuration old backup files are deleted on the
database server as well as on the NetMaster server. The storage location and old
backup files deletion settings are found in the Database settings in System Manager.
You can select either to take a backup right now, or to initiate periodic backup on the
selected user/schema.
If System Manager on the database server is not compatible with the System
Manager on the NetMaster server, the backup will be aborted with an error message.
If so, you should upgrade the outdated System Manager, and then rerun the Backup
User/Schema wizard.
Take a backup now
Leave the Scheduled backup check box unchecked. If this is checked, System
Manager will initiate periodic backup.
96
System Manager
Check the Keep this backup check box if you want this backup to be ignored by the
old backup files deletion job.
Press Backup to initiate the backup process causing the following page to appear:
To initiate periodic backup, check the Schedule backup check box and adjust the
start time and backup interval as desired. If you specify a start time in the past, the
periodic backup is scheduled and the first periodic backup is taken immediately.
If you enable periodic backup, it is recommended to also enable deletion of old
backup files to prevent the file system from filling up.
Press Schedule to schedule the periodic backup on selected NetMaster database:
97
98
System Manager
99
Specify the database connection parameters for the NetMaster database you want to
restore.
100
System Manager
101
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to restore the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to do restore, you need to have a Database administrator
user with sufficient privileges.
Press Next to continue the Restore User/Schema wizard.
102
System Manager
103
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
104
System Manager
Press the Select Backup File button to select an existing database backup.
105
Select a backup file and press OK to return to the Restore User/Schema wizard
page.
The Database Install Path is the database server path to the tools System Manger
needs to run backup and restore operations. The tools in question are exp.exe and
imp.exe for Oracle and pg_dump and pg_restore for Postgres.
If the Database Install Path is empty, press the Select Database Path to allow
System Manager to try to find the Database Install Path automatically:
106
System Manager
If System Manager fails to locate the correct path for you, you have to supply the
correct path yourself.
Check the Confirm to restore the active NetMaster user/schema check box to confirm
that you want to proceed with the operation.
Press Restore to initiate the restore operation. If NetMaster server is started, it will be
stopped.
If System Manager on the database server is not compatible with the System
Manager on the NetMaster server, the backup will be aborted with an error message.
If so, you should upgrade the outdated System Manager, and then rerun the Restore
User/Schema wizard.
The following page appears after a successful restore operation:
107
Uncheck the Start NetMaster Server check box if you don't want to start the
NetMaster server.
Press Close to complete the Restore User/Schema wizard.
108
System Manager
Specify the database connection parameters for the NetMaster database you want to
analyze.
109
110
System Manager
If the desired parameters are not present in the list, you need to fill in the parameters
manually.
All parameters are mandatory:
Name
Database
instance name
Database type
Database
server address
Database
server port
Username
Password
Explanation
Name of a database instance.
Either Oracle or Postgres.
IP address or hostname for the database server. Use localhost
for a 1+0 configuration.
Tcp port for the database. Default 1521 for Oracle, 5432 for
Postgres.
The database system user needed to analyze the NetMaster
user/schema.
Password for the database system user.
Please notice that in order to analyze, you need to have a Database administrator
user with sufficient privileges.
Press Next to continue the Analyze User/Schema wizard.
111
112
System Manager
If the desired parameters are not present in the list, you have to fill in the parameters
manually.
Both parameters are mandatory:
Name
Username
Password
Explanation
Name of desired NetMaster user/schema
Password for the desired NetMaster user/schema
113
Name
Report analysis
location
Explanation
Where to put the analysis reports.
Default location:
C:\NetMaster\SystemManager\log\dbAnalysis
Categories
Press Analyze to initiate the analyze process causing the following page to appear:
114
System Manager
115
License menu
License Administration View
Shows overview of current imported NetMaster license, with option to run the Import
License Wizard to import a new license into NetMaster.
To open this view you can either:
License Administration view contains a link to launch the Import License wizard and a
license content display area.
116
System Manager
Click on the Import License link to open the Import License wizard.
To be able to generate valid license files, Customer Support needs the activation key.
This information is therefore available in a copy and paste friendly area at the bottom
of the License Administration view.
The Activation key in the License Info dialogue is generated from the MAC-address
of one of the enabled network cards on the NetMaster server. In order to be
absolutely certain of which network card the license is bound to it is recommended to
disable all network cards except one. When the License is activated with this
Activation key, the license will be locked to this network card. If the network card later
is disabled the NetMaster server will stop with a violation lock error message.
117
The first page shown is the introduction giving an overview of the wizard steps:
NetMaster requires a valid license. A new license file is required for all major
NetMaster releases.
Press Browse to locate your license file:
118
System Manager
Select the license file and press Open, then press the Import button to import the
license into NetMaster:
119
You may have to copy the license file to a local disk for the import action to work.
Press Next to continue the Import License wizard.
Import License Wizard page 3 : Import License
120
System Manager
Uncheck the Restart NetMaster Server check box if you don't want to restart the
NetMaster server.
Press Close to complete the Import License wizard.
121
Settings menu
NetMaster Server View
This view contains NetMaster server related settings that allows you to:
NetMaster Server view contains scalability parameters, Snmp Trap Port Number, a
check box for email notification configuration and a button for resetting the NetMaster
server root password:
System Manager
Input Fields
Maximum
Connection
Pool Size
Maximum
Thread Pool
Size
Maximum
Heap Size
Snmp Trap
Port Number
Explanation
Specifies the maximum number of physical connections that
can be created in the pool. Increase this parameter to allow for
greater concurrency.
Maximum Connection Pool Size can not be larger than
available connections configured in database. For Oracle
database, consider increasing the PROCESSES parameter.
For PostgrSQL database, consider increasing the
max_connections and max_prepared_transactions parameters.
Maximum Connection Pool Size can not be less than 150. The
default value is set to 150
The application uses thread pools to manage concurrent tasks.
Maximum Thread Pool Size must be at least 100 and can not
be larger than 90% of Maximum Connection Pool Size. The
default value is set to 100. For Windows machines, the value
can not be larger than 250, and for Solaris machines, the value
can not be greater than 5000. It is also recommended that
Maximum Thread Pool Size to be at least 10% of the number
of elements in managed state.
Increase this parameter when the application needs a lot of
memory.
Maximum Heap Size must be at least 512 MB. For Windows
machines, the value can not be greater than 1300 MB. The
default value is set to 512MB. It is also recommended that
Maximum Heap Size to be at least 300 MB + 0,5 MB x the
number of elements in managed state and not more than 50%
of available physical memory.
The port that NetMaster listens to for incoming element traps.
The trap port must be available for NetMaster on the system
where NetMaster is running.
Default trap port is 162. One reason to change the port number
can be to avoid port conflicts caused by other SNMP
monitoring tools that are running in parallel with NetMaster on
the same server.
If you need to change the port number you will have to
configure your elements to send traps on the new trap port. For
Evolution type elements, this can be done by enabling Trap
Receiver Management in the Connection Templates view.
Send
Before changing this value, please make sure that all your
different element types managed by NetMaster can be
configured to use the new trap port number.
Check the check box to enable email notification when
123
Operation
Explanation
Revert to default (check box not
checked)
Make current check box state
active
Cancel check box change
Press the Reset NetMaster root user password button to reset the root password for
the active NetMaster database.
This dialogue should then appear:
124
System Manager
This is where you can change the System Manager root user password:
Input Fields
Old password
New
password
Confirm
password
Explanation
Old password. Default is "pw".
New password. Must be at least 2 characters and can only
consist of:
a-z, A-Z, 0-9, @, -, _, #, ., and $.
Type new password once more to prevent accidental typos.
Press Save button to change password or press Cancel button to cancel the
changes.
125
Email Notification view contains input fields for email notification configuration:
126
System Manager
If you want email notification, you need to fill in the following settings:
Name
Mail Server
Address
Mail Server
Port
From Address
To Address
Username
Password
Explanation
IP address or hostname to your SMTP server.
SMTP port on your mail server. Default is 25.
The email address that will appear as the email sender.
Be aware that no validation is performed whether this is a real
email address or not.
Email recipient. May be a list of email addresses, separated by
comma or semicolon.
Username for Mail Server Authentication.
Password for Mail Server Authentication.
Explanation
127
128
System Manager
Database View
This view contains database related settings that allows you to:
129
Explanation
Revert to default values.
Save current state.
Cancel changes.
130
System Manager
Database backup and restore must take place on the database server, so the backup
files are stored there. If NetMaster Server is installed on a separate machine, the
backup files are also copied to the location given in the Backup location setting on
the NetMaster machine.
You can enable automatic deletion of old backup files. By default days to keep is set
to 15.
The job is scheduled to run at 04:00 nightly.
If the database server is on a separate machine, the old backup files deletion job will
delete old backup files from both the NetMaster Server and the database server.
Check the Send notification when backup task fails check box to enable email
notification if a periodic backup job fails. See Email Notification settings for email
notification setup.
Database Optimization Settings
You can enable automatic database optimization job. By default job run period is set
to 15 days.
The job is scheduled to run at 03:00 nightly.
Check the Send notification when database optimization task fails check box to
enable email notification if a periodic database optimization job fails. See Email
Notification settings for email notification setup.
131
132
System Manager
Other menu
Task Log View
This view shows the list of all Task Log entries, with options to refresh list and inspect
Task Log details.
To open this view you can either:
Explanation
Open task details
Refresh task list
133
134
System Manager
Arrow buttons:
Button
Explanation
Show task details for task above. If top task is shown, wrap
to bottom task.
Show task details for task below. If bottom task is shown,
wrap to top task.
135
The NetMaster Log view shows the last NetMaster server log, i.e. <NetMaster
installation>/JBoss-4.2.3/server/netmaster/log/server.log.
136
Explanation
Refresh log field manually
Use Archive log files button to pack all the
application log files in a zip format. The
archive is named by default
NetMasterLogFiles.zip and it will be saved
under NetMaster installation folder. You may
change the name and the location of the
archive in the popup dialog that opens when
pressing the Archive log files button.
System Manager
Use Clean up old log files button to delete
old NetMaster log files located under
<NetMaster installation>/JBoss4.2.3/server/netmaster/log/
NetMaster log files can grow significantly in
time, and the log file folder should be
monitored regularly. Please note that only the
historical log files will be deleted this way, not
the log file currently being written to by
NetMaster.
137
Scheduled Tasks view contains a list of the configured scheduled System Manager
tasks:
Field description:
Field
Description
Period
Next Start Date
Delay until run
NetMaster User
Database
Connection
Explanation
Task description
Number of days between job runs
Time for next job run
If a job is running, this field shows time since job start,
shown like this: (hh:mm:ss). If a job is waiting to run, this
field shows count down time till job start, shown like this:
hh:mm:ss.
User/Schema to be used by periodic database jobs
Database parameters to be used by periodic database
jobs
138
System Manager
Operation
Explanation
Delete the selected scheduled task
Refresh scheduled task list
139
Log files
140
System Manager
System Manager log files are found here:
<NetMaster_Install_Dir>\SystemManager\Tomcat-6.0.18-win\logs\wrapper.log*.
System Manager keeps the 20 newest wrapper log files of 5 MB each.
In case you need to report System Manager problems to Customer Support, please
append the relevant wrapper.log file to the case. This will make it easier for us to
investigate the problem.
141
142
System Manager
Open Windows Services and restart the NetMaster System Manager service:
Solaris version
Memory problem
143
144