transconnect_imn

8/10/2019 transconnect_imn

1/48

Nokia Siemens Networks

TransConnect

8.10

Nokia Siemens Networks TransConnectInstallation Manual for Windows

A42022-L5978-J520-05-7630

Issue: 5 Issue date: September 2012

Nokia Siemens Networks is continually striving to reduce the adverse environmental effects of

its products and services. We would like to encourage you as our customers and users to join

us in working towards a cleaner, safer environment. Please recycle product packaging and

follow the recommendations for power use and proper disposal of our products and theircomponents.

If you should have questions regarding our Environmental Policy or any of the environmental

services we offer, please contact us at Nokia Siemens Networks for any additional information.


2/48

2 A42022-L5978-J520-05-7630Issue: 5 Issue date: September 2012

Nokia Siemens Networks TransConnect InstallationManual for Windows

The information in this document is subject to change without notice and describes only the

product defined in the introduction of this documentation. This documentation is intended for the

use of Nokia Siemens Networks customers only for the purposes of the agreement under whichthe document is submitted, and no part of it may be used, reproduced, modified or transmitted

in any form or means without the prior written permission of Nokia Siemens Networks. Thedocumentation has been prepared to be used by professional and properly trained personnel,

and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes

customer comments as part of the process of continuous development and improvement of the

documentation.

The information or statements given in this documentation concerning the suitability, capacity,

or performance of the mentioned hardware or software products are given "as is" and all liability

arising in connection with such hardware or software products shall be defined conclusively andfinally in a separate agreement between Nokia Siemens Networks and the customer. However,

Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions

contained in the document are adequate and free of material errors and omissions. Nokia

Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which

may not be covered by the document.

Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO

EVENT WILL NOKIA SIEMENS NETWORKS BE LIABLE FOR ERRORS IN THIS DOCUMEN-TATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT,

INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT

LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS

OPPORTUNITY OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT ORTHE INFORMATION IN IT.

This documentation and the product it describes are considered protected by copyrights and

other intellectual property rights according to the applicable laws.

The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark

of Nokia Corporation. Siemens is a registered trademark of Siemens AG.

Other product names mentioned in this document may be trademarks of their respectiveowners, and they are mentioned for identification purposes only.

Copyright Nokia Siemens Networks 2012. All rights reserved.

f Important Notice on Product SafetyThis product may present safety risks due to laser, electricity, heat, and other sourcesof danger.

Only trained and qualified personnel may install, operate, maintain or otherwise handle

this product and only after having carefully read the safety information applicable to this

product.

The safety information is provided in the Safety Information section in the Legal, Safety

and Environmental Information part of this document or documentation set.

The same text in German:

f Wichtiger Hinweis zur ProduktsicherheitVon diesem Produkt knnen Gefahren durch Laser, Elektrizitt, Hitzeentwicklung oder

andere Gefahrenquellen ausgehen.

Installation, Betrieb, Wartung und sonstige Handhabung des Produktes darf nur durch

geschultes und qualifiziertes Personal unter Beachtung der anwendbaren Sicherheits-

anforderungen erfolgen.

Die Sicherheitsanforderungen finden Sie unter Sicherheitshinweise im Teil Legal,Safety and Environmental Information dieses Dokuments oder dieses Dokumentations-

satzes.


3/48

A42022-L5978-J520-05-7630Issue: 5 Issue date: September 2012

3


Table of ContentsThis document has 48 pages.

1 Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.1 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.2 Structure of this document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.3 Documentation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

1.3.1 Nokia Siemens Networks TransNet operating documentation . . . . . . . . 8

1.3.2 Nokia Siemens Networks TransConnect operating documentation. . . . . 9

1.3.3 Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.3.4 Searching the PDF documentation set content . . . . . . . . . . . . . . . . . . . 10

1.4 Symbols and conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.5 Nokia Siemens Networks TransNet / TransConnectversion and software variants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.6 History of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.1 Server hardware prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.2 Server software prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.3 Nokia Siemens Networks TransConnect l icense file . . . . . . . . . . . . . . . 15

2.4 Client hardware prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.5 Client software prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.1 Installing the software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.2 Start ing the Nokia Siemens Networks TransConnect server. . . . . . . . . 27

3.3 Configuring a firewall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

3.4 Administering users with Nokia Siemens Networks TransConnect. . . . 28

3.5 Sharing projects with Nokia Siemens Networks TransNet. . . . . . . . . . . 31

4 Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

4.1 Uninstalling the software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

5 Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.1 Upgrading from Nokia Siemens NetworksTransConnect 8.00 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.2 Upgrading from Nokia Siemens NetworksTransConnect < 8.00 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

5.3 Determining the Nokia Siemens Networks TransConnectversion currently installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

6 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

6.1 Windows account TC_USER cannot be created during installation . . . 39

6.2 Server cannot be started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

6.3 Nokia Siemens Networks TransConnect Login pagecannot be displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

6.4 Log on to the server is not possible due to a server error . . . . . . . . . . . 43

7 Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

7.1 Creating an SSL certif icate file for HTTPS connection . . . . . . . . . . . . . 44

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47


4/48



List of FiguresFigure 1 Nokia Siemens Networks TransConnect Web server configuration . . . . 17

Figure 2 Nokia Siemens Networks TransNet client/server configuration . . . . . . . 18

Figure 3 Installation wizard, Introduction page . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Figure 4 Installation wizard, Choose Install Folder page . . . . . . . . . . . . . . . . . . . 21

Figure 5 Installation wizard, Choose Shortcut Folder page . . . . . . . . . . . . . . . . . 22

Figure 6 Installation wizard, Choose License File page . . . . . . . . . . . . . . . . . . . . 23

Figure 7 Installation wizard, Choose SSL Certificate page. . . . . . . . . . . . . . . . . . 23

Figure 8 Installation wizard, Choose Datastore Folder page . . . . . . . . . . . . . . . . 24

Figure 9 Installation wizard, Server Administrator Account page . . . . . . . . . . . . . 25

Figure 10 Installation wizard, TC_USER Password page. . . . . . . . . . . . . . . . . . . . 26

Figure 11 Nokia Siemens Networks TransConnect Login page . . . . . . . . . . . . . . . 29

Figure 12 Nokia Siemens Networks TransConnect All Projects page . . . . . . . . . . 30

Figure 13 Nokia Siemens Networks TransConnect Logout page . . . . . . . . . . . . . . 31Figure 14 Uninstallation wizard, Introduction page . . . . . . . . . . . . . . . . . . . . . . . . . 34

Figure 15 Remove Windows user account message box. . . . . . . . . . . . . . . . . . . . 34

Figure 16 Installation wizard, Choose Datastore Folder page . . . . . . . . . . . . . . . . 36

Figure 17 Installation wizard, Choose Datastore Folder page 2 . . . . . . . . . . . . . . . 37

Figure 18 Warning message on failing to create the TC_USER account. . . . . . . 39

Figure 19 Error message during Nokia Siemens Networks TransConnectserver start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Figure 20 Error message while trying to logon to the Nokia Siemens NetworksTransConnect server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43


5/48


5


List of TablesTable 1 Overview of document structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Table 2 List of symbols and conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Table 3 Document history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Table 4 TCP ports used by the Nokia Siemens Networks TransConnect server 41


6/48




7/48


7


Preface

1 PrefaceNokia Siemens Networks TransConnect is the software product providing the file and

Web server solution for creating new services in an existing Nokia Siemens Networks

hiT 7300 and SURPASS hiT 7500 optical transport network (hereinafter referred to as

hiT 7300 and hiT 7500) that was already setup with Nokia Siemens Networks TransNet.

The file server makes a centralized repository of project files available and the Web

server hosts the easy-to-use Nokia Siemens Networks TransConnect graphical user

interface (GUI), a cloud computing Web application for planning channel upgrades in an

existing optical network.

Nokia Siemens Networks TransConnect provides the server software required for the

following configurations (see chapter 3 Installationfor details):

Nokia Siemens Networks TransConnect Web server configuration

Nokia Siemens Networks TransNet client/server configuration

The license file to be installed on the server (see section 2.3 Nokia Siemens NetworksTransConnect license file) decides for which configuration Nokia Siemens Networks

TransConnect can be used.

This manual describes the Nokia Siemens Networks TransConnect software installa-

tion, uninstallation and upgrade procedure. It describes also the remaining post-instal-

lation steps necessary to setup the Web server.

This chapter describes the audience, structure, conventions, history of changes and

prerequisites of the Nokia Siemens Networks TransConnect Installation Manual for

Windows.

1.1 Intended audienceThis manual addresses customers or Nokia Siemens Networks staff whose task is to

perform Nokia Siemens Networks TransConnect software installation on the Microsoft

Windows operating system. This manual is only relevant for the A350 and A360

software variants (see section 1.5 Nokia Siemens Networks TransNet / TransConnect

version and software variants).

1.2 Structure of this document

This manual comprises the following main chapters:

Chapter Subject

1 Preface Introduction and overview of this document (this chapter)

2 Prerequisites Hardware, software and license prerequisites

3 Installation Installation of the software, start of the server, configuration

of a firewall, user administration on the server with Nokia

Siemens Networks TransConnect and project file sharing

4 Uninstallation Uninstallation of the software

5 Upgrade Software upgrade procedure and display of version informa-

tion

Table 1 Overview of document structure


8/48



Preface

1.3 Documentation overview

This section provides the following information:

Nokia Siemens Networks TransNet operating documentation overview (section

1.3.1)

Nokia Siemens Networks TransConnect operating documentation overview (section

1.3.2)

Related documentation overview (section 1.3.3)

Information on how to search all documents of a PDF documentation set (section

1.3.4)

1.3.1 Nokia Siemens Networks TransNet operating documentation

The Nokia Siemens Networks TransNet operating documentation consists of manuals,

help system and videos. The manuals are delivered as part of the Nokia Siemens

Networks TransNet / TransConnect documentation set. The help system and videos are

delivered together with the Nokia Siemens Networks TransNet software.

The following operating documentation parts are available:

Nokia Siemens Networks TransNet Installation Manual

addresses customers or Nokia Siemens Networks staff whose task is to perform the

Nokia Siemens Networks TransNet software installation.

Nokia Siemens Networks TransNet User Manual

gives an overview of the functionality and the necessary steps to perform the indi-

vidual tasks with Nokia Siemens Networks TransNet. In general, the details of oper-

ation in terms of working with the graphical user interface (GUI), the description of

the GUI itself and the parameters are out of scope of this manual but covered

instead in the Nokia Siemens Networks TransNet help system.

It is intended for Nokia Siemens Networks TransNet users working under the Link /

Network Planner software license (account) offering the complete functionality

needed for an efficient network planning. Nokia Siemens Networks TransNet GUI Description for A3x2 software variant

provides a description of the functions exclusively available in the A302/A312

software variant and any change compared to the A300/A310 software variant (see

section 1.5 Nokia Siemens Networks TransNet / TransConnect version and

software variants). The common set of function available for both the A300/A310

and A302/A312 software variants is described in the Nokia Siemens Networks

TransNet User Manual and help system.

Nokia Siemens Networks TransNet Open Source Licenses

provides information on the Open Source software used in Nokia Siemens Networks

TransNet and license text information.

6 Troubleshooting Possible errors occuring during software installation/config-

uration and suitable corrective actions

7 Appendix Procedure for creating a SSL certificate file

Chapter Subject

Table 1 Overview of document structure (Cont.)


9/48


9


Preface

Nokia Siemens Networks TransNet help system

gives users detailed step-by-step instructions for the tasks to perform with the Nokia

Siemens Networks TransNet GUI and includes context-sensitive help on window-

level, that is, for dialog boxes, wizard pages, editor and views.

The help system can be called from the Helpmenu and is displayed in an Help

browser window of its own.

Nokia Siemens Networks TransNet videos

demonstrate the individual steps of a workflow showing how a certain step can be

performed with the Nokia Siemens Networks TransNet GUI. A video presents a

screen capture of the GUI, the interaction of a user with the GUI and is supple-

mented with text boxes, for example, to introduce the individual workflow steps. A

set of greenfield planning workflow videos for different node types are available.

The videos can be called from the help system: The Tutorials and workflows help

book has individual help topics for every video. A video is realized as Flash anima-

tion and is shown in the same Help browser also used for displaying the help system

topics.

1.3.2 Nokia Siemens Networks TransConnect operating documentation

The Nokia Siemens Networks TransConnect operating documentation consists of

manuals and help system. The manuals are delivered as part of the Nokia Siemens

Networks TransNet / TransConnect documentation set. The help system is delivered

together with the Nokia Siemens Networks TransConnect software.

The following operating documentation parts are available:

NCP Workflow Description

is intended for all persons that require a general introduction and overview of the

Network Control Platform (NCP) solution and its workflows.This manual is only relevant for the A312 and A362 software variants (see section

1.5 Nokia Siemens Networks TransNet / TransConnect version and software vari-

ants).

Nokia Siemens Networks TransConnect Installation Manual for Windows

addresses customers or Nokia Siemens Networks staff whose task is to perform the

Nokia Siemens Networks TransConnect software installation on Microsoft Windows

operating system.

This manual is only relevant for the A350 and A360 software variants.

Nokia Siemens Networks TransConnect Installation Manual for Solaris

addresses customers or Nokia Siemens Networks staff whose task is to perform

Nokia Siemens Networks TransConnect software installation and administration onthe Solaris operating system.

This manual is only relevant for the A362 software variant.

Nokia Siemens Networks TransConnect Open Source Licenses

provides information on the Open Source software used in Nokia Siemens Networks

TransConnect and license text information.


10/48



Preface

Nokia Siemens Networks TransConnect help system

gives users detailed step-by-step instructions for the tasks to perform with the Nokia

Siemens Networks TransConnect Web GUI and includes context-sensitive help on

window-level, that is, for pages, panel and dialog boxes.

It is intended for Nokia Siemens Networks TransConnect users accessing the server

with a Web browser after they logged on to the Nokia Siemens Networks TransCon-

nect server.

The help system can be called from Nokia Siemens Networks TransConnect's

header (Helpicon) and is displayed in an Web browser window of its own showing

context-sensitive help for the page currently displayed. By clicking Show Naviga-

tionat the top of a context-sensitive help page this page is extended with the Nokia

Siemens Networks TransConnect help system table of contents.

1.3.3 Related documentation

Additional information is available for the network elements (NE) supported by NokiaSiemens Networks TransNet / TransConnect:

hiT 7300 network element (NE) operating documentation

hiT 7500 network element (NE) operating documentation

hiT 7300 SON network element (NE) operating documentation

g Besides the operating documentation, refer always to the release information includedwith the current Nokia Siemens Networks TransNet / TransConnect version and the

network element (NE) versions you are using to plan your networks.

1.3.4 Searching the PDF documentation set content

In some cases it may be advantageous to search for information on a topic throughout

the complete operating documentation set. In order to do a comprehensive search,

follow the procedure below.

g The following procedure is only valid for Adobe Reader X. For other versions please usethe Adobe Reader or Acrobat Pro Help system to obtain the correct path to the search

functionality.

To make a search through all the PDF documents of an operating documentation set,

complete the following steps:

1 Make sure that all PDF files of the documentation set are present in a folder.

2 Open Adobe Reader.

3

In the Adobe Reader main menu, select the Edit> Advanced Searchmenu

command.

The Searchwindow is opened.

4

Select the All PDF Documents inbutton and in the search source list below select

the folder containing the PDF documents.

The search can be made on all computer drives, network drives, or a specific folder

using the Browse for locationsoption.

5

Enter the text word, or phrase to be searched in the What word or phrase would

you like to search for?field.


11/48


11


Preface

6

Click the Searchbutton.

The search is initiated and the results shown in the Results:area.

1.4 Symbols and conventions

The following symbols and mark-up conventions are used in this document.

Representation Meaning

wNOTICE: A property damage message indicates a hazard that may result inequipment damage, data loss, traffic interruption, and so on.

g A note provides important information related to the topic, forexample, not obvious exceptions to a rule or side effects.

t A tip provides additional information related to the topic which is

not essential in the context, but given for convenience.

Bold All names of graphical user interface (GUI) objects, such as

windows, field names, buttons, and so on.

Example: Select the Full Screencheck box and press OK.

Terms and abbreviations which are linked to an entry in the

glossary and list of abbreviations respectively.

Important key words.

Italic Files, folders, and file system paths.

Example:/usr/etc/sbin/ftpd.exe

Emphasized words.

typewriter Input to be typed in a command line or a GUI field.Examples:

ping -t 192.168.0.1

Enter Worldin the Domainfield.

Output from a command, error messages, content of a status

line, and so on.

File content, such as program sources, scripts, logs, and set-

tings.

Placeholders, for example as part of a file name or field value.

Examples:

.pngor :[square brackets] A key to be pressed on a PC keyboard, for example [F11].

Keys to be pressed simultaneously are concatenated with a +

sign, for example [CTRL]+[ALT]+[DEL].

Keys to be pressed one after another are concatenated with

spaces, for example [ESC] [SPACE] [M].

Table 2 List of symbols and conventions


12/48



Preface

Screenshots of the graphical user interface are examples only to illustrate principles.

This especially applies to a software version number visible in a screenshot.

1.5 Nokia Siemens Networks TransNet / TransConnect

version and software variants

The version number together with the software variant identifier (ID) uniquely identify the

Nokia Siemens Networks TransNet / TransConnect software.

The complete Nokia Siemens Networks TransNet and TransConnect version is

composed of the main version part (for example, 8.10), the optional minor (or mainte-

nance) version part (25) followed by the build number (37), for example, 8.10.25 Build

37.Both Nokia Siemens Networks TransNet and TransConnect are available in different

software variants. Software variants exist to distinguish the common base and the cus-

tomized version, which, for example, provides functionality for planning transientproof

networks.

The following Nokia Siemens Networks TransNet software variants exist:

A300 - Base version for networks with hiT 7300, hiT 7500 and Metro nodes

A302 - Customized version for networks with hiT 7500 nodes

A310 - Base version for networks with hiT 7300+ nodes

A312 - Customized version for networks with hiT 7300+ nodes used in the Network

Control Platform (NCP) solution

All Nokia Siemens Networks TransNet software variants are running on a Windows

operating system. For installation on a 32-bit and 64-bit Windows operating system dif-

ferent installation executable files are delivered.

The following Nokia Siemens Networks TransConnect software variants exist:

A350 - Base version for networks with hiT 7300 and hiT 7500 nodes

A360 - Base version for networks with hiT 7300+ nodes

A362 - Customized version for networks with hiT 7300+ nodes used in the Network

Control Platform (NCP) solution

The Nokia Siemens Networks TransConnect A350 and A360 software variants are

running on a Windows operating system. For installation on a 32-bit and 64-bit Windows

operating system different installation executable files are delivered. The A362 softwarevariant is running on a Solaris operating system.

> The greater than symbol > is used to concatenate a series of GUI

items in order to depict a GUI path. This is an abridged presenta-

tion of a procedure to be carried out in order to perform an actionor display a window or dialog box.

Examples:

A simple menu path: File> Save as ...

A more complex GUI path:

> Nokia Siemens Networks TransNetwindow > Filemenu >

Change Passwordcommand > Change Passworddialog box

Representation Meaning

Table 2 List of symbols and conventions (Cont.)


13/48


13


Preface

The version number and the software variant ID information is present in the file name

used for installation and by requesting About information in the running application.

Example for Nokia Siemens Networks TransNet version 8.10.25 Build 09 in its A300

software variant for a 32-bit Windows operating system: Installer file name:

TransNet_A300_8_10_25_09_32.exe

About information (Helpmenu > About Nokia Siemens Networks TransNet

command > About Nokia Siemens Networks TransNetdialog box):

Nokia Siemens Networks TransNet 8.10.25 Build 9 32 bit version

P42022-P5201-A300-07-50VA

Example for Nokia Siemens Networks TransConnect version 8.10.25 Build 37 in its

A360 software variant for a 64-bit Windows operating system:

Installer file name:

TransConnect_A360_8_10_25_37_64.exe

About information (Product banner area > Abouticon > About message box):Nokia Siemens Networks TransConnect

Version 8.10.25 (Build 37)

...

Part number: P42022-P5201-A360-02-50VA

1.6 History of changes

Issue Issue date Remarks

1 July 2011 Initial issue for version 8.10

2 October 2011 Update to cover the new functionality intro-

duced with version 8.10.02

3 February 2012 Update to cover the new functionality intro-

duced with version 8.10.10

4 July 2012 Update for 8.10.20 with minor changes only

5 September 2012 Update for 8.10.25 with minor changes only

Table 3 Document history


14/48



Prerequisites

2 PrerequisitesThis chapter summarizes the prerequisites that must be fulfilled in order to install and

use Nokia Siemens Networks TransConnect.

2.1 Server hardware prerequisites

To install and run Nokia Siemens Networks TransConnect as server, the following

hardware requirements must be met:

Central processing unit (CPU):

Intel Core Duo or compatible with 32-bit or 64-bit architecture and with 1.5 Giga-

hertz processor clock speed each

Random access memory (RAM):

4 GigaByte (GB) for 32-bit architecture and 8 GB for 64-bit architecture

2.2 Server software prerequisites

To install and run Nokia Siemens Networks TransConnect as server, the following

software requirements must be met:

Operating system:

Windows Server 2008 (32-bit architecture)

Windows Server 2008 (64-bit architecture)

FTP server software:

An FTP server must be installed and running in order to use the Nokia Siemens

Networks TransConnect functionality to upload NCFs. The FTP server must be con-

figured by creating at least an FTP server user account with appropriate access

rights. It is recommended to use one FTP user account (named "transconnect") for

all Nokia Siemens Networks TransConnect users.

Nokia Siemens Networks TransNet / TransConnect software versions:

Nokia Siemens Networks TransNet and Nokia Siemens Networks TransConnect

must be used always in the same main version 8.10 if projects on the server are

accessed by both products.

Certificate for secure connection to the Web server by HTTPS:

To prepare a Web server to accept secure connections by Hypertext Transfer

Protocol Secure (HTTPS) a public-key certificate must be stored on the Web server.

This certificate must be signed by a certificate authority (CA), for example, VeriSign,

Inc. or Thawte, Inc.. The CA certifies that the certificate holder is indeed the entity it

claims to be. A Web browser uses this certificate to validate that the Web server isauthentic: When a user connects to a Web server by typing https://...in the

Web browser's address field and the browser gives no certificate warning message,

then the user can be sure that interacting with the Web server is equivalent to inter-

acting with the entity.

The Nokia Siemens Networks TransConnect installer expects that the certificate file

is already available under the namejboss.keystore. The certificate file is requested


15/48


15


Prerequisites

during Nokia Siemens Networks TransConnect installation (see section

3.1 Installing the software).

If the certificate file is not available during installation the corresponding installer

step can be skipped and the file can be copied later manually to this directory.

Refer to section 7.1 Creating an SSL certificate file for HTTPS connectionfor infor-

mation on how to create this certificate file and to copy the file to the required direc-

tory.

2.3 Nokia Siemens Networks TransConnect license file

You can connect or log on to the Nokia Siemens Networks TransConnect server only, if

a valid license file is available on the computer running the Nokia Siemens Networks

TransConnect software.

To use Nokia Siemens Networks TransConnect as server in a client/server configura-

tion, the license file must contain the "TransConnect TN Server" feature license.

To use Nokia Siemens Networks TransConnect as server in a Web server configuration,

the license file must contain user, project and network element (NE) specific feature

licenses.

To order the license file, open the license key request file (in HTML format) that is deliv-

ered with the Nokia Siemens Networks TransConnect software. Type the required infor-

mation and click Send. This causes an E-mail to be sent to the software supply center

that will send you back the license file.

For demonstration purposes only, a so called Demo license is available. With an

installed Demo license a Nokia Siemens Networks TransConnect user can work only

with a project that contains a maximum of 10 nodes.

The license file is requested during Nokia Siemens Networks TransConnect installation(see section 3.1 Installing the software). The installer copies this file to the following

directory:

\jboss\server\

default\conf\

2.4 Client hardware prerequisites

For a computer accessing the Nokia Siemens Networks TransConnect Web server as

client by a Web browser, the following hardware requirements must be met:

Central processing unit (CPU):

Intel Pentium IV or compatible with 2 Gigahertz processor clock speed

Random access memory (RAM):

1 GigaByte (GB)

Monitor:

14" display size and 1024 x 768 resolution (19" display size and 1280 x 1024 is rec-

ommended)

2.5 Client software prerequisites

For a computer accessing the Nokia Siemens Networks TransConnect Web server as

client by a Web browser, the following software requirements must be met:

Operating system:


16/48



Prerequisites

Windows XP Service Pack 3

Windows Vista

Windows 7

Web browser: Internet Explorer 6

Internet Explorer 7

Web browser configuration:

To prevent that a file download from the server is blocked (during generation of

NCFs and reports) make sure that in the Internet Explorer the Automatic

prompting for file downloads is enabled.

To prevent that opening a file from the server is blocked (for example, while

downloading an HTML file from the server) make sure that the server name (or

server IP address) is made an exception for any installed pop-up blocker soft-

ware.

To make sure that a file generated by the server (a report) is displayed with theappropriate application, the corresponding Multipurpose Internet Mail Exten-

sions (MIME) types must be configured. Reports are generated by the Nokia

Siemens Networks TransConnect server either in PDF or CSV format.

To increase the number of files you can download at one time with Internet

Explorer 6 or 7 from (the default value) 2 to 10 install the fix available as part of

the Microsoft knowledge base (KB) article 282402 available under http://sup-

port.microsoft.com/kb/282402. This will improve Nokia Siemens Networks

TransConnect performance significantly when handlig projects with a huge

amount of nodes

To enable the correct display of animated parts in the Nokia Siemens Networks

TransConnect GUI (progress bars) make sure that playing animations in theInternet Explorer is enabled.

The Nokia Siemens Networks TransConnect help system (topic Web browser con-

figuration prerequisites) provides more information including examples for configur-

ing the Internet Explorer 6 accordingly.
http://support.microsoft.com/kb/282402http://support.microsoft.com/kb/282402http://support.microsoft.com/kb/282402http://support.microsoft.com/kb/282402


17/48


17


Installation

3 InstallationYou can use the Nokia Siemens Networks TransConnect software to realize the Nokia

Siemens Networks TransConnect Web server configurationand the Nokia Siemens

Networks TransNet client/server configuration.

Nokia Siemens Networks TransConnect Web server configuration

Figure 1 Nokia Siemens Networks TransConnect Web server configuration

The computer having the Nokia Siemens Networks TransConnect software installed

and configured acts as file and Web server. It provides a repository of project files

created and shared on the server by Nokia Siemens Networks TransNet users (file

server functionality). In addition it hosts the Nokia Siemens Networks TransConnect

Web application (Web server functionality).In this configuration, a user accesses the server by a Web browser displaying the Nokia

Siemens Networks TransConnect graphical user interface (GUI). There is no need for

any software installation on the client side.

The purpose of the Web server configuration is to allow different Nokia Siemens

Networks TransConnect users to access and work on the same set of project files on

the server simultaneously (in live-impact mode). The Nokia Siemens Networks

TransConnect GUI is an an easy-to-use planning application for creating new services

in an existing network.

Internet/ Intranet

secured by https


TransNet clients

Share files from workspace


TransConnect clients

Administer users

Work with files by Web browser


TransConnect server

LAN

File

system

Server

database

File serverWeb server


18/48



Installation

Proceed as follows for realizing the Nokia Siemens Networks TransConnect Web server

configuration:

1. Installing the software(see section 3.1)

Install the software as Windows administrator on the computer acting as server.

2. Starting the Nokia Siemens Networks TransConnect server(see section 3.2)

3. Configuring a firewall(see section 3.3)

This is necessary to allow Nokia Siemens Networks TransNet users to share files

on the server when the Nokia Siemens Networks TransNet client accesses the

server across multiple networks.

4. Administering users with Nokia Siemens Networks TransConnect(see section 3.4)

5. Sharing projects with Nokia Siemens Networks TransNet(see section 3.5)

Share the project files intended for Nokia Siemens Networks TransConnect users

from a computer having the Nokia Siemens Networks TransNet software installed.

Provide the Nokia Siemens Networks TransConnect users with the URL to access the

Nokia Siemens Networks TransConnect GUI by a Web browser and with the informationon the user name and password to log on to the server.

Nokia Siemens Networks TransNet client/server configuration

Figure 2 Nokia Siemens Networks TransNet client/server configuration

The computer having the Nokia Siemens Networks TransConnect software installed

acts as file server. It hosts a repository of project files created and shared on the server

by Nokia Siemens Networks TransNet users.

In this configuration, a user accesses the server with the graphical user interface (GUI)of the Nokia Siemens Networks TransNet software installed on the local computer.


TransNet clients

Administer users

Share files from workspace

Work with files on the server


TransConnect server

LAN

File

system

Server

database

File server


19/48


20/48



Installation

2

From the Nokia Siemens Networks TransConnect software CD-ROM or from a copy

on your computers hard disk double-click the TransConnect_.exefile to

start the installation.

Confirm the Windows User Account Controlmessage box to allow the installationwizard to run on your computer.

After the installation wizard has finished the preparation, the Introductionpage

opens (see Figure 3).

Figure 3 Installation wizard, Introduction page

3

Click Nextto proceed.

The License Agreementpage opens displaying terms of license agreement.

w NOTICE:In case you have a Nokia Siemens Networks TransConnect software withmain version 8.10 installed and running on your computer, you are first requested to

stop the server (with the Stop servicemessage box) before you can proceed.

To avoid data loss, it is strongly recommended to follow the upgrade procedure in

chapter 5 Upgradeif an older Nokia Siemens Networks TransConnect software is

installed on your computer with a database you want to migrate to the new version.

4

Click I accept the terms of the License Agreementif you agree, and click Next.

The Choose Install Folderpage opens displaying the default installation directory

(see Figure 4).


21/48


21


Installation

Figure 4 Installation wizard, Choose Install Folder page

5 If you want to change the default installation directory, type a different path name

directly in the input field or click Chooseto display a dialog box for selecting a direc-

tory.

w NOTICE:Do not select the same installation directory as used for an old NokiaSiemens Networks TransConnect installation as long as in this directory the

database is present that needs yet to be migrated.

To avoid data loss, it is strongly recommended to follow the upgrade procedure in

chapter 5 Upgradeif an older Nokia Siemens Networks TransConnect software is


6 Click Nextto proceed.

The Choose Shortcut Folderpage opens (see Figure 5).


22/48



Installation

Figure 5 Installation wizard, Choose Shortcut Folder page

7 Click one of the available buttons to select the method Nokia Siemens Networks

TransConnect is to be started and stopped, for example, by an entry in one of the

Startmenu folders or by a desktop icon.

The installer proposes the following shortcut folder in the Windows home directory

for all users:

%ALLUSERSPROFILE%\Start Menu\Nokia Siemens Networks\Nokia SiemensNetworks TransConnect

g Do not select the same shortcut folder location as used for an old Nokia SiemensNetworks TransConnect software version still installed. Only by using different loca-

tions you will be able to selectively start and stop the server of the different versions.


The Choose License Filepage (see Figure 6) opens requesting you to add a

license file (see section 2.3 Nokia Siemens Networks TransConnect license file).


23/48


23


Installation

Figure 6 Installation wizard, Choose License File page

9 Click to selectYesand click Nextto proceed.

In the following page type the path name of the valid license file named licence.xml

or click Chooseto display a dialog box for selecting this file.

1


The Choose SSL Certificatepage (see Figure 7) opens asking you whether you

want to select a certificate file for secure connection to the Web server by Hypertext

Transfer Protocol Secure (HTTPS) (see section 2.5 Client software prerequisites).

Figure 7 Installation wizard, Choose SSL Certificate page


24/48



Installation

Not adding a valid certificate file for the domain/host Nokia Siemens Networks

TransConnect is installed will result in a Web browser warning message on an

unsigned certificate (based on the browser security settings) when a user tries to

connect to the Web server by HTTPS (see also section 3.4 Administering users with

Nokia Siemens Networks TransConnect).

11

Click to selectYesand click Nextto proceed.

In the following page type the path name of the certificate file namedjboss.keystore

or click Chooseto display a dialog box for selecting this file.

12


The Choose Datastore Folderpage (see Figure 8) opens asking you whether you

want to take over the database of an old Nokia Siemens Networks TransConnect

installation to your new installation.

Figure 8 Installation wizard, Choose Datastore Folder page

w NOTICE:Selecting Noin this page will result in a complete new installation in theselected installation directory including the removal of a database still present from

a previous Nokia Siemens Networks TransConnect installation.

To avoid data loss, it is strongly recommended to follow the upgrade procedure inchapter 5 Upgradeif an older Nokia Siemens Networks TransConnect software is


The current installation procedure assumes that no database for migration exists.

13 Click to select Noand click Nextto proceed without database migration.

The Server Administrator Accountpage opens (see Figure 9).


25/48


26/48



Installation

Figure 10 Installation wizard, TC_USER Password page

In this page you define the password of the TC_USER user account that will be

created at the end of the installation. This password will be requested when you start

the Nokia Siemens Networks TransConnect server (see section 3.2 Starting the

Nokia Siemens Networks TransConnect server). The password must met the

password policy requirements valid for your computer regarding minimum password

length, password complexity and password history requirements.

g The password policy requirements will be not validated in this installation wizard.However, an invalid password typed here prevents the creation of the TC_USER

user account and results in a warning message at the end of the installation.

In the input fields, type the password and re-type the password.


The Pre-Installation Summarypage opens displaying the summary of the selected

installation options.

16

Click Installto start the installation process.

The Installingpage opens displaying information on the ongoing installationprocess. After software installation is finished the TC_USER user account will be

created.

g If the Windows user creation fails, you will be informed with a warning message box.In such a case, it will be not possible to start the Nokia Siemens Networks TransCon-

nect server. One possible solution is to create the TC_USER account manually

under an administrator account having the required access rights (see section

6.1 Windows account TC_USER cannot be created during installation).

After the installation process has been finished, the Install Completepage opens

informing you on whether Nokia Siemens Networks TransConnect was installed

successfully on your computer.


27/48


27


Installation

In case of an installation error you get an information displayed to check the instal-

lation log file.

17

Click Doneto quit the installation wizard.

18 In case of an installation error open the following installation log file in a text editor:

\

Nokia_Siemens_Networks_TransConnect__InstallLog.log

Search the file for the installation error or warning. If you cannot solve the problem,

contact the Nokia Siemens Networks technical support department.

t In case the installation was aborted without creating the installation log file in theinstallation directory, the file is created on the desktop.

19

Log off as Windows administrator.

All the following tasks can be performed under a non-administrator account.

3.2 Starting the Nokia Siemens Networks TransConnect

server

The Nokia Siemens Networks TransConnect server can be started just like any compa-

rable Windows application, for example, by the appropriate entry in the Startmenu

folder. The method on how to start Nokia Siemens Networks TransConnect has been

determined during installation (see section 3.1 Installing the software, step 7). The fol-

lowing assumes that you selected the default shortcut folder during installation.

To start the Nokia Siemens Networks TransConnect server proceed as follows:

1 Click Startmenu > Nokia Siemens Networksmenu > Nokia Siemens NetworksTransConnect program group > Start Servercommand.

g Confirm all Windows User Account Controlmessage boxes displayed during thisprocedure to allow the commands to run on your computer.

The Nokia Siemens Networks TransConnect service startermessage box

opens displaying ongoing information on the different steps during the server start.

While this message box stays on your screen you are requested with the Password

message box to type the password of the TC_USER user account (see section

3.1 Installing the software, step 14).

2

In the Passwordmessage box, type the password and click OKto close the

message box.

The success of the server start is indicated by the Infomessage box (displaying

JBoss started).

g If an Errormessage box opens instead, one of the prerequisites for starting theserver is not fulfilled. Correct the problem described in the message box. Then try

again with the Start Servercommand.

3 Click OKto close the Infomessage box.

t To check the status of the Nokia Siemens Networks TransConnect Windows service: Control Panel> Administrative Tools> Services


28/48



Installation

For detailed information on working with the server in a Nokia Siemens Networks

TransNet client/server configuration, refer to the Nokia Siemens Networks TransNet

help system and Nokia Siemens Networks TransNet User Manual.

3.3 Configuring a firewall

The following ports are used for the communication between the Nokia Siemens

Networks TransConnect server and the Nokia Siemens Networks TransNet client and

have to be enabled in all affected firewalls when you are working in a configuration

across multiple networks:

TCP port 1098

TCP port 1099

TCP port 3873

When you run Nokia Siemens Networks TransConnect server a connection from a

Nokia Siemens Networks TransNet client to the server is possible only if the Windowsinternal firewall of the server is configured for mutual access using JNP (java network

protocol).

The following program must be enabled in the Windows firewall:

\jdk\bin\

java.exe

g The required Windows firewall administration steps are maybe slightly different depend-ing on your Windows version. The following procedure describes the required firewall

properties - but gives only a brief outline in how to set these properties based on

Windows XP Professional.

1 Make sure that the Windows firewall allows exceptions.

To enable firewall exceptions: Control Panel> Windows Firewall> General

2

Add the following program as an exception to the Windows firewall:

\jdk\bin\

java.exe

To add a program as exception to the firewall: Control Panel> Windows Firewall

> Exceptions> Add Program> Add a Program> Browse

t By enabling thejava.exeapplication in the Windows firewall the ports mentioned aboveare enabled implicitly. When you use a firewall different from Windows, you possibly

have to enable these ports explicitly.

3.4 Administering users with Nokia Siemens Networks

TransConnect

To verify that the Nokia Siemens Networks TransConnect server and its GUI can be

called from a Web browser and to administer the Nokia Siemens Networks TransCon-

nect users perform the following steps on a computer accessible from the server by

LAN:

1

Connect to the Nokia Siemens Networks TransConnect Web server.

Start the Internet Explorer and type one of the following URLs:
http://transnet_umn.pdf/http://transnet_umn.pdf/


29/48


29


Installation

To access the server by a secured connection, type:

https:///NokiaSiemensNetworks/TransConn

ect.html

To access the server by an unsecured connection, type:http://:8080/NokiaSiemensNetworks/Trans

Connect.html

t The Nokia Siemens Networks TransConnect specific part of the URL(NokiaSiemensNetworks/TransConnect.html ) is case sensitive.

The Nokia Siemens Networks TransConnect Login page opens (see Figure 11).

Figure 11 Nokia Siemens Networks TransConnect Login page

2

Log on to the server.

If you want to connect the first time to a newly installed server (without having any

user administration performed before) type as User namethe default server admin-istrator account and as Passwordthe corresponding password as defined during

Nokia Siemens Networks TransConnect installation (see section 3.1 Installing the

software, step 13). Then click Log In.

The All Projectspage opens (see Figure 12) listing all the projects already shared

before on the server (see also section 3.5 Sharing projects with Nokia Siemens

Networks TransNet).


30/48



Installation

Figure 12 Nokia Siemens Networks TransConnect All Projects page

3

Call the help system.

On the header, click Help.A new Internet Explorer window opens displaying context-sensitive help for the page

currently displayed in Nokia Siemens Networks TransConnect (the All Projects

page in the example shown in Figure 12).

Click Show Navigationat the top of a context-sensitive help page to extend the

page with the Nokia Siemens Networks TransConnect help system table of con-

tents. The help system provides step-by-step descriptions for the tasks to be per-

formed with Nokia Siemens Networks TransConnect.

4

Create users.

Create a user name and a password for every Nokia Siemens Networks TransCon-

nect user that should log on to the server.

Nokia Siemens Networks TransConnect supports the following three user types:

Operator, Supervisor and Administrator. The user access rights on the server are

administered by assigning a suitable permission (Operation, Supervision or Admin-

istration) to a user name.

As password for a newly created user you create a random string by resetting the

password.

g Create at least an Administrator user type for any upcoming Nokia SiemensNetworks TransConnect (user) administration purposes.

For detailed information on performing this task refer to the Nokia Siemens

Networks TransConnect help system (Creating a user account topic).


31/48


31


Installation

5

Log off from the server.

On the product banner area, click Log out and confirm the displayed

message box by clickingYes.

The Nokia Siemens Networks TransConnect Logout page is displayed (see Figure13).

Figure 13 Nokia Siemens Networks TransConnect Logout page

The Nokia Siemens Networks TransConnect Web server is now ready for use.

3.5 Sharing projects with Nokia Siemens Networks TransNet

Nokia Siemens Networks TransConnect users cannot create new projects - they can

only work with existing projects. All the projects that are intended for modification by a

Nokia Siemens Networks TransConnect user must be shared on the server.

The project files must be shared from a computer having the Nokia Siemens NetworksTransNet software installed. Refer to the Nokia Siemens Networks TransNet Installation

Manualfor information on how to install the Nokia Siemens Networks TransNet soft-

ware.

For sharing projects perform the following steps with Nokia Siemens Networks Trans-

Net:

1 Create a remote location.

Create the Nokia Siemens Networks TransConnect server as remote location.

Use for authorization the logon information of one of the users created before on the

server (see section 3.4 Administering users with Nokia Siemens Networks

TransConnect).
http://transnet_imn.pdf/http://transnet_imn.pdf/http://transnet_imn.pdf/http://transnet_imn.pdf/


32/48



Installation

2

Share projects.

The projects to be shared must be available in the workspace specified during Nokia

Siemens Networks TransNet software installation.

Before you share a project, you should check the project content regarding the fol-lowing issues:

Make sure that every node in the project has valid equipment.

In Nokia Siemens Networks TransNets Equipmentperspective the Network

editor displays differently colored node status icons to reflect the equipment

status.

Only "green" nodes indicate that the equipment is valid. For all other colored

nodes (gray, blue, yellow and especially red) you have to change the

node's equipment status in order to turn them to "green".

Make sure that the commissioning status settings reflect the installation status

of the network in reality.

Take special care in checking all commissioning status values assigned tooptical multiplex sections (OMS), connections and equipment items.

For detailed information on performing these - and other related - tasks refer to the Nokia

Siemens Networks TransNet help system.

t An alternative way to provide individual project files on the server is to upload them byusing the Nokia Siemens Networks TransConnect Web GUI (see also section

3.4 Administering users with Nokia Siemens Networks TransConnect). For details, refer

to the Nokia Siemens Networks TransConnect help system (Uploading a project file to

the server topic).

After installation and basic administration is completed, provide to every Nokia Siemens

Networks TransConnect user the URL of the server and the logon information (username and password) (see also section 3.4 Administering users with Nokia Siemens

Networks TransConnect).


33/48


33


Uninstallation

4 UninstallationThis chapter contains the software uninstallation procedure.

4.1 Uninstalling the software

g The Nokia Siemens Networks TransConnect database is kept when uninstalling NokiaSiemens Networks TransConnect. To re-use the database during the installation of a

new Nokia Siemens Networks TransConnect software version follow the upgrade pro-

cedure described in chapter 5 Upgrade.

The following procedure assumes that you selected the default shortcut folder during

installation.

To uninstall the Nokia Siemens Networks TransConnect software perform the following

procedure:

1

Stop the currently running server (or make sure that the server is already stopped):

Click Startmenu > Nokia Siemens Networksmenu > Nokia Siemens Networks

TransConnect program group > Stop Servercommand.

A command window opens displaying the result of the stop command.

Confirm the Windows User Account Controlmessage box to allow the command

to run on your computer.

2

Logoff and log on as administrator with the access rights listed in section

3.1 Installing the software.

3

Click Startmenu > Control Panel> Add or Remove Programs.

The Add or Remove Programsdialog box opens.

4 In the Currently installed programslist, click to select Nokia Siemens Networks

TransConnect and then click Change/Remove.

Confirm the Windows User Account Controlmessage box to allow the uninstalla-

tion wizard to run on your computer.

The uninstallation wizard, Introductionpage opens (see Figure 14).


34/48



Uninstallation

Figure 14 Uninstallation wizard, Introduction page


A message box is displayed (see Figure 15) asking you whether the Windows user

account TC_USER created during installation (see section 3.1 Installing the soft-

ware) should be kept or removed.

Figure 15 Remove Windows user account message box

6 Click Noif you want to install later a new version of Nokia Siemens Networks

TransConnect, clickYesotherwise.

The Uninstallingpage opens displaying information on the ongoing uninstallationprocess.

After the uninstallation process has been finished, the Uninstall Completepage

opens informing you on whether Nokia Siemens Networks TransConnect was unin-

stalled successfully from your computer.

7 Click Doneto quit the uninstallation wizard.

8 Log off as Windows administrator.

t In case you have multiple Nokia Siemens Networks TransConnect software mainversions 8.10 installed in parallel on your computer, only the version you installed at last

will be uninstalled by Control Panel> Add or Remove Programs. However, you can


35/48


35


Uninstallation

call the uninstallation wizard for a Nokia Siemens Networks TransConnect software

version manually by running the following executable file:

\Uninstall_Nokia

Siemens Networks TransConnect \Uninstall Nokia Siemens NetworksTransConnect .exe


36/48



Upgrade

5 UpgradeWith the following recommended standard upgrade procedure you can take over the

database from an old (meanwhile uninstalled) Nokia Siemens Networks TransConnect

software version to the new one while running the Nokia Siemens Networks TransCon-

nect installation wizard.

5.1 Upgrading from Nokia Siemens Networks

TransConnect 8.00

To upgrade from Nokia Siemens Networks TransConnect 8.00 to the current main

version 8.10 proceed as follows:

1

Log on as Windows administrator.

2

Stop the currently running server (or make sure that the server is already stopped).

3 Uninstall the old Nokia Siemens Networks TransConnect software by Control

Panel> Add or Remove Programs.

In the message box asking you whether the Windows user account TC_USER

should be kept or removed, click No.

The database is kept when uninstalling.

4

Install the new Nokia Siemens Networks TransConnect software (see section

3.1 Installing the software).

When performing step 12of the installation procedure, the Choose Datastore

Folderpage (see Figure 16) opens.

Figure 16 Installation wizard, Choose Datastore Folder page

5

Click to selectYesand click Nextto proceed.

The next Choose Datastore Folderpage opens (see Figure 17)


37/48


37


Upgrade

Figure 17 Installation wizard, Choose Datastore Folder page 2

6 Type the path name of the datastoresub-directory within the old Nokia Siemens

Networks TransConnect installation directory or click Chooseto display a dialog box

for selecting the directory.

This makes sure that the sub-directories datastore\filestore(including the project

files) and datastore\transnetDB(including the server database) will be copied to the

Nokia Siemens Networks TransConnect installation directory.The path name to type should be:

\datastore

7

Click Nextto open the TC_USER Passwordpage and then continue with the instal-

lation procedure (see section 3.1 Installing the software.)

8

Start the newly installed server (see section 3.2 Starting the Nokia Siemens

Networks TransConnect server).

The data (for example, project files, users with permissions) of the uninstalled Nokia

Siemens Networks TransConnect software version are now available with the newly

installed version.

After the software upgrade is finished, make sure that all projects shared on the server

are migrated to the new Nokia Siemens Networks TransNet (and Nokia Siemens

Networks TransConnect) version.

All projects available on the server should be migrated in the following way by using

Nokia Siemens Networks TransNet:

1 Copy the project from the server (to your local workspace) and open it.

2

Check the project content regarding the same issues as described in section

3.5 Sharing projects with Nokia Siemens Networks TransNet, step 2(while sharing

a project on the server).

3

Save the project (in your local workspace).


38/48



Upgrade

Saving of a project is only enabled after you have changed the project. If no other

(equipment-related) changes are necessary you can update the Userin the Project

Propertiesview, Network Configurationpage to enable saving and to complete

the migration.

4 Save the project back to the server (as a new revision).

The newly created project file revision should be used by all users as base for any mod-

ification.

For details on performing these tasks refer to the Nokia Siemens Networks TransNet

help system.

5.2 Upgrading from Nokia Siemens Networks

TransConnect < 8.00

The upgrade from older versions to the current main version 8.10 is not supported. An

upgrade path exists only from the predecessor main version 8.00 to the current main

version 8.10 (see section 5.1 Upgrading from Nokia Siemens Networks TransConnect

8.00).

The reason is that Nokia Siemens Networks TransConnect (and Nokia Siemens

Networks TransNet) opens a project only if it has been created with the current main

version or has been saved with the predecessor main version. Older projects must be

always migrated to the predecessor main version before they can be opened with the

current main version 8.10.

That means, Nokia Siemens Networks TransConnect upgrade is only possible between

two successive main versions.

5.3 Determining the Nokia Siemens Networks TransConnect

version currently installed

When you get a new Nokia Siemens Networks TransConnect software delivered you

may want to check which version is currently installed. Refer to section 1.5 Nokia

Siemens Networks TransNet / TransConnect version and software variantsfor details.


39/48


39


Troubleshooting

6 TroubleshootingThis chapter collects possible errors occuring during the Nokia Siemens Networks

TransConnect software installation and configuration and provides corrective actions.

6.1 Windows account TC_USER cannot be created during

installation

At end of the Nokia Siemens Networks TransConnect installation you receive a warning

message (like the one shown in Figure 18) informing you that the TC_USER Windows

user account could not be created.

Figure 18 Warning message on failing to create the TC_USER account

Reason

The Nokia Siemens Networks TransConnect installation wizard has been run under a

Windows user account without appropriate access rights (see section 3.1 Installing the

software).

The Nokia Siemens Networks TransConnect server can only be started under the

TC_USER Windows user account created and configured as follows: Type: Built-in domain user

Name: TC_USER

Assigned user groups: Users (only)

User rights assignment: Log on as a service

Permissions for the drive/directory used as Nokia Siemens Networks TransConnect

installation directory (for example, C:\): Read, Execute, Write

Corrective action

Create the TC_USER Windows user account manually before you start the Nokia

Siemens Networks TransConnect server.


40/48



Troubleshooting

g The required Windows user administration steps are maybe slightly different dependingon your Windows version and on whether your computer is being a domain or workgroup

member. The following procedure describes the required user properties - but gives only

a brief outline in how to set these properties based on Windows XP Professional with

local user administration.

To create and configure the new "TC_USER" account proceed as follows:

1 Log on as Windows administrator with the access rights listed in section

3.1 Installing the software.

2 Create the user with the following properties:

User name: TC_USER

Password: Type the password

Confirm password: Re-type the password

User must change password at next logon: Disable

User cannot change password: Enable

Password never expires: Enable

To set new user properties: Control Panel> Administrative Tools> Computer

Management> System Tools> Local Users and Groups> New User

3

Assign only the Users user group to the user.

To change user groups assigned to a user: Computer Management> System

Tools> Users> > Properties > Member Of

4 Assign the Log on as a service access right to the user.

To assign user access rights: Control Panel> Administrative Tools> Local

Security Policy> Security Settings> Local Policies> User Rights Assignment> Log on as a service> Properties> Add User or Group

5

Assign read, execute and write permissions for the drive/folder used as Nokia

Siemens Networks TransConnect installation directory (for example, C:\ ) to the

user.

To assign permissions for an object (drive, folder or file) to a user: Object > Proper-

ties> Security> Add> Select Users and Groups> Select as object type: Users,

Groups, or Built-in security principals, as location your computer and as object

name the user name > OK> Under Group or user namesselect the newly added

user name > Under Permissions forselect the permission-specific check boxes

6.2 Server cannot be started

When you start the Nokia Siemens Networks TransConnect server, you receive the

error message shown in Figure 19while non of the possible reasons for this error

reported in this message box exist.


41/48


41


Troubleshooting

Figure 19 Error message during Nokia Siemens Networks TransConnect

server start

Reason

The TCP ports used by the Nokia Siemens Networks TransConnect server for commu-

nication are already occupied by another application which result in port collisions.

Table 4provides an overview on the TCP ports used by the server and the location of

their configuration files. Note, that the path names in the Location column are relative

to the following directory:

\jboss\server\

default\

Port number Description Location

443 HTTPS port for the

Web container

.\deploy\jbossweb-tomcat55.sar\server.xml

1098 (anon) RMI naming service

port

.\deploy\naming-service.xml

1099 Bootstrap JNP port .\deploy\naming-service.xml

4444 RMI/JRMP invoker

port

.\deploy\invokers-service.xml

4445 Pooled invoker .\deploy\invokers-service.xml

8083 RMI dynamic class

loader port

.\deploy\dynclassloader-service.xml

8080 HTTP port for the

Web container


8009 AJP port for the

Web container


8093 UIL for JMS .\deploy\jms\uil2-service.xml

8443 (optional) HTTPS port for the

Web container


45566 (mcast) JGroups clustering .\deploy\jmx-console.war\WEB-INF\web.xml

Table 4 TCP ports used by the Nokia Siemens Networks TransConnect server


42/48



Troubleshooting

Corrective action

1

Make sure that none of the possible reasons reported in the message box in Figure

19exist:

The TC_USER Windows user account exists and has proper permissions (see

sections 3.1 Installing the softwareand 6.1 Windows account TC_USER cannot

be created during installation).

The password for TC_USER typed during server start is correct (see sections

3.1 Installing the software, step 14and 3.2 Starting the Nokia Siemens

Networks TransConnect server).

2

Analyze the port collisions in more detail:

1

Check the server log file to find out any reason for a server start failure or

whether the server works properly (in some cases the server may start without

some services running properly).

Search for "ERROR" messages in the server log file:

\jboss\

server\default\log\server.log

All port collisions are logged with:

ERROR priority ex. Address already in use:

:

for example:

ERROR priority ex. Address already in use: JVM_Bind:8080

2 Search for the processes that are using the listed ports.

Open a Windows Command Prompt window (to be started with cmd.exe) and

enter the following command:

netstat -aoYou receive a list of active TCP (and UDP) ports together with the process ID

(PID) of the application using the port.

3 Search for the applications using the listed ports.

Open the Windows Task Manager> Processespage and extend the default

columns by adding the PIDcolumn (by Viewmenu > Select Columnscom-

mand).

You have now the information available for mapping of process IDs to applica-

tions.

3 To solve port collisions you can either close the other application(s) using the same

ports as the Nokia Siemens Networks TransConnect server or you can reconfigure

3873 EJB3 remote

invoker

.\conf\deploy\ejb3.deployer\META-INF\jboss-

service.xml

.\deploy\ejb3.deployer\META-INF\jboss-ser-

vice.xml

Port number Description Location

Table 4 TCP ports used by the Nokia Siemens Networks TransConnect server


43/48


43


Troubleshooting

the server to use other ports as the default ones by editing the configuration files

listed in Table 4.

4

After applying one of both options, (re-)start the Nokia Siemens Networks

TransConnect server (see section 3.2 Starting the Nokia Siemens NetworksTransConnect server).

6.3 Nokia Siemens Networks TransConnect Login page

cannot be displayed

After typing the URL for accessing the Nokia Siemens Networks TransConnect server

you receive a Web browser-specific Web page cannot be displayed or an Apache

Tomcat Web server error page.

Reason

The Nokia Siemens Networks TransConnect server has been not started or the URL toaccess the Login page (secured or unsecured) is incorrect.

Corrective action

1

(Re-)start the Nokia Siemens Networks TransConnect server (see section

3.2 Starting the Nokia Siemens Networks TransConnect server).

2

Type the URL exactlyas described in section 3.4 Administering users with Nokia

Siemens Networks TransConnectas the Nokia Siemens Networks TransConnect

specific part of the URL is case sensitive.

6.4 Log on to the server is not possible due to a server error

When you try to logon to the server, you receive the error message shown in Figure 20.

Figure 20 Error message while trying to logon to the Nokia Siemens Networks

TransConnect server

Reason

The same reason applies as if the server cannot be started. Refer to section 6.2 Server

cannot be startedfor details.

Corrective action

The same corrective action applies as if the server cannot be started. Refer to section

6.2 Server cannot be startedfor details.


44/48


45/48


45


Appendix

First and last name - Type here the Common Name (CN), that is, the host and

domain name where Nokia Siemens Networks TransConnect is installed. Exam-

ples: www.company.com , company.com

Organizational Unit (OU) - This field is optional.

Organization (O) - Example: Type the XY & Z Corporation company organiza-

tion as XYZ Corporation.

Locality or City (L) - Example: Berkeley

State or Province (S) - Spell out the name completely; do not abbreviate the

name. Example: California

Country Name (C) - The two-letter code without punctuation. Examples: US, CA.

As a result thejboss.keystorefile is created in your working directory.

2

Generate a certificate signing request (CSR) file.

Type the following command:

keytool -certreq -alias tc -keyalg RSA-keystore jboss.keystore -file certreq.csr

Type on request the keystore password as specified in step 1.

As a result the certreq.csrfile is created in your working directory.

3 Request the signature for the certificate.

Send the certreq.csrfile for signature application to your certificate authority (CA),

for example, VeriSign, Inc. (http://www.verisign.com) or Thawte, Inc.

(http://www.thawte.com).

The procedure is specific for every CA. Get familiar with this procedure and follow it.

As a result you should receive signed certificate which can be used to authorize your

specific certificate generated in step 1.

4

Download and import a root certificate to the keystore.

Before the signed certificate a root (or chain) certificate must be imported to the key-

store.

Download the root certificate from the CA you obtained the signed certificate, for

example, use for VeriSign, Inc. commercial certificates the page http://www.veri -

sign.com/support/install/intermediate.html.

Type the following command for import:

keytool -import -alias root -keystore jboss.keystore

-trustcacerts -file Type on request the keystore password as specified in step 1and accept the certif-

icate.

5 Import the signed certificate to the keystore.

Type the following command for importing the signed certificate file obtained in step

3:

keytool -import -alias tc -keystore jboss.keystore

-file

As a result thejboss.keystorecertificate file is now valid.

6

Copy thejboss.keystorefile to the Nokia Siemens Networks TransConnect installa-

tion directory.
http://www.verisign.com/http://www.thawte.com/http://www.verisign.com/support/install/intermediate.htmlhttp://www.verisign.com/support/install/intermediate.htmlhttp://www.verisign.com/support/install/intermediate.htmlhttp://www.verisign.com/support/install/intermediate.htmlhttp://www.thawte.com/http://www.verisign.com/


46/48


47/48


47


Index

A

Apache Derby 19

C

certificate 14, 23, 44client/server configuration 7, 18configuration

client/server18Web server17

D

database 33

datastore 33, 37

F

filestore 37firewall 28FTP server software 14

H

hardwareclient 15server14

HTTPS 14, 44Hypertext Transfer Protocol Secure 14, 44

I

installing 19Internet Explorer16

J

JBoss 19jboss.keystore 15, 24, 44

Llicence.xml 22license file 15, 22logging on

Nokia Siemens Networks TransConnect 28

M

multiple installations 19

N

Nokia Siemens Networks TransConnect 7configuration 17installing 19logging on 28server application 19starting 27stopping 33uninstalling 33upgrading 36

Nokia Siemens Networks TransNet 31

O

operating system 14

Pprerequisite

client hardware 15client software 15license file 15server hardware 14server software 14

projectsharing 31

S

server software

Apache Derby 19JBoss 19Nokia Siemens Networks TransConnect serverapplication 19

servicestarting 27stopping 20, 33

sharingproject 31

softwareclient 15server14

T

TC_USERWindows account 19, 39

transnetDB 37troubleshooting 39

U

uninstalling 20, 33upgrading 24, 36user administration 28


48/48


V

version 38

WWeb server configuration 7, 17Windows 14

service 19TC_USER account 19, 39

Date post:	02-Jun-2018
Category:	Documents
Upload:	ductho
View:	214 times
Download:	0 times