MAS II description

Version 2.0.3
Contents

MAS II description ........................................................................................................................................... 1

MAS II Common statements ........................................................................................................................ 2
MAS II Installation........................................................................................................................................ 2
MAS II Settings ............................................................................................................................................. 8
MAS User interface...................................................................................................................................... 9
MAS II Known issues/obsolescence........................................................................................................... 14
MAS 2.0.2 release updates ........................................................................................................................ 15
MAS 2.0.2.1 release updates (28.03.14) ................................................................................................... 15
MAS II roadmap ......................................................................................................................................... 19

MAS II Common statements

MAS II statistics page (MAS II) is a classic active server pages (.asp) script that can be used to browse the
Mini activation server (MAS) database records and can be used to monitor the actual MAS licenses usage.
MAS II uses only “SQL SELECT” queries to get all the information from the Actix MS SQL database. It is
not destructive to the database. If license server was not configured to log the usage records into a
database, MAS II will not work with such a MAS installation. In this case, please refer to Actix Mini Activation
Server Admin Guide, provided with your activation server, in order to set up the Database.
MAS II was tested with MS SQL Express 2005 and 2008R2 versions. Please, feel free to report about any
problems with any other Microsoft SQL server, working with Mini activation server.
Free Flotchart java based library (http://www.flotcharts.org/) is included to MAS II to show the licenses
usage on a chart.
MAS II was tested in Opera, Google Chrome and MS Internet explorer web browsers. No problems were
discovered with Opera and Google Chrome, but some versions of IE didn`t show the Flotcharts graphics.
Please, report the bugs to za@azymuth.ru or in Skype (a.zubarew), I will try to fix them.

MAS II Installation
Administrator`s rights are required to install the MAS II to a Mini activation server PC. MAS II was not
tested to be installed on a different server. If this option is necessary, please, inform me, maybe some scripts
should be modified to support this.
Here are the steps to install MAS II on Mini Activation server:
1. Log in to the server with administrative rights.
2. Create a folder for MAS II on your choice (D:/MAS2.0 in my case).
3. Unzip and copy to the created folder files of MAS II (may be more files in next versions):

MAS II statistics page. Description. Page 2 of 19.

4. Go to Microsoft IIS (Start  Administrative Tools  Internet Information Services (IIS) Manager).
5. !!! In order not to violate the proper functioning of Mini Activation Server, do not change anything in
Actix Activation Website.

6. Add a new website (click the right mouse button on Sites. Specify the MAS II web-site name (MAS
2.0 in the example) and the TCP port to access the new web-site (Mini activation server uses
standard http port 80, the 8082 port is used in the example). Select a folder where the MAS II files
are located as Physical path.

MAS II statistics page. Description. Page 3 of 19.

7. It is strongly recommended to switch on the authentication on this web-server in order not to allow
anyone to open MAS II (Anonymous Authentication  Disabled, Windows Authentication  Enabled).

MAS II statistics page. Description. Page 4 of 19.

8. The MAS II web server must become available on localhost (http://127.0.0.1:8082) (or other port
you specified before). Try to open it in web browser, if authentication is on, the page will request to
enter your Windows user login and password.

9. After entering the user login/password, the MAS II page will open:

MAS II statistics page. Description. Page 5 of 19.

10. If the MAS II page must be accessed from other computers, it is necessary to add a new Inbound rule
to Windows firewall, after this step the MAS II page will become available from your local area
network:

MAS II statistics page. Description. Page 6 of 19.

MAS II statistics page. Description. Page 7 of 19.
It will be accessed by the name of MAS server on port 8082 (or other as defined on previous steps).

MAS II Settings

MAS II settings are available in mas2.ini file. It is one of files, copied to MAS II folder on the first
installation steps.
Actual settings list:

[Common settings]

Version Mi4wLjIuMSAyMDE0LTAzLTI4
An internal version number. Not to be changed.

ActivationFile C:\Program Files (x86)\Actix\Activation Server\Act\actserver.xml

Location of actserver.xml file of Mini activation server. If MAS was installed not in the default location, you
need to modify this setting- actserver.xml is used by MAS to connect to the Database.
If a not valid value will be specified here, MAS II will try to use the default DB connection parameters.

[User interface settings]

Title MAS Statistics Page version 2.0

A title that would be displayed at the header of MAS II page

Subtitle AZymuth Ltd MAS server (debug version)

A subtitle that would be displayed at the header of MAS II page

Logo1 AZ-logo.png
A link to a company logotype file. Is displayed on a left hand of Title. A web-link is supported. “none” for no
logo.
Logo2 none
A link to a company logotype file. Is displayed on right hand of Title. A web-link is supported. “none” for no
logo.

RefreshPage 60000
Time in milliseconds for automatically refreshing the MAS II page (60000 means that MAS II will be refreshed
once a minute).

Initial_date_period 3
Default data selection period if no options were selected on MAS II page (usually when opening MAS II page
first time)

TimeZoneShift 4
A value is a time difference between a MAS location and GMT.

[SK settings]
Softkey XXXXX Y
Used to define a number of licenses(Y) for a certain softkey(XXXXX) . Can be used to correctly display the
Softkey Usage if some of licenses were never used and have no records in database.

MAS II statistics page. Description. Page 8 of 19.

MAS User interface

MAS II User interface consists of 10 main logical panels.

1. Panel 1: The title

MAS II statistics page. Description. Page 9 of 19.

You can change the subtitle to your company name in mas2.ini (Title_String option)

2. Panel 2 – Statistics option select.

Here you can select the statistic period, softkey, number of lines per page. After choosing the options,
press “Select” button. If the number of selected records is greater than “Records per page” value, you can
move between the selection results pages.
You can export the results to a .csv file using ->.csv button.

3. Panel 3 - Summary of selection – common number

MAS II statistics page. Description. Page 10 of 19.

 Here you can see the summary for the requested conditions – how many records were selected due
to specified conditions, how many softkeys were used and the list of used softkeys.

4. Panel 4 - the Mini activation server statistics selected from the database

Here you can see the results of your request as it is stored in the MAS database. There are pages navigation
buttons at the bottom of this panel.
Note, that

5. Panel 5 – on line license status monitoring

Panel 5 is presented as a mini-dashboard, that can be used to monitor softkeys status in pseudo-online
mode. This panel is refreshed according to the RefreshPage settings in mas2.ini file.
The monitored softkeys list can be filtered by selecting a softkey at panel 2.

6. Panel 6 – softkeys usage statistics by users

The monitored softkeys list can be filtered by selecting a softkey at panel 2.

MAS II statistics page. Description. Page 11 of 19.

 You can export the selection results to a .csv file using -->.csv button.

7. Panel 7 – softkeys usage statistics on graph

Graphical statistics works in 2 modes:

- when an “All Softkeys” option is selected in panel 2

MAS II statistics page. Description. Page 12 of 19.

 The graph shows usage percentage for all the softkeys available the mini activation server (for the
selected time period)
- when a certain softkey is selected in panel 2

The graph shows usage graph for the selected softkey and time period. The graph scale also shows the
available number of licenses in a softkey (4 in an example).
If a today is selected as an end date, the usage graph shows time period up to now.

8. Panel 8– MAS II user details

Information about Windows user, IP, HTTP address used, user browser and IIS server details could be
found here. If MAS II authentication was not switched on in IIS, the “User:” field will be blank.

9. Panel 9 - MAS II connection details

MAS II statistics page. Description. Page 13 of 19.

 Information about the DB connection status, the name of the database used, SQL server version,
configuration files availability and the DB actual size could be found here. On mouse hover the exact
DB size in bytes is shown.
10. Panel 10 – link to original MAS administration page.

MAS II Known issues/obsolescence

MAS II statistics page is not using reverse engineering for its code. It only uses and analyzes data from
Mini Activation server database. In current version (2.0.1) the number of available licenses for softkey is
calculated as maximal number of “Seq” attribute for all the records. Therefore, if a license number 4 from
softkey XXXX was never used and not recorded in the DB, MAS II will consider, that softkey XXXX has 3
licenses even if there are 4 in mini activation server. – Fixed in 2.0.2

MAS II statistics page. Description. Page 14 of 19.

MAS 2.0.2 release updates

- Improvements in mas2.ini file – the sections are structured now

- Now a it is possible to set up a number of licenses for a softkey in mas2.ini file – adding a line “Softkey
XXXXX Y” in a SK settings section
- A UserRef field filter added – all the records that contain the searched substring are selected. It affects
also the Panel 6 – softkeys usage statistics by users

- Several bugs fixed

MAS 2.0.2.1 release updates (28.03.14)

- Company logos (Logo1 and Logo2) could be now displayed in MAS II header.

MAS II statistics page. Description. Page 15 of 19.

- Improvements in mas2.ini file – Logo 1 and Logo2 support added.

Any graphic file (of a type, supported by web-browsers) link could be specified as a Logo1 and Logo2
parameter (a web-link is also correctly understood). If “none” is specified as Logo1 or Logo2 in mas2.ini, no
Logo will be displayed. If a file name without link is specified as Logo1 or Logo2, MAS 2 will look for it in a
MAS 2 folder.
A height of 50 pixels is recommended for Logo image files.
- A title and subtitle string can be defined in mas2.ini now.

MAS II statistics page. Description. Page 16 of 19.

MAS 2.0.3 release updates (17.04.14)

- Sort functionality added to a main statistics table.

To sort the statistics table you need to click on the column name or the triangle near it.
The selected order type triangle is highlighted with grey.

- Added interactivity features to a Usage statistics graph.

o Hovering a mouse pointer over a point on a graph, an information about the date, time, number
of used licenses and a list of users is displayed an a tooltip.

MAS II statistics page. Description. Page 17 of 19.

o Clicking on legend on a Softkey opens a small statistics window, showing off the softkey usage
distribution for a previously selected period (in minutes and percentage). Can help to analyze if
additional licenses are necessary for certain softkey.

MAS II statistics page. Description. Page 18 of 19.

MAS II roadmap (suggestions are welcome)

- Adding a Number of licenses parameter for a certain softkey to mas2.ini configuration file (fixing an
issue with never used licenses) – done in 2.0.2.
- Add sort tabs to StartTime, EndTime, SoftKey, Seq, NumReAct, Minutes, UserRef done in 2.0.3
- Adding MAS user substring search in panel 2 – done in 2.0.2.
- Adding an licenses usage statistics for a softkey done in 2.0.3
- Adding interactive features to a graph done in 2.0.3
- Adding a possibility to select not only date range, but time range also – will be added in 2.0.4.

MAS II statistics page. Description. Page 19 of 19.