Element Management Launcher

Operating Instructions

23/1543-LZA 701 6014/1 Uen H1

Copyright

© Ericsson AB 2016, 2017. All rights reserved. No part of this document may
be reproduced in any form without the written permission of the copyright
owner.

Disclaimer

The contents of this document are subject to revision without notice due to
continued progress in methodology, design and manufacturing. Ericsson shall
have no liability for any error or damage of any kind resulting from the use of
this document.

Trademark List

All trademarks mentioned herein are the property of their respective owners.
These are shown in the document Trademark Information.

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22

 Contents

Contents

1 Introduction 1
1.1 Supported Client Environment 1
1.2 Compatibility 1

2 Procedure 2
2.1 Install Element Management Launcher 2
2.2 Uninstall the Element Management Launcher 2
2.3 Start and Install a Node Management Tool 3

3 Address Handling 4
3.1 Add Address 4
3.2 Remove Address 4
3.3 Prepare Address List 4
3.4 Mark Address as Favorite 4
3.5 Search 4

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22

Element Management Launcher

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22

 Introduction

1 Introduction

This instruction describes how to install and use the Element Management
Launcher.

The Element Management Launcher is a tool that is used to install and start
the available node management tools, for example the Element Management
Command Line Interface (EMCLI).

For each node, one or more node management tools are available.

1.1 Supported Client Environment

Table 1 describes the supported operating systems needed to run Element
Management Launcher.

Table 1 Supported Operating Systems

Operating System Version
Windows (American English) Vista
7
8

Note:
Due to compatibility issues between Windows 10 and Java Runtime
Environment (JRE) 8, EMCLI fails on Windows 10 with JRE 8.

As an alternative solution, use JRE 6 or 7.

1.2 Compatibility
A new generation of node types, which supports HTTPS, requires a
corresponding new version of the Element Management Launcher. This
version of Element Management Launcher contains support for both, old and
new node types. Therefore, it is recommended to replace any previous
Element Management Launcher installation with the new version.

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22 1

 Element Management Launcher

2 Procedure

Follow the instructions, to do one of the following:

• Install Element Management Launcher

• Uninstall Element Management Launcher

• Start and Install a Node Management Tool

If the procedures are performed on-site, first follow the instructions in Connect
Client to connect the computer to the node.

2.1 Install Element Management Launcher

Element Management Launcher is a tool which is used to install and start the
node management tools. The Element Management Launcher installation
package is downloaded through a web page on the node.

The web-page is node management tool specific. It contains installation

instructions for the Element Management Launcher and programs which
enable the node management tool function. The installation package is part of
the Element Management application package on the node.

To install the Element Management Launcher, enter one of the following

addresses in a web browser and follow the instructions on the web-page:

• For nodes supporting HTTP, use http://<IP address>/em/

index.html

• For nodes supporting HTTPS, use https://<IP address>/em/

index.html

For a list of the different port numbers refer to EMCLI.

If off-site, use the IP address of a TN port. The IP address of the TN port is set
during integration.

Note: When accessing nodes supporting HTTPS, a trusted certificate must

be downloaded and installed on the client before connecting to the
node, as described in EMCLI.

2.2 Uninstall the Element Management Launcher

The Element Management Launcher is removed when the tool is uninstalled,
together with all other files created during the installation.

2 23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22

 Procedure

To uninstall the Element Management Launcher, follow the instructions to

uninstall programs for the relevant operating system.

2.3 Start and Install a Node Management Tool

The Element Management Launcher fetches and installs a node management
tool the first time the node management tool is started.

To start a node management tool from the Element Management Launcher,

proceed as follows:

Steps

1. Click the Element Management Launcher start icon.

2. Select a node address in the Element Management Launcher window, or

enter the node address in the Address field.
The available node management tools are displayed as buttons on the
right side of the Element Management Launcher window.

Note: For more information on how to add, remove, and search for
addresses in the address field, see Address Handling on page
4.

3. Click on a the required node management tool button to start the

management tool.

Note: When launching an element management tool for a node

providing an HTTPS web server, the Element Manager Launcher
will try to validate the node credentials against a trusted
certificate. If that fails, a certificate validation error message will
be displayed.

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22 3

 Element Management Launcher

3 Address Handling

3.1 Add Address

To add a node address to the currently displayed address list, enter the IP
address in the Address field and click on the Add icon. It is possible to add a
name and a comment to the address.

3.2 Remove Address

To remove an address from the currently displayed list, select the address in
the list and click on the Remove icon.

3.3 Prepare Address List

An address list can be prepared in advance by scripting. The address list is
stored in the file, <user home>/Ericsson/visited.dat. The favorites list
is stored in visited_favorites.dat in the same directory.

The format is:

<address><space><name><semicolon><comment><semicolon>, see
Example 1. The name and comment fields are restricted to printable
characters except semicolon (;). The address must not contain a space or
semicolon. End each line with carriage return and line feed until the last line is
entered.

Example 1 Example of the Address List Format in visited.dat

12.34.123.56:8080 RBS_1233;Main Street, Solna;
12.68.130.160:8080 RBS_00123;Abbey Road 88, Stockholm;

3.4 Mark Address as Favorite

To mark an address as favorite, select a node address line and click the
Favorite icon. The node address is now marked as a favorite, with a mark in
the Favorite column. To Unmark a favorite, select a favorite node address and
click the Favorite icon. The node address will be unmarked in the right-most
column. To find all favorite node addresses, click the Favorite column header
to get a sorted list.

3.5 Search
Click each column heading to sort the contents in alphanumerical order.

4 23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22

 Address Handling

Enter search criteria in any of the text fields below the table, as follows:

• Characters entered in the Address field are compared character-by-

character with the first column of the list, and shows the addresses
beginning with the same characters.

• The search function in the Name and Comment fields filters the list
content to the occurrences of those lines containing the character-string
anywhere in the respective column. The search is case insensitive.

23/1543-LZA 701 6014/1 Uen H1 | 2017-11-22 5