FUJITSU 1FINITY - WebGUI - User - Guide
FUJITSU 1FINITY - WebGUI - User - Guide
1FINITY™
Web Graphic User Interface (WebGUI)
Issue 2, February 2020
FNC-1F-WEBGUI-02
User Guide
Fujitsu Network Communications Inc. Fujitsu and Fujitsu Customer Use Only https://partners.fnc.fujitsu.com
Page 2
Contents
1 Introduction p. 9
1.1 What's New p. 10
1.1.1 Responsive Web Design p. 10
1.1.2 Static Significant Tabs p. 11
1.1.3 Collapsible Alarm Table p. 13
1.1.4 Connected Navigation Control p. 14
1.1.5 Breadcrumb Navigation p. 15
1.1.6 Revamped Interface Creation p. 16
1.2 Supported Features p. 17
1.3 System Requirements p. 19
1.4 Application Menu p. 20
1.5 About p. 21
2 Getting Started p. 22
2.1 Log On p. 23
2.2 Log Off p. 25
2.3 User Interface p. 26
2.4 Filtering PM Data p. 29
2.5 Export Reports p. 34
2.6 Committing Configurations p. 36
2.6.1 Commit View Changes p. 36
2.6.2 Commit Validate Changes p. 38
2.6.3 Commit Revert p. 39
2.6.4 Commit Selective Revert p. 41
2.6.5 Commit Rollbacks p. 42
3 Operations p. 46
3.1 Configuring WebGUI p. 47
3.1.1 Configure Time-Out Value p. 47
3.1.2 Configure REST API p. 49
3.1.3 Configure HTTP Port p. 50
3.1.4 Configure HTTPS Port p. 51
3.2 User Management p. 54
3.2.1 Configure User Account p. 56
3.3 Provisioning p. 60
4 System Maintenance p. 85
4.1 Performance Monitoring p. 86
4.2 Boot Update p. 88
4.2.1 Update and Boot p. 88
4.3 NE Software Management p. 90
4.3.1 Viewing Software Information p. 90
4.3.2 Upgrade Software p. 91
4.3.3 Activate Software p. 92
4.3.4 Cancel Validation Timer p. 94
4.3.5 Unpack Software p. 95
4.4 NE FW Management p. 97
4.4.1 Viewing Firmware Information p. 97
4.4.2 Update Firmware p. 98
4.5 Database Management p. 101
4.5.1 Viewing Database Information p. 101
4.5.2 Back Up Database p. 102
4.5.3 Transfer Database p. 104
4.5.4 Restore Database p. 107
4.5.5 Activate Database p. 108
4.5.6 Cancel Rollback Timer p. 110
4.5.7 Initialize Database p. 112
4.6 Lock and Unlock Datastore p. 114
4.7 Restarting NE p. 115
4.7.1 Restart—COLD p. 115
4.7.2 Restart—WARM p. 116
4.8 Reports p. 118
4.8.1 Technical Information p. 118
4.8.2 Syslog p. 120
4.8.3 Alarm History p. 123
Index p. 125
Knowledge Creation
E-mail: knowledge.creation@fnc.fujitsu.com
For technical assistance, contact the Fujitsu Technical Assistance Center (FTAC) at:
Phone: 1-800-USE-FTAC (1-800-873-3822)
E-mail: ftac@us.fujitsu.com
For trouble-clearing assistance, always call the preceding phone number. Use the e-mail address only for general inquiries.
Product Training
This documentation is supplied as a service to our customers. For sales and general information, contact us at:
Fujitsu Network Communications Inc.
2801 Telecom Parkway, MS# 3F
Richardson, TX 75082
Attn: Inside Sales
Phone: 1-888-FNC-PROD (1-888-362-7763)
E-mail: inside.sales@fnc.fujitsu.com
http://www.fujitsu.com/us/products/network/services-support/contact/index.html
Trademarks and Disclaimers
Trademarks
FUJITSU (and design)® and “shaping tomorrow with you” are Firefox® is a registered trademark of the Mozilla Foundation.
trademarks of Fujitsu Limited in the United States and other
countries. All Rights Reserved. Google™ Chrome™ are trademarks of Google Inc.
1FINITY™ is a trademark of Fujitsu Network Communications Safari® is a trademark of Apple Inc., registered in the U.S. and
Inc. (USA). All Rights Reserved. other countries.
General Disclaimers
Note: All other products or services mentioned in this document are by the trademarks, service marks, or product names as
designated by the companies that market those products or services or own those marks. Inquiries concerning such products, services,
or marks should be made directly to those companies.
Fujitsu and Fujitsu Customer Use Only: This document and its contents are provided by Fujitsu Network Communications Inc. for
guidance purposes only. This document is provided “as is” with no warranties or representations whatsoever, either express or implied,
without notice, to make including without limitation the implied warranties of merchantability and for purpose. Fujitsu Network
Communications Inc. does not warrant or represent that the contents of this document are error free. Furthermore, the contents of this
document are subject to update and change at any time without notice by Fujitsu Network Communications Inc., since it reserves the
right, changes in equipment design or components as progress in engineering methods may warrant. No part of the contents of this
document may be copied, or otherwise reproduced without the express written consent of Fujitsu Network Communications Inc.
Document Change Notice
Issue 2
Location of Change Description of Change
Issue 1
Location of Change Description of Change
Disaggregation of the 1FINITY platform gives its product families integrated access, transport, switch, and lambda functions. A
software framework provides logical reaggregation to provide programmable software management and control. The modular blades
operate both independently or in combination with other Fujitsu or competitor optical platforms.
The 1FINITY platform uses the YANG (Yet Another Next Generation) data modeling language to model configuration and state data.
YANG data models are made up of modules and submodules that are managed by a Command Line Interface (CLI). A YANG module
defines a data model through the hierarchical organization and constraints on its data. Each YANG module, uniquely identified by a
namespace URL, provides the data model, remote procedural calls, and notifications for a particular part of the system.
Introduction Page 9
1
Introduction
In this chapter:
1.1 What's New
1.2 Supported Features
1.3 System Requirements
1.4 Application Menu
1.5 About
The 1FINITY Web Graphical User Interface (WebGUI) provides access to the 1FINITY products through a
web browser in a point-and-click environment. The users are provided the option for manipulating
graphical icons in a web browser to provision and manage network devices and configurations. This
option is an alternative for executing commands on the CLI.
The WebGUI shares the same hierarchical structure for provisioning that the CLI follows. For example,
equipment represents hardware (shelf, slot, subslot, port, and pluggable modules) and interface
represents interfaces and facilities. The structure is visualized in the WebGUI with graphical icons and
forms to enter provisioning values.
The changes performed to the device configuration using the WebGUI are applied to a copy of the
active configuration (candidate configuration). The changes do not take effect until a successful
commit or confirmed commit function is executed. A rollback command allows the users to reinstate a
past configuration.
Note: In the WebGUI, blades are referred to as shelves. The blades are shipped with a default
username and password (fujitsu/1finity) having Level-4 or Level-5 privileges assigned.
1.1
What's New
In this section:
1.1.1 Responsive Web Design
1.1.2 Static Significant Tabs
1.1.3 Collapsible Alarm Table
1.1.4 Connected Navigation Control
1.1.5 Breadcrumb Navigation
1.1.6 Revamped Interface Creation
1.1.1
Responsive Web Design
Responsive web design is an approach introduced to enhance user experience on all devices,
particularly on smaller screens, for example, tablet and iPad. The elements appear based on the screen
size making the application screen responsive. The Model Tree, Equipment tree, and Interfaces tree
are moved under the toggle element.
Figure 1
Responsive Web Design
Figure 2
Types of Appearances
Related Links
User Interface
1.1.2
Static Significant Tabs
The critical parts of the application operability are designed to appear static to reduce navigation time
for improved user experience. The static tabs make sure that the navigation access to Eqpt, Pm-
equipment, Interfaces, and Pm-interfaces is always available to the user.
Figure 3
Static Tab—Eqpt
Figure 4
Static Tab—Pm-equipment
Figure 5
Static Tab—Interfaces
Figure 6
Static Tab—Pm-interfaces
Related Links
User Interface
Provision Shelf
Provision Interface
Performance Monitoring
1.1.3
Collapsible Alarm Table
Collapsible alarm table allows the user to keep a tab on alarms raised and their severity status.
Collapse the alarm table to hide and show the alarm pane and focus on the other functionalities
without having to scroll nearly so much.
Figure 7
Collapsible Alarm Table
Related Links
User Interface
1.1.4
Connected Navigation Control
The interactive shelf graphic simplifies the way resources are used in the WebGUI. The connected
navigation controls increase the accessibility of NE resources using multiple options—from
Equipment tree, Shelf graphic, Menu, and Static tabs. The feature provides quick access to the
essential functionalities of the application and allows to choose any of the options even if a smaller
device is used.
Figure 8
Connected Navigation Control
Related Links
User Interface
1.1.5
Breadcrumb Navigation
Breadcrumb navigation, a secondary navigation system, keeps track of the web pages that are visited
by a user and informs about their exact location on the WebGUI. Breadcrumb navigation enhances the
user experience and the accessibility level of the WebGUI for a particular YANG module. Using
breadcrumb navigation the user can navigate within a YANG module in a hierarchical order.
Figure 9
Breadcrumb Navigation
Related Links
User Interface
1.1.6
Revamped Interface Creation
Creating a new interface is made easy with the revamped Add List Item dialog box.
Figure 10
Add List Item Dialog Box
Related Links
Provision Interface
1.2
Supported Features
The WebGUI Home page provides key information for tracking and managing the 1FINITY products.
The interactive graphical view of the shelf presents a virtual view of the modular shelf that gives the
users a first picture of the environment and configurations. The view makes it easier for the users to
quickly move to the NE resources that need attention. Hovering over the parts of the shelf displays the
current operational status and configurations of the shelf.
• Color-based borders are used for graphical shelf entities as an indication of the alarm-severity
level. The alarm-severity level is determined by the shelf-level, slot-level, and port-level alarms.
• In case of multiple alarms on the same entity, the most severe alarm type color indication is
used as the border.
• For alarms on the shelf, border on both front view and rear view is displayed. For alarms on the
slot and port, the border is visible on the front view.
■ Breadcrumb navigation
1.3
System Requirements
The following table lists the system configurations supported by the WebGUI.
Table 1
Requirements
Entity Supported
1.4
Application Menu
The following menu tree shows the WebGUI panes and buttons, and describes the hierarchy of menus
and settings.
Figure 11
Menu Tree
Table 2
Icon Descriptions
Icon Description
Searches using defined filter rules and produces the results in a tabular format
1.5
About
The about menu provides information about the NE and vendor.
Figure 12
About Tab
2
Getting Started
In this chapter:
2.1 Log On
2.2 Log Off
2.3 User Interface
2.4 Filtering PM Data
2.5 Export Reports
2.6 Committing Configurations
2.1
Log On
Prerequisites:
■ The NE HTTP/HTTPS service must be enabled and the NE must be available on the network.
■ The user must have the NE IP address (LMP/LCN), login credentials (username and password), and a
web browser.
Note: The WebGUI can be enabled using CLI. By default, WebGUI is enabled for all 1FINITY products
except the Open ROADM. Refer to the CLI Command Reference Guide of any 1FINITY Product in the
Partners website https://partners.fnc.fujitsu.com.
The following LMP IP address format is the default for the 1FINITY blades and address bar examples.
If a custom HTTP port is assigned, a colon with the port number needs to be added after the IP
address. The following example demonstrates how to access the WebGUI with the LMP IP address and
a custom HTTP port number.
Step 1
Log on to the WebGUI from a web browser.
Step 2
Enter the username and password.
Figure 13
Logon Page
Important: The blades are shipped with Level-4 or Level-5 privileges assigned.
Step 3
Select the terms and conditions checkbox.
Step 4
Click Login.
Note: If the NE closes the user logon session due to inactivity, the WebGUI remains open. A dialog box
opens requesting the user to either log on again or exit.
2.2
Log Off
Step 1
At the top right corner of the window, select from the menu bar:
User ID Logout
Figure 14
Logout Option
Step Result:
The Logon page opens.
2.3
User Interface
After logging onto the WebGUI using a browser, the default landing page displays a graphical view of
the selected shelf. The WebGUI provides options for setting up, maintaining, and monitoring the NE.
The status of the entities are displayed when user hover over the graphical view. The interface allows
quick identification of alarm severity conditions in a monitored network.
Figure 15
WebGUI Window Layout
Table 3
User Interface Attributes
Attribute Use
Menu Bar Defines categories of the functions—Select a menu to display the drop-down list of
the available options for that category
Entities Equipment Tree—Displays a hierarchical list of shelf, slots, subslots, and ports. NEs
and groups of NEs
Table 3 (Cont.)
User Interface Attributes
Attribute Use
Breadcrumbs Offers a secondary navigation system to move between the hierarchical windows
Help Sets the WebGUI configuration and displays information about the practice. Clicking
the Help menu opens the WebGUI Online Help
User Options Displays user information and logs the user off from the session
Graphical shelf view provides a responsive, graphical representation of the 1FINITY blade, enhancing
the user experience. The Graphical shelf view allows the user to directly open the provisioned shelf,
slots, subslots, ports, and interfaces at a click of the mouse. The graphical shelf view provides a pop-up
message that states the information about the provisioned shelf, slots, subslots, ports, and interfaces
when hovered over.
Figure 16
Graphical Shelf View
Alarms List
The panel shows alarms based on their severity, alarm type, last status change, alarm sequence, and
whether they are service-affecting. The display refreshes automatically.
■ Critical
■ Major
■ Minor
■ Warning
The number next to the alarm indicator denotes the number of the alarm in each severity conditions.
Table 4
Top Alarms Columns
Title Description
Last Status Change Date and time when the alarm status was last changed
Last Perceived Severity Severity of the last status-change that reported a severity not equal to cleared
Last Alarm Text Alarm text of the last status-change that reported a severity not equal to cleared
Last in Service Affecting In-service affecting status of the last status of the alarm
2.4
Filtering PM Data
The filter window allows users to define and apply filters that display specific PM data. The following
figures show how to use the filter window.
Figure 17
Filter Window
Figure 18
Filter Rules
Figure 19
Match Field
Click the Column and Condition fields to open the drop-down list of the filter criteria, and enter the
value in the Value field.
Figure 20
Column Field
Figure 21
Condition Field
To apply the filter, click Filter. The filtered results appear in the respective tab.
2.5
Export Reports
In most WebGUI windows, the user has the option to export information to Excel and save for future
reference. Download log information, PM data, and configuration information in table format. The
following figure is an example of exporting software information.
Step 1
From the menu bar, select:
NE SWDL SW Info
Figure 22
sw-information Selection
Step 2
Click Export to Excel to generate a report file on the local NE.
Figure 23
Export Window
2.6
Committing Configurations
In this section:
2.6.1 Commit View Changes
2.6.2 Commit Validate Changes
2.6.3 Commit Revert
2.6.4 Commit Selective Revert
2.6.5 Commit Rollbacks
The configurations are saved and activated using a commit model. The WebGUI configure functions
are performed in exclusive configure mode. The active database is locked and any uncommitted
changes are discarded. The user is allowed to make changes without interference from other users in
exclusive configure mode. When a configuration is committed, the NE checks the configuration for
errors, and if no errors are found, the configuration is activated. When conflicting configurations are
attempted by multiple users, an error message opens. The user is required to look at the conflict and
resolve it.
Table 5
Commit Options
Option Description
View Changes Displays the changes performed in candidate configuration and not committed
2.6.1
Commit View Changes
The View Changes is used to view the changes made to a configuration before a commit.
Step 1
From the menu bar, select:
Figure 24
Commit Menu—View Changes Selection
Step Result:
A window opens displaying the Path, Operation, Value, and Old value of the committed configuration.
Figure 25
View Changes Window
Step 2
Click Commit.
Figure 26
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 27
Commit? Dialog Box
Step 3
Click OK to confirm the changes made.
2.6.2
Commit Validate Changes
The Validate Changes is used to validate the changes made to a configuration before a commit.
Step 1
From the menu bar, select:
Figure 28
Commit Menu—Validate Changes Selection
Step Result:
The Information dialog box opens.
Figure 29
Information Dialog Box
Step 2
Click OK .
Step 3
Click Commit.
Figure 30
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 31
Commit? Dialog Box
Step 4
Click OK to confirm the changes made.
2.6.3
Commit Revert
The Revert is used to revert the changes made to a configuration without a commit.
Step 1
From the menu bar, select:
Commit Revert
Figure 32
Commit Menu—Revert Selection
Step Result:
A Revert? dialog box opens.
Figure 33
Revert? Dialog Box
Step 2
Click OK to revert the configuration.
Step 3
Click Commit.
Figure 34
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 35
Commit? Dialog Box
Step 4
Click OK to confirm the changes made.
2.6.4
Commit Selective Revert
The Selective Revert is used when a user wants to revert a particular change done in the current
configuration session.
Example: If the user makes 10 changes and wants to revert one or two changes, those specific
changes can be selected and reverted.
Step 1
From the menu bar, select:
Step 2
Select the appropriate checkbox(es).
Step 3
Click Revert to revert the changes done in the current configuration session.
Figure 36
Selective Revert
Step Result:
The selected checkbox is deleted.
2.6.5
Commit Rollbacks
The Rollbacks is used to rollback to any previous configuration from the current configuration.
Step 1
From the menu bar, select:
Commit Rollbacks
Figure 37
Commit Menu—Rollbacks Selection
Step Result:
A Rollback tab appears displaying the Rollback number, Date, Time, Filename, and name of the user
(Creator) who issued the commit configuration command.
Figure 38
Rollbacks Tab
Step 2
Click the rollback number to see the configuration performed.
Figure 39
Rollbacks Information
Step 3
Click Commit.
Figure 40
Commit Button
Step Result:
The Commit dialog box opens.
Figure 41
Commit? Dialog Box
Step 4
Click OK to confirm the changes made.
3
Operations
In this chapter:
3.1 Configuring WebGUI
3.2 User Management
3.3 Provisioning
3.4 CLI Window
3.1
Configuring WebGUI
In this section:
3.1.1 Configure Time-Out Value
3.1.2 Configure REST API
3.1.3 Configure HTTP Port
3.1.4 Configure HTTPS Port
■ Enable WebGUI for a shelf and set time-out interval for a session
■ Enable REST
Note: The user can update the security settings for the web server.
The committed configuration changes interrupt the current WebGUI session and the Logon page
appears.
3.1.1
Configure Time-Out Value
The default time-out value for the WebGUI is set to PT30M, which is 30 minutes. The following steps
show users how to set a specific time-out value.
Step 1
From the menu bar, select:
Help Settings
Figure 42
WebGUI Configuration Selection
Step 2
In the webgui-enabled field, select the appropriate option:
Option Description
true Enable the WebGUI for the shelf.
false Disable the WebGUI for the shelf and does not allow user to access from next
session.
Note: The WebGUI can be enabled using CLI. By default, WebGUI is enabled for all 1FINITY products
except the Open ROADM. Refer to the CLI Command Reference Guide of any 1FINITY Product in the
Partners website https://partners.fnc.fujitsu.com.
Figure 43
WebGUI Server
Step 3
In the webgui-timeout field, change the time-out value.
Step 4
Click Commit to commit the changes.
Figure 44
Commit Button
Step Result:
The Commit dialog box opens.
Figure 45
Commit? Dialog Box
Step 5
Click OK to confirm the changes made.
Note: Log off and log on again for the changes to take effect.
3.1.2
Configure REST API
REST is a Network Management over http protocol (create, read, update, and delete) based on IETF
YANG data model and simple web implementation over HTTP transport. Refer to 1FINITY REST API User
Guide available at Fujitsu Partners website, https://partners.fnc.fujitsu.com.
Step 1
From the menu bar, select:
Step 2
In the rest-enabled field, select the appropriate option:
Option Description
true Enable REST on system services web-server.
false Disable REST on system services web-server.
Figure 46
Enable/Disable REST
Step 3
Click Commit.
Figure 47
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 48
Commit? Dialog Box
Step 4
Click OK to confirm the changes made.
3.1.3
Configure HTTP Port
Step 1
From the menu bar, select:
Step 2
Select the http checkbox.
Figure 49
WebGUI Configuration—HTTP
Step 3
Enter HTTP port value in the http-port field.
Note: The default HTTP port value is 80. Allowed range limitation—80, 2000…6021, 6023…32767,
and 61001…65535.
Step 4
Click Commit.
Figure 50
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 51
Commit? Dialog Box
Step 5
Click OK to confirm the changes made.
Step Result:
The user session terminates.
Note: Reopen the session for the port changes to take effect. To log on with the new HTTP port
number, a colon with the port number needs to be added after the IP address in the address bar.
3.1.4
Configure HTTPS Port
Step 1
From the menu bar, select:
Step 2
Select the https checkbox.
Figure 52
WebGUI Configuration—HTTPS
Step 3
Select a certificate type from the Choice-certType drop-down list.
Note: Users can create their own certificate id using the certificate-id option from the list.
Step 4
Enter the HTTPS port value in the https-port field.
Step 5
Select system-generated-certificate from the Choice-certType drop-down list.
Step 6
Check the system-generated-certificate checkbox.
Figure 53
System Generated Certificate
Step 7
Enter data in the protocols and ciphers fields.
Step 8
Click Commit.
Figure 54
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 55
Commit? Dialog Box
Step 9
Click OK to confirm the changes made.
3.2
User Management
In this section:
3.2.1 Configure User Account
Each user created is allotted to a user group. The user group defines authorization levels that control
command and data access privileges. The WebGUI supports the following eight levels by default.
Table 6
Groups and Permission Levels
Level-3 Operator-interface Equipment and interfaces provisioning along with Level-2 privileges
Level-4 Super-user Full access to all system, provisioning, and security functions
Level-7 Crypto-user Provision data-encryption interfaces and read the encryption status
on the encryption-enabled interfaces.
Note: These privileges are applicable for 1FINITY products that
support encryption.
Username
If a username is already in the /etc/passwd file or in the current database, it cannot be used to create a
new user.
• Hyphen: -
• Underscore: _
UMIN determines the minimum length of username. Default UMIN=3. Range is 3…32.
User Password
The password content type, BASIC or ENHANCED, is defined in the systemwide pcontent YANG model.
The default pcontent type is BASIC.
■ If the pcontent type is BASIC, the password must contain at least one alphabetic and one non-
alphabetic character. Basic password minimum length (PMIN) range is 6…20. Default PMIN=6.
■ If pcontent type is ENHANCED, the password must contain at least two characters from each of the
following groups. Enhanced password minimum length range is 8…20. Default PMIN=8.
• Numeric: 0…9
• Special: ! @ $ % ^ ( ) _ + ~ { } [ ] . - & *
Password must not contain username. To create an encrypted password, use crypt-password
command. The crypt-password parameter uses a unique SHA-256 algorithm.
Admin State
Manage admin state privilege of the user by selecting allow or inhibit options. Inhibit option prevents
user from accessing the management interfaces.
3.2.1
Configure User Account
The following steps show how to add a new user and configure the account.
Step 1
Log on to the WebGUI.
Step 2
At the landing page, locate the Model tree and expand the Configuration.
Step 3
Click Users option.
Step Result:
A User tab appears with the list of users who are logged on.
Figure 56
User Tab
Step 4
Click the Add icon to add a new user.
Step Result:
The Add List Item dialog box opens.
Figure 57
Add List Item Dialog Box
Step 5
Enter the new username.
Step 6
Click Ok.
Step Result:
The User tab displays the newly added user account.
Figure 58
New User Account
Step 7
Click the newly added user account.
Step 8
Enter a password in the password field.
Step 9
Enter the level of the user in group field.
Step 10
Select the option to either allow or inhibit the user in the adminState field.
Figure 59
User Info Window
Step 11
Click Commit to save the changes.
Figure 60
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 61
Commit? Dialog Box
Step 12
Click OK.
Step 13
Switch back to the User tab to view the changes made.
Additional Instructions:
To delete a user, select the username on the User tab and click the Delete icon.
3.3
Provisioning
In this section:
3.3.1 Turn Up Wizard
3.3.2 Provision Shelf
3.3.3 Provision Slot
3.3.4 Provision Port
3.3.5 Provision Interface
3.3.6 Provision Cross-Connect
The LMP and shelf 1 ports are autoprovisioned (AUTOP=Y) when the main shelf is powered up.
3.3.1
Turn Up Wizard
Turn Up Wizard is used to configure the NE in the initial stage. The following steps show how to set
the wizard to configure an NE.
Step 1
From the menu bar, select:
NE Turn up wizard
Figure 62
Turn Up Wizard Selection
Step Result:
The Turn up wizard dialog box opens.
Figure 63
Turn up Wizard Dialog Box
Step 2
Enter the System Name, Date and Time.
Step 3
Select the appropriate NE Mgmt Mode from the drop-down list: Bridge, Router, or MixMode.
Figure 64
NE Management Mode Options
Step 4
Select the NTP checkbox to enable the system NTP, if required.
Step 5
In Bridge mode, perform the following substeps to set the management mode options:
Note: By default, only IPv4 checkbox is selected and options for IPv4 are editable.
Figure 65
Bridge Mode
Step 6
In Router mode, perform the following substeps to enable the management mode options:
b. Enter a unique IP in LCN 1 IP and NEM 1 IP fields along with the Prefix-length field, if
required.
Note: By default, only IPv4 checkbox is selected and options for IPv4 are editable.
Figure 66
Router Mode
Step 7
Click Submit to provision the Turn Up Wizard.
3.3.2
Provision Shelf
Step 1
Log on to the WebGUI.
Step Result:
The WebGUI opens displaying the Eqpt tab. The Eqpt tab contains the shelf tab that lists the
provisioned shelves.
Figure 67
Shelf Tab
Step 2
Click the Add icon.
Step Result:
The Add List Item dialog box opens.
Figure 68
Add Shelf Dialog Box
Step 3
Assign a shelf ID.
Step 4
Click Ok.
Step Result:
The shelf tab displays the newly added shelf.
Figure 69
New Shelf
Step 5
Click the shelf ID link in the shelfId column.
Step Result:
The Shelf Info tab appears.
Figure 70
Provisioning Shelf
Notes: The following operations fields are grayed out and show the current operational state of the
interface. The operations fields cannot be edited.
■ currentDrawFeed
Step 6
Select the appropriate admin-status option from the drop-down list: up, down, or testing.
Step 7
Select the shelf type.
Step 8
Select the shelf mode.
Note: The shelf mode has to be changed only when no slots are provisioned.
Step 9
Assign a role for the shelf, MAIN or TRIB, and set a fuse value.
Step 10
Click the supportingRack tab to enter information about the rack/bay where the shelf is to be
mounted.
Note: The rack ID is a descriptive name to associate the shelf to a rack and the shelf location is the
location of the shelf within the rack.
Step 11
Click the pi tab.
Step Result:
The fields in pi tab display physical inventory information of the shelf.
Step 12
Click Commit.
Figure 71
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 72
Commit? Dialog Box
Step 13
Click OK to confirm the changes made.
Note: After commit succeeds, the user can see the shelf in the Equipment tree and in the Shelf tab,
which lists the alarms for that shelf and all the entities in that shelf.
3.3.3
Provision Slot
Step 1
Log on to the WebGUI.
Step 2
In the shelf tab, select the desired shelf ID from the provisioned shelves list.
Figure 73
Shelf Tab
Step 3
Select the slot tab.
Step Result:
The Slot tab appears.
Figure 74
Slot Tab
Step 4
Click the Add icon.
Step Result:
The Add List Item dialog box opens.
Figure 75
Add List Item Dialog Box
Step 5
Select the slotID from the drop-down list.
Step 6
Click Ok.
Step Result:
The slot tab displays the newly added slot.
Figure 76
New Slot
Step 7
Click the slotID link in the slotID column.
Step Result:
The Slot Info tab appears.
Notes: The following operations field are grayed out and show the current operational state of the
interface. The operations field cannot be edited.
Figure 77
Slot Information
Step 8
Select the appropriate admin-status option from the drop-down list: up, down, or testing.
Step 9
Select the card type.
Step 10
Click Commit.
Figure 78
Commit Button
Step Result:
The Commit dialog box opens.
Figure 79
Commit Dialog Box
Step 11
Click OK for the changes to take effect.
Step 12
Click Export to Excel for future reference.
Provision Subslot
Step 13
Log on to the WebGUI.
Step 14
In the slot tab, select the desired slot ID from the provisioned slots list.
Step 15
Select the subslot tab.
Step Result:
The subslot tab appears.
Figure 80
Subslot Tab
Step 16
Click the Add icon.
Step Result:
The Add List Item dialog box opens.
Figure 81
Add List Item Dialog Box
Step 17
Select subslotID from the drop-down list.
Note: The subslot can be provisioned by clicking the edit icon on the slot from the Equipment tree.
Step 18
Click Ok.
3.3.4
Provision Port
Step 1
Log on to the WebGUI.
Step 2
In the subslot tab, select the desired subslotID from the provisioned subslots list.
Step Result:
The Subslot Info tab appears.
Figure 82
Subslot Info Tab
Step 3
Select the port tab.
Step Result:
The Port tab appears.
Figure 83
Port Tab
Step 4
Click the Add icon.
Step Result:
The Add List Item dialog box opens.
Figure 84
Add List Item Dialog Box
Step 5
Select portID from the drop-down list.
Step 6
Click Ok.
Step 7
Click the Port Info in the portID column.
Step Result:
The Port Info tab appears.
Figure 85
Port Info Tab
Step 8
Select the pluggableInterfaceType, admin-status, or ains from the drop-down list.
Step 9
Enter the port ID of the remote source port to be associated with local destination port and remote
destination port to be associated with local source port in the remoteSrcPeerPort-id and
remoteDestPeerPort-id fields, respectively.
Step 10
Click Commit.
Figure 86
Commit Button
Step Result:
The Information dialog box opens.
Figure 87
Commit Dialog Box
Step 11
Click OK to commit the changes.
Step Result:
The new slot and port appear on the main page of the application.
Figure 88
New Slot and Port
Additional Instructions:
Click Create Interface to add an interface to the provisioned port.
Note: If an interface is already provisioned for this port, a message opens stating the existence of the
interface.
3.3.5
Provision Interface
Step 1
Log on to the WebGUI.
Step 2
To provision an interface, select the Interfaces tab.
Step Result:
The Interfaces tab appears.
Figure 89
Autoprovisioned Interface List
Step 3
Click the Add icon.
Step Result:
The Add List Item dialog box opens.
Figure 90
Add List Item Dialog Box
Step 4
Enter interface name.
Step 5
Click Ok.
Step Result:
The Interface tab displays the newly added interface.
Step 6
Click the newly added interface link in the name column.
Step Result:
The Interface Info tab appears.
Figure 91
Interface Info Tab
Step 7
Enter a text description.
Step 8
Select the interface type.
Step Result:
The dynamic options are enabled according to the interface type selected.
Step 9
In the enabled field, select the appropriate option:
Option Description
true Enable interface
false Disable interface
Step 10
In the link-up-down-trap-enable field, based on the selected interface type, select the appropriate
option:
Option Description
enabled Enable SNMP notifications generation when the link changes the status.
disabled Disable SNMP notifications generation when the link changes the status.
Note:
If the node is not configured, the value enabled is operationally used by the server for interfaces that
do not operate on top of any other interface, that is, if no lower-layer-if entries exist. Otherwise, the
value disabled is used.
Step 11
Click Commit.
Figure 92
Commit Button
Step Result:
A confirmation dialog box opens.
Figure 93
Commit? Dialog Box
Step 12
Click OK to confirm the changes made.
3.3.6
Provision Cross-Connect
Notice: The cross-connect is applicable only for L-Series products.
Step 1
Log on to the WebGUI.
Step 2
From the menu bar, select:
NE Cross connect
Figure 94
Cross Connect Selection
Step 3
To add a new cross-connect, click the Add icon.
Figure 95
New Connection Id
Step Result:
The Add List Item dialog box opens.
Figure 96
Add List Item Dialog Box
Step 4
Enter a unique connection-id.
Step 5
Click Ok.
Step 6
Click the connection ID.
Figure 97
Connection ID Window
Step 7
Enter the circuit cross-connect setting information.
Figure 98
Cross-connect Information
Step 8
Click Commit.
Figure 99
Commit Button
Step Result:
The Information dialog box opens, indicating that the committed configuration is successful.
Figure 100
Information Dialog Box
Step 9
Click OK.
3.4
CLI Window
In this section:
3.4.1 Run CLI Scripts
The CLI is rendered using data models defined in YANG modules. Two modes of operation are
available:
■ Operation mode
■ Configure mode
■ Show
■ Request
■ Set
■ Delete
The CLI provides a mechanism for the user to enter commands that configure and manage entities (for
example, interfaces, access control lists, and maintenance end points) and perform operations,
administrative, and maintenance tasks on the NE.
NE Utilities CLI
Figure 101
CLI Selection
The changes made by any user through CLI are immediately visible within the web interface. The CLI
can be opened within the web interface, which allows users to simultaneously leverage the
functionality and familiarity of CLI commands and view summary graphics and dashboard status.
Figure 102
CLI Window
Create a script that can execute a set of commands without manual intervention. Scripts allow various
quick methods to simplify actions.
3.4.1
Run CLI Scripts
Users can upload a CLI script to quickly apply a list of provisioning commands for the entire node. The
following steps show how to run a CLI script that can execute a set of commands without manual
intervention.
Step 1
From the menu bar, select:
Figure 103
Run Scripts Selection
Step 2
Click Select script.
Step 3
Browse and select a file of type text.
Step Result:
The selected script with the filename is displayed.
Figure 104
Selected Script
Step 4
Click Run script to execute the commands.
Step Result:
The Result box contains the output of the CLI execution.
Step 5
Click Save to disk to browse and save the result displayed in a file to the local drive.
4
System Maintenance
In this chapter:
4.1 Performance Monitoring
4.2 Boot Update
4.3 NE Software Management
4.4 NE FW Management
4.5 Database Management
4.6 Lock and Unlock Datastore
4.7 Restarting NE
4.8 Reports
4.1
Performance Monitoring
Retrieve PM register values (monitoring types), filter threshold time-period settings, and reset
registers, and monitor NE attributes, shelves, and slots.
The following are the three types of performance monitored data that can be retrieved:
■ Bin—Data count of the current bin depending on time period and threshold
Note: It contains all data on attributes. Attributes in the bin vary according to entities and
products.
• 15-Min—Stores bin value for monitoring every 15 minutes. Contains a maximum of 32 index list
Figure 105
Pm-equipment Tab
Click the shelfId to view the PM data. To refresh the page, click Refresh.
Figure 106
PM Data—Equipment
Figure 107
Pm-interfaces Tab
Figure 108
PM Data—Interfaces
4.2
Boot Update
In this section:
4.2.1 Update and Boot
The Boot Update option allows the user to perform in-field software and FW updates.
4.2.1
Update and Boot
Step 1
On the NE menu, select:
Figure 109
Boot Update
Step 2
Select the shelf-id from the drop-down list.
Step 3
Select the relevant slot-id from the drop-down list.
Step 4
Select the relevant sub-slot-id from the drop-down list.
Step 5
Enter the boot image filename in the fileName field.
Note: The fileName field is optional and can be used if the user wants to support multiple versions of
boot code.
Figure 110
Boot Update Fields
Step 6
Click Invoke boot-update.
Step Result:
The boot update request is sent successfully.
Figure 111
Update Request Status
4.3
NE Software Management
In this section:
4.3.1 Viewing Software Information
4.3.2 Upgrade Software
4.3.3 Activate Software
4.3.4 Cancel Validation Timer
4.3.5 Unpack Software
Use the software download function to download a new software to an NE. User can download
software, activate or schedule the activation of a new software, delete software file in the repository,
and perform software backup.
NE SWDL
4.3.1
Viewing Software Information
To view the version information of the current running software, select from the menu bar:
NE SWDL SW Info
Figure 112
Software Information
Table 7
Software Information Fields
Field Description
activation-date-time Displays activation date and time in which the load was activated
4.3.2
Upgrade Software
Step 1
From the menu bar, select:
NE SWDL SW Stage
Figure 113
SW Stage Selection
Step 2
Enter the software PGM or signed.tgz filename in the filename field.
Step 3
Select the destination of the repository bank in the repository field.
Figure 114
SW Fields
Step 4
Click Invoke sw-stage to stage the software for upgrade.
Figure 115
Stage
4.3.3
Activate Software
Step 1
From the menu bar, select:
NE SWDL SW Activate
Figure 116
SW Activate Selection
Step 2
Enter the gissue and validationTimer in the sw-activate tab.
Figure 117
Sw-activate Tab
Step 3
Click Invoke sw-activate to activate the software.
4.3.4
Cancel Validation Timer
Step 1
From the menu bar, select:
Figure 118
Cancel Validation Timer Selection
Step 2
In the accept field, select the appropriate option:
Option Description
true Cancel the validation timer and accept the new software load.
false Trigger an immediate reversion to the previous software load.
Figure 119
Cancel Validation Timer Fields
Step 3
Click Invoke cancel-validation-timer to cancel the validation timer and accept the new load.
4.3.5
Unpack Software
Step 1
From the menu bar, select:
NE SWDL SW Unpack
Figure 120
SW Unpack Selection
Step 2
Enter the path or tar/gzip filename in the filename field.
Figure 121
SW Unpack Fields
Step 3
Click Invoke sw-unpack.
4.4
NE FW Management
In this section:
4.4.1 Viewing Firmware Information
4.4.2 Update Firmware
4.4.1
Viewing Firmware Information
To view the loaded FW information, select from the menu bar:
NE SWDL FW Info
Figure 122
FW Info Selection
Table 8
FW Information Fields
Field Description
bootVersion Displays the version number of the boot loader running on the EQPT
entityName Displays EQPT AID. For example, fw-info 1 // show FW of shelf 1 fw-info 1/1 // show FW
for slot 1 in shelf 1 fw-info 1/1/1 // show FW for subslot 1 in slot 1 in shelf 1
expfwcompat Displays the FW compatibility value for the version of FW that is yet to be installed (the
FW whose FW issue is displayed in expfwissue)
Table 8 (Cont.)
FW Information Fields
Field Description
expfwissue Displays the FW issue for FW that is yet to be applied. (For example, after upgrading
the software, if a new FW is available in the new software load, this version is that of
the new FW.)
expinservicefwcompat Displays the list of FW issue ranges, for which the new FW upgrade is hitless, instead of
lowest FW issue
expverFlag Displays the new version flag for the FW yet to be installed. (For example, if the FW is
provided with new capabilities, this version flag shows those capabilities.)
fwcompat Displays the list of FW issue ranges, which the HAL can be compatible with, instead of
lowest FW issue
fwdlType Displays FWDL type for given unit code (equipment type) that is read from the
hardware
4.4.2
Update Firmware
Step 1
From the menu bar, select:
NE SWDL FW Update
Figure 123
FW Update Selection
Step 2
Select the shelf-id from the drop-down list.
Step 3
Select the relevant slot-id from the drop-down list.
Step 4
Select the relevant sub-slot-id from the drop-down list.
Step 5
In the force field, select the appropriate option:
Option Description
true Update the FW irrespective of the equipment state.
false Do not update if equipment is not in a desired state.
Step 6
In the overwrite field, select the appropriate option:
Option Description
true Overwrite the FW even if the FW version is the same.
false Do not overwrite the FW if the FW version is the same.
Figure 124
FW Update Fields
Step 7
Click Invoke fw-update.
Step Result:
The FW update request is sent successfully.
Figure 125
FW Update Request Status
4.5
Database Management
In this section:
4.5.1 Viewing Database Information 4.5.5 Activate Database
4.5.2 Back Up Database 4.5.6 Cancel Rollback Timer
4.5.3 Transfer Database 4.5.7 Initialize Database
4.5.4 Restore Database
WebGUI allows the user to manage the NE database, for example, initialization, backup, transfer,
restoration, and activation. To manage database, select from the menu bar:
NE DB
■ DB Restore—Restores the NE database from the user-defined remote FTP or SFTP server.
■ Cancel Rollback Timer—Cancels rollBackTimer set by the user during database activation.
4.5.1
Viewing Database Information
WebGUI allows the user to check and monitor database information of all active NEs. To manage
database, select from the menu bar:
NE DB DB Info
Figure 126
DB Info Selection
WebGUI opens the Db-show tab that displays information about active NEs. Use CTRL+C to copy the
selected data to the clipboard and use CTRL+P to paste the copied data into another application, for
example, Notepad or Excel.
Figure 127
Db-show Tab
4.5.2
Back Up Database
Step 1
From the menu bar, select:
NE DB DB Backup
Figure 128
DB Backup Selection
Step Result:
The Db-backup tab appears displaying filename field.
Figure 129
Db-backup Tab
Step 2
Enter the filename in the filename field.
Step 3
Click Invoke db-backup.
Step Result:
A confirmation message opens, indicating that the database backup is complete. A local copy of the
database on the NE is created.
Figure 130
Db Backup Complete
4.5.3
Transfer Database
Step 1
From the menu bar, select:
Figure 131
Model Tree > Actions
Step Result:
The Transfer tab appears.
Figure 132
Transfer Tab
Step 2
Select the appropriate transfer-method from the drop-down list: SFTP or FTP.
Step 3
Select the appropriate action from the drop-down list: upload or download.
Step 4
Enter the location of the database in local-file-path field.
Step 5
Enter the SFTP or FTP credentials.
Step 6
Enter the appropriate value in the server[:port] field.
Step 7
Enter the desired SFTP or FTP location where database needs to be copied in remote-file-path field.
Step 8
Click Invoke transfer.
Step Result:
A confirmation message opens, indicating that the database transfer is complete.
4.5.4
Restore Database
Step 1
From the menu bar, select:
NE DB DB Restore
Figure 133
DB Restore Selection
Step Result:
The Db-restore tab appears displaying filename and sysNameCheck fields.
Figure 134
Db-restore Tab
Step 2
Enter the filename in the filename field.
Step 3
In the sysNameCheck field, select the appropriate option:
Web Graphic User Interface
(WebGUI) Fujitsu and Fujitsu Customer Use Only
Issue 2, February 2020
FNC-1F-WEBGUI-02
System Maintenance Page 108
Database Management
Option Description
true Indicate if sysNameCheck is required
false Indicate if sysNameCheck is not required
Step 4
Click Invoke db-restore.
Step Result:
A confirmation message opens, indicating that the database restore is complete.
Figure 135
DB Restore Complete
4.5.5
Activate Database
Step 1
From the menu bar, select:
NE DB DB Activate
Figure 136
DB Activate Selection
Step Result:
The Db-activate tab appears displaying rollBackTimer field.
Figure 137
Db-activate Tab
Step 2
Enter the rollback time in the rollBackTimer field.
Step 3
Click Invoke db-activate.
Step Result:
A Warning! dialog box opens.
Figure 138
Warning Dialog Box
Step 4
Click OK to activate the database.
Step Result:
A confirmation message opens, indicating that the database activation is complete.
Figure 139
DB Activate Complete
Step 5
Proceed to Cancel Rollback Timer to cancel the set rollback time.
4.5.6
Cancel Rollback Timer
Step 1
From the menu bar, select:
Figure 140
Cancel RollBack Timer Selection
Step Result:
The Cancel-rollback-timer tab appears.
Figure 141
Cancel-rollback-timer Tab
Step 2
In the accept field, select the appropriate option:
Option Description
true Cancel rollback timer and accept the new load
false Continue rollback timer and restore the old load
Step 3
Click Invoke cancel-rollback-timer.
Step Result:
A confirmation message opens, indicating that the cancellation of the rollback timer is complete.
Figure 142
Cancel Rollback Timer Complete
4.5.7
Initialize Database
Create the database when database errors occur.
Step 1
From the menu bar, select:
NE DB DB init
Figure 143
DB init Selection
Step Result:
A Warning! dialog box opens.
Figure 144
Warning Dialog Box
Step 2
Click OK to initialize the database.
4.6
Lock and Unlock Datastore
The Lock and Unlock feature offers an option to secure access to a datastore without having to shut
down while the user is not using it. User can continue to monitor the network without interference
from other users. Other users can view the configuration; however, cannot commit any configuration
changes.
Step 1
Click Lock to lock datastore.
Figure 145
Lock Menu
Step Result:
The user database is locked.
Step 2
Click Unlock to unlock the user datastore.
Figure 146
Unlock Menu
4.7
Restarting NE
In this section:
4.7.1 Restart—COLD
4.7.2 Restart—WARM
■ COLD restart—NE shuts down completely and does not affect the current traffic
Note: The behavior of COLD and WARM restart is based on the NE. The WebGUI connection is lost.
4.7.1
Restart—
COLD
Step 1
From the menu bar, select:
NE Restart Cold
Figure 147
Cold Restart Selection
Step Result:
A Cold Reset dialog box opens.
Figure 148
Cold Reset Dialog Box
Step 2
Click OK to close the current session.
4.7.2
Restart—
WARM
Step 1
From the menu bar, select:
NE Restart Warm
Figure 149
Warm Restart Selection
Step Result:
A Warm reset dialog box opens.
Figure 150
Warm Reset Dialog Box
Step 2
Click OK to close the current session.
4.8
Reports
In this section:
4.8.1 Technical Information
4.8.2 Syslog
4.8.3 Alarm History
Store logs of various system events, and download and send log information to a remote Secure File
Transfer Protocol (SFTP) or File Transfer Protocol (FTP) server.
4.8.1
Technical Information
Step 1
From the menu bar, select:
Figure 151
Tech Info Selection
Step 2
Click Create New.
Step Result:
The Create Tech Info window opens.
Figure 152
Create Tech Info Window
Step 3
Select the specific shelf or All from the Select Shelf drop-down list.
Step 4
Select the action to be carried out: Download & Send or Download.
Step 5
Enter the desired name for the TAR file.
Step 6
To change the destination location, go to browser setting.
Step 7
If the user selects Download & Send, SFTP and FTP server information is to be entered.
Step 8
Click Submit.
Step Result:
A message dialog box informs the status of the Tech Info Log generation.
Figure 153
Tech Info Log Generation Message
Step 9
Click Close to close the message.
Note: The action is repeated for all the shelves that the user has selected. After all the logs are
collected, the logs become available under the respective shelf name in the user folder name
under /tmp/techinfo.
Step Result:
The Tech Info summary page shows the status of the log generation. The TAR file is available for
download after the log generation process is complete.
Figure 154
Tech Info Summary Page
4.8.2
Syslog
Step 1
Log on to the WebGUI.
Step 2
From the menu bar, select:
Logs Syslog
Step Result:
The Show-log tab appears.
Step 3
Select the shelf-id from the drop-down list.
Step 4
Enter the path of the syslog file in the log-file field.
Step 5
Click Invoke show-log.
Figure 155
Show Log
Step Result:
The complete log report appears.
Figure 156
Log Report
Step 6
Click Download File to download the log report.
Figure 157
Download File
Additional Instructions:
To filter the log report, type the text in the box and click Filter.
Figure 158
Filter Log
4.8.3
Alarm History
Alarm History provides the user a list of alarms raised for each provisioned resource with their
respective status and conditions.
Step 1
To check alarm list, select from the menu bar:
Figure 159
Alarm History Selection
Step Result:
The Alarm History tab appears.
Figure 160
Alarm History Tab
Step 2
Click Export to excel to generate a report file on alarm history.
Step Result:
A confirmation message opens, indicating that the cancellation of the rollback timer is complete.
Additional Instructions:
Click Refresh to check for alarm updates.
Index
A I
alarm interface attributes 26
export to excel 123
history 123
refresh 123
K
key
B configure mode 81
operation mode 81
boot
invoke boot-update 88
update 88
L
log off 25
C log on 23
R
report 118
REST 49
rollbacks 42
run script 83
S
secure file transfer protocol 118
select script 83
software
unpack 95
subslot
provisioning 70
syslog 120
system
requirement 19
setting 47
T
turn up wizard
bridge mode 60
management mode 60
mix mode 60
router mode 60
U
user account
configure 56
W
web server 47
web-based graphical user interface 10
WebGUI