Lap Dat

Alcatel 5530NETWORK ANALYZER | RELEASE 4.1I N S T A L L A T I O N A N D C U S T O M I Z A T I O N G U I D E

PRINTED ONRECYCLED PAPER

Alcatel assumes no responsibility for the accuracy of the information presented, which is subject to change without notice.

Alcatel and the Alcatel logo are registered trademarks of Alcatel. All other trademarks are the property of their respective owners.

Copyright 2006 Alcatel.All rights reserved.

Disclaimers

Alcatel products are intended for commercial uses. Without the appropriate network design engineering, they must not be sold, licensed or otherwise distributed for use in any hazardous environments requiring fail-safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, direct life-support machines, or weapons systems, in which the failure of products could lead directly to death, personal injury, or severe physical or environmental damage. The customer hereby agrees that the use, sale, licence or other distribution of the products for any such application without the prior written consent of Alcatel, shall be at the customer's sole risk. The customer hereby agrees to defend and hold Alcatel harmless from any claims for loss, cost, damage, expense or liability that may arise out of or in connection with the use, sale, licence or other distribution of the products in such applications.

This document may contain information regarding the use and installation of non-Alcatel products. Please note that this information is provided as a courtesy to assist you. While Alcatel tries to ensure that this information accurately reflects information provided by the supplier, please refer to the materials provided with any non-Alcatel product and contact the supplier for confirmation. Alcatel assumes no responsibility or liability for incorrect or incomplete information provided about non-Alcatel products.

However, this does not constitute a representation or warranty. The warranties provided for Alcatel products, if any, are set forth in contractual documentation entered into by Alcatel and its customers.

This document was originally written in English. If there is any conflict or inconsistency between the English version and any other version of a document, the English version shall prevail.

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 iiiApril 2006 3EQ 10056 AAAA RJAAA

Preface

This guide describes how to:

• install or upgrade the 5530 NA software• enter or change the 5530 NA Licence Key• stop and verify the status of the 5530 NA server • back up and restore the database• customize probable cause and repair advice messages for CSR, NOC, and service

provider user types• translate the 5530 NA GUI

See the 5530 Network Analyzer User Guide for information about how to use the 5530 NA GUI.

Conventions used in this guide

The following table lists the conventions that are used throughout the guide.

Table 1 Documentation conventions

Convention Description Example

Key name Press a keyboard key Delete

Italics Identifies a variable hostname

↵ Press the Return key ↵

Preface

iv Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Procedures with options or substepsWhen there are options in a procedure, they are identified by letters. When there are substeps in a procedure, they are identified by roman numerals.

Example of options in a procedure

At step 1, you can choose option a or b. At step 2, you must do what the step indicates.

1 This step offers two options. You must choose one of the following:

a This is one option.

b This is another option.

2 You must perform this step.

Example of substeps in a procedure

At step 1, you must perform a series of substeps within a step. At step 2, you must do what the step indicates.

1 This step has a series of substeps that you must perform to complete the step. You must perform the following substeps:

i This is the first substep.

ii This is the second substep.

iii This is the third substep.

2 You must perform this step.

Important informationThe following conventions are used to indicate important information:

Warning — Warning indicates that the described activity or situation may, or will, cause equipment damage or serious performance problems.

Caution — Caution indicates that the described activity or situation may, or will, cause service interruption.

Note — Note provides information that is, or may be, of special interest.

Contents

Preface iiiConventions used in this guide.............................................................................................. iii

Procedures with options or substeps ................................................................ ivImportant information ........................................................................................ iv

Getting started

1 — Getting started 1-11.1 5530 NA overview.............................................................................................. 1-2

Protocols and ports ........................................................................................ 1-21.2 Platform and system requirements .................................................................... 1-3

Browser requirements.................................................................................... 1-31.3 Single node and multi-node configuration ......................................................... 1-4

Single node configuration .............................................................................. 1-4Cluster configuration ...................................................................................... 1-4

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 vApril 2006 3EQ 10056 AAAA RJAAA

Contents

Installing and upgrading

2 — Installing the 5530 NA 2-12.1 Installation overview .......................................................................................... 2-22.2 Installing the 5530 NA server............................................................................. 2-2

Procedure 2-1 To install the 5530 NA server for one node........................... 2-2Procedure 2-2 To install the 5530 NA server for multiple nodes .................. 2-4

2.3 Logging in and setting the password ................................................................. 2-6Procedure 2-3 To log in as the ni user.......................................................... 2-6Procedure 2-4 To change the password....................................................... 2-6

2.4 Optional post-installation procedures ................................................................ 2-7HTTP and HTTPS.......................................................................................... 2-7Procedure 2-5 To set HTTP or HTTPS for 5530 NA server and

workstations connections ....................................................................... 2-7Starting SELT................................................................................................. 2-7Procedure 2-6 To start SELT after installation.............................................. 2-8Improving performance with sizing tool.......................................................... 2-8Procedure 2-7 To improve 5530 NA runtime performance and

behavior with the sizing tool ................................................................... 2-82.5 Starting and stopping the 5530 NA server and GUI .......................................... 2-9

Procedure 2-8 To start and display status of the 5530 NA server ................ 2-9Procedure 2-9 To stop the 5530 NA server ................................................ 2-10Procedure 2-10 To start the 5530 NA GUI for the first time as the

administrator ........................................................................................ 2-10Procedure 2-11 To stop the 5530 NA GUI.................................................. 2-16

3 — Upgrading the 5530 NA 3-13.1 Upgrading overview ........................................................................................... 3-2

Backing up and restoring the database

4 — Backing up and restoring the database 4-14.1 Database back up and restore overview ........................................................... 4-24.2 Backing up the database ................................................................................... 4-2

Procedure 4-1 To back up the 5530 NA database........................................ 4-24.3 Restoring the database...................................................................................... 4-3

Procedure 4-2 To restore the 5530 NA database ......................................... 4-3

vi Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Contents

Customization

5 — Probable cause and repair advice messagecustomization 5-1

5.1 Probable cause and repair advice message customization overview ............... 5-25.2 Customizing probable cause and repair advice messages ............................... 5-2

Procedure 5-1 To modify probable cause and repair advicemessages for a CSR or NOC................................................................. 5-2

6 — GUI translation 6-16.1 GUI translation overview.................................................................................... 6-26.2 Translating the GUI............................................................................................ 6-2

Procedure 6-1 To translate the 5530 NA GUI............................................... 6-2

Glossary

Index

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 viiApril 2006 3EQ 10056 AAAA RJAAA

Contents

viii Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 April 2006 3EQ 10056 AAAA RJAAA

Getting started

1 — Getting started

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 1-1April 2006 3EQ 10056 AAAA RJAAA


1.1 5530 NA overview 1-2

1.2 Platform and system requirements 1-3

1.3 Single node and multi-node configuration 1-4


1-2 Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

1.1 5530 NA overview

The 5530 NA performs network diagnosis and analysis for DSLs on element-managed nodes. Figure 1-1 shows an example of a network with the 5530 NA.

Figure 1-1 5530 NA in the network

Alcatel recommends that you install the 5530 NA on a separate workstation.

Protocols and ports

Table 1-1 describes the protocols and ports that are used by the 5530 NA.

ManagementPVC

HTTP

SNMP/TFTP

HTTPS

Network operations

Customer careoperations

Northbound interfacevia SOAP

OSS application

5530 NA

EML IM

Router

CPE

7300/7301 ASAM, 7302 ISAM

17743



Table 1-1 Protocols and ports

1.2 Platform and system requirements

The 5530 NA server must be installed on a Sun Sparc that is running the Solaris 8 or 10 operating system. You must install the following patch clusters:

• Solaris 8 and 10 patch cluster:http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

• J2SE Solaris 8 and 10 patch cluster:http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

Table 1-2 lists the minimum and recommended system requirements for the 5530 NA server.

Table 1-2 5530 NA server system requirements

Note(1) The amount of free disk space required depends on the number of DSLs in the network and the

number of saved network assessments. The minimum amount of free disk space required during installation is 750 kbytes.

Contact your Alcatel technical support representative for more information about 5530 NA server system requirements.

Browser requirements

Table 1-3 lists the browser requirements for the 5530 NA GUI.

5530 NA function Platform Protocol and port

Synchronization of the 5530 NA with EML providers

EML workstations Telnet to port tcp/23

Node data collection Nodes SNMP to port udp/161

TFTP to port udp/69

5530 NA GUI

Northbound interface

5530 NA workstation and server

http to port tcp/8080 (unsecure)

http to port tcp/8443 (secure)

E-mail notification 5530 NA server SMTP to port tcp/25 for configured mail servers

Requirement Minimum requirement Recommended requirement

Platform Sun sparc running Solaris 8 Sun sparc running Solaris 8

Processors > 550 MHz > 1 GHz

Memory 1 Gbyte 2 Gbytes

Free disk space (1) 2 Gbytes (750 kbytes are used at installation)

20 Gbytes



Table 1-3 Browser requirements

1.3 Single node and multi-node configuration

The installation of the 5530 NA is affected by the type of configuration. The types of configuration are:

• single node• cluster - consists of multiple nodes and it is used to increase performance

Single node configuration

A single node configuration is used when you have only one node. See Procedure 2-1 for information about how to install the 5530 NA server for one node.

Cluster configuration

For a cluster configuration, the workload of the application server is divided over multiple nodes. However, the database server is installed on only one node, which is typically the first node that you install. When you install additional nodes that do not have a database, you must enter the location of the node that contains the database. Figure 1-2 shows a cluster configuration in the network.

Browser Version Solaris platform PC platform

Opera 7 or later ✓ ✓

Mozilla 1.4 or later ✓ ✓

Mozilla Firefox 1.0 or later ✓ ✓

Internet Explorer 5 or later ✓



Figure 1-2 Cluster configuration in the network

A cluster configuration requires a shared drive for the nodes in the cluster to communicate, which requires a shared folder to be configured during the installation of the nodes. The shared folder must be mounted with the same path for each node to access the folder. You can modify the folder after the installation. You can add application servers to an operational cluster. Figure 1-3 shows a cluster configuration with application servers, a database, and shared file system.

DSLAM

Customerservice

representativeOperator

http://<master host name>:8080https://<master host name>:8443

MySQLdatabase

(centralized)

5530NA

5530NA

5530NA

5530 NA

18477



Figure 1-3 Cluster configuration

To configure the shared drive, choose Administration→System Settings from the main menu. Enter the path to the shared drive for the Shared drive path parameter and click on the Apply button.

After the shared drive is configured, the administrator can display the active nodes in the cluster by choosing Administration→System status from the main menu and clicking on the Node statistics tab button. The node does not appear in the list of active node or in the performance graph when:

• the node is not started• the cluster partition name for the node does not match the name that was entered

during installation

See Procedure 2-2 for information about how to install the 5530 NA server for multiple nodes.

Applicationserver 1

Applicationserver 2

18377

Database

File system


Installing and upgrading

2 — Installing the 5530 NA

3 — Upgrading the 5530 NA




2.1 Installation overview 2-2

2.2 Installing the 5530 NA server 2-2

2.3 Logging in and setting the password 2-6

2.4 Optional post-installation procedures 2-7

2.5 Starting and stopping the 5530 NA server and GUI 2-9



2.1 Installation overview

The 5530 NA server is installed on a Sun Sparc that is running the Solaris 8 operating system. Table 2-1 lists the installation tasks.

Table 2-1 Installation tasks

2.2 Installing the 5530 NA server

Use the following procedure to install the 5530 NA server on a Sun server workstation. The 5530 NA software CD contains the:

• 5530 NA server package to install the network diagnosis, analysis, and Northbound interface functions

• 5530 NA online documentation

Procedure 2-1 To install the 5530 NA server for one node

1 Log in to the host as root.

Task See

Before server installation

To determine system requirements Section 1.2

Server installation

To install the 5530 NA server for one node Procedure 2-1

To install the 5530 NA server for multiple nodes Procedure 2-2

After server installation

To log in as the ni user Procedure 2-3

To change the password Procedure 2-4

To set HTTP or HTTPS for 5530 NA server and workstations connections (optional)

Procedure 2-5

To start SELT after installation (optional) Procedure 2-6

To improve 5530 NA runtime performance and behavior with the sizing tool (optional)

Procedure 2-7

To start and display status of the 5530 NA server Procedure 2-8

To stop the 5530 NA server Procedure 2-9

To start the 5530 NA GUI for the first time as the administrator Procedure 2-10

To stop the 5530 NA GUI Procedure 2-11

Note — The element-managed nodes and element managers must be configured before you install the 5530 NA server.



2 Insert the CD-ROM in CD-ROM drive.

3 Mount the CD-ROM drive, if required.

4 Run the installation script by typing:

/directory/ni-release.bin ↵

where

directory is the directory where the CD-ROM is mounted

release is the release of the 5530 NA that you are installing, in the format number.number

For example: /mnt/cdrom/ni-4.1.bin

5 Respond to the prompt: “In which top directory you want to install the software? The directory should exist [“/opt (default) | “<directory>”]”, as shown in Figure 2-1.

Figure 2-1 Initial installation process information

a Press ↵ to install in the default /opt directory. Alcatel recommends that you use the /opt directory.

b Enter a path to install in a different and existing directory, and press ↵. For example:

/directory1

The installation directory is created in that directory.

6 Respond to the prompt: “Do you want to store the data directory inside the installation directory? [yes (default)| no]?”, as shown in Figure 2-1.

a Press ↵ to store the directory on the 5530 NA server for saved data.

b Type no and respond to the prompt: “By default the base for the data directory is “/var/opt”. In this directory we will create a “ni” subdirectory. Do you accept this?. The directory should exist [ “/var/opt” (default) | “<directory>” ]?”



7 At the prompt: “Is this setup part of a cluster configuration [ no (default) | yes ]?”, as shown in Figure 2-1, press ↵.

The installation starts. The 5530 NA server package and online documentation are installed in the directory/nireleaseid directory, where directory is the installation directory specified in step 5 and ni-releaseid is the release and build identification of the 5530 NA.

Table 2-2 describes the top directories that are installed on the 5530 NA server.

Table 2-2 Directories on the 5530 NA server

Procedure 2-2 To install the 5530 NA server for multiple nodes

1 Log in to the host as root.

2 Insert the CD-ROM in CD-ROM drive.

3 Mount the CD-ROM drive, if required.

4 Run the installation script by typing:

/directory/ni-release.bin ↵

where

directory is the directory where the CD-ROM is mounted

release is the release of the 5530 NA that you are installing, in the format number.number

For example: /mnt/cdrom/ni-4.1.bin

5 Respond to the prompt: “In which top directory you want to install the software? The directory should exist [“/opt (default) | “<directory>”]”, as shown in Figure 2-1.

a Press ↵ to install in the default /opt directory. Alcatel recommends that you use the /opt directory.

Directory Description

/installation_directory Installation directory

/installation_directory/bin System management and uninstall scripts

/installation_directory/log Log files

/installation_directory/lib Libraries for system management

/installation_directory/doc 5530 Network Analyzer User Guide and 5530 Network Analyzer Installation and Customization Guide online documentation

/installation_directory/server Server files

/installation_directory/conf Configuration file template for advanced configurations

/installation_directory/data directory

Data files

/etc/ni Configuration file for the database server and 5530 NA



b Enter a path to install in a different directory, and press ↵. For example:

/directory1

The installation directory is created in that directory.

6 Respond to the prompt: “Do you want to store the data directory inside the installation directory? [yes (default)| no]?”, as shown in Figure 2-1.

a Press ↵ to store the directory on the 5530 NA server for saved data.

b Type no and respond to the prompt: “By default the base for the data directory is “/var/opt”. In this directory we will create a “ni” subdirectory. Do you accept this?. The directory should exist [ “/var/opt” (default) | “<directory>” ]?”

7 At the prompt: “Is this setup part of a cluster configuration [ no (default) | yes ]?”, as shown in Figure 2-1, type yes and press ↵.

8 At the prompt: “Name of the cluster {should be unique in your network):”, enter a name for the cluster. The “cluster” message appears, where cluster is the name of cluster partition.

9 At the prompt: “Is this correct? [ no (default) | yes ]?”, enter yes.

10 At the prompt: “Do you want to install the database server on this machine [ no (default) | yes ]?”, enter:

a Yes for the first node in the installation. Go to step 12.

b No for the second node in the installation. Go to step 11.

11 At the prompt: “IP-address or name of the machine where the database server will be (is) installed”, enter the IP address of the first node that contains the database server.

12 Verify the value for the fd_cur for the file descriptors by typing:

ulimit –n

If the default number is less than but not equal to 4096, go to step 13. Otherwise, go to step 15.

13 In the /etc/system file, add the following lines:

set rlim_fd_cur=4096

set rlim_fd_max=4096

14 Restart the host to apply the changes.

15 Verify the value of the fd_max for the file descriptors by typing:

ulimit –Hn

Note — The cluster partition name must be the same for each node in the cluster. There is no communication between nodes that do not have the same cluster partition name.



If the default number is less than but not equal to 4096 for each line, go to step 13. Otherwise, go to step 16.

16 Restart the 5530 NA server.

i Stop the 5530 NA server, as described in Procedure 2-9.

ii Start the 5530 NA server, as described in Procedure 2-8.

17 Run ni_sizing.sh in the /ni/bin directory, as described in Procedure 2-7.

The installation starts. The 5530 NA server package and online documentation are installed in the directory/ni directory, where directory is the installation directory specified in step 5 and ni-releaseid is the release and build identification of the 5530 NA.

Table 2-2 describes the top directories that are installed on the 5530 NA server.

2.3 Logging in and setting the password

The following procedures describe how to log in as the ni user and change the password after the first login.

Procedure 2-3 To log in as the ni user

1 Open a command or shell tool from the 5530 NA server workstation.

2 Type:

su - ni ↵

3 Type the password. Contact your Alcatel technical support representative for the password.

Procedure 2-4 To change the password

1 Log in to the 5530 NA server workstation as ni, as described in Procedure 2-3.

2 Type:

passwd ↵

Note — Alcatel recommends that you change the password after you log in for the first time, as described in Procedure 2-4.



3 Respond to the password prompts.

2.4 Optional post-installation procedures

After the 5530 NA is installed, you can:

• set HTTP or HTTPS for 5530 NA server and 5530 NA workstations connections• activate SELT• use the sizing tool

HTTP and HTTPSBy default, the 5530 NA allows HTTP and HTTPS connection protocols. HTTPS uses port 8443 for secure connections between the 5530 NA server and workstations. HTTP uses port 8080 for unsecure connections between the 5530 NA server and workstations. You can change the connection protocol between the 5530 NA server and workstations from both connection protocol types to only HTTPS or HTTP, as described in Procedure 2-5.

Procedure 2-5 To set HTTP or HTTPS for 5530 NA server and workstations connections

1 Log in to the 5530 NA host as ni, as described in Procedure 2-3.

2 Navigate to /etc/ni and open the ni.conf file.

3 Find the line:

NI_PROTOCOL=BOTH

4 Edit the NI_PROTOCOL=BOTH line to:

NI_PROTOCOL=HTTP

or

NI_PROTOCOL=HTTPS

5 Stop the 5530 NA server, as described in Procedure 2-9.

6 Start the 5530 NA server, as described in Procedure 2-8.

Starting SELT

By default, the 5530 NA does not start the SELT function after the 5530 NA is installed; SELT functionality does not appear on the 5530 NA GUI. Procedure 2-6 describes how to start SELT after installation to have the functionality appear on the 5530 NA GUI.



Procedure 2-6 To start SELT after installation

This procedures assumes the 5530 NA server is stopped. See Procedure 2-9 to stop the 5530 NA server.


2 Navigate to /etc/ni and open the ni.conf file.

3 Find the line:

STARTSELT=NO

4 Edit the STARTSELT=NO line to:

STARTSELT=YES


Improving performance with sizing tool

To maximize the utilization of the installed memory on the 5530 NA server, Alcatel recommends that you use the sizing tool. The sizing tool modifies the database and the server configuration files of the 5530 NA to maximize the use of hardware resources.

Procedure 2-7 To improve 5530 NA runtime performance and behavior with the sizing tool


2 Start the sizing tool by typing:

bin/ni_sizing.sh ↵

A menu appears displaying the sizing options.

3 Enter the number of the sizing option.

The sizing options correspond to the installed and available memory on the 5530 NA server. Choose an option that is closest, but does not exceed, the installed memory on the 5530 NA server. For example, choose 1 Gbyte if the 5530 NA server has 1.5 Gbytes of installed memory. Do not choose 2 Gbytes.

4 Stop the 5530 NA server, as described in Procedure 2-9.


6 Restart the mysql server by typing:

/etc/init.d/nimysqlserver stop ↵

/etc/init.d/nimysqlserver start ↵




2.5 Starting and stopping the 5530 NA server and GUI

The following procedures describe how to start and stop the 5530 NA server and GUI. See the 5530 Network Analyzer User Guide for information about the 5530 NA GUI.

Procedure 2-8 To start and display status of the 5530 NA server

1 Log in to the 5530 NA workstation as ni, as described in Procedure 2-3.

2 Navigate to the directory where the 5530 NA server is installed.

3 Type:

bin/ni_server start ↵

The 5530 NA server starts. Each node in a cluster must be started individually. You should start the node with the database server first.

a To display the status of all processes for the 5530 NA server, database, and GUI, go to step 4.

b To start the 5530 NA GUI, go to Procedure 2-10.

4 Type:

bin/ni_server status ↵

The status of the 5530 NA server and other processes are displayed, as shown in Figure 2-2.



Figure 2-2 Status prompts

Procedure 2-9 To stop the 5530 NA server

1 Log in to the 5530 NA workstation as ni, as described in Procedure 2-3.

2 Navigate to where the 5530 NA server is installed.

3 Type:

bin/ni_server stop ↵

Procedure 2-10 To start the 5530 NA GUI for the first time as the administrator

This procedure describes how to:

• start the 5530 NA GUI • set the License Key• synchronize the 5530 NA and EML providers



Before you perform this procedure, see Procedure 2-5 if you want to set the server connection protocol.


2 Open a browser and navigate to https://server:port number or http://server:port number

where

server is the name of the 5530 NA server

port number is the port number for the web server

For example: https://naserver:8443 or http://naserver:8080.

3 Depending on your browser, one or more security certificates may appear. Click on the Yes or OK button to continue. The login prompt appears in the 5530 Network Analyzer login window, as shown in Figure 2-3.

Figure 2-3 Login window

4 Enter your user name and password.



5 Click on the Log in button. The About window appears, as shown in Figure 2-4.

Figure 2-4 About window

6 Click on the Update License button. The License key input page window appears, as shown in Figure 2-5.

Figure 2-5 License key input page

Note — Contact your Alcatel technical support representative for the default user name and password.



7 Enter the License Key and click on the OK button. The About window appears with the license information.

8 Change the administrator password.

i Choose Administration→User management from the 5530 NA main menu. The User management window appears, as shown in Figure 2-6.

Figure 2-6 User management window

ii Click on the admin hyperlink. The User properties window appears.

iii Set the Password and Confirm Password parameters.

iv Click on the OK button.

9 Choose Administration→System settings from the 5530 NA main menu. The System settings window appears, as shown in Figure 2-7.



Figure 2-7 System settings window

10 To use the e-mail function for network diagnosis results, set the system setting parameters, which are described in Table 2-3.

Table 2-3 System Settings parameters - Mail

11 Add one or more DSLAM providers.

a For an EML provider, go to step 12.

b For a URL provider, go to step 13.

12 To add an EML provider:

i Choose Administration→System settings from the 5530 NA main menu. The System settings window appears.

ii Configure the parameters, which are described in Table 2-4.

Parameter Description Option

SMTP server SMTP server address for sending e-mails SMTP server

From address E-mail address that appears as the sender for e-mails sent by the 5530 NA, for example, at the end of a monitoring line quality diagnosis

E-mail address



Table 2-4 System settings parameters - Synchronization

See the 5530 Network Analyzer User Guide for more information about the other system setting parameters.

iii Choose Configuration→Synchronization from the 5530 NA main menu. The DSLAM providers window appears.

iv Click on the Add EML provider button. The EML DSLAM provider editor window appears.

v Set the parameters, as described in Table 2-5. The Provider name is a mandatory parameter, as denoted with an asterisk (*).

Table 2-5 EML provider parameters

vi Click on the OK button. The EML provider appears in the DSLAM providers list.

vii Go to step 14 to synchronize the EML provider and the 5530 NA.

13 To add a URL provider:

i Choose Configuration→Synchronization from the 5530 NA main menu. The DSLAM providers window appears.

ii Click on the Add URL provider button. The URL DSLAM provider editor window appears.

iii Set the parameters, which are described in Table 2-6. Both parameters are mandatory, as denoted with an asterisk (*).

Parameter Description Option

EML user account

Name of the EML provider user account

The account name must match the name of the user account on the EML provider.

EML user password

Password for the EML provider user account

The account password must match the password of the user account on the EML provider.

Parameter Description Options

Provider name * Specifies the name of the EML provider

Enter characters that should be unique

EML user account Name of the EML provider user account

Enter characters. The account name must match the name of the user account on the EML provider. The default account is the account set by the EML user account parameter in the system settings.

EML user password Password for the EML provider user account

Enter characters. The account password must match the password of the user account on the EML. The default password is the EML user password set in the system settings.



Table 2-6 URL DSLAM provider parameters

iv Click on the OK button. The URL provider appears in the DSLAM providers list.

14 Click on the Synchronize DSLAM button to synchronize the DSLAM providers. See the 5530 Network Analyzer User Guide for more information about DSLAM providers and synchronization.

Procedure 2-11 To stop the 5530 NA GUI

Choose File→Close or File→Exit to close the browser.

Parameter Description Options

Provider name * Specifies the name for the list of nodes

Enter characters that should be unique

URL * Specifies the location of the nodes

URL, for example:

file:///home/Operator1/other/eml_im.txt

http://myserver/dslams.csv

http://username:password@myserver/dslams.csv

The format for the file is comma-separate with the following information:

ASAM name (mandatory), ASAM IP address (mandatory), ASAM SNMP port (optional, default is 161), ASAM SNMP read-community (optional, default is public), ASAM SNMP write-community (options, default is public), for example:

DSLAM1,192.168.13.51

or

DSLAM2,192.168.13.52,5161,test,test

If you do not use the default values, you must specify a value for all the optional parameters in the order listed above.

To test the URL, enter the URL in a browser. Note that the server for the URL may have different access privileges than the access privileges for your workstation.



3.1 Upgrading overview 3-2



3.1 Upgrading overview

You can only upgrade line quality diagnosis results from a previous release to Release 4.1.

A new License Key is required after you upgrade the 5530 NA server. Contact your Alcatel technical support representative for information about how to upgrade the 5530 NA.


Backing up and restoring the database

4 — Backing up and restoring the database




4.1 Database back up and restore overview 4-2

4.2 Backing up the database 4-2

4.3 Restoring the database 4-3



4.1 Database back up and restore overview

You can back up and restore the 5530 NA database using Procedures 4-1 and 4-2.

For more advanced backup and restore procedures, Alcatel recommends that you use third-party software packages to create database backups and to manage backups for mysql database servers. See the following URL:

http://www.mysql.com

4.2 Backing up the database

The following procedure describes how to back up the 5530 NA database.

Procedure 4-1 To back up the 5530 NA database

1 As ni on the 5530 NA server, change to the mysql directory by typing:

cd /opt/ni/bin ↵

2 To create the backup script, type:

./ni_backup.sh ↵

The backup script moves the database to the /dat/backup directory. The format of the backed up database file is: 5530-YYMMDDhhmm.sql.bz2.

3 To store the backed up database:

a In another directory, type:

-d directory name ↵

where directory name is the directory path for the backed up database

b With a different filename, type:

-f filename ↵

where filename is the filename of the backed up database

The extension .bz2 is added to the end of the filename.

Note 1 — Alcatel recommends that you perform this procedure when the activity of the 5530 NA is low, for example, at midnight.

Note 2 — Alcatel recommends that you monitor the directory that contains multiple backup files for disk space.



4.3 Restoring the database

The following procedure describes how to restore the 5530 NA database.

Procedure 4-2 To restore the 5530 NA database

This procedure stops the 5530 NA server, deletes the database, and restores the backed up database.

1 As ni on the 5530 NA server, change to the mysql directory by typing:

cd /opt/ni/bin ↵

2 Restore the backed up database by typing:

./ni_restore.sh directory_and_filename ↵

where directory_and_filename is the directory path and name of the backed up database, as set in step 3 in Procedure 4-1, in the format, 5530-YYMMDDhhmm.sql.bz2

Note — Alcatel recommends that you use this procedure when the activity of the 5530 NA is low, for example, at midnight.




Customization

5 — Probable cause and repair advice message customization

6 — GUI translation




5.1 Probable cause and repair advice message customization overview 5-2

5.2 Customizing probable cause and repair advice messages 5-2



5.1 Probable cause and repair advice message customization overview

Probable cause and repair messages, which appear on the 5530 NA GUI for line quality or equipment fault diagnoses, can be customized for the following user types:

• CSR• NOC• service provider

The 5530 NA provides default probable cause and repair advice messages for the NOC user type. To create probable cause and repair advice messages for the CSR and service provider user types, you must modify the default NOC probable cause and repair advice messages.

The probable cause and repair advice messages can be translated, as described in Procedure 6-1.

5.2 Customizing probable cause and repair advice messages

You can customize probable cause and repair advice messages.

Procedure 5-1 To modify probable cause and repair advice messages for a CSR or NOC

This procedure affects all accounts with an account profile when the View type parameter is set to CSR and NOC, and all accounts with a service provider.

1 As ni on the 5530 NA server, change to the directory that contains the language file by typing:

cd NA_Installation/server/jboss-4.0.2/server/ni/nadeploy ↵

where NA_Installation is the 5530 NA installation directory

2 Create a temporary directory, by typing:

mkdir -p temp/unzipped ↵

where temp is the name of the temporary directory

3 Unzip the 100-ni-default-resources.zip file in the temporary directory, by typing:

unzip -d temp/unzipped 100-ni-default-resources.zip ↵


4 Create a directory to save the modified property files, by typing:

mkdir temp/dist ↵




5 Edit the property files that are located in the temp/unzip directory. Table 5-1 lists the property files.


where unzip is the name of the folder that contains the unzipped files

Table 5-1 Property files

For example, to create a CSR version, change the following line:

startday=Good morning {0}

to:

startday=Hi {0}

The place holders (for example, {0}) are for variable information, such as dates or user names.

You can add HTML tags to modify the format of the text, for example, italics, bold, or underline. For example, to italicize, enter:

startday=<|> Hi {0} </|>

The text appears as: Hi

6 Add suffixes and save the property files.

a For CSR problemdescriptions and repairaction files property files, add a CSR suffixes, in uppercase.

For example, change:

problemdescription.properties

to:

problemdescription_CSR.properties

b For service provider problemdescriptions and repairaction property files, add an SP suffix, in uppercase.

For example, change:


Property file Description

problemdescription.properties Network diagnosis problem messages

repairaction.properties Network diagnosis repair advice messages

Note — If a place holder is deleted from the property file, the English value is used on the GUI.



to:

problemdescription_SP.properties

You can create multiple service provider problem and repair advice descriptions, for example, problemdescription_SP1.properties and problemdescription_SP2.properties. Only the accounts with the Service parameter set to same service provider name are affected. For example, the problemdescription_SP1.properties file does not affect accounts that have the Service provider parameter set to SP2.

c For NOC problemdescriptions and repairaction property files, you can modify the files without renaming or adding a suffix.

7 Create a directory for the modified property files by typing:

/NA_Installation/server/jdk/bin/nativetoascii temp/unzipped/ni-web.properties temp/dist/ni-web_SUFFIX.properties ↵

where

NA_Installation is the 5530 NA installation directory

temp is the name of the temporary directory

SUFFIX is the ISO country code and must be lowercase, the CSR or SP must be in uppercase. For example, a CSR or SP version of the problemdescriptions property files in French is problemdescription_fr_CSR.properties.

Nativetoascii converts the property files to ASCII format.

8 Repeat step 7 for each property file.

9 Zip and move all the modified property files to the nadeploy directory by typing:

cd temp/dist ↵

zip /NA_Installation/server/jboss-4.0.2/server/ni/nadeploy/100-ni-SUFFIX-resources.zip *.properties ↵

where

temp is the name of the temporary directory

NA_Installation is the 5530 NA installation directory

SUFFIX is the ISO country code and must be lowercase, the CSR or SP must be in uppercase. For example, a CSR or SP version of the problemdescriptions property files in French is problemdescription_fr_CSR.properties.

10 Stop the 5530 NA server by typing:

bin/ni_server stop ↵

The 5530 NA server stops.

11 Restart the 5530 NA server by typing:

bin/ni_server start ↵

The 5530 NA server starts.



12 Start the 5530 NA GUI.

i Open a browser and navigate to http://server:port number

whereserver is the name of the 5530 NA serverport number is the port number for the web server

For example: https://naserver:8443 or http://naserver:8080

ii Depending on your browser, one or more security certificates may appear. Click on the Yes or OK button to continue.

The 5530 Network Analyzer login prompt appears.

iii Enter your user name and password.

iv Click on the Log in button. The 5530 NA GUI appears.

Note — Contact your Alcatel technical support representative for the user name and password if you are starting the 5530 NA GUI for the first time as the administrator.





6.1 GUI translation overview 6-2

6.2 Translating the GUI 6-2



6.1 GUI translation overview

By default, the 5530 NA GUI is in English. It can be translated into another language. The translation is performed on the 5530 NA server; all accounts are affected. The language options are specified by ISO 639-2. Alcatel recommends that you refer to the material provided by the ISO for more information.

The probable cause and repair advice messages can be customized for CSR, NOC, and service provider user types, as described in Procedure 5-1.

6.2 Translating the GUI

Perform the following procedure to translate the 5530 NA GUI.

Procedure 6-1 To translate the 5530 NA GUI

You can translate the 5530 NA GUI, including the CSR and NOC probable cause and repair advice messages.

1 Perform steps 1 to 4 in Procedure 5-1.

2 Edit the property files that are located in the temp/unzip directory. Table 6-1 lists the property files.


where unzip is the name of the folder that contains the unzipped files

Table 6-1 Property files

Note — The 5530 NA documentation is only published in English.


action.properties Network diagnosis execution messages

application-framework.properties System-wide property files

bulkdatacollector.properties Bulk collector text strings

dashboard.properties Dashboard text strings

datacollection.properties Statistics collection text strings

dlm.properties DLM text strings

dlminspection.properties DLM inspection text strings

html.properties General HTML text strings, for example, hyperlink text

impact.properties Network diagnosis impact messages

importExport.properties Importing and exporting text strings

(1 of 2)



For example, to translate the 5530 NA to French, change the following line:

startday=Good morning {0}

to:

startday=Bonjour {0}

The place holders (for example, {0} and {1}) are for variable information, such as dates or user names.

3 Add suffixes and save the property files.

a For problemdescriptions and repairaction property files with a CSR version, add language-specific suffixes, in lower case, and CSR suffixes, in upper case. For example, when you translate the problemdescription.property file into French for a CSR, rename the file:


to:

problemdescription_fr_CSR.properties

intelligence.properties System-wide property files, including network diagnosis

mvc.properties DSLAM-related text strings

na.properties Network assessment text strings

ni-web.properties System-wide property files, including network diagnosis

problemdescription.properties Network diagnosis problem text strings

problemdescription_csr.properties Network diagnosis problem text strings for CSRs

repairaction.properties Network diagnosis repair advice messages

role.properties Profile role messages

scenario.properties Network diagnosis text strings

selt.properties SELT text strings

security.properties Northbound access text stings

shared.properties System-wide property files, including network diagnosis

snmp.properties SNMP related text strings

user-management.properties User management text strings

util.properties Non-system related text strings, for example, mail properties

Note — If a place holder is deleted from the property file, the English value is used on the GUI.


(2 of 2)



b For all other property files, including modified problemdescriptions and repairaction files property files for NOC, add language-specific suffixes, in lower case, to the names of all the translated resource properties files. For example, if you are translating the GUI into French, rename the file:

ni-web.properties

to:

ni-web_fr.properties

4 Perform steps 7 to 12 in Procedure 5-1.

5 To change the locale to the translation language for existing accounts:

i Choose Administration→User management from the 5530 NA main menu. The User management window appears.

ii Choose an account. The User properties window appears.

iii Set the Locale parameter to the translation language.

iv Click on the OK button.

The 5530 NA GUI uses translated information and the new or modified versions of the property files.

Note — The default for the Locale parameter is set to the translation language for new accounts.

Note — The 5530 NA online documentation is not translated and is only available in English.

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 GL-1April 2006 3EQ 10056 AAAA RJAAA

Glossary

Numerics

5530 NA 5530 Network Analyzer

The 5530 NA performs analysis and diagnosis of DSLs for ADSL, SHDSL, VDSL, and multi-DSL cards on element-managed nodes.

7300 ASAM 7300 Advanced Services Access Manager

7301 ASAM 7301 Advanced Services Access Manager

Release 5.0 or later of the 7300 ASAM.

7302 ISAM 7302 Intelligent Services Access Manager

C

CSR customer service representative

D

DLM dynamic line management

DSL digital subscriber line

A DSL carries data at high speeds over standard copper telephone wires.

DSLAM digital subscriber line access multiplexer

DSLAM provider EML and URL providers.

Glossary

GL-2 Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

E

EML element management layer

EML provider A type of DSLAM provider. An EML provider is the element-management system for 7300 ASAM, 7301 ASAM, and 7302 ISAM nodes.

G

GUI graphical user interface

A GUI is a computer user interface that incorporates graphics to make software easier to use.

H

HTTP hypertext transfer protocol

HTTPS secure hypertext transfer protocol

M

MDF main distribution frame

A distribution frame on one part which the external trunk cables enters a facility terminate and on another part of which the internal user subscriber lines and trunk cabling to any intermediate distribution frames terminate.

The MDF is used to cross-connect any outside line with any desired terminal of the multiple cabling or any other outside line. The MDF usually holds central office protective devices and functions as a test point between a line and the office.

N

NA network analyzer

ni See NA.

NOC Network Operations Center

S

SELT single-ended line testing

SELT is automatic testing of a DSL loop between the CO and the subscribers equipment.

Glossary

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 GL-3April 2006 3EQ 10056 AAAA RJAAA

SMTP Simple Mail Transfer Protocol

SMTP is the IETF standard for transferring electronic mail messages from one computer to another. It is the main protocol used to send electronic mail on the Internet. SMTP consists of a set of rules for how a program sending mail and a program receiving mail should interact.

SNMP Simple Network Management Protocol

SNMP is the IETF Internet network management protocol, the standard protocol for LAN management. SNMP provides the means to monitor and set network configuration and runtime parameters. SNMP originated in the Internet community as a response to the need to manage TCP/IP devices. SNMP provides access to a device’s MIB.

Examples of SNMP-compatible devices include routers, hubs, and switches. A device is SNMP compatible if it can be monitored and/or controlled using SNMP messages. Devices that are SNMP compatible contain SNMP agent software to receive, send, and act upon SNMP messages.

Solaris An operating system used by Sun workstations.

SP service provider

T

TCP transmission control protocol

TFTP trivial file transfer protocol

U

UDP user datagram protocol

URL provider A type of DSLAM provider. A URL provider is a URL to a list of Alcatel nodes that is used to synchronize the nodes with the 5530 NA.

W

workstation A workstation is a personal computer or Sun workstation, that can be used to perform tasks using the 5530 NA GUI.

Glossary

GL-4 Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 IN-1April 2006 3EQ 10056 AAAA RJAAA

Index

Numbers

5530 NA, 1-2ports, 1-2protocols, 1-2server, 1-3server configuration, 1-4

5530 NA GUIproperty files, 6-2starting, 2-10stopping, 2-16translating, 6-2

5530 NA serverbacking up database, 4-2changing password, 2-6cluster configuration, 1-4directories, 2-4displaying status, 2-9increasing performance, 2-8installation, 2-2installing for cluster configuration, 2-4installing for multiple nodes, 2-4installing for one node, 2-2licensing, 2-10log file, 2-9logging in, 2-6multiple node configuration, 1-4platform requirements, 1-3restoring database, 4-3

setting connection to HTTP, 2-7setting connection to HTTPS, 2-7single node configuration, 1-4sizing tool, 2-8starting, 2-9starting SELT, 2-8stopping, 2-10synchronizing, 2-10system requirements, 1-3upgrading, 3-2

A

administratorlogging in for first time, 2-10

B

backing up database, 4-2browser

requirements, 1-3

C

cluster, 1-4CSR

creating probable cause messages, 5-2creating repair advice messages, 5-2translating probable cause messages, 6-2translating repair advice messages, 6-2

Index

IN-2 Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

D

databasebacking up, 4-2restoring, 4-3

directorieson the 5530 NA server, 2-4

DSLAM providersadding, 2-10synchronizing, 2-10

H

HTTPsetting, 2-7

HTTPSsetting, 2-7

I

installing, 2-25530 NA server for multiple nodes, 2-45530 NA server for one node, 2-2platform requirements, 1-3tasks, 2-2

L

License Keysentering, 2-10

log file, 2-9logging in, 2-6

N

NOCmodifying probable cause messages, 5-2modifying repair advice messages, 5-2translating probable cause messages, 6-2translating repair advice messages, 6-2

O

online documentationinstalling, 2-2

P

passwordchanging, 2-6

platform requirements, 1-35530 NA server, 1-3

ports, 1-2probable cause messages, 5-2

modifying for CSR, 5-2modifying for NOC, 5-2translating, 6-2

protocols, 1-2

R

repair advice messages, 5-2modifying for CSR, 5-2modifying for NOC, 5-2translating, 6-2

restoring database, 4-3

S

SELT, 2-7server; See 5530 NA serversizing tool, 2-8SMTP, 1-2SNMP, 1-2starting

5530 NA GUI, 2-105530 NA server, 2-9SELT, 2-8

stopping5530 NA GUI, 2-165530 NA server, 2-10

system requirements, 1-35530 NA server, 1-3browsers, 1-3

T

TCP ports, 1-2Telnet, 1-2TFTP, 1-2translation, 6-2

GUI, 6-2

D — translation

Index

Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1 IN-3April 2006 3EQ 10056 AAAA RJAAA

U

UDP ports, 1-2upgrading, 3-2

platform requirements, 1-3

U — upgrading

Index

IN-4 Alcatel 5530 Network Analyzer Installation and Customization Guide, Release 4.1April 2006 3EQ 10056 AAAA RJAAA

Customer documentation and product support

Technical support

Customer documentation

Product manuals and documentation updates are available through the Alcatel SupportDocumentation and Software Download service at Alcatel.com. If you are a new user andrequire access to this service, please contact your Alcatel sales representative.

Customer documentation feedback

http://www.alcatel.com/support/

http://www.alcatel.com/osds/

[email protected]

© 2006 Alcatel. All rights reserved.3EQ 10056 AAAA RJAAA Edition 01

Lap Dat

Documents

alcatel logo

alcatel harmless

return key prefaceiv

network analyzer installation

network analyzer release

network analyzer user

incomplete information

disclaimersalcatel products