Escolar Documentos
Profissional Documentos
Cultura Documentos
Installation Guide
December 2015
Release: R14B00 Rev A
Notice
This document contains information that is proprietary to Ceragon Networks Ltd. No part of this
publication may be reproduced, modified, or distributed without prior written authorization of
Ceragon Networks Ltd. This document is provided as is, without warranty of any kind.
Trademarks
Ceragon Networks, FibeAir and CeraView are trademarks of Ceragon Networks Ltd., registered
in the United States and other countries.
Ceragon is a trademark of Ceragon Networks Ltd., registered in various countries.
CeraMap, PolyView, EncryptAir, ConfigAir, CeraMon, EtherAir, CeraBuild, CeraWeb, and
QuickAir, are trademarks of Ceragon Networks Ltd.
Other names mentioned in this publication are owned by their respective holders.
Statement of Conditions
The information contained in this document is subject to change without notice. Ceragon Networks
Ltd. shall not be liable for errors contained herein or for incidental or consequential damage in
connection with the furnishing, performance, or use of this document or equipment supplied with it.
Information to User
Any changes or modifications of equipment not expressly approved by the manufacturer could void
the users authority to operate the equipment and the warranty for such equipment.
Revision History
Rev Date Author Description Approved by Date
A December 2015 Yael Klein NetMaster release Moti Sharf December 2015
R14B00
Table of Contents
1. About NetMaster ............................................................................................... 4
2. NetMaster Installation....................................................................................... 6
2.1 NetMaster Installation on Windows ................................................................................ 6
2.1.1 NetMaster Server Pre-Installation for Windows ............................................................. 6
2.1.2 NetMaster Installation for Windows ................................................................................ 6
2.1.3 System Manager Installation on Database Server ....................................................... 19
2.1.4 Uninstall NetMaster for Windows ................................................................................. 29
2.2 NetMaster Installation on Solaris ................................................................................. 31
2.2.1 NetMaster Server Pre-installation for Solaris ............................................................... 31
2.2.2 NetMaster Server Installation for Solaris ...................................................................... 32
2.2.3 Uninstall NetMaster for Solaris ..................................................................................... 34
2.3 Post Installation ............................................................................................................ 35
2.3.1 NetMaster Server post installation ............................................................................... 35
2.4 Database Installation .................................................................................................... 41
2.4.1 NetMaster Database .................................................................................................... 41
2.4.2 Oracle ........................................................................................................................... 42
2.4.3 PostgreSQL .................................................................................................................. 47
2.5 High Availability Solution .............................................................................................. 60
2.5.1 NetMaster High Availability Solution ............................................................................ 60
2.5.2 Installation Instructions ................................................................................................. 64
2.5.3 Failover Procedure ....................................................................................................... 67
2.5.4 System Parameter Configuration ................................................................................. 68
2.5.5 Troubleshooting ............................................................................................................ 71
2.5.6 High-Availability Solution for Solaris ............................................................................ 78
2.6 External Documents ................................................................................................... 100
2.6.1 System Requirements ................................................................................................ 100
2.6.2 Technical Description ................................................................................................. 100
1. About NetMaster
NetMaster is a comprehensive Network Management System offering centralized
operation and maintenance capability for a range of network elements.
NetMaster offers full range management of network elements. It has the ability to
perform configuration, fault, performance and security management. NetMaster is
the user interface to transmission and access products and the key issue for the
system is to present management networks in the simplest possible manner. The
software has network auto-discovery and uses the configuration data in the
network elements to automatically build the managed network. The various
elements and their attributes may be accessed using the intuitively graphical
presentation of the element and its components. NetMaster has a continuously
updated display of network status and network events are reported from the
elements using notifications. An extensive database and context sensitive help
facilities enable the user to analyze and report network events.
NetMaster provides the following network management functionality:
Fault Management
Configuration Management
Performance Monitoring
Security Management
Graphical User Interface with Internationalization
Network Topology using Perspectives and Domains
Automatic Network Element Discovery
HW and SW Inventory
Software Download jobs
Northbound interface to higher order OSS
Report Generator
Functionality is maintained during network growth, with solutions covering the
entire range of radio networks from a single hop to nationwide multi-technology
networks. High availability and reliability is obtained through various redundancy
schemes.
NetMaster functionality
The NetMaster system is scalable both in size and functionality. The NetMaster
NMS Server is the basis for any NetMaster system, providing basic functionality
within the Fault, Configuration, Performance and Security (FCPS) management
areas. The NMS Server is by itself an advanced tool for the user to perform
operations and monitor network elements for the whole operational network in
real time. The flexible client/server architecture gives the operators easy access to
all network elements and full control of the system from many different locations.
By selecting among a set of optional features, the NetMaster system can be
enhanced and tailored to each operators individual needs and requirements. With
all optional features installed, the NetMaster system provides the operator with an
advanced and sophisticated network management system that will highly increase
the efficiency of operations and maintenance in the network.
For easy integration to external higher-level management systems, a Northbound
SNMP interface can be provided.
Installation Guide
The NetMaster NMS Installation Guide is the printed version of installation section
of the online help system for the NetMaster network management system. The
installation guide can provide you with help about how to install and how to
configure the application. For detailed information regarding how to use
NetMaster, including system management information, please see the NetMaster
NMS User Guide.
More information
If you cannot find the answer to your question in the installation manual, contact
your responsible support person.
2. NetMaster Installation
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 installed on the same computer as the NetMaster
Server refer to the NetMaster System Requirements document for guidance.
However, it does not need to be installed on the same computer.
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 if you need to install a database server from
scratch. Please refer to Oracle documentation for instructions how to install
Oracle.
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.
System Manager Configuration and maintenance tool for NetMaster Server. System Manager
must be installed on both the NetMaster Server and the database server.
Polyview Topology Enables exporting discovered elements and subnetworks from PolyView
Import into a file and then importing them, while preserving their hierarchy, into
NetMaster as managed elements in administrative domains
Server NetMaster Client, NetMaster Server, SNMP Agent, System Manager and
Polyview Topology Import
System Manager System Manager only. Intended for stand-alone database server installation.
Install Modes
There are three modes of installation:
New Installation
Upgrade Installation
Maintenance Installation
The NetMaster installer looks for existing NetMaster installations on your
installation server in order to determine correct install mode.
Run the Setup.exe file to launch the NetMaster Installer home page.
Click Install NetMaster to initiate NetMaster installation. A File Download
Security Warning pop-up window appears.
If you accept the agreement, select the Accept option and then click Next to
continue.
Choose Install Set step. Note that the NetMaster Server install sets include Server,
System Manager, Client and Northbound SNMP Agent.
\
Click Next to continue.
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.
Installing step
Watch the product features being presented during the installation progress.
Click Done to finish the wizard. 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:
2.1.3.1 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.
Press the Install NetMaster button to initiate System Manager installation.
Internet Explorer needs to be told to run the installer:
If you accept the agreement, select the Accept option and then click Next to
continue.
Choose Install Set step. Select NetMaster Database Server only. This is in fact
System Manager in standalone mode.
2.1.3.2 Configuration
If you open System Manager on the database server the following information is
shown:
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 occupy
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.
3. Change the path to another existing location and save the file
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.
Note: NetMaster supports the Oracle Database Server on the Solaris
platform. For further details, refer to the NetMaster System
Requirements document. We recommend installing a 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.
Java installation
The Java Runtime environment (JRE) can be downloaded from the Internet.
Go to the following web page and download version 1.7.0_45:
http://www.oracle.com/technetwork/java/javase/downloads/
After the JRE is installed, do the following steps:
1. Open a command prompt (cmd)
2. Verify that the installed JRE is in PATH by typing java version
3. If the java command is not recognized, you must add the bin directory under
the JRE installation directory to the PATH
If the command is recognized, you shall see the version of the installed JRE
which shall be 1.7_0.45
If the version is not 1.7, do the following (assuming you have version 1.7.0.45):
cd /usr
rm java
ln -s /usr/jre/jre1.7.0_45 java
System Manager Configuration and maintenance tool for NetMaster Server. System Manager
must be installed on both the NetMaster Server and the database server.
Polyview Topology Enables exporting discovered elements and subnetworks from PolyView
Import into a file and then importing them, while preserving their hierarchy, into
NetMaster as managed elements in administrative domains
System Manager System Manager only, intended for stand-alone database server installation.
Install Modes
For the Solaris platform, this version of the installer supports only new
installations. (No Upgrade/Maintenance). This means that you must uninstall the
current version before installation.
Please note that the installation of NetMaster on Solaris is less automated
compared to Windows installer, and some steps need to be done manually.
Remove files:
rm -r <install-dir>
rm -r /var/svc/manifest/application/ngnms/
In order for NetMaster server to act as an FTP server, the following ports must be
opened toward the NetMaster application server:
Port Description
TCP port 20 FTP - File Transfer Protocol [default data]
TCP port 21 FTP - File Transfer Protocol [Control]
In order for NetMaster server to act as an SFTP server, the following ports must be
opened toward the NetMaster application server:
Port Description
TCP port 20 SFTP Secure File Transfer Protocol [default data]
TCP port 22 SFTP Secure File Transfer Protocol [Control]
In order for the NetMaster server to receive traps from network elements, the
following port must be opened:
Port Description
UDP port 162, SNMP trap port.
or any other user Default port is 162, but can be set to a different port in the Snmp
defined port Trap Port Number field in NetMaster Server system manager
view
7. If you want to limit the IP addresses that is allowed to connect using this port,
click the Change scope button:
Select Custom list and specify the IP-addresses of all GUI Client computers,
or
Select My network (subnet) only to only allow GUI Clients within your local
subnet.
8. Click OK
9. Click OK
10. 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.
Database server connection parameters and other settings (also copy sub
folders):
<NetMaster installation>\SystemManager\conf\*
Database backup files. Can be stored on user configurable folders. Default
folder for Windows is:
C:\NgNMS\backup\database
2.4.2 Oracle
12. Right-click the connection that was just created. This is usually named "Local
Area Connection 2". Choose Properties.
13. On the General tab, select Internet Protocol (TCP/IP), and click Properties.
14. In the Properties dialog box, click Use the following IP address and do the
following:
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
Subnet mask: Enter 255.255.255.0.
Note: Record the values entered, which will be need later in this
procedure.
Leave all other fields empty.
Click OK.
15. Click OK.
16. Close Network Connections.
17. Restart the computer.
18. 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 where:
IP_address is the non-routable IP address you entered in step 14.
hostname is the name of the computer.
domainname is the name of the domain.
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.
2.4.3 PostgreSQL
1. Introduction screen
Introduction message.
2. Installation Directory
Select the installation directory. You can change the directory by selecting Browse
to pick the new directory.
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.
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.
Please note that 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, as follows:
1. 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.
2. Select Groups and double-click 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.
3. 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.
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.
7. Ready to install
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.
9. Finished
Unselect the option Launch Stack Builder at exit .Installation is complete. You
can now go ahead and test your installation.
Click Finish.
3. Expand the following in the left window: PostgreSQL Database Server ->
Databases -> Postgres.
4. Choose Tools | Server Configuration | postgresql.conf.
5. 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.
6. Click OK.
The table below contains required minimum values for running NetMaster with
PostgreSQL:
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.
To ensure high availability, two NetMaster NMS systems run in parallel one
Primary system and one Standby system (secondary server). NetMaster high
availability solution replicates the information from the Primary database server
to the Standby database server by running nightly exports of the Primary
database server, and nightly restores on the Standby database server (updating
the Standby database with changes in the Primary database). During the restore
operation, the secondary NetMaster server is automatically stopped to be able to
complete the restore operation. Once the restore operation is completed, the
NetMaster server is automatically restarted and continues to monitor the
network.
the Primary servers and separately on the Standby server allowing maximum
redundancy and performance.
Set-up instructions
1. On both database servers, open the file NetMaster_environment.cmd in a text
editor (e.g., Notepad) and add all required general parameters listed in System
parameter configuration. Make sure that the database parameters are correct
and that the DB_INSTANCE_HOME parameter points to the database home
path.
2. On the Standby database server, create and share the folder: .\tasks\backup\
Give everyone full rights to modify the content (see Sharing folders).
3. On the Primary database server, create and share the folder: .\tasks\backup\
Give everyone full rights to modify the content (see Sharing folders).
4. On the Primary database server, open the file ha_netmaster_environment.cmd
batch script in a text editor (Notepad).
5. Assign the necessary values to the parameters described below (refer to High
availability parameters):
RESTORE_DATABASE_SERVER_UNC_SHARE=<The path to the shared
folder on the (Standby) database server to receive backups after export, ex.
\\StandbyDBserverIP\backup\>
2.5.5 Troubleshooting
This chapter describes common errors and provides instructions to investigate
and resolve the issues. In addition, it provides suggestions as to tools and utilities
that may be useful in tracking down solutions.
Computer name
Under My Computer > System Properties > Computer Name > Change, make sure
all servers have the correct names and are configured to belong to the same
Workgroup.
LAN settings
1. Make sure that all required services are activated on both servers.
2. In the Windows Control Panel > Network Connections, right-click and select
Properties for the active LAN connection.
3. Ensure that the following items are enabled:
Client for Microsoft Networks
File and Printer Sharing for Microsoft Networks
Internet Protocol (TCP/IP)
4. Under Internet Protocol (TCP/IP) > Properties, make sure the IP address
settings are correct.
IP alias setting
Edit the C:\Windows\system32\drivers\etc\hosts file. Add an entry to link the
computer name and IP address of the opposite server,
e.g., 142.22.1.40 Netmaster2.
2. Click Next.
3. Select when the task should start. (For high availability, it is recommended
that the task run daily.)
4. Click Next.
5. Enter the start date and time and how often it should run each day.
6. Click Next.
2.5.6.2 Concepts
Subsystem
A subsystem consists of a host running NetMaster server, and a host running the
database.
Active subsystem
The subsystem that is used for daily tasks. All updates (manage element, define
services, manage users, etc.) shall be done on the active subsystem. It is important
that all NetMaster users are aware of which subsystem is active.
Ceragon Proprietary and Confidential Page 78 of 105
NetMaster NMS R14B00 Installation Guide
Standby subsystem
The redundant subsystem that is kept synchronized with the active subsystem, on
a scheduled basis, usually daily. This subsystem should be used by NetMaster
clients only for read operations. Please note: There is nothing that prevents users
from updating the standby subsystem, but these updates will be lost upon
synchronization.
Synchronization
The process of backing up the active system, transferring the backup to the
standby system, and then restoring the standby system.
2.5.6.3 Functionality
The log will show what decisions/actions were taken, and report on lost contact,
or other errors.
Terminology
The hosts are referred to as follows:
nm1 - 1. NetMaster host
nm2 - 2. NetMaster host
db1 - 1. database host
db2 - 2. database host
The subsystems are referred to as follows:
HA1 - nm1 + db1 subsystem
HA2 - nm2 + db2 subsystem
Prerequisites
Identical version of the Oracle database installed on db1 and db2.
NetMaster server installed on nm1 and nm2.
nm1 connected with database schema on db1
nm2 connected with database schema on db2
Both use same database schema name and password.
The following software installed on both db servers
Samba (see appendix: Problems & Solutions if Samba net not found)
An ssl/ssh implementation (see appendix: install ssl/ssh)
Create an HA user
User : root
On both hosts db1 and db2, create an HA user, as shown in the following example.
Example:
useradd -d /export/ha -m ha
passwd ha
Note: The user name can be chosen freely in the following pages, ha
is used).
On db2:
scp .ssh/id_rsa.pub <db1-ip>:.ssh/authorized_keys
(Type "yes" in response to the question, are you sure you want to ..., and
provide the password to ha on db1)
6. Check that ssh is set up correctly:
On db1, type: ssh <db2-ip>. If the system responds with a remote
session on db2, requiring a password, this is an indication that ssh is set up
correctly.
Perform the same check on db2: ssh <db1-ip>
Unpack ha.zip
1. On db1 host, copy the file ha.zip to a folder accessible by the ha user.
2. Log in to db1 as ha.
3. Unzip ha.zip to the home folder.
4. Check that folder netmaster-ha is created.
Type the following:
chmod +x netmaster-ha/*.sh
chmod +x netmaster-ha/bin/*.sh
Configure ha environment
User : ha
1. If ha-env.sh does not exist already, copy ha-env-example.sh by typing the
following:
cp ha-env-example.sh ha-env.sh
2. Edit the ha-env.sh file.
see Configuration Files
Configure ha-cronjob.sh
User : ha
The file ha-cronjob.sh contains scheduling data for recurrent running of ha-
main.sh script.
By default, ha-cronjob.sh schedules ha-main.sh to run every night at 1:00
A.M. :
####################################
#Script for scheduling ha-main.sh
####################################
00 01 * * * * /export/ha/netmaster-ha/ha-main.sh
To reschedule so that ha-main.sh runs every half-hour, for example, edit the file
as follows:
00,30 * * * * * /export/ha/netmaster-ha/ha-main.sh
Edit to reflect your needs.
Note: Ensure that the path to ha-main.sh is absolute (i.e., begins
with a backslash character - "/")
See also man crontab
Transfer scripts
User : ha
When you have set up the ha-env.sh and ha-cronjob.sh with the correct
values for your system, the next step is to transfer the scripts to the other ha part.
On host db1, as user ha, execute the commands:
cd ~
scp -r netmaster-ha <ha2-ip>:.
Warning! All files under netmaster-ha will be transferred to ha2. If you
have backups they will also be transferred. If you need to
transfer only specific files, see man scp
3. Determine which ip address is reached, when connecting from the other end
by executing the following command from the other end: ping <ip-
address>
4. Create file netmaster-ha/my-ip with the ip-address as content. This ip
address should be the one specified in the ha-env.sh file under
HA?_DB_SERVER_ADDRESS. The following is an example of creating the my-ip
file:
echo 12.66.32.151 > my-ip
Give permissions
In order to allow user oracle to write backups and log files to ha users
netmaster-ha/exports directory, and to allow user ha to run export/import,
do the following on both db host machines:
1. While logged in as root user, type usermod -G oinstall ha
2. Logout user ha and login as user ha again (this is to let usermod take effect).
3. While logged in as user ha, type:
chgrp oinstall exports/
chmod g+w exports/
Set tnsnames.ora
While logged in as user root, ensure that the file tnsnames.ora exists in
directory ${ORACLE_HOME}/network/admin
It should contain (as a minimum) the following:
<SID> =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = <ip-address>)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = <SID>)
)
)
NMSORCL4 =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 172.24.90.4)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = nmsorcl4)
)
)
Ensure that the tnsnames.ora file is owned by user oracle, and has oinstall
group.
If the system returns the following, see Appendix: Problems & Solutions,
Cannot find samba net program to fix the problem.
If the system returns the following, correct the admin user and password:
If system returns the following, start the netlogon service on the nm host.
Crontab Restrictions
You can execute crontab if:
Your name appears in the file /usr/lib/cron/cron.allow.
Your name does not appear in the file /usr/lib/cron/cron.deny.
Note that:
If only cron.deny exists and is empty, all users can use crontab.
If neither file exists, only the root user can use crontab.
The allow/deny files consist of one user name per line.
See also http://www.adminschoice.com/crontab-quick-reference/
ha-env.sh
The following table describes all properties that need to be set in ha-env.sh file.
Many names in this file will have two similar entries, one for HA1 and one for HA2.
Such properties will be mentioned once in the table with HA? prefix.
Tip: In case HA1 and HA2 use same value for a property, that can be
set as follows (note the $):
HA1_DB_PORT=1521
HA2_DB_PORT=$HA1_DB_PORT
strings.sh
The strings.sh file may need to be modified if the language used in the Solaris
environment is other than English.
The default content of this file is as follows:
#!/bin/bash
my-ip
The my-ip file may be needed in case a db host has multiple ip addresses. See
Configure the IP address.
Example run:
ls -l log/
total 39178
-rw-r--r-- 1 ha other 115618
May 6 18:09 ha-stb.log
-rw-r--r-- 1 ha other 19879232 May
15 12:42 ha.log
The results list shows the timestamp of last modification to the logs. If you want to
check the time of the last run on the other ha end, do a remote login (see remote
login) and execute the above command.
Example run:
-bash-3.2$ ./ha-status.sh
Active : HA1 (137.133.9.70)
Standby : HA2 (137.133.9.79)
This host : HA1 (137.133.9.70)
If ha1 and ha2 have connectivity, you dont need to run this command on both
systems. Run it on either db1 or db2 host - the result should be the same.
Create a backup
User : ha
To create a backup, log in as user ha to the db host you want to backup and
execute:
bin/ha-backup.sh
To back up the active system, and restore it on the standby system, run from
the active db host:
./ha-main.sh
Check logs
User : ha
Log files are located at netmaster-ha/log
Ceragon Proprietary and Confidential Page 90 of 105
NetMaster NMS R14B00 Installation Guide
Implications:
Downtime from the time of the crash event until users are informed to use
other host.
Changes on active system, made after last synchronization, will be lost.
Note: It is better to not perform a switchover back to a previous active
db, because any switchover potentially loses some of the most
recent changes.
Downloading OpenSSL/OpenSSH
In case there is no ssl/ssh implementation installed on the Solaris host, it can be
downloaded using the following links:
For SPARC architecture:
http://artfiles.org/sunfreeware.com/pub/freeware/sparc/10/
For i386 architecture:
http://artfiles.org/sunfreeware.com/pub/freeware/i386/10/
The required packages are:
OpenSSL
ZLib
GNU Compiler Collection
OpenSSH
Select the latest stable versions, download them and place them on a disk
accessible from the Solaris host.
Installing OpenSSL/OpenSSH
User : root
Unzip and install gcc
solaris10# gunzip libgcc-3.4.6-sol9-sparc-local.gz
solaris10# pkgadd -d libgcc-3.4.6-sol9-sparc-local
You should receive the following message:
Installation of <SMCgcc> was successful.
Unzip and install zlib
solaris10# gunzip zlib-1.2.1-sol9-sparc-local.gz
solaris10# pkgadd -d zlib-1.2.1-sol9-sparc-local
You should receive the following message:
Installation of <SMCzlib> was successful.
Unzip and install OpenSSL
solaris10# gunzip openssl-0.9.8f-sol9-sparc-local.gz
solaris10# pkgadd -d openssl-0.9.8f-sol9-sparc-local
You should receive the following message:
Installation of <SMCossl> was successful.
Unzip and install OpenSSH
solaris10# gunzip openssh-4.7p1-sol9-sparc-local.gz
solaris10# pkgadd -d openssh-4.7p1-sol9-sparc-local
#!/bin/sh
case "$1" in
'start')
/usr/local/sbin/sshd
;;
'stop')
/usr/bin/kill `/usr/bin/head -1 /var/run/sshd.pid`
;;
'reload')
/usr/bin/kill -HUP `/usr/bin/head -1
/var/run/sshd.pid`
;;
*)
echo "Usage: $0 { start | stop }"
exit 1
;;
esac
exit 0
SSHD
chown root:root /etc/init.d/sshd
chmod 555 /etc/init.d/sshd
ln -s /etc/init.d/sshd /etc/rc2.d/S98sshd
/usr/local/bin/ssh-keygen -t rsa -
f /usr/local/etc/ssh_host_rsa_key -N ""
/usr/local/bin/ssh-keygen -t ecdsa -f
/usr/local/etc/ssh_host_ecdsa_key -N ""
# start sshd
/etc/init.d/sshd start
bash
for i in SUNWsmbac SUNWsmbar SUNWsmbau SUNWsfman
> do
> pkginfo $i
> done
...
NET=/usr/sfw/bin/net
#or:
#NET=/usr/sfw/sbin/net
Problem: When running the net program, the output starts with message similar
to this:
[2013/05/15 10:15:28, 0] param/params.c:(536)
params.c:OpenConfFile() - Unable to open configuration file
"/etc/sfw/smb.conf":
No such file or directory
Solution:
User : root
Check for the existence of the file /etc/sfw/smb.conf on db1 and db2 hosts.
If the file doesnt exist, then execute the following command while logged in as
root::
cp /etc/sfw/smb.conf-example /etc/sfw/smb.conf
Problem:
Restore fails. log/ha-stb.log shows
ORA-01940 cannot drop a user that is currently connected
Solution:
This error occurs when a NetMaster user is currently logged in to the database.
That may happen because the NetMaster server has not been stopped, or because
there is another session (typically sqlplus interactive session) active.
Ensure that ha-env.sh is setup correctly, such that the ha-restore.sh script
succeeds in stopping the NetMaster server before proceeding to perform the
database restore. Ensure also that interactive sessions are closed.
Problem:
When running ./ha-status.sh, the output reports multiple ip addresses, as
follows:
Disagreement on who is active system:
HA2 (20.66.53.51
20.86.10.1
20.86.10.2
Solution:
See Configure the IP address.
Problem:
When running restore the log shows ./ha-status.sh, the output reports multiple
ip addresses as follows:
...
===============================================================
=
Restore script start at : Mon Jun 17 16:13:51 EDT 2013
===============================================================
=
mv /db_restore/HA/netmaster-
ha/exports/remote/0_NetMaster_database.dmp.gz /db_restore/HA/netmaster-
ha/exports/remote/1_NetMaster_database.dmp.gz
actual-status stopped
Control service request failed. [DOS code 0x00000426]
actual-status stopped
ERROR:
ORA-12514: TNS:listener does not currently know of service requested in connect
descriptor
SP2-0306: Invalid option.
Usage: CONN[ECT] [logon] [AS {SYSDBA|SYSOPER}]
where <logon> ::= <username>[/<password>][@<connect_identifier>] | /
SP2-0306: Invalid option.
Usage: CONN[ECT] [logon] [AS {SYSDBA|SYSOPER}]
where <logon> ::= <username>[/<password>][@<connect_identifier>] | /
SP2-0157: unable to CONNECT to ORACLE after 3 attempts, exiting SQL*Plus
Import: Release 10.2.0.4.0 - Production on Mon Jun 17 16:14:01 2013
Copyright (c) 1982, 2007, Oracle. All rights reserved.
Connected to: Oracle Database 10g Enterprise Edition Release 10.2.0.4.0 - 64bit
Production
Export file created by EXPORT:V10.02.01 via conventional path
import done in US7ASCII character set and AL16UTF16 NCHAR character set
import server uses WE8ISO8859P1 character set (possible charset conversion)
. importing NETMASTER1's objects into NETMASTER1
. . importing table "AXXRPC_USER" 0 rows imported
. . importing table "CORE_DISCOVER_SETTINGS" 5 rows imported
. . importing table "CORE_EJB3_SEQUENCE"
IMP-00019: row rejected due to ORACLE error 1
IMP-00003: ORACLE error 1 encountered
ORA-00001: unique constraint (NETMASTER1.PK_CORE_EJB3_SEQUENCE)
violated
...
Solution:
The error messages for IMP-00019,IMP-00003,and ORA-00001 are a result
incorrect connection parameters for running sqlplus under admin. This is
indicated by the messages for SP2-0306 and SP2-0157 above.
To resolve the problem:
1. Check values in ha-env.sh for:
HA1_DB_ADMIN_USER
HA1_DB_ADMIN_PASSWORD
HA2_DB_ADMIN_USER
Ceragon Proprietary and Confidential Page 98 of 105
NetMaster NMS R14B00 Installation Guide
HA2_DB_ADMIN_PASSWORD
2. Ensure that values are correct by starting an sqlplus session (execute the
following command):
$DB_HOME/bin/sqlplus -s
<DB_ADMIN_USER>/<DB_ADMIN_PASSWORD>@<MYIP>:1521/<SID>
3.1 Overview
For PolyView NMS customers that are migrating to the NetMaster NMS, a special
tool is provided to import:
The managed elements from PolyView into NetMaster (see Importing
Topology from PolyView to NetMaster).
NetMaster processes the list of elements that were managed by PolyView
and carries out the discovery and manage processes on these elements.
The elements are placed in the Geographical or Logical Trees under the
same hierarchy that existed in PolyView.
The PolyView users (not Groups) into the NetMaster (see Importing users
from PolyView to NetMaster).
The users to be imported into NetMaster are selected from the list of users
that were defined in PolyView.
3. In the Data types area, clear the checkboxes of any data types you wish to
exclude from export.
4. In the File area, enter or browse to the desired output destination path and
filename.
5. Click OK to perform the export.
By default, the import process places elements in the geographical map. However,
you can instruct the import process to place the element in the logical map by
changing the defaultDomain parameter in the config.properties file, from:
defaultDomain = G
to
defaultDomain = L
By default, the import process performs all import stages: parsing the import file,
discovering elements, creating an administrative domains (AD) tree, and
managing the elements. However , you can instruct the import process to
perform only some of these stages by setting the processMode parameter of the
config.properties file to any of the following values:
In Unix, run:
polytopoimporter.sh <filename.exp>
or
polytopoimporter.sh <filename.exp>
<subdomain1/subdomain2/subdomain3/>
where:
<filename.exp> is the full path and name of the export file. For
example:
c:\67-68.exp.
How many IPs were successfully discovered and managed during the import
process.
The elements that failed to be managed, together with the reason for failure. You
can also view these elements in the Unmanaged Elements view.
The error titles of any errors that occurred. For detailed error information, see
the error log.
Note that if the import file contains IPs that are already managed in NetMaster,
these IPs are not affected by the import process. These IPs will be reported in the
console and the log file.
3. Select the users to be imported and click OK. The new users will appear in the
Users table.
4. Select the new user in the Users table and then select an appropriate group in
the Groups table.