improved documentation about connectorRISdump

config.yml.example

@@ -12,8 +12,8 @@ connectors:
         socketOptions:
           includeRaw: false
 
-  - file: connectorRISDump
+#  - file: connectorRISDump
-    name: dmp
+#    name: dmp
 
 monitors:
   - file: monitorHijack

docs/configuration.md

@@ -133,7 +133,14 @@ Parameters for this connector module:
 |perMessageDeflate| Enable gzip compression on the connection. |
 
 #### connectorRISDump
-It connects to the RIPEstat's BGPlay API and retrieves a RIS dump about the monitored resources. The retrieved dump is 2 hours old, due to limitations on the API side.
+It connects to the RIPEstat's BGPlay API and retrieves a RIS dump about the monitored resources. The retrieved dump is 2 hours old, due to limitations on the API side. 
+
+Without this connector, when you start BGPalerter the monitoring will start based on new BGP updates. This means that you will not receive alerts before a new BGP update is propagated; e.g., if one of your prefixes is already hijacked when you start BGPalerter, you will not get notified immediately.
+
+This connector runs only in the two following conditions:
+- you enable it in the config.yml (commented out by default);
+- you didn't start BGPalerter in the last two hours.
+
 
 #### connectorTest
 

docs/rpki.md

@@ -116,3 +116,17 @@ You can use any of the RPKI validator that support JSON as output format to gene
     ```
     
 > Please, help with other examples    
+
+
+### Staging/testing ROAs
+You can use BGPalerter to test ROAs before deploying them for real.
+
+How:
+- enable [connectorRISDump](configuration.md#connectorrisdump) (optional but useful);
+- add the "ROA" in the VRP file using the JSON format described above;
+- be sure there is a prefix rule in config.yml covering the prefix of the ROA;
+- leave BGPalerter on for some time.
+
+You will get notified if your new staged roa conflicts with what announced at the BGP level.
+If you are starting BGPalerter after you already created the VRP file, by enabling connectorRISDump you would be able to get an immediate feedback based on a BGP dump. In any case, new BGP updates are going to be processed in real-time and compared with the VRP file provided.
+

src/config/config.js

@@ -24,10 +24,10 @@ export default class Config {
                         }
                     }
                 },
-                {
+                // {
-                    file: "connectorRISDump",
+                //     file: "connectorRISDump",
-                    name: "dmp"
+                //     name: "dmp"
-                }
+                // }
             ],
             monitors: [
                 {