Chapter V.- Symphony Console

1. Mobility
2. Deployment
3. Monitoring
4. Reports
5. Administration

1 Mobility Module

Units help

This page manage the units, a unit is a PDA that is connected to the Symphony Console, every unit connected to the console can be seen from this page. The units have a lot of information that you can see on the columns of the units page, like their connection status, MUID, IP, Client Version, Platform, Model and User ID.
On this page there are two different tabs, Units Management and Packages.

Unit Management View

Shows the information about your mobile units connected to the console, also it allows you to update the packages on the units. This are the options from the first menu:

Get all: Retrieve information of all the mobile units.
Get Information: Retrieve the information of the unit selected (you can select multiple units with the keys Ctrl and Shift).
Remote Control: Start a Remote Control Session with the unit selected, you need the Remote Control Console installed on your system, when you select a connected unit and make a click on this button, the Remote Control Console will open and automatically connect with the unit.

Actions:

• Send a message
• Execute an application
• Delete a File
• Apply a .cpy file
• Unzip a file
• Kill a process
• Apply a .reg file
• Warmboot
• Coldboot

Add to group: Add the Selected units to a group (you can select multiple units with the keys Ctrl and Shift), the group must be already created.

Statistics: At the bottom of the web console you can see the statistics of the units connected to the console, when the color of the unit is green it means that the connection is working, if the color is yellow it means that the unit missed the last report and if is red the unit is completely lost.

Edit unit

You can edit some parameters of the unit selected, it's state (deactivated or activated), also you can add a description and a comment.

Unit History

Is a registry of the updates and modifications made on the unit. You can apply filters to make easier to find a determinate log.

Unit Packages View

his is where you can see the information about the packages on the units, when you select a unit you can see the Installed Packages, Packages To Install and Collections Applied.

This are the options of the package menu:

• Update: Update the selected unit (you can select multiple units with the keys Ctrl and Shift) that will make effective the changes made on the units packages and collections and any modifications made on that unit or group of units.
• Reset: cleans the list of packages to install on the selected unit.

Statistics: At the bottom of the web console you can see the statistics of the units connected to the console, when the color of the unit is green it means that the unit has already the latest update, if the color is red it means that the unit is out of date.

Unit visualization settings: you can apply filters to visualize the units for groups and sites and also change the sorting.

Sites

A site is a way to organize the units connected to Symphony using the information of their IP address so you can sort them by the place where are the units.

Sites Management

This is where you can create, eliminate and modify the Sites, you will see the list of sites on the console.
You can see this options:

• Creates a new site, just complete the form with the name of the site, the network address and it's routing prefix. Even when you can create the sites manually, the sites are created automatically when a unit when a different site is connected to the console.
• It allows you the change the name and add a description of a site.
• It eliminates the selected site after a confirmation.
• Eliminates the sites who hasn't units associated to them.

Sites Summary

The summary page shows all the sites on the console and the information of the units located on their respective sites, to get a more detailed information about a site just select it and you will be able to see it's status.

Groups

You can create groups to classify the units, this is an arbitrarily way to organize the units.

Groups Management

The management page shows the list of groups created on the console, the groups can only be created manually and you can modify the list with the options above the list:

• Just Complete the fields with the name of the new group and,if you want, with a description, the new group will appear on the list.
• It allows you to change the description of the selected unit.
• Eliminates the selected group after a confirmation.

Groups Summary

This is where we can see the information of the groups created on the management page, the units connected, the units missing and also you will be able to see the detail of each group by clicking on them.

2 Deployment Module

Collections

A collection is a group of packages to install on the mobile unit/s, you can create your own collections and fill them with a group of packages. Also you can setup when you want to apply the collection and what units will be updated with that collection.

Collection Management

This is where you can create the new collections and change the settings from the existing ones. To do that you have to use the buttons above the list of collections.

• To make a new collection use the Create Collection button and choose a name for the collection and a description (it's optional), the new collection will be added to the list without parameters, you will have to edit it with the Button Edit Collection.
• Change the parameters of the selected collection, there are lot of things that you can setup on the collection, the options are divided by frames:
• Information: You can visualize the name of the collection and you can change the description.
• Formula List: The formula defines on which mobile unit/s the packages included on the list to Install will be installed.
  To add a formula click on the button and a new window will appear, you will see the fields to create a new formula and the listbox Value will show the fields that match the formula. Once that you have created the formula click on and the formula will be displayed on the list.
  You can modify a formula just selecting it and making click on the button.
  To Eliminate a formula just select it and click on .
• Package List: We can see two lists inside the frame Packages To Install and Packages to Uninstall. The first list shows the packages that the collection will install on the units selected on the formula when you update. To add a package to the list Click on and you will see the list of packages installed on the console, select the package and click on . The uninstall list shows the list of packages that will be deleted from the units on the next update, use the buttons and to change a package from a list to another.
  To remove a package from any list click on the respective buttons.
• Activate/Deactivate: This checktbox selects whether a collection is active or not. An inactive collection will never be included for updates.
• Validity: A validity period defines when a collection can be installed. It is not mandatory to define one for each collection but it may be useful to organize user's activity. 
  The frame Date Defines a validity period between 2 dates. The collection will be valid between those dates. If only one date is defined, the collection will be valid either to or from the selected date. If no date is selected, the collection will be valid from the moment it is created until it is manually deactivated. 
  On the frame Days we can Select on which days of the week this collection will be valid.
  Time Selects a validity time-frame within the day. The collection will be valid within that time-frame.
  To save the changes made on the collection click on .
• Eliminates the selected collection after a confirmation.

Collection Status

The status page shows first the list of collections and their status, also clicking on them you will be able to see the install and uninstall list of the collection selected. On the units dropdown menu you can check on which units the collection has been deployed or not, you can use different filters to find easily a specific unit.

Packages

A package is a file that will be installed on the units from the console, it can contain a file or a program. The packages are added from you system to the console and then are installed on the units acording to the configuration chosen by the user.

Package Management

On this page you will be able to see the list of packages, create new ones and modify them. The options available to manage the packages are:

• Show information about the package selected, also you can see the list of files from the package that have been already installed, also the uninstalled ones.
• With this option you will be able to upload packages from your system to the console, just click on the Select button and choose the package that you wish to add, then click on Upload and the process will start, if the file is invalid the console will warn you. When the upload finishes you will see the package on the list.
• Eliminates the selected package before a confirmation, is important to know that deleting a package from a collection doesn't uninstall it from the client.

Package Status

This is where the status of the different packages is shown, on the list of packages you will be able to see the on how many units it has been installed, also you can apply filters to make easier to find a specific unit.
There is a Collections dropdown menu that shows the collections where the package can be found and also if the collection is active or not.
The last dropdown menu has the list of units where the package is installed and it's information, you can customize the columns of information that are shown, and again, apply filters.

QuickCab

This tool allows you to create packages with just a file .cab.
To create a package click on the button and choose a .cab file on your system, then you have to select if you want to remove the file after the installation on the unit, also you can choose if you want to apply that package to all the units, if you want to add the package to a collection (then you have to select which collection or do nothing (the package will just be added to the package list, you will see it on the management page Management.
Then when the settings are already changed click on the button. When the upload ends the console will tell show a message saying that the upload was successful.

3 Monitoring Module

Unit modifications history

This page shows the changes applied to the units, everytime when a unit is modify through the console the action is logged on that list. The modifications are classified in Status Modification, Package Deployment, Package Deployment Error and Property Modification.
You can apply filters like date, sites, groups and modification type.

Edit Report

Yo can create your own reports and customize every detail of them to make sure that they fit your needs. There are a lot of things that you can decide each tab shows the different fields that you can setup.

• Details Tab: On the Main Configuration frame you have to fill the blanks with the name of the Report and the description (is not mandatory). The date configuration allows you to select when the report will be registering the selected events, any date is the default value but you can select a specific range of dates or a relative one.
• Selection Of Events Tab: Here is where you are going to choose which events will be reported, add a new event with the button , you will see the new registry, choose a category, you will see the events associated to that category, select the one that you want to report, also you can add some parameters like Threshold, Quantity and Result if you have chosen Site as target on the Main Configuration tab you will be able to Add a function.
• Unit filters Tab: On this tab you can create filters to restrict the report to applied on certain units. Click on , a new field will appear, just select a category and the list of values will appear, select a value and the filter will be ready.
• Properties to display Tab: This is where you decide which columns of information will appear when you Run the report, you can sort the columns according your preference.
• Charts Tab: You have the option to generate charts with the information shown on the columns of the report, you can create a unique chart or a chart for any unit, the X Axis Time Unit sets the scale of the time line on the chart.

Parameters: On the date parameters you can select the range of dates and times when the report will be deployed if you have chosen fixed dates as date configuration, if you have chosen Relative Dates as date configuration you will have activated the Relative Date field to setup.
On the Group/Site parameters you can select on which sites or groups you will be applying the report.
Run: It shows the results of the selected report, you can save the results on a document making a click on the icon of the format that you prefer Excel, PDF, CSV and DOC.

Reports

You can see the list of reports created automatically and the reports created manually on Create/Edit Report, also you can see the Date Parameters of each report (you have to select the report first) and the Groups/Sites involved.
The buttons above the list and it's functions are:

• Making a click on this button will send you to the page Create/Edit Report, the page will be empty so you can make a new report.
• Select a report and click on this button to be sent to the Create/Edit Report page, you will see the information of the selected report and you will be able to modify it, then when you finish the modifications click on the button on the Details tab.
• Use this button to download a .xml file with the selected report so you can pass it to other consoles or just to have a backup of the Reports setup.
• This is the way to import the .xml created with Export Reports, just click on this button and a dialog will open where you will have to select the .xml file, then just click on, make sure that the report file is not already in the console because it doesn't allow two identical reports.
• It eliminates the selected report (you can make a multiple selection with the keys Ctrl and Shift).

Run Report: It shows the results of the selected report, you can save the results on a document making a click on the icon of the format that you prefer Excel, PDF, CSV and DOC.

4 Reports Module

Edit Report

On this page you can make a new Report that will be added at the list of Report Execution. On the first frame write a name for the report, the description is not mandatory.

Reports

This page is where you can run the reports created on Create/Edit Report. The buttons above the list and it's functions are:

• Making a click on this button will send you to the page Create/Edit Report, the page will be empty so you can make a new report.
• Select a report and click on this button to be sent to the Create/Edit Report page, you will see the information of the selected report and you will be able to modify it, then, when you finish the modifications click on the button.
• Use this button to download a .xml file with the selected report so you can pass it to other consoles or just to have a backup of the Reports setup.
• This is the way to import the .xml created with Export Reports, just click on this button and a dialog will open where you will have to select the .xml file, then just click on , make sure that the report file is not already in the console because it doesn't allow two identical reports.
• It eliminates the selected report (you can make a multiple selection with the keys Ctrl and Shift).

Run Selected Query: It shows the results of the selected query, you can save the results on a document making a click on the icon of the format that you prefer Excel, PDF, CSV and DOC.

5 Module Administration

Configuration

This is the Control Panel of the Symphony console, where you can create new users, activate the licenses, clean the database by deleting old events and more.

Local Configuration

On this page you can change settings from the configuration of the console and it's modules. The fields to modify are self explanatory, to edit any of them just select the field, the Section's Description will give you the information about the field and the Parameter's Description will tell you the value needed to complete the blank. After changing it click on the  button, to end click on .

Maintenance

It manages different settings from Symphony and it's configuration.

Database Status

Here is where you can see the number of events recorded by the console. The events reported are the saved on the database used by the console, you can select when the old registries are eliminated to clean space on the database.
You have 3 frames with different settings about cleaning the space.

• Unit Event Table Status
• Command Logs Table Status
• Unit Modifications Table Status

On every case you will be able to delete the registers older than the amount of days that you choose, write a number of days and click on the Go button, after a confirmation the registries will be deleted.

Users

On the symphony console you can make as much users as you want, the defaults are Admin and Operator.

User Creation

Make a new user is very simple, you only have to complete the fields with the information required and add the permits from the Roles list, each role has a little description so it's very easy to setup, when everything is ready click on  and it will be created, now you can login as the new user.

Users List

This is where you can see the users list and also modify the users settings. To change a user setting just select it and click on the button , you will see a new window with the user's information, now you can modify it and then click on Update User to set the changes. Also you have the option to activate or deactivate the user.

•  you have the option to assign groups or sites to a specific user.
•  settle a site to a specific user.

Licenses

Symphony allows only one PDA connected to the console, if you want to connect more devices you will need a license, follow the instructions from the Symphony License Manual to apply the registration of the console.

Go to top