Adust topdocs to current system functionality
authorszewczenko <szewczenko@T3400.(none)>
Thu, 17 Oct 2013 12:22:06 +0000 (14:22 +0200)
committerszewczenko <szewczenko@T3400.(none)>
Thu, 17 Oct 2013 12:22:06 +0000 (14:22 +0200)
35 files changed:
doc/config.dox
doc/distr.dox
doc/faq.dox
doc/help.dox
doc/install.dox
doc/intro.dox
doc/pgf.dox
doc/reqs.dox
doc/secure.dox
doc/subscribe.dox
doc/ug.dox
images/bdb_age.png
images/bdb_age_sched.png
images/connect.png [new file with mode: 0644]
images/data_source_add.png [new file with mode: 0644]
images/data_source_name.png [deleted file]
images/data_source_object.png [deleted file]
images/data_source_radar.png [deleted file]
images/data_source_summary.png [deleted file]
images/data_source_user.png [deleted file]
images/distr_route.png
images/dr_conf.png
images/key_exchange.png [new file with mode: 0644]
images/key_exchange_keystore.png [new file with mode: 0644]
images/key_exchange_msg.png [new file with mode: 0644]
images/login_page.png
images/logs_conf.png
images/pgf_adapter.png
images/pgf_comp.png
images/pgf_cqc.png
images/pgf_gm.png [new file with mode: 0644]
images/pgf_gmscript.png [deleted file]
images/pgf_vol.png
images/radars_add.png [new file with mode: 0644]
images/subscribe_list.png

index 046bf0e..aa7cb02 100644 (file)
@@ -1,6 +1,6 @@
 /** \page config Configuration
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 Congratulations! If you've come this far, it means you've succesfully
 followed the instructions in \ref install and you have a node that is up and
@@ -24,15 +24,15 @@ pre-configured user called \c admin, and this user's password is
 'baltrad'. You have to log on using the web-based user interface and change
 it to something only you know. 
 
-Go to the "Settings" --> "User accounts" --> "Edit" page. There you'll see
-the \c admin user and a link to the right called "Change" under the heading
-"Password". Use a safe password, and store it in a safe place that you
-remember.
+From the main menu placed in the left column, click "User accounts" --> "Edit" 
+link (located in the "Settings" section). There you'll see the \c admin user 
+and a link to the right called "Change" under the heading "Password". 
+Use a safe password, and store it in a safe place that you remember.
 
 \section con_ns Configure your node settings
-Go to "Settings" --> "Node settings". This is where you should identify
-your node properly. If you didn't build your node with \c --nodename, then
-your default node name will be your computer's \c hostname. Your node
+Click "Node settings" from the left-column menu. This is where you should 
+identify your node properly. If you didn't build your node with \c --nodename, 
+then your default node name will be your computer's \c hostname. Your node
 should be type "Primary".
 
 The "node address" is very important. If the URI contains "localhost" or
@@ -69,17 +69,15 @@ radars operated by other organizations too if you plan on forwarding their
 data to other nodes, but we will only deal with your data here for the sake
 of simplicity.
 
-Go to the "Settings" --> "Radars" page and "Add" a new radar. The only
-information you need is the radar's name and its WMO number. The name is
-easy: don't use a crypticly coded name, use the name of the place that
-people refer to it as, e.g. "Arlanda". That's a lot easier for a human
-being to remember than "02451"...
+Select "Radars" from the main menu and "Add" to define a new radar. 
+The selection of radars is predefined based on the set of European weather radar 
+identifiers, also used in RAVE package. These identifiers are found in an XML 
+file being a copy of a file used by RAVE. Click on the center identifier in 
+the left column to expand the list of radar stations available for the selected
+center. Select a desired radar and click the "Save" button. Radar station 
+will be saved in local database.
 
-The WMO "number" is a different story. It should be a combination of five
-(5) digits, where the first two are the "block" number and the last three
-are the "station number". So, even if your block is only one digit, it
-should be padded with a zero, e.g. Sweden is "02". If your radar doesn't
-have a WMO number, just use "00000".
+\image html radars_add.png
 
 \section con_ds Add one or several data sources
 We use "data sources" in BALTRAD for identifying data that are available
@@ -88,29 +86,30 @@ e.g. a polar scan or volume, and then you can expose them selectively to
 other nodes via their peer users that connect to your node. We'll deal with
 the peer users later.
 
-Adding a data source takes a few steps. Go to "Settings" --> "Data
-sources" --> "Add". We'll use the Swedish radar at Stockholm-Arlanda
-airport as an example. Start by adding a source name and description.
-\image html data_source_name.png
-Then continue by associating the radar you just configured with it. Note
-that you have to select a radar from the drop-down list and then press the
-green "+" button for your choice to be validated. This technique is used on
-subsequent pages. You can add several radars, and you can remove the last
-one by pressing the "-" button.
-\image html data_source_radar.png
-After that, specify what type of data from this radar are relevant for
+In order to define a data source, select "Data sources" --> "Add" from the 
+"Settings" section of the main menu. The example uses Polish radar located in 
+Legionowo, as shown in the image below. 
+
+\image html data_source_add.png
+
+Start by adding a source name and description. Then continue by associating 
+selected radar with it. To achieve this, select desired radar from the 
+"Available radar stations" and click the ">" button to add the radar. Selected
+radar will be moved to "Selected radar stations" list. In order to remove 
+radar from selection, use the button marked with "<" sign. 
+The same approach is applied to the selection of the remaining data source 
+parameters.
+
+Next specify what type of data from this radar are relevant for
 exchange. If your radar sends you data one scan at a time, then select
 "SCAN". If the radar sends a complete polar volume all at once, then select
 "PVOL". Don't worry about the other menu items for now.
-\image html data_source_object.png
-Then you link users to this data source. Normally, you would use "peer"
-users (who we'll discuss later in \ref subscribe), but you can start by
-just linking the \c admin for lack of any other.
-\image html data_source_user.png
-Finally, you're presented with a summary of this data source configuration,
-which you can confirm by pressing "Save".
-\image html data_source_summary.png
-Editing data sources is done with the same procedure.
+Then you link users to this data source. Note that only peer users can be linked
+with a data source (it is not possible to assign local users like "admin" or 
+"operator" to a data source). Finally, click "Save" to store the data source.
+
+Editing data sources is done with the same procedure. To edit an existing data 
+source, select "Data sources" and "Edit" from the main menu.
 
 You can combine several radars into one data source. Likewise, you can
 combine several types of data in a single data source. A \b warning, however,
@@ -122,14 +121,16 @@ same data source, then it means they'll receive the same data twice.
 
 \section con_lr Keeping the system log clean
 You should configure your system log so that it doesn't overflow with
-messages. This is done in "Settings" --> "System messages" --> "Configure".
+messages. This is done by selecting "Messages" --> "Configure" from the 
+"Settings" section of the main menu.
 \image html logs_conf.png
 
 \section con_dr Keeping the delivery registry clean 
 You should configure your delivery registry so that it doesn't overflow with
 messages. This registry contains all information on successful and failed
-data transfers. Configuring the registry's size is done in "Settings" -->
-"Delivery registry" --> "Configure". 
+data transfers. Configuring the registry's size is done by selecting 
+"Delivery registry" --> "Configure" from the "Settings" section of the main 
+menu.
 \image html dr_conf.png
 
 \section con_dat Getting your own data into your node
@@ -140,7 +141,7 @@ mechanism.
 
 But before you inject your data, they must be converted to the ODIM_H5 file
 format. There are several good converters available from within the
-community and from manufacturers. Ask around if the anyone has already
+community and from manufacturers. Ask around if anyone has already
 succeeded in converting from the format that your radar uses; chances are
 good that someone has something you can use.
 
@@ -157,7 +158,8 @@ the OdimH5 documentation on how to install, configure, and use it.
 
 \li The \b n2b injector in the RAVE package. You'll find it in RAVE's 'bin'
 directory. Note that you don't need your node's whole software
-installation, just the RAVE package and RAVEs dependencies like hlhdf and pyinotify. Run
+installation, just the RAVE package and RAVEs dependencies like hlhdf and 
+pyinotify. Run
 \verbatim
 $ n2b --help
 \endverbatim
@@ -177,8 +179,8 @@ comes to communication security, which is covered in \ref secure.
 A classic problem that causes systems to stop working is that the
 computer's disks become full. In BALTRAD, its your database (BDB subsystem)
 that stores your data. It's very easy to configure it to a comfortable size
-that suits your needs. This is done by creating a new route in "Processing"
---> "Routes" --> "Create DB trim age", e.g.
+that suits your needs. This is done by creating a new route in "Processing" 
+section of the main menu. Select "Routes" --> "Create DB trim age", e.g.
 \image html bdb_age.png
 Note that when the route has been defined, it must also be scheduled. You
 don't need to do this scheduling for normal data processing tasks, just the
index 235d499..ce9ba45 100644 (file)
@@ -1,6 +1,6 @@
 /** \page dist Distribution
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 We've installed and configured a BALTRAD node, injected our own data into
 it, exchanged data with other nodes, generated products with all the data,
@@ -25,28 +25,82 @@ set this up.
 We will give an example where we distribute the product we've configured
 and generated in \ref pgf_comp to a remote computer using SCP. In the
 web-based interface, go to "Processing" --> "Routes" --> "Create
-distribution". The first four fields are easy to deal with, whereas the
-last two need some attention. First the "Destination" field which can have
-one of three different URI formats:
+distribution". The first four fields are easy to deal with, while the remaining
+ones require some attention.
+
+First the "Destination" field which can have one of three different URI formats:
 \li copy:///dir/in/local/system
 \li ftp://user:pass\@host/dir/
 \li scp://user\@host/dir/
 
-In our case, SCP uses the last of these three formats. The "Filter" is a
-generic ODIM filtering tool that allows you to define selection criteria
-based on metadata attributes in ODIM files. In our case we have defined a
-fairly simple set of two criteria, the \c /what/source attribute must
-contain the geographic area name. In BALTRAD we use the CMT identifier for
-this together with the ORG identifier. The second selection criterion is
-that the \b /what/object attribute is COMP, ie. a composite. This filtering
-functionality assumes you are conversant with 
+In the example below, we use FTP protocol for file distribution. Destination
+URI looks like the following:
+
+\verbatim
+ftp://rainbow:s3cret@172.31.85.101/opt/baltrad/odimH5/rb5input/BOR
+\endverbatim
+
+The example URI using SCP would look like this:
+
+\verbatim
+scp://rainbow@172.31.85.101/opt/baltrad/odimH5/rb5input/BOR
+\endverbatim
+
+\note
+Directories in the destination must exist, since upload handler doesn't creates 
+target folders.
+\endnote
+
+Name template field supports naming the files. If this field is not empty, 
+it will be used to generate the names of the uploaded files. \c ${} is used in 
+the template to specify placeholders. The placeholder itself should be an 
+ODIM_H5 metadata attribute provided with full path. Following is an example 
+of a name template: 
+
+\verbatim
+${/_bdb/source_name}_${/what/object}_${/what/date}T${/what/time}Z.h5
+\endverbatim
+
+The template will produce the following file names:
+
+\verbatim
+ee_COMP_20120205T010000Z.h5
+eehar_PVOL_20120205T010000Z.h5
+eesur_PVOL_20120205T010000Z.h5
+sease_SCAN_20120206T083200Z.h5
+\endverbatim
+
+Besides standard ODIM_H5 attributes, the following placeholder variables are 
+triggered with a special prefix \c /_bdb:
+
+\li /_bdb/uuid - entry uuid
+\li /_bdb/source_name - name of the source in BDB
+\li /_bdb/stored_date - UTC date this file was imported to BDB
+\li /_bdb/stored_time - UTC time this file was imported to BDB
+
+\note
+Name template takes absolute paths (e.g /what/object).
+
+If the name template is not specified, files will be named after the entry UUID.
+\endnote
+
+The "Filter" is a generic ODIM filtering tool that allows you to define 
+selection criteria based on metadata attributes in ODIM files. In our case we 
+have defined a fairly simple set of two criteria, the \c /what/source attribute 
+must contain the geographic area name. A full set of idntifiers is used here 
+in order to match files against filter: WMO, RAD, PLC and CMT. This ensures that 
+in case id any of these identifiers match the file's attribute, the file will
+be distributed.
+The second selection criterion is that the \b /what/object attribute is PVOL, 
+ie. a polar colume. This filtering functionality assumes you are conversant with 
 <a href="http://www.knmi.nl/opera/opera3/OPERA_2008_03_WP2.1b_ODIM_H5_v2.1.pdf"
 target="_blank">ODIM_H5</a> and its metadata.
+
+\note
+Filter takes relative attribute paths (e.g. what/object).
+\endnote
+
 \image html distr_route.png
 
-The resulting file name that is distributed will be hashed beyond human
-recognition, so for the time being you will need some kind of routine for
-reading the distributed files and determining what to do with them based on
-their metadata. Our functionality will be elaborated in BALTRAD+ and we
-hope to offer distribution functionality with flexible file-naming conventions.
- */
+*/
index ba0f485..ca3c116 100644 (file)
@@ -1,6 +1,6 @@
 /** \page faq Frequently Asked Questions
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 \htmlonly<hr>\endhtmlonly
 
index bed024c..1ee1997 100644 (file)
@@ -1,6 +1,6 @@
 /** \page help Getting post-installation help
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 The various subsystems' built-in documentation will be generated
 automatically during \ref install. This is detailed technical documentation
index 0383309..30f5c29 100644 (file)
@@ -1,6 +1,6 @@
 /** \page install Installation
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 Welcome to the installation chapter of the user guide. BALTRAD software has
 been built and installed in seven countries already, and at least three
index 35220ea..a67207e 100644 (file)
@@ -1,8 +1,8 @@
 /** \mainpage Community-based weather radar networking
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 \par Copyright 
-&copy; 2012 Swedish Meteorological and Hydrological Institute (SMHI), Norrk&ouml;ping, Sweden <br> on behalf of the BALTRAD partnership
+&copy; 2013 Swedish Meteorological and Hydrological Institute (SMHI), Norrk&ouml;ping, Sweden <br> on behalf of the BALTRAD partnership
 
 \par Legals
 BALTRAD is free software: you can redistribute it and/or modify
@@ -52,4 +52,4 @@ TAKE ME TO ...
 </table>
 \endhtmlonly
 
- */
\ No newline at end of file
+ */
index f9b12f9..332beea 100644 (file)
@@ -289,8 +289,31 @@ If you built and installed your node with the \c --with-rave-gmap argument,
 then you already have the package installed. There are a few things
 you need to do manually before this service will work for you.
 
+
 \subsection pgf_gm_ap Configuring your web server
-Make sure your web server knows about this plugin. We have integrated
+
+First thing to do is preparing a file containing geographic area definitions 
+to use with the Google Maps plugin. To generate areas definition file, do the
+following:
+
+\verbatim
+%> cd $prefix/rave_gmap/web
+%> source $prefix/etc/bltnode.rc
+%> python ../Lib/GenerateProductInfo.py smhi-areas.xml
+\endverbatim
+
+\note
+The name of the file \c smhi-areas.xml might be a bit confusing, but it actually
+contains different product definitions.
+\endnote
+
+Assuming that all went fine, a file called \c products.js will be created in 
+<tt>$prefix/rave_gmap/web</tt> directory. It contains some area definitions we 
+have used while developing the system. They can be replaced with your new one,
+or your new one can be added - refer to \ref pgf_gm_gm section to learn how to 
+do that.
+
+Next, make sure your web server knows about this plugin. We have integrated
 against an Apache server, so the instruction is valid for it. At the bottom
 of your server's \c httpd.conf file, add the following entry. This is
 assuming that you've checked with your system administrator what want to do
@@ -309,27 +332,22 @@ root# service httpd restart
 
 \subsection pgf_gm_route Configuring a route in your node
 Define a route in the node for generating images for Google Maps. This is
-currently done by Groovy scripting, and there's a ready-made script
-for you for this purpose that comes along with the node installer. In the
-\c packages directory, you'll find the \c beast package and a subdirectory
-called \c examples. There you will find an example script named \c
-GenerateGmapPng.groovy. Start by using the web-based user interface to your
-node, and go to "Processing" --> "Routes" --> "Create script". Paste the
-Groovy script into the "Script" field and make sure the AREAS and PATH
-declarations are correct:
-\image html pgf_gmscript.png
+done by selecting "Routes" -> "Create Google Map" from the "Processing" section
+of the main menu. Remember to make sure that the "Area" and "Path" field values
+are correct:
+\image html pgf_gm.png
 As soon as you have saved this route, the plugin will generate a PNG image
 for Google Maps each time an input file for it is generated.
 
 \subsection pgf_gm_gm Configuring the plugin itself
 The final step is for you to configure the plugin itself, so that it
 contains a selectable product menu item that matches the product you're
-generating. In the <tt>$prefix/rave_gmap/web</tt> directory, there is a
-file named \c products.js that comes with some area definitions we have
-used while developing the system. They can be replaced with your new one,
-or your new one can be added. Continuing with our example from Vara, a
-corresponding entry for it makes use of the corner coordinates we
-determined earlier in \ref pgf_cp_area and the radar's location:
+generating. We will use \c products.js file that you've generated in 
+\ref pgf_gm_ap section. As was mentioned above, the file contains some default
+area definitions. They can be replaced with your new one, or new one can be 
+added. Continuing with our example from Vara, a corresponding entry for it makes 
+use of the corner coordinates we determined earlier in \ref pgf_cp_area and the 
+radar's location:
 \verbatim
 //Product sevar_gmaps, Vara 1 km
 radar_products['sevar_gmaps'] = new RadarProduct;
index 790caee..856ab2d 100644 (file)
@@ -1,6 +1,6 @@
 /** \page req Requirements
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 \li \ref req_hw
 \li \ref req_nw
index 58ba193..bfe6d9d 100644 (file)
@@ -1,13 +1,13 @@
 /** \page secure Security in BALTRAD
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 The BALTRAD system communicates with other nodes securely, and the
-web-based user interface is also secure, even though the URI prefix is
-"http" instead of "https". When the node is installed, security mechanisms
-are established that are fundamental for maintaining safe operations. This
-chapter is devited to explaining how it works and what steps you need to
-take.
+web-based user interface is also secure - sensitive data is encrypted before
+sending from the browser to server by means of HTTPS protocol.
+When the node is installed, security mechanisms are established that are 
+fundamental for maintaining safe operations. This chapter is devited to 
+explaining how it works and what steps you need to take.
 
 \li \ref sec_how
 \li \ref sec_in
@@ -38,12 +38,11 @@ a node from being spammed with messages from unknown sources.
 There are different user types in the system, each with its own
 privilages. These are presented below in \ref sec_usr.
 
-Encryption is currently not implemented in BALTRAD, although the signatures
-are encrypted in all messages. All passwords are also encrypted when you
-log into a BALTRAD node using the web-based interface. While some countries
-have officially banned the use of encryption, we will be addressing
-encryption in the BALTRAD+ project as an option for those who want or need
-it.
+Encryption is currently applied to communcication between local host (browser)
+and the server (BALTRAD node). To achieve this, HTTPS protocol is used with 
+SSL encryption. Note that for the sake of efficiency, only the sensitive parts 
+(usually forms with passwords and unique names) of user interface have been 
+secured with SSL.  
 
 \section sec_in Default key configuration
 When the BALTRAD node is installed, a so-called \a keystore is created
@@ -110,35 +109,39 @@ Remember to keep your private key (at /path/to/your/key) secret and safe!
 
 \section sec_ex Exchanging keys with other nodes
 In order to connect to another node, and subsequently subscribe to data
-from it, you must exchange public keys with that node. The process is
-manual for the time being, not automatic, although we are working on an
-automated procedure.
-
-Assuming your keystore is located in the directory
-<tt>$prefix/etc/bltnode-keys</tt> directory, your public key is found
-in the subdirectory called \c $DEX_NODENAME.pub. That means if your node
-name is \c se.smhi.balthazar, then your public key will be found in the
-directory called \c se.smhi.balthazar.pub. There are two inside
-this subdirectory, one called \c "1" and the other called \c "meta". These
-two files are your public key.
-
-It is up to you to figure out the best way to communicate the contents of
-these two files to the node with which you want to connect. Do this in
-agreement with the administrator of the other node. Practices and policies
-will be different in different places, but the two most realistic methods
-are e-mail and the use of third-party certificate authorities.
-
-If you decide transmit your public key electronically, which is a
-reasonable assumption, you can decide to pack it, e.g.
-\verbatim
-[bltnode-keys]$ tar cvzf se.smhi.balthazar.tgz se.smhi.balthazar.pub 
-\endverbatim
-Then transmit this file to the remote node's administrator. Upon safe
-reception, it is unpacked in the equivalent location:
-\verbatim
-[bltnode-keys]$ tar xvzf se.smhi.balthazar.tgz se.smhi.balthazar.pub
-\endverbatim
-You are now able to connect to the other node.
+from it, you must exchange public keys with that node. To achieve this, select
+"Connect" option from main menu's "Exchange" section. 
+Type in peer node's URL address in "Enter URL address section". Remember to 
+provide fully qualified address including port number as in the example 
+screenshot below.
+
+\image html key_exchange.png
+
+Next, send your public key to the peer node by clicking "Send key" button. 
+Assuming that peer node has successfully received the key, you will see the 
+following message box:
+
+\image html key_exchange_msg.png 
+
+Now, the recipient has to approve the key in order to allow its peer to make 
+connections to their node. It is done by selecting "Keystore" option from 
+the "Settings" section in the main menu. The option allows to access the 
+keystore and to grant or revoke access for the selected keys, as shown in the
+image below. 
+
+\image html key_exchange_keystore.png
+
+Note that the keys are named after the submitting nodes for clarity.
+In order to grant access for the key "baltrad.eu", click red icon located in 
+the "Access" column next to it. Once clicked, the icon will turn blue and 
+baltrad.eu will be able to connect to local node. In order to revoke access, 
+click the blue icon in "Access" column. Use "Delete" buttons in order to
+permanently remove the key. 
+
+\note
+Note that the same steps have to be taken by the peer node (that is the peer
+node has to submit its public key) in order to establish two-way communication.
+\endnote
 
 \section sec_usr Users types, their roles and privileges
 This section is not related to those above. There are different types of
@@ -159,6 +162,10 @@ includes data browsing, data preview, and system log inspection.</td></tr>
 <tr><td>peer</td> <td>This role is reserved for data exchange only. A peer
 accounts cannot be created locally, it is established automatically upon
 first successful connection from a remote node.</td></tr>
+<tr><td>node</td> <td>This role is not available for user accounts, although 
+it is used in communication between the nodes. The "node" account is 
+established during installation. The user account with role "node" always takes 
+its name from the node itself. </td></tr>
 </table>
 \endhtmlonly
 
@@ -167,22 +174,21 @@ This is the first step towards being able to exchange data. Once two nodes
 have exchanged public keys (see above), they will be allowed to connect to
 each other for the first time.
 
-In the web-based user interface, go to "Exchange" --> "Connect". In the
-"Define new connection" field, type the complete URI to the remote node,
-e.g. <tt>http://balthazar.smhi.se:8080/BaltradDex/dispatch.htm</tt> and
+In the web-based user interface, from the exchange section of the main menu,
+select "Connect" item. In the "Enter URL address" field, type the complete URI 
+to the remote node, e.g. <tt>http://balthazar.smhi.se:8080</tt> and
 then press the "Connect" button.
 
 This authentication-by-connection must have been done by both nodes
 before either of the nodes can subscribe to any data!
 
-You should be greeted by a simple page confirming that you have succeeded
-and that the next step is for the remote admin to enable you to subscribe
-to the data sources on that node:
-\verbatim
-Data source list is empty. Ask remote node's administrator to make data
-sources available for you.
-\endverbatim
-This was described in \ref con_ds. The
+You should be greeted by a simple page confirming that you have succeeded, as
+shown below.
+
+\image html connect.png
+
+The next step is for the remote admin to enable you to subscribe
+to the data sources on that node: This was described in \ref con_ds. The
 only difference is that the remote node's admin will "Edit" an existing
 data source by adding your peer user to it, if this data source doesn't
 already exist. Remember, \b don't subscribe to anything until both sides
index f76c723..b860208 100644 (file)
@@ -1,6 +1,6 @@
 /** \page subscribe Exchanging data
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 In BALTRAD, you control \b who is allowed access to \b what. We recognize
 that we live in an international world where we benefit from exchanging
@@ -40,7 +40,8 @@ In the web-based user interface, go to "Exchange" --> "Connect", and this
 time select from the drop-down list under "Select connection". The remote
 node's name should appear in this list. Select it and press the "Connect"
 button. In the following example, the node has connected to a node called
-"Sweden" that has allowed us to subscribe to polar scans from a Swedish radar.
+"baltrad2.imgw.pl" that has allowed us to subscribe to polar volumes from a 
+Polish radar called Pastewnik.
 \image html subscribe_list.png
 Check the "Select" box and then the "OK" button, you confirm, and that's
 it. You've subscribed.
@@ -50,11 +51,10 @@ overall list of subscriptions.
 
 \section sub_mnr Managing your subscriptions on remote nodes
 Once you have connected to a remote node and subscribed to data, you cannot
-resubscribe to the same data. Trying to do this will result in an error
-message. Instead, the way to cancel a subscription is to go to "Exchange"
---> "Subscriptions" and uncheck the box of the catalog entry you no longer
-want. That will result in your node telling the remote one to stop sending
-those data.
+resubscribe to the same data. In order to cancel a subscription, go to 
+"Exchange" --> "Subscriptions" and uncheck the box of the catalog entry you no 
+longer want. That will result in your node telling the remote one to stop 
+sending those data.
 
 If you accidently clear the database table containing your subscriptions to
 data from remote nodes, then you will have the unusual situation where you
@@ -72,8 +72,8 @@ the database table is reinstalled on a remote node that contained
 subscriptions to your node's data. In these circumstances, your node may be
 sending data to the remote node, and the remote node can't resubscribe
 because your node already has a record of that subscription. It is then
-advisable to go to "Settings" --> "Subscriptions" --> "Upload" and remove
-any "ghost" subscriptions.
+advisable to go to "Settings" --> "Subscriptions" --> "Remove uploads" 
+and remove any "ghost" subscriptions.
 
 If you haven't seen to it already, now would be a good time to \ref con_clean.
 
index 367e706..d6d0222 100644 (file)
@@ -1,6 +1,6 @@
 /** \page ug User Guide
-\date January 2012
-\version 1.0
+\date October 2013
+\version 1.1
 
 Welcome to the BALTRAD User Guide. This documentation is designed
 to assist you with the most common tasks you undertake with BALTRAD
index 413c67b..bd17140 100644 (file)
Binary files a/images/bdb_age.png and b/images/bdb_age.png differ
index 15c6d95..3dc95fe 100644 (file)
Binary files a/images/bdb_age_sched.png and b/images/bdb_age_sched.png differ
diff --git a/images/connect.png b/images/connect.png
new file mode 100644 (file)
index 0000000..2a2dac2
Binary files /dev/null and b/images/connect.png differ
diff --git a/images/data_source_add.png b/images/data_source_add.png
new file mode 100644 (file)
index 0000000..3022216
Binary files /dev/null and b/images/data_source_add.png differ
diff --git a/images/data_source_name.png b/images/data_source_name.png
deleted file mode 100644 (file)
index c4246c3..0000000
Binary files a/images/data_source_name.png and /dev/null differ
diff --git a/images/data_source_object.png b/images/data_source_object.png
deleted file mode 100644 (file)
index 80c34b7..0000000
Binary files a/images/data_source_object.png and /dev/null differ
diff --git a/images/data_source_radar.png b/images/data_source_radar.png
deleted file mode 100644 (file)
index 96140de..0000000
Binary files a/images/data_source_radar.png and /dev/null differ
diff --git a/images/data_source_summary.png b/images/data_source_summary.png
deleted file mode 100644 (file)
index 89699fc..0000000
Binary files a/images/data_source_summary.png and /dev/null differ
diff --git a/images/data_source_user.png b/images/data_source_user.png
deleted file mode 100644 (file)
index 2a7d726..0000000
Binary files a/images/data_source_user.png and /dev/null differ
index 501624e..eb293f1 100644 (file)
Binary files a/images/distr_route.png and b/images/distr_route.png differ
index 8a07081..bfd8ae0 100644 (file)
Binary files a/images/dr_conf.png and b/images/dr_conf.png differ
diff --git a/images/key_exchange.png b/images/key_exchange.png
new file mode 100644 (file)
index 0000000..4e47d5b
Binary files /dev/null and b/images/key_exchange.png differ
diff --git a/images/key_exchange_keystore.png b/images/key_exchange_keystore.png
new file mode 100644 (file)
index 0000000..5b9763a
Binary files /dev/null and b/images/key_exchange_keystore.png differ
diff --git a/images/key_exchange_msg.png b/images/key_exchange_msg.png
new file mode 100644 (file)
index 0000000..7237ad3
Binary files /dev/null and b/images/key_exchange_msg.png differ
index 28627a8..37c4a40 100644 (file)
Binary files a/images/login_page.png and b/images/login_page.png differ
index c5fd516..a855b63 100644 (file)
Binary files a/images/logs_conf.png and b/images/logs_conf.png differ
index a45e7c9..d885747 100644 (file)
Binary files a/images/pgf_adapter.png and b/images/pgf_adapter.png differ
index 0171938..0ffa827 100644 (file)
Binary files a/images/pgf_comp.png and b/images/pgf_comp.png differ
index 651916a..542e693 100644 (file)
Binary files a/images/pgf_cqc.png and b/images/pgf_cqc.png differ
diff --git a/images/pgf_gm.png b/images/pgf_gm.png
new file mode 100644 (file)
index 0000000..57260d4
Binary files /dev/null and b/images/pgf_gm.png differ
diff --git a/images/pgf_gmscript.png b/images/pgf_gmscript.png
deleted file mode 100644 (file)
index f18c2ca..0000000
Binary files a/images/pgf_gmscript.png and /dev/null differ
index 324b779..43f1772 100644 (file)
Binary files a/images/pgf_vol.png and b/images/pgf_vol.png differ
diff --git a/images/radars_add.png b/images/radars_add.png
new file mode 100644 (file)
index 0000000..1fa7841
Binary files /dev/null and b/images/radars_add.png differ
index 93da6fa..b3f26a5 100644 (file)
Binary files a/images/subscribe_list.png and b/images/subscribe_list.png differ