Augmenting Facet-Eye

Adding Programs


Overview

Fig. 1 Goal: Compact facet-enabled status
 
Fig. 2 Admin page:
Right click PerServ tray icon and click Admin
 
Fig. 3 Running aug_demo and getting url
 
Fig. 4 Path to augment files
 
Fig. 5 Content of aug_demo.py
To allow many processes monitored as possible in Facet-Eye, we want to return html from as many code processes as possible. Within PerServ, code is Python version 3. In the Python library, you can invoke command lines (os.system) and batch file (os.startfile) so your code can be expressed many ways.

Fig. 1 shows a 4x4 facet screen. It could display 16 different urls but we only use 2 urls here. We only need supply 16 distinct urls in the settings list for Facet-Eye and set up the other screen parameters.

Finding augment_demo url

To reach the augment pages, right click the PerServ tray icon (fig. 2) and click the admin button. You then reach the admin page which already has the local url for the fixed augment port (fig. 3). You can either right click and copy the link or left click it to get the local link.

The url is then placed between <url>...</url> tags in the Facet-Eye setup. Referring again to fig. 2, right click the PerServ tray icon but now click the Setup1 button.

The bottom of fig. 3 shows the result of running the demo and the url in the address bar on a system when Perserv has been exited at least once since install (error message show at right for first time only. this is known and can be ignored).

You may open up the augment http port and/or add https capability by clicking the port_46934 button in fig.3.

Finding code for augment_demo

Fig. 4 shows the relative directories leading to the Python search path (syspath) and the PerServ menu (gui). To get to these variables, show the admin page (fig. 3) and then hover over the Admin menu (just to right of the Home menu). Click on the XML Edit pull down link. Referring now, again, to fig. 4, click on the control.xml button if not already selected. For the UP line, click augment so the "control >> augment" path is displayed as shown. The two "add_to_..." entries are displayed.

You may add other files to the @data/augment default path to define additional Python 3 files.

Fig. 5 shows part of the aug_demo.py file. You may edit this file to experiment or create a new Python file in the same directory. If you delete aug_demo.py, it will be restored on next reboot of Perserv. Otherwise, change you make are preserved.