Professional Documents
Culture Documents
EMS Network Manager
EMS Network Manager
When logging on for the first time, you are referred to the Topology work space
1.1 Overview
The RADview-EMS GUI consists of the following elements:
• Menu bar. Opens various applications and tools.
• Work space selection. This area is used to select the various work spaces.
• Work space. Provides device maps, task lists, lists of services, catalog entries
etc. For additional information, refer to the summary in Table 0-1.
• Navigation panes. Navigate devices, user profiles, catalog entries, filters etc.
Various navigation panes appear, depending on the work space you choose.
• Auxiliary Pane. Displays summaries, lists or events etc, depending on the
currently selected work space. For additional information, refer to the
relevant section.
• Task bar. Displays the user name, the name or the IP address of the active
sever and the connection status.
RADview-EMS GUI components are associated with the work space you select as
explained in the table below.
Topology map(s). For • Network Element Repository. Displays Event Browser. Events and
additional the managed devices on their alarms of network
information, refer to respective levels, adds single devices elements. For additional
Working with or groups of devices. The network information, refer to
Topology in this repository tree appears when Chapter 7 in the System
document. selecting the Topology view User Manual.
• Groups. Dynamic user groups, for
additional information, refer to
Chapter 6 in the System User Manual
<Overview 1
Selection Work Space Navigation Panes Auxiliary Pane
Catalog. List of Catalog. List of catalogs for service Details on catalog entries
catalog entries in the components and services.
selected catalog
Services. Lists and Filters. Options to display selected Properties, details etc of
defines/edits services. service the selected service
Docking Windows
You can undock each dockable window component so that it becomes a floating
window, and you can redock it, in whatever position is suitable.
To undock a window:
• On the window title bar, click Toggle floating to change the window to a
floating window.
The window is undocked and becomes a floating window.
1. On the window title bar, click Toggle floating to change the window to a
dockable window.
Or
Right-click the title bar of the window and in the submenu that appears, clear
Floating and select Dockable
2. Drag the window to the desired position.
Autohiding Windows
You can autohide the windows when it is not necessary to view their contents.
Term Definition
Map Covers the main part of the user interface and provides a
visual representation of levels (submaps) and nodes
(network elements and clouds) and links in the EMS
network. The levels and the nodes on each level of the
map correspond with the tree in the Network Element
Repository
Event Browser Shows events received from the network devices. Refer to
Chapter 7 for details on the Event Browser.
You can add new levels and nodes in the Network Element Repository or map
pane. New levels and nodes added in the Network Element Repository are
immediately shown in the map, and new levels and nodes added in the map are
immediately shown in the Network Element Repository.
Note
For the search utility to operate, you have to select Topology . All other
work spaces do not support the search for devices (NEs), even if the Navigation
Pane displays the NER.
2. If an element is found with a name that matches the text, the element is
highlighted in the Network Element Repository or Groups, or is surrounded by
a frame in the map.
Parameter Function
Find what Specifies the text string to search for. If you choose to run a
recursive search, you can enter part of the string to search for.
Whole words only Checked – The text being searched for must match a whole
word
Cleared – The text being searched for can match a whole word
or part of a word.
Default: Cleared
<Find Next> Click <Find Next> to search for the next occurrence of the string
Notes
• In the Network Element Repository or under Groups, all elements found with a
name that match at least part of the text are highlighted or surrounded by a
frame in the map respectively.
• On the map, only the current level is searched while in the Network Element
Repository, a search through all levels (recursive) is performed. Therefore,
searches in the Network Element Repository can take up to a minute,
depending on the number of nodes in the system.
Map Functions
You can perform the following functions with the map.
Task Description
Change layout of map Click on the map toolbar. Refer to Changing Level Layout for details.
Save the map as an image file Right-click and select Save as image
Export the map as Tom Sawyer To export the map, right-click somewhere inside the map, select Export
Visualization file (*.TSV). which from the shortcut menu, and then choose Tom Sawyer Visualization File
can be loaded by the Tom and specify the desired location.
Sawyer Tomahawk utility for
review.
To display a submap:
• In the Network Element Repository, double-click the desired level.
The submap of the desired sublevel appears.
Each submap contains icons corresponding to the content belonging to the level
in the Network Element Repository.
You are able to navigate between submaps, view multiple submaps in the work
space or close submaps from the Submap Tab menu.
Note The New Horizontal Group menu item does not show if horizontal groups already
exist for all submaps.
Add a level under the selected New Level New Level –––
level (see Adding New Levels)
Add a range of IP addresses as New NEs ––– New NEs ––– –––
network elements to the selected
level (see Adding )
Expand all levels as overview maps ––– ––– Expand > ––– –––
(see Expanding Levels) Expand All
Expand level as overview map (see ––– ––– ––– Expand –––
Expanding Levels)
Collapse all expanded level ––– ––– Collapse > ––– –––
overview maps Collapse All
Remove the selected level and all Delete ––– ––– Delete –––
subordinate levels (this function is
not available for the highest level)
(see Deleting Levels)
Locate the level icon on the map Locate on Map ––– ––– ––– –––
(this function is not available for
the highest level) (see Locating
Levels)
Hide the nearest neighbors of the ––– ––– Hide > Hide ––– –––
level Neighbors >
One Level
Hide the entire neighbor hierarchy ––– ––– Hide > Hide ––– –––
of the level Neighbors> All
Levels
Represent the nearest neighbors ––– ––– Fold > Fold ––– –––
of the level as a folder, which can Neighbors >
be double-clicked to open an One Level
overview
Represent the level’s entire ––– ––– Fold > Fold ––– –––
neighbor hierarchy as a folder, Neighbors> All
which can be double-clicked to Levels
open an overview
Transfer any elements in a folder ––– ––– Fold > Unfold –––
back to their original location
Update the level with the latest Refresh ––– Refresh ––– –––
configuration
Job Parameters Defines the job parameters of the level and, if desired, all
subordinate levels and nodes, for authentication if a
script is sent to network elements.
2. Click <Set>.
The level is configured with the new properties and added to the Network
Element Repository tree under the selected level, and added to the map
as a level icon ( ). You can double-click the level icon to open the
submap for the new level.
Note • The corresponding submap tab appears at the bottom of the map pane only
after you double-click the new level icon to open its submap.
• It is recommended to use systematic level names, such as names or locations
of units or a part of the IP address range. Names assigned to NEs should
reflect the naming convention of the respective levels. This allows for easy
location of NEs in large systems when grouping NEs and creating security
domains for those groups.
Expanding Levels
You can expand levels as overview maps, or expand a sublevel as a submap.
Deleting Levels
You can delete any level except the highest level.
1. In the level map’s toolbar, click Layout or right-click the level in the map
and select Layout from the shortcut menu.
2. In the Layout submenu, select or clear Incremental Layout. If Incremental
Layout is selected, RADview-EMS attempts to preserve map element locations
whenever possible, possibly relocating some elements if necessary, according
to the layout type. If Incremental Layout is cleared, the entire map is
formatted and map elements are relocated to best fit according to the layout
type.
3. Select the desired layout type:
Orthogonal –Produces compact map, using only horizontal and vertical
edge routing (see Figure 0-3 and Figure 0-5)
Circular –Emphasizes clusters inherent in the drawing topology (see
Figure 0-4 and Figure 0-6)
Symmetric –Emphasizes symmetries inherent in the drawing topology,
while ensuring that adjacent nodes are close to each other (see
Figure 0-7 and Figure 0-9)
Hierarchical –Emphasizes dependency relationships (see Figure 0-8 and
Figure 0-10).
Figure 0-9. Symmetric Layout Diagram Figure 0-10. Hierarchical Layout Diagram
Locating Levels
The locate function is useful for navigating directly to a level icon. This function
does not exist for the highest level.
To locate the level on the map:
• Right-click the level in the Network Element Repository navigation tree and
choose Locate on Map.
The level submap is opened that contains the icon corresponding to the level that
you wish to locate. The submap is positioned to show the part that contains the
level icon, with a frame surrounding it.
Configure trap synchronization Fault > Trap Sync ––– Fault > Trap Sync –––
groups for the selected network Groups Groups
element
Synchronizing the RADview-EMS Fault > Alarms ––– Fault > Alarms Sync –––
fault data with the network Sync
element
Connect to network element via Web Browser ––– Web Browser –––
Web Browser
Test connectivity of a network External Tools > ––– External Tools > –––
element by sending ping Ping Ping
Trace route to network element External Tools > ––– External Tools > –––
Trace Route Trace Route
Run a custom external tool for External Tools > ––– External Tools > –––
network element <customized tool> <customized tool>
Note: If you added external tools
as described in , they appear in
the External Tools submenu.
View active alarms for the Active Alarms ––– Active Alarms –––
network element in the Event
Browser, via filter (refer to
Chapter 7 for details on viewing
device events)
View previous alarms for the History Events ––– History Events –––
network element in the Event
Browser, via filter (refer to
Chapter 7 for details on viewing
device events)
Hide the nearest neighbors of the ––– ––– Hide > Hide –––
network element Neighbors > One
Level
Hide the entire neighbor hierarchy ––– ––– Hide > Hide –––
of the network element Neighbors> All
Levels
Represent the nearest neighbors ––– ––– Fold > Fold –––
of the network element as a Neighbors > One
folder, which can be Level
double-clicked to open an
overview
Represent the network element’s ––– ––– Fold > Fold –––
entire neighbor hierarchy as a Neighbors> All
folder, which can be Levels
double-clicked to open an
overview
Transfer any elements in a folder ––– ––– Fold > Unfold –––
back to their original location
Note
If you added external tools, they appear in the External Tools submenu.
To add a single network element to the Network Element Repository and map:
1. Select the level in the Network Element Repository for which you wish to add
a network element and select New NE on the toolbar, or right-click the
level in the Network Element Repository or in the map and select New NE
from the shortcut menu.
The New NE dialog box is displayed. It contains the following tabs:
General – Defines general network element parameters. Refer to
Table 0-6 for a description of the parameters.
SNMP – Defines the SNMP parameters of the network element if it is
managed via SNMPv1. Refer to Table 0-7 for a description of the
parameters.
SNMPv3 – Defines the SNMP parameters of the network element if it is
managed via SNMPv3. Refer to Table 0-8 for a description of the
parameters.
Job Parameters – Defines the job parameters of the network element, for
authentication if a script is sent to it. Refer to Table 0-9 for a description
of the parameters.
External Tools – Defines default command parameters for external tools.
Refer to Table 0-10 for a description of the parameters
Note – Holds optional text description.
2. Click <Set>.
The network element is configured with the new properties and appears
in the navigation tree as a node in the selected level. A new icon
corresponding to the network element appears on the level map.
Default double-click action Specifies action to take when Shelf View: Open shelf view
node is double-clicked. The Web Browser: Connect to
default is the action that was network element via Web
defined for the level, but you can browser
specify a different action for the
Telnet/SSH: Connect to
node if you wish.
network element via Telnet.
Parameter Function
Polling Interval (sec) The SNMP polling interval for the network element(s), in
seconds
Menu Option Specifies for which external tool Ping – Define the command
to define the command line and parameters for
parameters sending ping to network
element
Trace Route – Define the
command line and parameters
for tracing route to network
element
Note: If you added external
tools as described in , they
appear in the list.
Command Line Defines the command line for
the external tool
Note: This parameter is read-
only.
Command Parameters Defines the command
Note: If you change the parameters for the external tool
command parameters, the
attribute is stored in the
EMS database and used for
command line generation
for this object, rather than
the value in the External
Tools tab in the Level
Properties dialog box.
To add multiple network elements to the Network Element Repository and map:
1. Right-click the selected level and select New NEs from the shortcut menu.
The New NEs dialog box is displayed. It contains the following tabs:
General – Defines general network element parameters.
SNMP – Defines the SNMP parameters of the network element. Refer to
Table 0-7 for a description of the parameters.
SNMPv3 – Defines the SNMPv3 parameters of the node. Refer to
Table 0-8 for a description of the parameters.
Job Parameters – Defines the job parameters of the network element, for
authentication if a script is sent to it. Refer to Table 0-9 for a description
of the parameters.
External Tools – Defines default command parameters for external tools.
Refer to Table 0-10 for a description of the parameters.
Note – Holds optional text description.
2. Click <Set>.
Note Before removing a network element from the network, you have to first remove
all the links associated with the relevant network element.
1. Right-click the RAD device in the Network Element Repository and select
Delete from the shortcut menu.
You are prompted to confirm the deletion.
2. Click <OK> to confirm the deletion.
The network element is deleted from the Network Element Repository
and map.
Note • Clouds are associated with a provider, therefore at least one provider must be
added to the Business Entities list (in the Business Entities work space) before
you can add a cloud.
• If you try to add a cloud without selecting a provider, an error message is
displayed.
To locate a cloud:
• Follow the instructions on locating RAD devices under Locating RAD Devices.
To add a cloud:
1. Select the level in the Network Element Repository for which you wish to add
the cloud and select New Cloud on the toolbar, or right-click the level in
the Network Element Repository or in the map and select New Cloud
from the shortcut menu.
The New Cloud dialog box is displayed.
2. Assign a name to the cloud and enter a short description (optional).
3. Under Provider, click <…>.
The Providers list appears.
4. In the Providers list, select the desired provider and then click <Select>.
The selected provider is added to the Provider field in the New Cloud
dialog box.
You are now able to associate the access point with a virtual private network
(VPN).
To add a VPN:
1. In the Cloud Properties dialog box, select the VPNs tab.
The VPN list and the Access Point (AP) Membership table appear with one
VPN already configured.
2. To add an additional VPN, click <Add…> under the VPN list.
The Add VPN dialog box appears.
To remove a cloud:
1. Remove all VPNs and access points from the cloud.
2. Right-click the cloud.
A shortcut menu appears.
Figure 0-12. Legacy Link Created on the Map between two NEs in the Same Level
Note You cannot ‘upgrade’ a legacy link to a topographical link. You have to create a
new link.
Note Ports that already have a link defined or do not match the start point (End Point
A) appear grayed out and cannot be selected.
5. Click <Set>.
The Topological link is created between the selected ports of the two
selected network elements. The color of the link reflects the status of the
network elements.
Figure 0-13. Topological Link on the Map between two NEs on the Same Level
Figure 0-14. Topological Link on the Map between two NEs on the current Level
and a Sublevel
Note Ports that already have a link defined or do not match the start point (End Point
A) appear grayed out and cannot be selected.
1. Select the link. To do so, select Select from the toolbar and then click the
desired link.
The link is selected.
Note The entry Link List appears in the right-click menu if the map corresponds to a
level. It does not appear if the map corresponds to a group.
The Link Properties dialog box appears with a list of all the links
associated with the device, and displays the properties for the link that is
selected in the list.
To delete a link:
1. Right-click the link and select Delete from the shortcut menu.
The Delete Link dialog box opens, showing a list of links between the two
devices.
2. In the list, select the link that you wish to delete and click <Delete>.
You are prompted to confirm the deletion.
3. Click <Yes> to confirm the deletion.
The selected link is deleted.
Group Operations
You can perform group operations as shown in Table 0-12.
You can perform the same operations on group members as for levels/NEs in the
Network Element Repository, except you cannot explicitly add or delete members
of dynamic groups.
Operation Description
Open (double-click) Opens a tab in the map pane, showing the devices that belong to
group
New Level Opens a dialog box to add a new level to the group
(Static group only)
Locate on Map Opens a tab in the map pane, showing the groups in the subtree
Paste Pastes the previously copied or cut device(s) into the selected group
(Static group only)
Note • If you copy a level from the map or Network Element Repository, the
corresponding network elements are added to the group, but the level itself is
not copied
• If you copy/move a level from another static group, the level is added with the
corresponding network elements.
To edit resources:
1. In the Resources list, select the desired resource and then click Edit .
The Edit Resource dialog box appears.
2. Enter or edit the entries for Alias, Asset ID and/or Serial Number and then
click <Set>.
The entries are added/updated in the Resources list.
Filtering Resources
There is a Filters pane in both the Business Entities and Resources work space. It
has different default filters and different criteria for the filters, according to
which work space it is in.
To work with Jobs, you have to select Jobs in the work space selection
area.
Jobs Table Displays the jobs that are defined in the system. Refer to
Working with the Jobs Table for more information.
Attribute Description
Job Name A user-defined string of up to 255 characters that is used to identify the job
Job ID A number that is used to uniquely identify the job, set by the management system at
job creation. Each execution of a recurring job has the same job ID, but can be
distinguished by the execution date and time.
Action Action defined for job, e.g. Download Software
Description Description of job
Creator User name of the user who created the job
Creation Time Date and time (YYYY-MM-DD HH:MM:SS) that the job was created
Last Updated By User name of the user who last updated the job parameters via edit job operation
Last Update Time Date and time (YYYY-MM-DD HH:MM:SS) that the job parameters were last updated
Last Operation By User name of the user who last performed any action on this job such as: run, stop,
activate, deactivate, cancel
Last Operation Date and time (YYYY-MM-DD HH:MM:SS) that the job operation (stop, active, deactive,
Time cancel) was last performed – RO, set by the management system.
Owner The owner is the user name of the job owner. The default owner is the user who
created the job. A user can become the new owner of a job if permitted by
administrator.
Since job is running on server side, the owner security profile is used for the job.
Refer to Job Security in Chapter 4 for additional information.
Security Domain This is empty by default. You can add a domain name during job creation or when
editing a job, to control access to the job (the domain must be defined in the user
security profile with relevant permissions). When security domain is set for a job, some
users may not be able to access the job.
Refer to Job Security in Chapter 4 for additional information.
The shortcut (right-click) menus for the History and Active tabs are illustrated
below.
The section below outlines how to add a job. For additional information and
instructions, refer to Working with Jobs in Chapter 4 of the System User Manual.
The table below highlights the wizard steps and provides reference to additional
information and instructions.
NE Selection Method Select the method that defines the nework elements (NEs).
Select an Action Define the task to execute from a list. Only tasks that apply to all
selected network elements can be selected. All others appar listed,
but are grayed out.
Validate an Action Appears only if a conflict occurs, for example one or more NEs do not
support the selected action.
Validate the Job Appears only if a conflict occurs, for example one or more NEs
Parameters support the job, but not the selected job parameters.
Schedule Define whether to execute the job now, at a later stage or frequently
according to defined intervals
6 Creating Jobs
3. Select New Job .
1. In the Jobs Table Active tab, right-click and then select New Job from the
shortcut menu.
You are now able to select the NEs according to your choice (Step )
3. Select NE(s) according to the desired method (refer to Table 0-4).
Selecting NEs
This section explains how to select the NEs that apply to the desired job.
Note The examples of the dialogs below are provided for Windows 7, but apply to
Windows 2008 Server and Unix as well.
1. In the Jobs table, click New Job or start the wizard without prior selection
of NEs as explained above.
The Create New Job wizard appears with the NE Selection Method dialog
box (Step ).
Creating Jobs 7
2. Select the NE Selection Method and then click <Next>.
The Selection dialog box relevant to the selected method appears
(Step ).
3. Select the desired NEs according to one of the methods listed and explained
in Table 0-4
To discard the selection you made and choose different NEs or a
different selection method, click <Back> and repeat this procedure.
Method Instructions
8 Creating Jobs
Method Instructions
4. After selecting the desired NEs, click <Next> to start selecting the job itself.
Selecting Tasks
In Step , you select the tasks. Tasks are usually referred to as ‘actions’ in the
user interface and the wizard. For some tasks, you may have to select additional
options at this step.
To select a task:
1. In Step (Figure 0-4), under Select an Action, select the desired task.
For some tasks, additional settings appear from which you have to
choose the ones required for the task.
2. Refer to Table 0-5 for additional information and instructions on these
additional settings.
3. To continue, click <Next>.
Note • In case of Upload Software or Upload Software to Backup, all NEs must be of
the same type. If NEs were selected by selecting a dynamic group or via
criteria, there must be only one criterion for a single NE type and the
condition must be set to Equals.
• Step is skipped unless at least one selected NE does not support the
selected task or you are not authorized to perform this task on them. For
additional information on Step , refer to Validating Tasks.
Creating Jobs 9
Figure 0-4. Job Wizard – List of Tasks (For a Group of NEs)
10 Creating Jobs
Figure 0-5. Job Wizard –Upload Configuration Selected (For a Group of NEs)
Creating Jobs 11
Figure 0-6. Job Wizard – Task List (For LA-210)
Allow only actions • Checked. Tasks that are unsupported by at least one If you selected a
supported by all of the selected NEs are listed, but grayed out and dynamic user group, this
selected NEs unavailable for selection. option does not appear
• Cleared. Tasks that are unsupported by at least one of and all the listed tasks
the selected NEs are listed and selectable. When can be selected.
moving on, the system returns a list of NEs that do
not support the task (step ). For further
information, refer to Validating Tasks
12 Creating Jobs
Parameters Available Settings Remarks
Activate congfig file • Checked. Acivates the configuration upon upload. Appears if Upload
upload • Cleared. Does not activate the configuration. Configuration is checked
as illustrated in
Default: Cleared
Figure 0-5
Install Software • Checked. Installs the software and resets the NE. Appears if Upload
• Cleared. Only uploads the software. Software is checked.
Default: Cleared
Note: Some NEs automatically reset after uploading
software, regardless of whether Install Software is
checked or not.
Reboot after Swap • Checked. Reboot the NE after swapping the main and Appears as selectable
backup software files. swap option when Swap
• Cleared. No reboot after swapping main and backup Main and Backup
software files. The swap takes effect only after Software is checked.
manually rebooting the NE.
Default: Cleared
Creating Jobs 13
Figure 0-7. Job Wizard – Select Upload License Action (For LA-210)
Validating Tasks
Step is a validation step that the system passes if the current user is not
authorized to perform the task on at least one NE or if at least one NE does not
support the task defined in Step as outlined below.
Activate operation is not The Activate config upload option was selected
supported but the operation is not supported by the NE
14 Creating Jobs
NEs must be of the same The selected operation is Upload Software or
type Upload Software to Backup and the selected NEs
do not have the same NE Type
1. Click <Back> twice to return to Step and then modify the NE selection.
If all NEs are supported and none of the conditions above apply, Step
is skipped and the wizard moves straight to Step .
Creating Jobs 15
To continue defining the task:
1. In Step , edit the name for the task if desired and add a description in the
optional Description field.
By default, the Description field is empty and the name is comprised of the
task name from the ‘Select an Action’ list and the following, dpending on the
number of NEs and whether they are of the same type:
1-2 NEs: <Task name><Name of NE>, <Name of NE>, for example
Execute Script – 172.17.151.209, 172.17.155.17
3 or more NEs of different types: <Task name> - <#> NEs, for example
Execute Script – 3 NEs
3 or more NEs of the same type: <Task name> - <NE type>, for example
Execute Script – LA-210
2. Select the various parameters according to the task you select. These tasks
are explained and illustrated in the sections outlined below.
Note If the job action is Generate Statistics Report, the dialog box Report Parameters
appears before Completing Adding the Job or Scheduling Jobs. For additional
information, refer to Chapter 5.
16 Creating Jobs
The sections below explain selecting and setting task parameters for the every
job. Follow the respective link to get to the desired job.
• Collect Statistics
• Download Auxiliary File
• Download Configuration
• Download Log
• Download Software
• Download Software from Backup
• Download User File
• Execute Script
• Execute SNMP Script
• Generate Data Report
• Install Software
• Reboot
• Save Configuration
• Swap Main and Backup Software
• Upload Configuration
• Upload License
• Upload Software
• Upload Software to Backup
• Upload User File
Collect Statistics
For this task, Step defines how long to store the statistic data in the NMS
database. The default is 90 days. For scheduling options, refer to Scheduling
Jobs.
Note Verify that your hard drive has sufficient space to store the statistics data.
Creating Jobs 17
Figure 0-9. Collect Statistics
18 Creating Jobs
Figure 0-10. Download Auxiliary File
Download Configuration
In step , you choose to download the configuration to a specified location on
your work station.
You specify the download location on your work station beforehand using the
TFTP or SFTP server you installed.
Depending on the NE, you can download up to four different configuration files
that you can select under Source File Name within NE.
startup-config Configuration file that resembles the state at the start of the device
Creating Jobs 19
Source File Name within NE Remarks
Notes
• If some of the selected NEs do not support several configuration files, the
value selected in Source file name within NE is valid only for the NEs
supporting multiple configuration files.
• For the NEs that support a single configuration file, the configuration file that
resides in the NE is downloaded.
• If none of the selected NEs supports file name within NE, or a dynamic group
was not selected for the job, the parameter does not appear.
20 Creating Jobs
Download Log
In step , you choose to download the log file according to the label under
Source File Name within NE to a specified location on your work station.
You specify the download location on your work station beforehand using the
TFTP or SFTP server you installed. The example below is set to download the
alarm history.
Download Software
In step , you choose to download the software file to a specified location on
your work station.
You specify the download location on your work station beforehand using the
TFTP or SFTP server you installed.
Creating Jobs 21
The Source File within NE list box shows, if multiple software versions reside on
the relevant NE from which you select the desired one.
Note • If the parameter Source File Name within NE does not appear, the active
software is downloaded.
• If the Main software file is downloaded, the version attribute in the
configuration archive is obtained from the MIB parameter sysDescr.
22 Creating Jobs
Download User File
In step , you choose to download the user MAC address table to a specified
location on your work station. You specify the download location on your work
station beforehand using the TFTP or SFTP server you installed.
Under Source File within NE, the user file name (for example user.dat) is
displayed.
Execute Script
In step , you choose to execute scripts entered via the following three ways to
one or several NEs:
• Selecting built-in and pre-define scripts
• Importing scripts that are saved as text files (*.txt)
• Manually entering CLI commands.
Creating Jobs 23
The latter two options allow for running CLI command that are not supported by
a job, for example uploading a license file to a device that does not support the
Upload License job.
For more information on CLI commands, refer to the user manual associated with
the desired device.
Note Menu driven devices do not support the Execute Script job.
2. If required, edit the syntax to enter correct parameters (for example keys or
number of retries under TACAS+). These changes are preserved and take
effect for all selected NEs that support the respective feature when
completing the wizard.
24 Creating Jobs
Figure 0-15. Script Preview for ‘ETX-203AM Prepare for Service Config’
To import a script:
1. Click <Browse>.
The Select File dialog box appears.
2. Navigate to the desired file and then click <OK>.
The entire content of the text file appears under Select pre-defined script
and the Select File dialog box closes.
1. In the Execute Script: Job Parameters dialog box (Step ), click <Advanced>.
The Advanced Job Parameters dialog box becomes available as illustrated
under Setting Advanced Job Parameters.
2. In the Advanced Job Parameters dialog box, select Log all job tasks.
3. Once you completed the wizard, in the Jobs Report, click <More details> to
view the result of the script execution.
Creating Jobs 25
Figure 0-16. Execute Script
Set Net Date and Time for MP- Synchronize the time and the date of
2100/2104 all selected MP-2100/2104 with the
network’s time and date.
Clear Net Alarms for MP-2100/2104 Clearing all current alarms for all
selected MP-2100/2104 devices.
26 Creating Jobs
Figure 0-17. Execute SNMP Script
Note This job uses two wizard steps (step and ) to assign the job parameters.
Creating Jobs 27
Install Software
In step , you choose to install software that has already been uploaded to the
NE and stored there.
If the selected NE(s) support(s) multiple software files, you can activate a specific
software pack listed under Target File Name within NE.
Note Installing a previous software version may not be compatible with the device and
cause it to fail operating properly. Therefore, you have to verify that the desired
software version is compatible with your current hardware.
Reboot
In step , you choose to restart all the selected NE(s).
28 Creating Jobs
Figure 0-19. Reboot
Save Configuration
In step , you choose to save the current configuration.
If your NE supports it, you can copy running-config to startup-config in the NE in
order to save its current configuration.
Creating Jobs 29
Figure 0-20. Save Configuration
30 Creating Jobs
Figure 0-21. Swap Main and Backup Software
Upload Configuration
In step , you choose to upload the configuration to a single or to multiple NEs.
In addition, you can upload the configuration from the archive or from the local
file system.
Creating Jobs 31
Figure 0-22. Upload Configuration - From Archive to Single NE
32 Creating Jobs
To upload a configuration from the archive to multiple NEs:
Last running Use last running configuration file that was archived by a
download job. If such was not found, nothing is uploaded.
For NEs that do not support running configuration file, the
latest configuration file saved in the configuration archive is
loaded.
By Date Use file with the specified date. If such was not found, the
file with the closest earlier date is loaded. If the job action is
Upload Configuration, then for NEs that support running and
startup configuration files, if both running and startup files
have the same date, the file with the latest time is loaded.
Note If the selected task is Upload User File, By Date is the only available upload
option.
Creating Jobs 33
Figure 0-23. Upload Configuration - From Archive to Multiple NEs
34 Creating Jobs
Figure 0-24. Upload Configuration File from Local File System to Single NE
2. Click <Browse>.
The Select Path dialog box appears.
3. Navigate to the desired file and click <OK>.
4. Under Target File Name within NE, select the target file name and type.
To upload a configuration file from the local files system to multiple NEs:
Note These instructions apply if you selected multiple NEs of the same type
specifically, for example multiple LA-210 devices.
Creating Jobs 35
Figure 0-25. Upload Configuration - From Local File System to Multiple NEs
2. Click <Browse>.
The Select Path dialog box appears.
36 Creating Jobs
Figure 0-26. Select Path Dialog Box – Multiple Configuration Files
Note The files are not displayed and the white field in the Select Path dialog box
remains empty.
Creating Jobs 37
Figure 0-27. Upload Configuration - From Local File System to Multiple NEs, Path Specified
38 Creating Jobs
Notes • If a file is not found for a particular NE, nothing is uploaded to it.
• For all Upload Configuration options, if at least one of the selected NEs
supports the target file name within NE or a dynamic group was selected for
the job, the Target file name within NE parameter is displayed in the dialog
box, with only the startup-config option available.
• In the case of Upload User file, the Target file name within NE parameter is
displayed in the dialog box as a text box that you can fill in.
Upload License
In step , you choose to upload a license file to a single or to multiple NEs. In
addition, you can upload the configuration from the archive or from the local file
system.
Note The Upload License job is currently supported by LA-210 units only.
To upload a license file from the local file system to a single NE:
Creating Jobs 39
Figure 0-28. Upload License File from Local File System to Single NE
5. Click <Browse>.
The Select Path dialog box appears.
6. Navigate to the desired file and click <OK>.
40 Creating Jobs
Figure 0-29. Upload License File from Local File System to Single NE – License File Selected
The license file names must include the MAC address of the device to which
the respective file is going to be uploaded. They are composed as follows:
LIC_<MAC address of the relevant LA-210 unit>.txt
If the MAC address is for example 00-20-D2-2A-60-37, the associated license
file name is LIC_0020D22A6037.txt
Note To identify the MAC address of the relevant device, open its shelf view and then
go to System Info or Device Info as explained in the respective RADview-EMS
agent manual.
Creating Jobs 41
To upload a license file from the local file system to multiple NEs:
Note License files are dedicated to specific devices and are identified by the MAC
address of the respective device as part of their file names. The file names are
composed as explained above.
1. Verify that all license files are stored in the same folder and match the
number and MAC addresses of the LA-210 you selected.
2. Under Load From:, select Local File System.
The Multiple Files option is selected and the Single File option is
unavailable.
Figure 0-30. Upload License Files - From Local File System to Multiple NEs
3. Click <Browse>.
The Select Path dialog box appears.
42 Creating Jobs
Figure 0-31. Select Path Dialog Box – Multiple License Files
Note The files are not displayed and the white field in the Select Path dialog box
remains empty.
Creating Jobs 43
Figure 0-32. Upload Licenses - From Local File System to Multiple NEs, Path Specified
Note You can upload single and multiple license files from the archive.
44 Creating Jobs
Figure 0-33. Upload Multiple License Files via Archive – Selecting the File Option
2. Select the desired license file group. The following license file options are
available:
Note
If you select By Date and the file issued at the specified date is not found, the
file issued at the nearest date is uploaded instead.
Creating Jobs 45
Figure 0-34. Upload Multiple Licenses License – Last License
46 Creating Jobs
Figure 0-35. Upload Multiple Licenses License - By Date
Upload Software
In step , you choose to upload a software version to a single NE or to multiple
NEs.
Note If you select multiple NEs, all NEs must be of the same type, for example
ETX-203AX.
• Select the desired software version from the Software Version list as
illustrated in Figure 0-36 and Figure 0-37.
Creating Jobs 47
Note • If the desired software version does not appear, it is not listed in the
RADview-EMS Software File Management Table and must first be imported. For
instructions on importing the software version, refer to the instructions on
importing a software version below.
• If you upload the software file to multiple NEs and the NEs support multiple
software files, the dropdown list Target file name within NE appears, enabling
you to specify the SW pack as which you want to upload the software file.
• For NEs that support multiple software files, in order to activate the SW pack
you have to create a task to install software. For additional information, refer
to Install Software.
• If multiple software files are not supported by an NE, the software file is
uploaded to the main software
48 Creating Jobs
Figure 0-37. Upload Software - To NEs Selected By Criteria
Creating Jobs 49
Figure 0-38. Upload Software – Import SW Version
2. Click <Browse> to navigate to the location and the desired software file.
3. Under SW Version, enter the software version, for example 4.3.
4. Under Comments, add a comment if desired.
7. Click <OK>.
The software is imported and appears listed. It also appears in the
RADview-EMS Software File Management Table.
To set advanced job parameters and complete this step of the wizard:
50 Creating Jobs
3. Click <Next>.
You are moved to the next stop of the wizard.
Parameter Description
Send report to: When this is selected, a text box is available where you can enter one
or more email addresses, separated by semicolons (“;”), to which the
job report should be sent
By default, the text box contains the email address(es) entered in
previous job creations
If Send report to: is selected, you can select which type of report to
send – Summarized or Detailed (default), as well as to send email
only if job was unsuccessful
Creating Jobs 51
Parameter Description
Send report only if job fails When this is selected, job report is emailed only if job execution
completes with status not equal to OK
Note: Relevant only if Send report to: is selected
Maximum number of concurrent Specifies how many NE tasks (such as SNMP, xFTP, or Telnet session
NE Tasks for this job between NMS and an NE) can be opened for the specific job. For
Note: Does not appear for action example, if the job applies to 25 NEs, there are 25 NE tasks to
Generate Statistics Report. execute. If this parameter is set to 5, a maximum of five NE tasks can
be executed simultaneity. When one of the five NE tasks finishes, the
next task starts, and so on.
This parameter should be set to equal to or less than the value set in
the system console for the number of concurrent sessions allowed in
the entire system.
Values: 1–200 (default 100)
Set as default If selected, all future new jobs have the security domain of the
current job. Clear this option to cancel setting the security domain
for new jobs.
Clear Click to delete the list of previously defined security domain names
from the dropdown list (this applies to all jobs). This is useful if the
autocompletion feature prevents you from entering the desired
domain name.
Configuration Error Policy Determines the device behavior if an error occurs while NE is loading
Note: Appears only for action configuration file:
Configuration Upload for RAD-OS • Ignore errors and continue loading the file
devices. • Stop loading the configuration file if an error occurs
• Reject the file, reboot, and load the next configuration file in the
following sequence: startup, rollback, user default, or factory
default
52 Creating Jobs
Completing Adding the Job
Once you configured the job parameters, you are asked to schedule the job. In
case that one or more NEs do not support task parameters you set, you are
notified and asked to validate the job parameters.
Step lists the NEs that do not support at least one parameter you set as
explained under Validating Job Parameters.
The scheduling options in step vary with the selected job. Refer to
Scheduling Jobs to locate the parameters and complete setting up the task.
Note The Generate Statistics Report job uses two wizard steps to set parameters,
therefore the validation of job parameters and scheduling are performed in steps
and respectively. For additional information on the Generate Statistics
Report job, refer to Generate SLA Reports in Chapter 5.
Creating Jobs 53
Figure 0-40. Job Wizard – Job Parameter Validation
54 Creating Jobs
Note • Unsupported/unauthorized NEs for the selected job and its parameters are not
included in the selection.
• The Job Scheduling dialog varies with available scheduling options, which
depend on the respective job. For additional information, refer to the next
page.
• f a group from the private group tree was selected for the job, only the option
Now appears
• The option Recurring appears only for the job actions Download Configuration,
Download Software, Download User File, Collect Statistics, and Generate
Statistics Report
• For job action Collect Statistics, only the option Recurring appears.
• For job action Generate Statistics Report, only the options Now and Once
appear if the report period is not the previous month; only the option
Recurring appears if the report period is the previous month
• For job action Generate Data Report, only the options Now and Once appear.
Scheduling Jobs
Depending on the specific task, up to three scheduling options are available:
• Running the job now
• Running the job once at a scheduled time.
• Running the job periodically according to a specified recurrence pattern.
Note Make sure that all selected NEs are connected and online at the time when the
task is scheduled to be executed.
Creating Jobs 55
Figure 0-42. Job Scheduling – Time Frequency for Collect Statistics and Generate Data Report
Figure 0-43. Job Scheduling – Recurring Pattern for all other Jobs
56 Creating Jobs
4. Click <Finish> to complete creating the task (job).
The job to the Active tab of the Jobs Table.
Creating Jobs 57
Table 0-9. Scheduling the Range of Recurrence
Parameter Description
Start Specifies the date when the job starts running, according to the recurrence
pattern. A combo-box is available where you can select the date, and a text
box is available where you can enter the time.
End after A text box is available where you can enter the number of recurrences
Default: 10
End by (default) A combo-box is available where you can select the date until when the job
runs
Default: one year later
<Recurence Options>
If a recurring job session is executing, and the next job session is about to
start, the default behavior is to skip the next session.
To stop the current session instead, select Stop current session in the
Recurrence Options dialog box.
To edit a job:
• Select the job, then click Edit Job on the toolbar or right-click and select
Edit Job .
The job wizard opens at step . You can edit the job attributes as
desired, except for the job action, which cannot be changed.
58 Editing Jobs
1.6 Copying Jobs
You can create a new job with the same parameters as an existing job, except the
copied job has a new job ID.
To copy a job:
• Select the job, then click Copy Job on the toolbar or right-click and select
Copy Job .
• Select the job, then click Properties on the toolbar or right-click and
select Properties .
The Properties dialog box appears, displaying the General tab parameters,
which reflects the task you select and the schedule as explained under
Setting Job Parameters.
Parameter Description
Job Owner Each job has an owner, whose security profile is used for the job.
The default owner is the user that created the job. If you are viewing
properties for a job that you do not own, the job owner is displayed
as a dropdown list that contains the current owner of the job and
the current user. You can select your user name to become the job
owner if you have the relevant permission.
Security Domain A dropdown list is provided for domain name. By default it is empty,
therefore all users can obtain this job. If you wish to control the
access to the job, you can add a domain name (the domain must be
defined in the user security profile with relevant permissions).
Set as default If selected, all future new jobs have the security domain of the
current job. Clear this option to cancel setting the security domain
for new jobs.
Clear Click to delete the list of previously defined security domain names
from the dropdown list (this applies to all jobs). This is useful if the
autocompletion feature prevents you from entering the desired
domain name.
To run a job:
• Select the job, then click Run Job on the toolbar or right-click it and select
Run Job .
The job runs immediately. The progress bar in the Status column is
updated accordingly.
62 Running a Job
Catalog
Before you can create an E-line service, you have to set up a service catalog that
defines attributes that will be attached to the service. A service catalog consists
of classes of service (CoS) of different priorities attached to an Ethernet
bandwidth profile. The attributes of a catalog appear in the Navigation pane
illustrated below.
The service catalogs are defined and/or edited using a wizard that consists of
three steps.
Ethernet Parameters Enter Ethernet parameters that address shaping, bandwidth and class of
service
OAM Parameters Specify the Maintenance Domain (MD) level, enable Performance
Monioring (PM) etc.
1. Select any row in the QoS Priorities list and then select Edit .
The Edit CoS CoS Priority dialog box appears.
To add an additional CoS priority, click <Add> and assign a name and a
description to it.
To remove a CoS priority, select the relevant row by clicking the square to
the left and then click <Delete>.
To move the priority of a CoS priority up or down, click the <Up> and
<Down> buttons respectively.
To map CoS priorities to priority bits and create a CoS priority profile:
1. In the Navigation pane (Figure 1-1), select CoS to pBit.
The CoS CoS to pBit list appears.
Figure 1-7. Adding a CoS Priority Profile (Marking Profile) – Example for Modifying the List
Table 1-2. New CoS CoS to pBit – pBit Color Marking for the CoS Priorities
DEI Color Aware pBit 0..7 Using the Drop Eligible Indicator bit
pBit Color Marking pBit Green 0..7 pBit marking per color (green and/or yellow)
pBit Yellow 0..7
Note
The number of CoS Priority profiles (marking profiles) supported depends on the
device in use. For example, ETX-203AX (Ver. 4.30) supports up to 12 marking
profiles.
2. Click New .
The New Ethernet BW dialog box appears.
Figure 1-16. Catalog Work space – Add Service Catalog (Name and Description added)
4. Click <Next>.
You are asked to add the Ethernet parameters illustrated below and
explained in Table 1-3.
VLAN Manipulations
Action on Z End Point Pop Pop. Remove the service VLAN. The inner VLAN
Keep (Concentrator) becomes the service VLAN.
Keep. Keep the service VLAN.
Swap Outer VLAN on Z End Check to swap the outer VLAN and the inner
Point VLAN at the end point.
BW by Service Level
Set Shaping by Service Level Click <…> to select one of the bandwidth profiles
A-Z Shaping (shaping profiles) you just configured for the
service level in A-Z direction.
Set Shaping by Service Level Click <…> to select one of the bandwidth profiles
Z-A Shaping (shaping profiles) you just configured for the
service level in Z-A direction.
Note: BW by Service Level must be defined for
both directions.
Add EVC.CoS(s)
Figure 1-18. Catalog Work space – Add Service Catalog (Ethernet Parameters, Adding EVC.CoS)
CoS Platinum The values listed reflect the defaults and the CoS
Gold called Test added for this example. Additional
Silver CoS entries may have been added by users.
Best Effort
Test
BW by CoS
Set Shaping by Service Level Click <…> to select one of the bandwidth profiles
A-Z Shaping (shaping profiles) you just configured for the
service level in A-Z direction.
Set Shaping by Service Level Click <…> to select one of the bandwidth profiles
Z-A Shaping (shaping profiles) you just configured for the
service level in Z-A direction.
Note: BW by CoS must be defined for both
directions.
CCM 3.3 ms Check CCM and define the interval for continuity
10 ms check messages.
100 ms
1s
10 s
1 min
10 min
AIS 1 sec Check AIS and select the intervav for the AIS
1 min interval.
The parameters you selected are displayed at the bottom of the Service Catalog
dialog box (Figure 1-20). You can now proceed to add the service.
1. In the Service Catalog list, select the desired catalog entry and click Edit .
The Add Service Catalog wizard appears with the existing service catalog’s
name.
2. Follow the instructions above as if you are entering a new catalog entry.
Notes • Creating and modifying services requires a separate license. If you try to work
with services without the proper license installed, you will receive an error
message. For additional information and instructions on installing the license,
refer to Installing Licenses in Chapter 2.
• Services are uni-directional. The beginning and end nodes are referred to as A
and Z respectively.
• Before adding a service, you have to create a new Q-group for the NET ports
of the devices involved on the CLI level using the Execute Script job.
• The following units currently support creating E-line services in RADview-EMS:
ETX 203AM, ETX 203AX, ETX 205A, ETX 220A.
• The examples below are provided for Windows 7, but apply to Windows 2008
Server and Unix as well.
• Using the CLI interface, devices that are part of a service should be configured
as follows: configure management snmp config-change-notification
End Points Start and end point of the service, defined by a previously
routed link.
The Service work space allows you to configure, edit and utilize E-line services
between nodes. These nodes can be on the same level or different levels. To
configure a new E-line service, do the following:
2. Do the following:
Assign a name to the service.
Enter a description optional (optional).
Assign an external ID.
3. Attach a service catalog to the new service. To do so, under Service Catalog,
click <…>.
The Select Service Catalog dialog box appears.
7. Click <Next>.
You are asked to define the end points of the new service.
Note Services are uni-directional, therefore you have to configure a start (end point A)
and a target (end point Z).
12. Click <Next> and specify VLAN and OAM parameters as illustrated below and
explained in Table 1-2.
Table 1-2. Adding New Service – Step 3, Specifying VLAN and OAM Settings
Parameter Description
VLAN Settings
Service VLAN The service VLAN you may have selected for the service catalog
Note: Available for editing if a VLAN was selected in the catalog.
Swap Outer VLAN on Z End Point Specify the outer VLAN to swap with the inner VLAN at end point Z.
Note: Available for editing if Swap VLAN was selected in the catalog.
OAM
Destination MAC adress The MAC address of the selected interface on end point Z.
Note: Available for editing if OAM was defined in the catalog.
PM Collection Device Select the device that collects the data in the performance monitor
(PM).
Note: Available for editing if OAM was defined in the catalog.
MEPs Define the maintenance end poins on end point A and end point Z.
To make the table cells eitible, double-click the respective table cell.
Note: Available for editing if OAM was defined in the catalog.
2. Select the desired service option and follow the onscreen instructions.
1. In the Business Entities work space, click New Business Entity on the
toolbar or right-click and select New Business Entity.
The New Business Entity dialog box is displayed.
2. Fill in the fields as needed.
3. Click <Set>.
The business entity is created.
Parameter Description
General
Business Entity Parent You can click the browse button to select the parent of the business entity
Status Indicates whether the Business Entity is Active. “Locked” means the user
cannot add Service to the Business Entity (but the user can unbind service).
Active
Not Active
Locked
Type Free form text where you can enter the type of business entity, e.g. Individual,
Company, Department, etc.
Ranking The customer ranking can be used to associate policies with OAM services for
statistic reports (refer to Chapter 5). The rankings are:
• Normal
• Platinum
• Gold
• Silver.
Parameter Description
Default Filters
The default filters can be edited, with the exception of the All filter. They can be
deleted, but it is recommended to not delete them. The following tables describe
the default filters.
Unreachable Public Fault Status Resources with Class set to Device are displayed if they haven’t
responded to Get/Set SNMP requests within a timeout period
Critical Public Fault Status • Legacy devices – Resources with Class set to Device are
displayed if they have Critical alarms
• Supported devices – Any resources with Critical alarms are
displayed
Major and Up Public Fault Status • Legacy devices – Resources with Class set to Device are
displayed if they have Major or Critical alarms
• Supported devices – Any resources with Major or Critical
alarms are displayed
Minor and Up Public Fault Status • Legacy devices – Resources with Class set to Device are
displayed if they have Minor, Major, or Critical alarms
• Supported devices – Any resources with Minor, Major, or
Critical alarms are displayed
Applying a Filter
Follow the instructions below to apply an existing filter.
To apply a filter:
To add a filter:
1. Right-click the tree or group where you would like to add a filter, and select
Add Filter .
2. Fill in the filter name.
3. For resource filters, do one of the following:
Select Include Ancestors if you wish to include parent nodes.
Select Include Descendants if you wish to include child nodes.
4. Select the desired criterion (refer to Table 0-4 or Table 0-5) and select And or
Or to specify whether logical and or logical or is applied to the criterion
condition.
5. Click <Add Criterion> to add it to the filter criteria.
6. When you have finished specifying criteria, click <OK> to create the filter.
Changing a Filter
To change a filter:
* You can click <…> to open a list of available values and select one of them, or you can enter the value
directly. It is recommended to select the value whenever possible rather than enter it, to lessen the chance
of adding an incorrect criterion.
* You can click <…> to open a list of available values and select one of them, or you can enter the value
directly. It is recommended to select the value whenever possible rather than enter it, to lessen the chance
of adding an incorrect criterion.
Deleting a Filter
To delete a filter:
1. Right-click the filter and select Delete.
2. Click <OK> to confirm the deletion and delete the filter.
14 Adding a Group
Installation and Operation Manual Chapter 0 Chapter Name
Deleting a Group 15