web based automatic spectrum monitoring user guide for lpt ... · web asm is an easy to use and...

Page | 1

LPT WEB ASM 2.1.1 E-mail: [email protected] Tel : (1) 316-831-9696

LP Technologies™

Web Based Automatic Spectrum Monitoring

User Guide

For

LPT WEB ASM

06/26/2019

mailto:[email protected]

Page | 2



Page | 3


Table of Contents 2 User Management 29

Server Time 32

Installation 5 Alarm Settings 30

Introduction 5

New Installation 5 Wall Control 35

Update Installation 8 Introduction 35

WEB Server Port 8 Hiding Navbars 36

Bitnami Control Panel 9

Adding Licenses 8 Walls 38

SSL Setup 10

Initial Connection 11 Single Trace View 39

Introduction 39

Logging In 12 Assigning Bandwidth Segments 40

Display Modes 41

Dashboard 13 Labels 44

Introduction 13 Min/Max 45

Trace Menu Bar 15 Cross-Pol Configuration 45

Bandwidth Segments 16 Baseline 47

Wall Settings 19 Monitors 48

Time Warnings 20 Spectral Masks 51

Quick Trace Replay 21 Markers 53

Trace History 22

Marker History 23 Compartmentalization 55

Cross-Pol History 25 Introduction 55

Channel Power History 26 Bandwidth Segment Restrictions 55

Alarms 27 History 56

Min/Max Log 28 Wall Sharing 57


Page | 4


Privilege Levels 59 Properties Table 63

Introduction 59 Controls and Measurement 64

Super User 60 Return Analyzer 64

Administrator 61 Home 64

Operator 61 Min/Max Trace 64

Viewer 61 Setting a Label 64

Split Screen 65

Live Mode 62 Interference Report 66

Introduction 62

Going Live 62 Appendix 59

Live Layout 63 Linux install 59

Trace Display 63


Page | 5



Page | 6


Installation

Introduction

LPT WEB ASM is an added layer to the LPT-ASM Server and Client software. While it is true the

WEB ASM and the LPT-ASM Server both connect to the same database and spectrum analyzer

controller, the WEB ASM requires several additional tables and the Bitnami WAMP Stack

(Bitnami). LP Technologies decided to operate with the Bitnami WAMP Stack to allow users

quick PHP and JS Installation, and the option to easily add SSL encryption to WEB ASM if

needed.

Note: LPT-ASM Server MUST be installed before starting installation of LPT WEB ASM. Failure

to install LPT-ASM Server before WEB ASM will result in needing to uninstall WEB ASM before

installing LPT-ASM Server

New Installation

To install WEB ASM as a new installation follow the steps below

1. Execute the webasm_2.0.0 installer.

a. For Windows a Bitnami WAMP Stack install will appear

2. Go to the second page of the installer and select “New Install”

3. The Bitnami installer will start, select “Next > ” when ready

4. In the Select components page deselect everything but PhpMyAdmin (this is not

deselectable).


Page | 7


5. Select Bitnami instllation location(\\Bitnami\wampstack-7.1.15-0).

6. Enter a password for root (this will not be needed again) and select next

7. Enter MySQL port (choose a port that is not 3306) and select next

8. Deselect “Launch wampstack in the cloud with Bitnami” and select next

9. Select “Next” on installing Bitnami

10. Once Bitnami is finished leave “Launch Bitnami WAMP Stack” selected and select finish

11. The WEB ASM Setup will open

a. Select “Install WEB ASM v2.0.0” then select next

b. Choose the location of the Bitnami folder (default will be \\Bitnami)


Page | 8


c. Select next and allow WEB ASM to install into the correct folder.

12. The Bitnami Control Panel will open

Note: During install Windows Firewall might block Apache HTTP Server from running on the PC,

select Allow Apache HTTP Server to communicate with private networks.


Page | 9


13. On the Control Panel select Manage Servers tab

14. Select stop for the MySQL Database

15. Restart Apache Web Server

Update Installation

Note: for WEB 2.0.0 there is not an update install. Users will be required to uninstall Bitnami

and Install ASM 2.0.0 as a new install.

WEB Server Port

The default (unsecured) port for WEB is 80. If a change is required for operation within the

network follow these instructions

1. Select Apache Web Server from the Manage Servers Tab

2. Select Configure

3. Adjust the Port


Page | 10


4. Select OK

5. Restart Apache Web Server

Bitnami Control Panel

Once started the Apache server will continually run as a service in the background, which

means there is no need to keep the Bitnami Control Panel open. If the Control Panel is needed

again go to \\Bitnami\wampstack-7.1.15-0 and select “manager-windows”

LPT recommends for ease of use to create a shortcut of the Bitnami Control Panel

Adding Licenses

For WEB ASM connect to a spectrum analyzer the appropriate license must be added. To add a

license, drop the license document received by LP Technologies into the public directory of the

LP_Project folder (default directory \\Bitnami\wamptstack-7.1.15-0\apache2\htdocs\LPT-WEB-

ASM\public).


Page | 11


SSL Setup

For companies that wish to setup the WEB server using SSL certifications please follow the

directions below.

1. Generate SSL key/cert files from your cert provider

2. Drop both the key and cert file into \\Bitnami\wampstack\apache2\conf

3. Open bitnami.conf inside \\Bitnami\wampstack\apache2\conf\bitnami

4. Inside bitnami.conf edit the following lines to reflect your SSL cert and key file

location/names

a. SSLCertificateFile “C:\Bitnami\wampstack-7.1.15-

0/apache2/conf/your_cert_file.crt”

b. SSLCertificateFile “C:/Bitnami/wampstack-7.1.15-

0/apache2/conf/your_key_file.key”

5. Direct all traffic to the HTTPS version of the site, add the following lines under the first

VirtualHost in bitnami.conf (_defaul_:80, or which port it’s set to)

a. <VirtualHost _default_:yourport>

b. ServerName (enter URL WEB ASM will be running on e.g. yoursite.com)

c. RewriteEngine on


Page | 12


d. RewriteCond %{HTTPS} !=on

e. RewriteRule ^/(.*) https://%{SERVER_NAME}/$1 [R,L]

6. Restart Apache through the Bitnami manager

Initial Connection

After Installing Bitnami, the WEB ASM Server, and placing the licenses to the required location

open a browser and enter 127.0.0.1 with the machine hosting the WEB ASM and LPT-ASM

Server. If WEB ASM has installed correctly the browser should go to the WEB ASM login page.

6. For the initial login of the Super User use:

a. Email Address: [email protected],

b. Password: admin

NOTE: LPT strongly recommends that the main admin of the WEB ASM changes the Super User

login credentials, the email and password are the system default and thus the same for all

installations

7. Change Super User Credentials.

a. Once within the WEB ASM Dashboard go to Admin → Change Super User

Credentials.

b. Enter a new Email and new Password then click “Save”.

c. If the WEB ASM does not automatically refresh, logging the user out, refresh by

pressing “F5” or the refresh button on the browser.



Page | 13


d. Log in with the new credentials for the Super User.

8. Set Server Time Zone

a. As the Super User navigate to Admin → Set Server Time Zone on the WEB ASM

Dashboard.

b. Select what time zone the machine hosting WEB ASM is set to by picking the

correct time zone from the dropdown menu.

c. A popup will appear alerting that the time zone change will either take 5 minutes

or will require an Apache reset.

d. If after 5 minutes the Timezone has not changed, adjust the config documents

i. Navigate to \\Bitnami\wampstack\apache2\htdocs\LPT-WEB-ASM\Config

ii. Open app.php with Notepad

iii. Find ‘Timezone’ =>

iv. Adjust the timezone to match the time the Server PC is in (ensure that

you copy the exact wording of the Server time found in the time drop

down)

v. Save app.php

vi. Go to (LPT-WEB-ASM)/bootstrap/cache and open config.php with

Notepad

vii. Find ‘timezone’=>

viii. Adjust the timezone to match the time the Server PC is in (ensure that

you copy the exact wording of the Server time found in the time drop

down)

ix. Save config.php

x. Restart Bitnami Server

xi. Log into software as Super User and ensure that the time zone has been

changed.

NOTE: The WEB ASM must be set to the same time as the machine hosting it. Any deviation of

times will prevent WEB ASM’s traces from functioning properly

Logging In

When going to the LPT-WEB ASM page (WEB ASM) you will be directed to the Login Page. On

Login Page, the user will be able to continue into the LPT Dashboard by entering the designated

username (which will be in the form of an email address) and a password. If so desired a user


Page | 14


may select to have the web page remember the profile, logging directly into that profile’s

Dashboard.

Note: by selecting “Remember Me” on the Login Page the entered profile will automatically log

into the Dashboard. To cancel this log out of the Dashboard by navigating to the top right

where the profile name is displayed, and select “Logout”.

Dashboard

Introduction

WEB ASM is an easy to use and intuitive page designed to take minimal amount of training to

use effectively. Though this software is designed to be easy to use it is by no means indicative

of how powerful it truly is. Within the WEB ASM users have option of generating numerous

reports, view graphs, watch analyzers update in real time, and receive notifications when issues

arise.


Page | 15


The WEB ASM Dashboard can be divided into 3 separate portions: Wall Control (yellow box),

Wall (green box), and Navigation Bar (red box).

By clicking on one of the traces on the Wall the Single Trace View (STV) for that window will

appear.


Page | 16


Bandwidth Segments

Much like the LPT-ASM Client, the WEB ASM operates by polling numerous trace profiles, called

Bandwidth Segments, that users create. The Bandwidth Segments that the WEB ASM polls are

the same Bandwidth Segments that are created in the LPT-ASM Client, in fact the two systems

share the same database. If a user creates a new Bandwidth Segment on the LPT-ASM Client

profiles on the WEB ASM that have the specific privileges will see the new Bandwidth Segment.

If an Admin of the WEB ASM creates a new Bandwidth Segment the LPT-ASM Client will receive

the new Bandwidth Segment as well.

To access the Bandwidth Segment Window, go to Configuration → Bandwidth Segment in the

Navigation bar.

In the Bandwidth Segment Window there is a drop-down list containing all licenses and

connected spectrum analyzers communicating with the LPT-ASM Server. Underneath the

analyzer drop down list is an additional list containing all the Bandwidth Segments established

for that analyzer.

To edit a Bandwidth Segment, click the Bandwidth Segment and adjust the desired properties

on the right side of the Bandwidth Segment Window.


Page | 17


The properties on the right side of the Bandwidth Segment Window determine all aspects of

the Bandwidth Segment (e.g. center frequency, span, RBW/VBW filters). Setting and adjusting

the properties are imperative for proper trace displays. Below is a table of the properties and

their effects on the Bandwidth Segment.


Page | 18


Property Effect

Name Changes the Name of the Bandwidth Segment

Status Determines if the Bandwidth Segment is in the queue for polling. Selecting Deactivate “turns” that Bandwidth Segment off.

Analyzer Port # Determines which of the rear RF ports the Bandwidth Segment will query

Switch Port # Determines which port on the external switch will forward to the Analyzer Port #

Center Changes the center frequency of the Bandwidth Segment

Span Changes the span of the Bandwidth Segment query

Ref Reference Level on the Dashboard and Single Trace View

Scale Scale on the Dashboard and Single Trace View

RBW Changes the Resolution Band Width setting, AUTO finds a balance of fast and accurate for the setting

VBW Changes the Video Band Width setting, AUTO finds a balance of fast and accurate for the setting

Atten Sets the attenuation level

Sweep Sweep Time, can be set to Auto or Manual, if Manual is selected user must enter sweep time (in milliseconds)

PreAmp Turns the PreAmp to Auto or bypass (LPT-X3000 or LPT-3000RX4), on or off (LPT-3000, 6000, or LPT-3000R)

LO Local Offset, allows adjustment of the frequency to represent a higher frequency

LO Mode Sets the center frequency to add or subtract from the LO

Invert Trace Inverts the frequency on Dashboard and Single Trace View. Normal: lowest to highest, inverted: highest to lowest.

Owner Labels who owns the Bandwidth Segment (not needed)

Extra Wait Time The time the Server waits before polling the next Bandwidth Segment.


Page | 19


To create a new Bandwidth Segment, select “New” and enter a name that has not being

currently used by any other Bandwidth Segment on that analyzer.

To delete a Bandwidth Segment, select “Delete” and confirm the deletion.

To clone a Bandwidth Segment, select “Clone”. The cloned segment will have the same name as

the original segment, adjust as necessary.

Note: Eventually the browser will offer “prevent this page from creating additional dialogs”

check box, do not check this box the WEB ASM Client will lose numerous reporting features!

Wall Settings

Each profile in WEB ASM has its own set of walls, these walls can be seen on the left side of the

Dashboard (see Dashboard Introduction). The walls can be either created by the user, or

shared by the Administrator.

To open the Wall settings, navigate to Display → Wall Settings on the Navigation bar.

To create a new wall for the current profile, select “New Wall”. The Wall Name will read “New

Wall”, adjust the name and then select “Save Wall”.


Page | 20


Under the Wall creation section is the Current Wall Settings section. To delete the current wall,

select “Delete Wall”, a dialog box will appear verifying deletion of the wall.

Time Warnings

WEB ASM has included a warning system that will visually alert the user if a Bandwidth

Segment has exceeded the designated time. This Time Warning system is identical to the one

in the LPT-ASM Client software, except that each profile can assign their own times. To access

the Time Warning feature, go to Display → Time Warnings in the navigation bar.


Page | 21


The Normal Below time indicates the time WEB ASM will consider the update cycle to be

normal. Once a Bandwidth Segment passes the Normal Below time the update time will turn

orange for that window on the dashboard. Once the update time passes the Warning Below

time the orange update time will turn red and a red box will appear around the window.

Users may adjust the Normal and Warning times by changing the time and selecting “Save”.

Quick Trace Replay

The Quick Trace Replay on the WEB ASM Dashboard allows the user to instantly recall the

previous 100 traces of a given Bandwidth Segment. To open Quick Trace Replay, go to History

→ TRACE → Quick Trace Replay in the Navigation bar.


Page | 22


To load a quick trace within the Quick Trace Replay Window the user must first select the

desired spectrum analyzer from the drop-down menu on the left and the Bandwidth Segment

on the right. Once the historical trace loads the past 100 traces will begin to play automatically.

The Pause button will stop the replay at the current frame.

The Play button will resume playing.

The Replay button will restart the trace history from the beginning.

The “<” and “>” move the trace one frame backwards or one frame forward, respectively.

Underneath the buttons is a slide bar allowing the user to quickly move through the timeline of

the trace history.

If the min/max traces are turned on for the selected Bandwidth Segment being replayed the

traces will be overlaid on the replay for user convenience.

Trace History

Just like LPT-ASM Client the WEB ASM allows users to recall and replay any historical trace, if

the user’s profile is authorized to view.

To open Trace History go to History → Trace → Trace History within the Dashboard.


Page | 23


To pull up the history of a Bandwidth Segment within Trace History first select the desired

analyzer from the dropdown menu on the left, then select the desired Bandwidth Segment

from the dropdown menu on the right. Once the analyzer and Bandwidth Segment are select

the user will then select the Start Date and the End Date. Once the End Date is selected WEB

ASM will load the trace history.

Marker History

WEB ASM offers a quick and accurate way to generate historical graphs and CSV for Markers.

This feature is called Marker History and is not unlike the Marker History in the LPT-ASM Client.

To open the Marker History Window, in the WEB ASM Dashboard go to History → Marker →

Marker History.


Page | 24


Once the Marker History Window opens the operator will need to select the appropriate

spectrum analyzer, the desired Bandwidth Segment, the Start and End dates, and then fill in the

desired markers with the value and the units, unless the Bandwidth Segment has Markers

already created.

Once the above-mentioned parameters are entered the user will then need to select either the

Power Values or Delta Values, or both, and then select “Query”.

The Power Value check box will generate the Amplitude level report, while the Delta Value will

generate the dB difference between the markers.

Once the query has completed the table at the bottom of the Marker History Window will

populate. After the table population is complete users can select the “Graph” button to

retrieve a visual representation of the marker history on a Time vs dB graph.


Page | 25


Cross-pol History

Users can retrieve historical readings of the relative Cross-pol. To open the Cross-pol History go

to History → Cross-Pol History in the WEB ASM Dashboard.

With the Cross-Pol History Window open the user must select the spectrum analyzer, then the

Bandwidth Segment for the basis, the beginning and end dates, then the Cross-Pols (one or

both Cross-pols), and finally select “Query”.

Once the query has finished being polled and calculated the results will be displayed in a table

at the bottom of the Cross-pol History (as seen above) along with the number of rows and the

option to export the table as a CSV to the user’s computer.


Page | 26


Channel Power History

The WEB ASM Channel Power History allows the user to quickly generate a channel power

report over a specified time frame. To access the Channel Power History, go to History →

Channel Power History on the WEB ASM Dashboard.

As with most other historical windows in the WEB ASM software the user needs to first select

the correct spectrum analyzer then select the Bandwidth Segment, manually inserting the

frequency value of the desired markers, the span associated with the markers, then the RBW

filter. Once all properties are entered the user will then select “Query” and wait for the

Channel Power History table to be populated, the table will be found at the bottom of the

Channel Power History Window.

After the table has been populated the user can export the report as a CSV.


Page | 27


Alarms

A history of all alarms that are triggered are stored under the Alarm Log. The Alarm Log can be

viewed by going to History → Alarm in the WEB ASM Dashboard.

The Alarm Log records the Time the alarm triggered, the alarm’s name, the type of alarm, the

Bandwidth Segment(s) associated with the alarm, the analyzer(s) associated with the alarm, the

user defined location, and the IP Address of the spectrum analyzer.


Page | 28


Min/Max Log

WEB ASM records when the Min and Max values are turned on and off through the Min/Max

Log. To open the Min/Max Log go to History → Min/Max Log.


Page | 29


Within the Min/Max Log, the time stamp, user, analyzer, Bandwidth Segment, and the action

are recorded and can be sorted by the date.

User Management

To create, edit, or delete profiles Admins must use the User Management tool. To access User

Management, go to Admin → User Management on the Dashboard.

Add User

To create a new user, select “Create User”, an Add User window will appear.


Page | 30


Username- the nickname of the User.

Email- User’s email, used for logging in, must email format.

Password- User’s password, must be at least 4 characters long.

Once the Admin enters the new profile and selects “Add User”, “User Added!” will appear at

the top of the window.

Delete User


Page | 31


To Delete a profile, select the User’s profile from the drop-down menu, then select “Delete

User”. A dialog box will ask to confirm deletion.

Changing Passwords

Only Admin may change User’s passwords. To change a password, choose the desired profile

from the User drop-down menu, then select “Change User’s Password”. A new dialog box will

open, enter the new password then press “Change Password”.

A confirmation will appear on the User Management showing that the password has changed.

Edit Permissions

To edit a profile’s permission levels the Admin will need to first select the user, assign a

Permission level (see Privilege Levels), then add what Bandwidth Segments that profile can

access (see Compartmentalization). Selecting “Select All” allows all Bandwidth Segments of the

selected spectrum analyzer to be granted at once.


Page | 32


Server Time

The Super User can set the Server time by going to Admin → Set Server Timezone on the WEB

ASM Dashboard (see Initial Connection step 8).

Alarm Settings

Much like LPT-ASM, the WEB ASM ASM system allows users (operators and above) to create

alarms that will generate visual, auditory, or email notifications. To access the Alarm Settings

Window, go to Alarms → Alarm Settings on the WEB ASM Dashboard.

To create a new alarm the user will need to select the “New” button, a new window will

appear, enter a distinct name for the new alarm.


Page | 33


Once the new alarm is created a browser will generate a dialog box. After selecting “OK” the

user will be pushed out of their Alarm creating window. Again, open the Alarm Settings

Window then select the created alarm from the drop-down menu.

Add the associated Bandwidth Segments to the alarm by selecting the appropriate spectrum

analyzer then the Bandwidth Segment, and finally select the “Enabled” button to add the

Bandwidth Segment to the list.


Page | 34


Numerous Bandwidth Segments can be added to a single alarm, but for the alarm to activate all

Bandwidth Segments must be triggered simultaneously. After the Bandwidth Segments have

been added to the created alarm, open the “Notifications” tab at the top of the window.

Within the Notification Window the user must enter a time the Bandwidth Segments are

triggering before the alarm will trip and time the alarm is desensitized to the Bandwidth

Segments trigger.


Page | 35


The final step includes the user assigning the notification mode; the pop up notification will

create a pop up dialog box on the browser, the sound notification will play an alarm sound, and

the email alarm will send an email. Once the desired notification is selected save the

properties.

If sending emails from the WEB ASM is desired additional setup and properties must be

addressed. Next to the Notifications tab on the Alarm Settings Window is the Email notification

tab, select it. The Email Settings Window allows users to configure the SMTP with either

encrypted or unencrypted connections. At the bottom on the window is a “Test Email” button

allowing the user to test the configuration of the SMTP.

Wall Control

Introduction

Each profile has its own list of viewable Walls, that are distinct and isolated from other profiles.

Walls can be added or deleted through the Wall Settings Window (see Wall Settings). The Walls

can be easily swapped between by selecting the desired name of the Wall.


Page | 36


Underneath the Wall selection is the Wall Control area. The Wall Control area offers quick

buttons to change properties to the entire Wall as well as the option to Share Walls with other

profiles.

The “Show Scale” button activates the scales for the entirety of the current Wall, while “Hide

Scale” makes the scales disappear from the wall.

“Share Wall” sends a copy of the wall to the desired profile (see Compartmentalization).

Hiding Navbars

WEB ASM offers the ability to go full screen, allowing the wall to take up the entire screen.

At the bottom left of the Dashboard is a “Hide Navbars” button that will remove the Wall

column and the Navbar.


Page | 37


Hitting the “Show Navbar” button will return the WEB ASM Dashboard back to its original

display settings.

Note: pressing F11 will make the browser go full screen, removing the address bar and links. A

combination of hiding the Navbar and pressing F11 will result in the largest available screen.


Page | 38


Walls

The main attraction on the WEB ASM Dashboard is the Wall (green box). The Wall section

displays all the Bandwidth Segments assigned to that Wall. If the user has the correct privileges

to that wall they will be able to click on a Window and switch Bandwidth Segments (see Single

Trace View).

Each Window in the wall will display several key pieces of information.


Page | 39


On the X-axis of the trace is the frequency center frequency, start point, and endpoint. On the

Y-axis is the dB level starting from the reference level and going downward.

At the top of the graph the is the spectrum analyzer’s name (yellow box) and the Bandwidth

Segment’s name (green box). The last refresh time (pink box) is located under the Bandwidth

Segment’s name.

Within the trace itself the yellow trace is the current trace value. The red trace is the maximum

trace value since the max has been turned on. The blue trace is the minimum trace value since

the min has been turned on, and the gray trace is the Bandwidth Segment’s baseline.

If a Wall has too many windows and the user cannot view all of them simultaneously, they can

zoom out in the browser.

Single Trace View

Introduction

If the WEB ASM Dashboard and Wall section is considered the overview and general monitoring

of the Bandwidth Segments, Single Trace View would be the fine tuning and close observation

section of WEB ASM. Single Trace View is the piece of WEB ASM software that controls

manipulation of the Windows and the traces by adding or swapping Bandwidth Segments and


Page | 40


numerous other options, such as turning on min/max, adding live Cross-pol, activating Monitors

and Spectral Masks for alarm reporting, and adding Markers.

Assigning Bandwidth Segments

To add a Bandwidth Segment to a blank Window within WEB ASM the user needs to simply

click on the blank Window, choose the appropriate spectrum analyzer, then select the

Bandwidth Segment desired.


Page | 41


Once the Bandwidth Segment is selected the Single Trace View Window populates a trace

representing the most recent update of the Bandwidth Segment. At any point a user may

change the Bandwidth Segment of a Window by clicking the Window and changing the

spectrum and/or the Bandwidth Segment.

Display Modes

ASM WEB offers three different display modes for each Bandwidth Segment that are

interchangeable in Single Trace View: Trace (graticule), Waterfall, and Spectrogram. The display

modes get stored for every profile wall and will remain for until otherwise changed. Each

display mode has its benefits, and draw backs, which will be discussed shortly.

To change the display mode, open the Single Trace View of the desired Bandwidth Segment.

Once open select the drop-down menu, next to the Bandwidth Segment list, and choose the

desired display mode


Page | 42


Trace (Graticule)


Page | 43


Every Bandwidth Segment, when first created, is defaulted to Trace Mode display. Trace Mode

is the standard frequency vs amplitude graph with the reference value as the uppermost Y-axis

line. Trace Mode display is independent of time, and updates only when a new Bandwidth

Segment sweeps. Trace Mode is the most resource friendly on the local computer, users with

relatively decent computer can expect to run a 10 x 10 wall with no issues.

3D Waterfall

Once a Bandwidth Segment is created and added to a wall, users can switch the display mode

to (3D) Waterfall Mode. Waterfall Mode presents the last 20 traces of the Bandwidth Segment

in a three-dimensional graph: frequency vs time vs amplitude. Amplitude values are color

coded, a scale for reference is provided on the right-hand side of the graph for user reference.

The Waterfall display can be rotated 360°, zoomed in and out, and the mouse over will display

values of the point of the mouse.


Page | 44


Spectrogram

The third display mode available is Spectrogram. Spectrogram Mode presents the Bandwidth

Segment as frequency vs time, with color representing the amplitude (in dBm) of the trace. The

Spectrogram display shows the past 100 traces of the Bandwidth Segment with the newest

trace coming from the bottom and dropping the oldest trace off.

The Spectrogram display can zoom in and out and the mouse over will display values of the

point of the mouse.

Once Single Trace View is closed, the display mode it was changed to will remain on the wall for

the section that was changed. Users can have more than one of the same Bandwidth Segment

on a Wall, allowing the ability to watch both Waterfall, Spectrogram, and Trace of the same

Bandwidth Segment.

Labels

Besides showing the scales of all Windows on a given Wall through the “Show Scale” button,

users can select individual Windows to turn the scale on or off. To activate/deactivate a

specified Window’s scale, enter that that Window’s Single Trace View then go to Trace →

Labels.


Page | 45


A check mark next to “Labels” indicates that the scale is on, no check mark indicates the

scale is off.

Min/Max

To turn on the min and max of an individual Window, go to Traces → Min or Max on the

Single Trace View. Once Min or Max is activated wait one update cycle to see the new

traces on the Single Trace View trace or on the Dashboard. Red trace is the traces maximum

value since activation of the trace max, while the blue trace is the minimum value since the

activation of the traces min.

Cross-pol Configuration

Besides the Cross-pol history accessible through the WEB ASM Dashboard the Single Trace

View allows users to view live Cross-pol information that updates with each refresh of a

trace. To activate the live Cross-pol go to Traces → Configure Cross-pol in the Single Trace

View.


Page | 46


Once selected the Cross-pol Configuration Window will open, select either one or two

Bandwidth Segments to evaluate the cross-pol to compared to the main Bandwidth

Segment, the select “Save”

Once Cross-pol has been configured the cross-pol trace and cross-pol difference will appear

on the Single Trace View trace as well as in the Window of the Dashboard displaying the

Cross-pol level between the two traces.


Page | 47


To clear the Cross-Pol traces select “Clear”.

Baseline

The Spectral Mask alarm mode requires a Baseline be present on the trace before the alarm

will be created. To create the Baseline, go to Traces → Baseline in the Single Trace View.


Page | 48


Monitors

Much like the LPT-ASM Client, the WEB ASM has several different alarm modes: Monitors,

Spectral Masks, and Marker values. To activate a Monitor alarm the user must enter Single

Trace View for the desired Bandwidth Segment then go to Monitors → Add Monitor.

To create a monitor the user will first need to select the Beginning box so that the cursor is

there, then move the mouse to the desire starting point on the trace and left click a single time.

Then the user will need to select the Ending point box then select the ending point on the trace.


Page | 49


To add the upper and lower bound simply enter the upper bound and lower bound dB levels

(units are not required). Adding a unique name to the Monitor will make it easier to edit later.

Note: multiple Monitors can be created for a single Bandwidth Segment, giving specific names

during creation of Monitor will help user confusion later.

Below is an example of what the completed Monitor should look like on Single Trace View.


Page | 50


To edit Monitors, go to Monitor → Edit Monitors in Single Trace View.


Page | 51


Within the Edit Monitors Window users can redefine the Monitor settings, its name, or delete

individual Monitors.

To clear a Monitor, select Monitor → Clear Monitors in Single Trace View.

Spectral Masks

The second threshold alarm mode is Spectral Mask. The Spectral Mask is a shifted baseline,

both above and below, that will trigger an alarm if the signal passing the thresholds.

Before any Spectral Masks can be created the Bandwidth Segment must have the Baseline

turned on (see baseline).

To access the Spectral Mask creation window go to Masks → Create Mask in Single Trace View.


Page | 52


Once Create Mask has been selected use the cursor to draw a frequency range on the trace,

starting with the lower frequency and dragging the mouse to the higher frequency. Once done

a Spectral Mask edit window will open allowing the user to adjust the amplitude above and

below the baseline.

Below is an example of what the completed Spectral Mask should look like on Single Trace

View.


Page | 53


To clear a Spectral Mask, select Mask → Clear Masks in Single Trace View.

Markers

Like all spectrum monitoring software and spectrum analyzers, markers are one of the major

features needed for successful analysis of traces. Markers can be accessed within the Single

Trace View of WEB ASM by going to Markers → Marker Menu.

in the Marker Menu, the user can create up to four markers and 4 channel power readings.

To Create a Marker, select the Marker first entry box, then select the desired point on the trace.

The Marker will automatically update the amplitude level and the frequency.

To create a Channel Power report, first create the Marker, then enter the span of the desired

Channel Power entering the units.


Page | 54


The Channel Power Report will display on the display of the Single Trace View and on the Wall.

Within the Marker Menu Window is the third alarm type: delta marker alarms. For the delta

marker alarms to trigger two or more Markers must be activate, then the parameter values

must be entered, either greater than or less than.


Page | 55


Selecting Active Peak Search will activate Marker 1 to continually search for the highest point in

the trace

Compartmentalization

Introduction

One of the biggest and most unique features of WEB ASM is the ability for administrators to

compartmentalize profiles. Simply put, administrators can quickly and easily block or allow

profiles to view specific Bandwidth Segments. This compartmentalization is extremely useful

for businesses to allow customers to view their specific trace/carrier without looking at other

customer’s traces.

Restricting Bandwidth Segments is complete, a profile cannot gain access to the blocked

Bandwidth Segments traces, its history, historical reports, or even see the traces on shared

walls.

Bandwidth Segment Restrictions


Page | 56


To edit the Bandwidth Segments to a profile, an administrator will need to open the

Permissions window, and adjust the restrictions of the desired profile (see Permissions).

History

A Compartmentalized profile has access to all historical graphs, reports, and recordings to the

allowed Bandwidth Segments, though some restrictions apply (e.g., cross-pol between an

allowed Bandwidth Segment and a restricted Bandwidth Segment). The profile can recall all the

reports from the same locations as unrestricted profiles, but the block segments will not be

selectable.

Example: Phil is only allowed Bandwidth Segments 48-1 through 48-3, though there are five

Bandwidth Segments assigned to Atlanta.


Page | 57


Using Phil’s profile, the user can open Marker History and not see any Bandwidth Segments

associated with the selected spectrum analyzer other than the ones assigned.

Wall Sharing

Part of the compartmentalization feature of WEB ASM is the ability to create walls and share

the walls with other profiles. Sharing of walls can only be performed by administrators or the

super user.

To share a wall from administrator to another profile the user only needs to follow these easy

steps

1. (optional) Create a new Wall

2. Fill in the Wall’s Windows with Bandwidth Segments

3. Select “Share Wall” on the Dashboard


Page | 58


4. Select the profile to share the Wall with

5. Select “Editable” if profile should be allowed to adjust the windows on the wall


Page | 59


6. Select “Share”

Once a Wall is shared to a profile, the Wall is cloned and a copy of the Wall is given to the

profile. Any changes the Wall’s creator performs on the Wall will not be observed by the

profile the Wall was share too, and vice versa.

If a Wall is shared to a profile which does not have access to some of the Bandwidth

Segments, those Bandwidth Segment Windows will not appear for the user.

Privilege Levels

Introduction

Within WEB ASM there are four privilege levels: super user, administrator, operator, and

viewer. The privilege levels work much as they do with LPT-ASM with a few exceptions. A quick

overview of each privilege level can be seen in the table below; a more in-depth view of each

privilege level will follow.


Page | 60


ADD BW SEG.

EDIT BW SEG.

ADD WALL SHARE WALL

EDIT TIME WARN. Q. TRACE HIS.

Super YES YES YES YES YES YES

Admin YES YES YES YES YES YES

Operator NO NO YES NO YES COMPART

Viewer

TRACE HIS.

MARK. REP.

MARK. HIS. X-POL HIS. CHP HIS. ALARM HIS.



Operator COMPART COMPART COMPART COMPART COMPART YES

Viewer

ADD USR. EDIT PERM. SET TIME

CHANGE SUPER

CREATE ALARM

SINGLE TRACE VIEW


Admin YES YES NO NO YES YES

Operator NO NO NO NO YES COMPART

Viewer

MIN/MAX CON. X-POL BASELINE

ADD MONITOR ADD MASK ADD MARK.



Operator COMPART COMPART COMPART COMPART COMPART COMPART

Viewer COMPART COMPART COMPART NO NO NO

Super User

There is only one Super User (SU), and that profile is the system administrator for the WEB ASM

software. The SU profile starts defaulted as [email protected] but the SU is encouraged to

change the profile as quickly as possible.

The SU is not compartmentalized in any way, though they cannot view other profile’s personal

Walls. All Bandwidth Segments, spectrum analyzers, and Single Trace View windows are all

accessible, as well as the complete access of Dashboard features.

The SU profile can add or remove Bandwidth Segments to Operator and Viewer profiles, as well

as share editable or non-editable walls with other profiles.

The additional options SU has of the Admin profile include changing the WEB ASM time zone,

and changing Super User Credentials.



Page | 61


The Super User profile should be managed by the primary caretakes of the LPT-ASM and WEB

ASM, this is the most sensitive of profiles.

Administrator

Unlike the Super User profile there can be as many Admin profiles as needed. The Admin

privilege level does not have any restrictions to Bandwidth Segments, spectrum analyzers, and

Single Trace View windows, as well as complete access of Dashboard features minus the Super

User Time Zone change and credential changes.

Admins can add or remove Bandwidth Segments to Operators and Viewers, as well as share

editable or non-editable walls with other profiles.

LP Technologies suggest that Admin profiles are controlled by internal engineers because there

is no compartmentalization.

Operator

The Operator profile is a restricted profile, their privileges are controlled by the Super User or

the Admin, and can change at any time. Operators have access to Trace History, Marker Report

and History, Cross-pol History, and Alarm History for only their authorized Bandwidth

Segments. Any Bandwidth Segment not authorized to the Operator cannot be observed.

Operators also may create Alarms, and access Single Trace View to Walls they are authorized to

edit.

Within the authorized Walls’ Single Trace View the Operator profile has access to all spectrum

analysis, and alarm trigger modes.

Operator profiles are recommended for either internal use or external use.

Viewer

Viewer profiles are the most restricted profiles on the WEB ASM. The Viewer’s privileges are

controlled by the Super User or the Admin, and can be changed at any time. Viewers have

access to Trace History, Marker Report and History, Cross-pol History, and Alarm History for

only the authorized Bandwidth Segments. Any Bandwidth Segment not authorized to the

Viewer cannot be observed. The Viewer may also not create alarms, have access to any alarm

features within Single Trace View, or share walls.


Page | 62


Viewer profiles are recommended for people with no RF experience, or the need to do anything

other than monitor traces.

Live Mode

Introduction

ASM WEB has two monitoring modes, one is Spectrum Monitoring, which polls Bandwidth

Segments analyzer(s) in a round robin architecture, and the second is Live Interference

Detection (Live Mode, or Live).

Live Mode closely resembles what engineers associate with real time spectrum analyzers, and it

is an invaluable asset for interference detection.

Going Live

Switching an instrument from Monitoring to Live Mode is quick and simple. On the Navbar of

the Global View, select Live Mode → Instrument. The instruments under Live Mode selection

will be spectrum analyzers that are currently in the WEB ASM software.

Note: When an instrument has been selected for Live Mode, it will disconnect from monitoring

mode, all Bandwidth Segments will stop updating, and become red.


Page | 63


Once the Instrument is selected a new browser will open with the live instrument connected

and displaying live traces.

Live Layout

The Live Window has three major sections: Trace Display (green box), Properties Table (yellow

box), Controls and Measurement Area (red box).

Trace Display

This location is where the analyzer will update the trace. The trace is constantly pushed from

the spectrum analyzer into the Live Mode window.

Properties Table

The Properties Table is controls of the spectrum analyzer, this is where the center frequency,

span, RBW/VBW, and other settings can be adjusted. The property settings in the Property

Table are responsive, meaning that after the analyzer accepts the adjustment it will report back

with the confirmed settings. Graph Mode will change the display from Trace to Waterfall or

Spectrogram. For a detailed list of properties see Bandwidth Segments.


Page | 64


Controls and Measurement

In the Control and Measurement area is where interference Report, and set Trace display

settings.

Return Analyzer

Once finished with Live Mode, selecting “Return Analyzer” will close the Live Mode window and

the spectrum analyzer will reconnect to WEB.

Home

Selecting “Home” from the Navbar will reset any changes to the Trace display.

Min/Max Trace

To turn Min and Max on for the Live Mode, select Traces → Min/Max

Settings Label

Turn on Settings Label will display the main components of the spectrum analyzer’s settings on

the trace screen. To activate the Settings Labels, go to Traces → Settings Label.


Page | 65


Split Screen

Live Mode gives users the option to display two traces simultaneously. Operators can choose

to display any of the three combinations of displays (Trace, Waterfall, or Spectrogram) in any

combination. To start Split Screen go to Traces → Split Screen.

Once Split Screen is activated, the bottom half of Live Mode will become another trace; adjust

Graph Mode and Second Graph mode to display the desired settings.


Page | 66


Interference Report

The Interference Report is Live’s main interference detection method. Setting up the

Interference Report allows WEB to record spurious signals that are observed in Live’s trace by

drawing and watching a defined threshold.

To open start recording on the Interference Report select the “Interference Report” button,

and a new window will open.

Setting the Upper Limit establishes a horizontal threshold across the trace (visually a red line at

the specified amplitude).

Start Report will create the line and begin the monitoring of the trace. Any threshold breaches

will be recorded in the Interference Report.

Stop Report prevents Live Mode from querying any more data and erase the Upper Limit value.

Clear Report wipes the information on the report


Page | 67


Export as CSV exports the recorded interference, as well adds the spectrum analyzer’s

information and settings.

Below is a definition of the recorded properties shown in the Interference Report.

Property Definition

Record The event number of the interference.

Date & Time Time stamp of the event.

Duration The length of time the interference breached the threshold.

Event Center Freq The center frequency of the signal breaking the threshold.

Event 3dB BW Measurement that estimates bandwidth of the signal by scanning to the left and to the. right of the center frequency for the 3 dBm drop.

Max Signal Level Maximum interference level.

Appendix

Linux Install

1. Install Bitnami

a. Unzip the Linux WEB folder

b. Run bitnami-lampstack-7.1.15-0-x64-installer.run

i. Open a terminal, and navigate to where the Linux WEB folder was

unzipped to

ii. Enter ./bitnami-lampstack-7.1.16-0-x64-installer.run

1. If permission is denied enter chmod +x bitnami-lampstack-7.1.16-

0-x64-installer.run

iii. If an error prompt mentions that glibcxx is not up to date, run the

installer with the command –-disable_glibcxx_version_check 1

1. Example: ./bitnami-lampstack-7.1.16.0-0-x64-installer.run –-

disable_glibcxx_version_check 1

iv. When prompted to install any other components, say no to everything

except PHPMyAdmin


Page | 68


v. Install Bitnami to the default location /opt/lampstack-7.1.16.0-0

vi. It will ask to setup a MySQL root password, this MySQL server won't be

used, put in any password

vii. MySQL will ask for a port, again this is not used, put in port that the ASM

Server is not on like 3307

viii. Deselect Launch “Lampstack in the cloud with Bitnami”


Page | 69


ix. After a few moments of installing the Bitnami installer will finish

x. Select Launch Bitnami LAMP Stack.

2. Start Bitnami Manager

a. If Bitnami is not started from the install, or the Bitnami Manger is closed, users

will need to open the Bitnami Manager to ensure the Apache Web Server

running.

i. Through File Explorer navigate to /opt/lampstack-7.1.16.0-0 and run the

Bitnami Control Panel by selecting manager-linux-x64.run

1. If the Bitnami Control Panel will not run

a. Open a terminal

i. Enter cd /opt/lampstack-7.1.16.0-0

ii. Enter chmod +x manager-linux-x64.run into the

terminal

iii. Try opening the Bitnami Control Panel by select

manager-linux-x64.run or entering sudo

./manager-linux-x64.run

2. If the Bitnami Control Panel fails to open, the MySQL/Apache can

be controlled with command lines

a. ./ctlscript.sh stop mysql - To stop the unneeded MySQL

server

b. ./ctlscript.sh start apache (should already be running)

b. Once Bitnami Control Panel is running stop the MySQL Database

i. Select MySQL Database under the Manage Servers tab, then select Stop


Page | 70


3. Install LPT-ASM-WEB

a. Download LP_Project folder and place it in /opt/lampstack-7.1.16.0-

0/apache2/htdocs

i. Copy and paste through File Explorer

ii. Or In a terminal go to the directory with the LPT-ASM-WEB folder and

enter sudo cp -r LP_Project /opt/lampstack-7.1.16-0/apache2/htdocs

b. Open the bitnami.conf text file located in /opt/lampp-stack-7.1.16.0-

0/apache2/conf/bitnami

i. Change the documentroot and directory to /opt/lampstack-7.1.16.0-

0/apache2/htdocs/LPT-WEB-ASM/public (Lines 9, 10 and 44, and 49)


Page | 71


c. Restart Apache Web Server either through the Bitnami Control Panel, or in the

terminal go to /opt/lamppstack-7.1.16.0-0 and enter ./ctlscript.sh restart

apache

d. Unlock LP_Project folder


Page | 72


i. in the terminal enter chmod -R 777 /opt/lampstack-7.1.16.0-

0/apache2/htdocs/LP_Project

e. Go to /opt/lamp-stack-7.1.16.0-

0/apache2/htdocs/LP_Project/bootstrap/cache and rename config.php to

something else, like config2.php

4. Update MySQL database

a. Download web_script and web_tables

b. In a terminal enter ./web_script

i. If permission is denied enter chmod +x web_script to unlock web_script

c. Terminal will request the MySQL login, use username: root pw: lptech

d. A successful MySQL update will display several lines of new tables created for

the LPT Database

5. Start WEB ASM

a. Restart Apache on Bitnami Control Panel

b. Place required licenses.txt into /opt/lampp/htdocs/LP_Project/public

c. Start a browser

d. Enter 127.0.0.1 into browser

e. WEB ASM main page should appear


Page | 73



web based automatic spectrum monitoring user guide for lpt ... · web asm is an easy to use and...

Documents