From 1f75ecd9bc47c12a3c1596497dfaa621a2d16103 Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Mon, 8 Aug 2016 17:30:58 -0400 Subject: Move old manual to doc/manual, to make it easier to find other documentation. --- doc/00.RPKI.md | 41 -- doc/00.RPKI.wiki | 39 -- doc/01.RPKI.Installation.md | 47 -- doc/01.RPKI.Installation.wiki | 38 -- doc/02.RPKI.Installation.DebianPackages.md | 66 -- doc/02.RPKI.Installation.DebianPackages.wiki | 90 --- doc/03.RPKI.Installation.FreeBSDPorts.md | 68 -- doc/03.RPKI.Installation.FreeBSDPorts.wiki | 124 ---- doc/04.RPKI.Installation.FromSource.md | 208 ------- doc/04.RPKI.Installation.FromSource.wiki | 297 --------- doc/05.RPKI.RP.md | 78 --- doc/05.RPKI.RP.wiki | 81 --- doc/06.RPKI.RP.rcynic.md | 624 ------------------- doc/06.RPKI.RP.rcynic.wiki | 690 --------------------- doc/07.RPKI.RP.rpki-rtr.md | 150 ----- doc/07.RPKI.RP.rpki-rtr.wiki | 213 ------- doc/08.RPKI.RP.RunningUnderCron.md | 61 -- doc/08.RPKI.RP.RunningUnderCron.wiki | 72 --- doc/09.RPKI.RP.HierarchicalRsync.md | 88 --- doc/09.RPKI.RP.HierarchicalRsync.wiki | 103 --- doc/10.RPKI.RP.rcynicChroot.md | 161 ----- doc/10.RPKI.RP.rcynicChroot.wiki | 214 ------- doc/11.RPKI.CA.md | 242 -------- doc/11.RPKI.CA.wiki | 264 -------- doc/12.RPKI.CA.Configuration.md | 192 ------ doc/12.RPKI.CA.Configuration.wiki | 263 -------- doc/13.RPKI.CA.Configuration.Common.md | 71 --- doc/13.RPKI.CA.Configuration.Common.wiki | 63 -- doc/14.RPKI.CA.Configuration.myrpki.md | 295 --------- doc/14.RPKI.CA.Configuration.myrpki.wiki | 413 ------------ doc/15.RPKI.CA.Configuration.rpkid.md | 80 --- doc/15.RPKI.CA.Configuration.rpkid.wiki | 129 ---- doc/16.RPKI.CA.Configuration.irdbd.md | 47 -- doc/16.RPKI.CA.Configuration.irdbd.wiki | 76 --- doc/17.RPKI.CA.Configuration.pubd.md | 76 --- doc/17.RPKI.CA.Configuration.pubd.wiki | 123 ---- doc/18.RPKI.CA.Configuration.rootd.md | 145 ----- doc/18.RPKI.CA.Configuration.rootd.wiki | 216 ------- doc/19.RPKI.CA.Configuration.CreatingRoot.md | 123 ---- doc/19.RPKI.CA.Configuration.CreatingRoot.wiki | 143 ----- doc/20.RPKI.CA.Configuration.web_portal.md | 47 -- doc/20.RPKI.CA.Configuration.web_portal.wiki | 73 --- doc/21.RPKI.CA.Configuration.autoconf.md | 29 - doc/21.RPKI.CA.Configuration.autoconf.wiki | 43 -- doc/22.RPKI.CA.Configuration.Tests.md | 108 ---- doc/22.RPKI.CA.Configuration.Tests.wiki | 102 --- doc/23.RPKI.CA.Configuration.DifferentServer.md | 37 -- doc/23.RPKI.CA.Configuration.DifferentServer.wiki | 69 --- doc/24.RPKI.CA.MySQLSetup.md | 65 -- doc/24.RPKI.CA.MySQLSetup.wiki | 73 --- doc/25.RPKI.CA.OOBSetup.md | 4 - doc/25.RPKI.CA.OOBSetup.wiki | 6 - doc/26.RPKI.CA.UI.md | 107 ---- doc/26.RPKI.CA.UI.wiki | 177 ------ doc/27.RPKI.CA.UI.rpkic.md | 86 --- doc/27.RPKI.CA.UI.rpkic.wiki | 105 ---- doc/28.RPKI.CA.UI.GUI.00.jpg | Bin 18883 -> 0 bytes doc/28.RPKI.CA.UI.GUI.01.jpg | Bin 26282 -> 0 bytes doc/28.RPKI.CA.UI.GUI.02.jpg | Bin 15759 -> 0 bytes doc/28.RPKI.CA.UI.GUI.03.jpg | Bin 23814 -> 0 bytes doc/28.RPKI.CA.UI.GUI.04.jpg | Bin 32473 -> 0 bytes doc/28.RPKI.CA.UI.GUI.05.jpg | Bin 15774 -> 0 bytes doc/28.RPKI.CA.UI.GUI.06.jpg | Bin 19565 -> 0 bytes doc/28.RPKI.CA.UI.GUI.md | 52 -- doc/28.RPKI.CA.UI.GUI.wiki | 47 -- doc/29.RPKI.CA.UI.GUI.Installing.md | 41 -- doc/29.RPKI.CA.UI.GUI.Installing.wiki | 34 - doc/30.RPKI.CA.UI.GUI.Upgrading.md | 40 -- doc/30.RPKI.CA.UI.GUI.Upgrading.wiki | 36 -- doc/31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.md | 78 --- ...1.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.wiki | 71 --- doc/32.RPKI.CA.UI.GUI.Configuring.md | 89 --- doc/32.RPKI.CA.UI.GUI.Configuring.wiki | 65 -- doc/33.RPKI.CA.UI.GUI.Configuring.Apache.md | 85 --- doc/33.RPKI.CA.UI.GUI.Configuring.Apache.wiki | 79 --- doc/34.RPKI.CA.UI.GUI.UserModel.md | 130 ---- doc/34.RPKI.CA.UI.GUI.UserModel.wiki | 93 --- doc/35.RPKI.CA.Protocols.LeftRight.md | 486 --------------- doc/35.RPKI.CA.Protocols.LeftRight.wiki | 473 -------------- doc/36.RPKI.Utils.md | 182 ------ doc/36.RPKI.Utils.wiki | 179 ------ doc/37.RPKI.Protocols.md | 9 - doc/37.RPKI.Protocols.wiki | 8 - doc/38.RPKI.Protocols.OOB.00.svg | 321 ---------- doc/38.RPKI.Protocols.OOB.md | 15 - doc/38.RPKI.Protocols.OOB.wiki | 15 - doc/38.RPKI.Protocols.OOB.zip | Bin 4627 -> 0 bytes doc/39.RPKI.Protocols.Up-Down.00.svg | 305 --------- doc/39.RPKI.Protocols.Up-Down.md | 8 - doc/39.RPKI.Protocols.Up-Down.wiki | 8 - doc/39.RPKI.Protocols.Up-Down.zip | Bin 4295 -> 0 bytes doc/README | 34 - doc/README.md | 30 + doc/manual/00.RPKI.md | 41 ++ doc/manual/00.RPKI.wiki | 39 ++ doc/manual/01.RPKI.Installation.md | 47 ++ doc/manual/01.RPKI.Installation.wiki | 38 ++ doc/manual/02.RPKI.Installation.DebianPackages.md | 66 ++ .../02.RPKI.Installation.DebianPackages.wiki | 90 +++ doc/manual/03.RPKI.Installation.FreeBSDPorts.md | 68 ++ doc/manual/03.RPKI.Installation.FreeBSDPorts.wiki | 124 ++++ doc/manual/04.RPKI.Installation.FromSource.md | 208 +++++++ doc/manual/04.RPKI.Installation.FromSource.wiki | 297 +++++++++ doc/manual/05.RPKI.RP.md | 78 +++ doc/manual/05.RPKI.RP.wiki | 81 +++ doc/manual/06.RPKI.RP.rcynic.md | 624 +++++++++++++++++++ doc/manual/06.RPKI.RP.rcynic.wiki | 690 +++++++++++++++++++++ doc/manual/07.RPKI.RP.rpki-rtr.md | 150 +++++ doc/manual/07.RPKI.RP.rpki-rtr.wiki | 213 +++++++ doc/manual/08.RPKI.RP.RunningUnderCron.md | 61 ++ doc/manual/08.RPKI.RP.RunningUnderCron.wiki | 72 +++ doc/manual/09.RPKI.RP.HierarchicalRsync.md | 88 +++ doc/manual/09.RPKI.RP.HierarchicalRsync.wiki | 103 +++ doc/manual/10.RPKI.RP.rcynicChroot.md | 161 +++++ doc/manual/10.RPKI.RP.rcynicChroot.wiki | 214 +++++++ doc/manual/11.RPKI.CA.md | 242 ++++++++ doc/manual/11.RPKI.CA.wiki | 264 ++++++++ doc/manual/12.RPKI.CA.Configuration.md | 192 ++++++ doc/manual/12.RPKI.CA.Configuration.wiki | 263 ++++++++ doc/manual/13.RPKI.CA.Configuration.Common.md | 71 +++ doc/manual/13.RPKI.CA.Configuration.Common.wiki | 63 ++ doc/manual/14.RPKI.CA.Configuration.myrpki.md | 295 +++++++++ doc/manual/14.RPKI.CA.Configuration.myrpki.wiki | 413 ++++++++++++ doc/manual/15.RPKI.CA.Configuration.rpkid.md | 80 +++ doc/manual/15.RPKI.CA.Configuration.rpkid.wiki | 129 ++++ doc/manual/16.RPKI.CA.Configuration.irdbd.md | 47 ++ doc/manual/16.RPKI.CA.Configuration.irdbd.wiki | 76 +++ doc/manual/17.RPKI.CA.Configuration.pubd.md | 76 +++ doc/manual/17.RPKI.CA.Configuration.pubd.wiki | 123 ++++ doc/manual/18.RPKI.CA.Configuration.rootd.md | 145 +++++ doc/manual/18.RPKI.CA.Configuration.rootd.wiki | 216 +++++++ .../19.RPKI.CA.Configuration.CreatingRoot.md | 123 ++++ .../19.RPKI.CA.Configuration.CreatingRoot.wiki | 143 +++++ doc/manual/20.RPKI.CA.Configuration.web_portal.md | 47 ++ .../20.RPKI.CA.Configuration.web_portal.wiki | 73 +++ doc/manual/21.RPKI.CA.Configuration.autoconf.md | 29 + doc/manual/21.RPKI.CA.Configuration.autoconf.wiki | 43 ++ doc/manual/22.RPKI.CA.Configuration.Tests.md | 108 ++++ doc/manual/22.RPKI.CA.Configuration.Tests.wiki | 102 +++ .../23.RPKI.CA.Configuration.DifferentServer.md | 37 ++ .../23.RPKI.CA.Configuration.DifferentServer.wiki | 69 +++ doc/manual/24.RPKI.CA.MySQLSetup.md | 65 ++ doc/manual/24.RPKI.CA.MySQLSetup.wiki | 73 +++ doc/manual/25.RPKI.CA.OOBSetup.md | 4 + doc/manual/25.RPKI.CA.OOBSetup.wiki | 6 + doc/manual/26.RPKI.CA.UI.md | 107 ++++ doc/manual/26.RPKI.CA.UI.wiki | 177 ++++++ doc/manual/27.RPKI.CA.UI.rpkic.md | 86 +++ doc/manual/27.RPKI.CA.UI.rpkic.wiki | 105 ++++ doc/manual/28.RPKI.CA.UI.GUI.00.jpg | Bin 0 -> 18883 bytes doc/manual/28.RPKI.CA.UI.GUI.01.jpg | Bin 0 -> 26282 bytes doc/manual/28.RPKI.CA.UI.GUI.02.jpg | Bin 0 -> 15759 bytes doc/manual/28.RPKI.CA.UI.GUI.03.jpg | Bin 0 -> 23814 bytes doc/manual/28.RPKI.CA.UI.GUI.04.jpg | Bin 0 -> 32473 bytes doc/manual/28.RPKI.CA.UI.GUI.05.jpg | Bin 0 -> 15774 bytes doc/manual/28.RPKI.CA.UI.GUI.06.jpg | Bin 0 -> 19565 bytes doc/manual/28.RPKI.CA.UI.GUI.md | 52 ++ doc/manual/28.RPKI.CA.UI.GUI.wiki | 47 ++ doc/manual/29.RPKI.CA.UI.GUI.Installing.md | 41 ++ doc/manual/29.RPKI.CA.UI.GUI.Installing.wiki | 34 + doc/manual/30.RPKI.CA.UI.GUI.Upgrading.md | 40 ++ doc/manual/30.RPKI.CA.UI.GUI.Upgrading.wiki | 36 ++ .../31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.md | 78 +++ ...1.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.wiki | 71 +++ doc/manual/32.RPKI.CA.UI.GUI.Configuring.md | 89 +++ doc/manual/32.RPKI.CA.UI.GUI.Configuring.wiki | 65 ++ doc/manual/33.RPKI.CA.UI.GUI.Configuring.Apache.md | 85 +++ .../33.RPKI.CA.UI.GUI.Configuring.Apache.wiki | 79 +++ doc/manual/34.RPKI.CA.UI.GUI.UserModel.md | 130 ++++ doc/manual/34.RPKI.CA.UI.GUI.UserModel.wiki | 93 +++ doc/manual/35.RPKI.CA.Protocols.LeftRight.md | 486 +++++++++++++++ doc/manual/35.RPKI.CA.Protocols.LeftRight.wiki | 473 ++++++++++++++ doc/manual/36.RPKI.Utils.md | 182 ++++++ doc/manual/36.RPKI.Utils.wiki | 179 ++++++ doc/manual/37.RPKI.Protocols.md | 9 + doc/manual/37.RPKI.Protocols.wiki | 8 + doc/manual/38.RPKI.Protocols.OOB.00.svg | 321 ++++++++++ doc/manual/38.RPKI.Protocols.OOB.md | 15 + doc/manual/38.RPKI.Protocols.OOB.wiki | 15 + doc/manual/38.RPKI.Protocols.OOB.zip | Bin 0 -> 4627 bytes doc/manual/39.RPKI.Protocols.Up-Down.00.svg | 305 +++++++++ doc/manual/39.RPKI.Protocols.Up-Down.md | 8 + doc/manual/39.RPKI.Protocols.Up-Down.wiki | 8 + doc/manual/39.RPKI.Protocols.Up-Down.zip | Bin 0 -> 4295 bytes doc/manual/README | 34 + doc/manual/pubd-bpki.dot | 42 ++ doc/manual/rpki-wiki-to-markdown.py | 341 ++++++++++ doc/manual/rpkid-bpki.dot | 76 +++ doc/pubd-bpki.dot | 42 -- doc/rpki-wiki-to-markdown.py | 341 ---------- doc/rpkid-bpki.dot | 76 --- 191 files changed, 11117 insertions(+), 11087 deletions(-) delete mode 100644 doc/00.RPKI.md delete mode 100644 doc/00.RPKI.wiki delete mode 100644 doc/01.RPKI.Installation.md delete mode 100644 doc/01.RPKI.Installation.wiki delete mode 100644 doc/02.RPKI.Installation.DebianPackages.md delete mode 100644 doc/02.RPKI.Installation.DebianPackages.wiki delete mode 100644 doc/03.RPKI.Installation.FreeBSDPorts.md delete mode 100644 doc/03.RPKI.Installation.FreeBSDPorts.wiki delete mode 100644 doc/04.RPKI.Installation.FromSource.md delete mode 100644 doc/04.RPKI.Installation.FromSource.wiki delete mode 100644 doc/05.RPKI.RP.md delete mode 100644 doc/05.RPKI.RP.wiki delete mode 100644 doc/06.RPKI.RP.rcynic.md delete mode 100644 doc/06.RPKI.RP.rcynic.wiki delete mode 100644 doc/07.RPKI.RP.rpki-rtr.md delete mode 100644 doc/07.RPKI.RP.rpki-rtr.wiki delete mode 100644 doc/08.RPKI.RP.RunningUnderCron.md delete mode 100644 doc/08.RPKI.RP.RunningUnderCron.wiki delete mode 100644 doc/09.RPKI.RP.HierarchicalRsync.md delete mode 100644 doc/09.RPKI.RP.HierarchicalRsync.wiki delete mode 100644 doc/10.RPKI.RP.rcynicChroot.md delete mode 100644 doc/10.RPKI.RP.rcynicChroot.wiki delete mode 100644 doc/11.RPKI.CA.md delete mode 100644 doc/11.RPKI.CA.wiki delete mode 100644 doc/12.RPKI.CA.Configuration.md delete mode 100644 doc/12.RPKI.CA.Configuration.wiki delete mode 100644 doc/13.RPKI.CA.Configuration.Common.md delete mode 100644 doc/13.RPKI.CA.Configuration.Common.wiki delete mode 100644 doc/14.RPKI.CA.Configuration.myrpki.md delete mode 100644 doc/14.RPKI.CA.Configuration.myrpki.wiki delete mode 100644 doc/15.RPKI.CA.Configuration.rpkid.md delete mode 100644 doc/15.RPKI.CA.Configuration.rpkid.wiki delete mode 100644 doc/16.RPKI.CA.Configuration.irdbd.md delete mode 100644 doc/16.RPKI.CA.Configuration.irdbd.wiki delete mode 100644 doc/17.RPKI.CA.Configuration.pubd.md delete mode 100644 doc/17.RPKI.CA.Configuration.pubd.wiki delete mode 100644 doc/18.RPKI.CA.Configuration.rootd.md delete mode 100644 doc/18.RPKI.CA.Configuration.rootd.wiki delete mode 100644 doc/19.RPKI.CA.Configuration.CreatingRoot.md delete mode 100644 doc/19.RPKI.CA.Configuration.CreatingRoot.wiki delete mode 100644 doc/20.RPKI.CA.Configuration.web_portal.md delete mode 100644 doc/20.RPKI.CA.Configuration.web_portal.wiki delete mode 100644 doc/21.RPKI.CA.Configuration.autoconf.md delete mode 100644 doc/21.RPKI.CA.Configuration.autoconf.wiki delete mode 100644 doc/22.RPKI.CA.Configuration.Tests.md delete mode 100644 doc/22.RPKI.CA.Configuration.Tests.wiki delete mode 100644 doc/23.RPKI.CA.Configuration.DifferentServer.md delete mode 100644 doc/23.RPKI.CA.Configuration.DifferentServer.wiki delete mode 100644 doc/24.RPKI.CA.MySQLSetup.md delete mode 100644 doc/24.RPKI.CA.MySQLSetup.wiki delete mode 100644 doc/25.RPKI.CA.OOBSetup.md delete mode 100644 doc/25.RPKI.CA.OOBSetup.wiki delete mode 100644 doc/26.RPKI.CA.UI.md delete mode 100644 doc/26.RPKI.CA.UI.wiki delete mode 100644 doc/27.RPKI.CA.UI.rpkic.md delete mode 100644 doc/27.RPKI.CA.UI.rpkic.wiki delete mode 100644 doc/28.RPKI.CA.UI.GUI.00.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.01.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.02.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.03.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.04.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.05.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.06.jpg delete mode 100644 doc/28.RPKI.CA.UI.GUI.md delete mode 100644 doc/28.RPKI.CA.UI.GUI.wiki delete mode 100644 doc/29.RPKI.CA.UI.GUI.Installing.md delete mode 100644 doc/29.RPKI.CA.UI.GUI.Installing.wiki delete mode 100644 doc/30.RPKI.CA.UI.GUI.Upgrading.md delete mode 100644 doc/30.RPKI.CA.UI.GUI.Upgrading.wiki delete mode 100644 doc/31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.md delete mode 100644 doc/31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.wiki delete mode 100644 doc/32.RPKI.CA.UI.GUI.Configuring.md delete mode 100644 doc/32.RPKI.CA.UI.GUI.Configuring.wiki delete mode 100644 doc/33.RPKI.CA.UI.GUI.Configuring.Apache.md delete mode 100644 doc/33.RPKI.CA.UI.GUI.Configuring.Apache.wiki delete mode 100644 doc/34.RPKI.CA.UI.GUI.UserModel.md delete mode 100644 doc/34.RPKI.CA.UI.GUI.UserModel.wiki delete mode 100644 doc/35.RPKI.CA.Protocols.LeftRight.md delete mode 100644 doc/35.RPKI.CA.Protocols.LeftRight.wiki delete mode 100644 doc/36.RPKI.Utils.md delete mode 100644 doc/36.RPKI.Utils.wiki delete mode 100644 doc/37.RPKI.Protocols.md delete mode 100644 doc/37.RPKI.Protocols.wiki delete mode 100644 doc/38.RPKI.Protocols.OOB.00.svg delete mode 100644 doc/38.RPKI.Protocols.OOB.md delete mode 100644 doc/38.RPKI.Protocols.OOB.wiki delete mode 100644 doc/38.RPKI.Protocols.OOB.zip delete mode 100644 doc/39.RPKI.Protocols.Up-Down.00.svg delete mode 100644 doc/39.RPKI.Protocols.Up-Down.md delete mode 100644 doc/39.RPKI.Protocols.Up-Down.wiki delete mode 100644 doc/39.RPKI.Protocols.Up-Down.zip delete mode 100644 doc/README create mode 100644 doc/README.md create mode 100644 doc/manual/00.RPKI.md create mode 100644 doc/manual/00.RPKI.wiki create mode 100644 doc/manual/01.RPKI.Installation.md create mode 100644 doc/manual/01.RPKI.Installation.wiki create mode 100644 doc/manual/02.RPKI.Installation.DebianPackages.md create mode 100644 doc/manual/02.RPKI.Installation.DebianPackages.wiki create mode 100644 doc/manual/03.RPKI.Installation.FreeBSDPorts.md create mode 100644 doc/manual/03.RPKI.Installation.FreeBSDPorts.wiki create mode 100644 doc/manual/04.RPKI.Installation.FromSource.md create mode 100644 doc/manual/04.RPKI.Installation.FromSource.wiki create mode 100644 doc/manual/05.RPKI.RP.md create mode 100644 doc/manual/05.RPKI.RP.wiki create mode 100644 doc/manual/06.RPKI.RP.rcynic.md create mode 100644 doc/manual/06.RPKI.RP.rcynic.wiki create mode 100644 doc/manual/07.RPKI.RP.rpki-rtr.md create mode 100644 doc/manual/07.RPKI.RP.rpki-rtr.wiki create mode 100644 doc/manual/08.RPKI.RP.RunningUnderCron.md create mode 100644 doc/manual/08.RPKI.RP.RunningUnderCron.wiki create mode 100644 doc/manual/09.RPKI.RP.HierarchicalRsync.md create mode 100644 doc/manual/09.RPKI.RP.HierarchicalRsync.wiki create mode 100644 doc/manual/10.RPKI.RP.rcynicChroot.md create mode 100644 doc/manual/10.RPKI.RP.rcynicChroot.wiki create mode 100644 doc/manual/11.RPKI.CA.md create mode 100644 doc/manual/11.RPKI.CA.wiki create mode 100644 doc/manual/12.RPKI.CA.Configuration.md create mode 100644 doc/manual/12.RPKI.CA.Configuration.wiki create mode 100644 doc/manual/13.RPKI.CA.Configuration.Common.md create mode 100644 doc/manual/13.RPKI.CA.Configuration.Common.wiki create mode 100644 doc/manual/14.RPKI.CA.Configuration.myrpki.md create mode 100644 doc/manual/14.RPKI.CA.Configuration.myrpki.wiki create mode 100644 doc/manual/15.RPKI.CA.Configuration.rpkid.md create mode 100644 doc/manual/15.RPKI.CA.Configuration.rpkid.wiki create mode 100644 doc/manual/16.RPKI.CA.Configuration.irdbd.md create mode 100644 doc/manual/16.RPKI.CA.Configuration.irdbd.wiki create mode 100644 doc/manual/17.RPKI.CA.Configuration.pubd.md create mode 100644 doc/manual/17.RPKI.CA.Configuration.pubd.wiki create mode 100644 doc/manual/18.RPKI.CA.Configuration.rootd.md create mode 100644 doc/manual/18.RPKI.CA.Configuration.rootd.wiki create mode 100644 doc/manual/19.RPKI.CA.Configuration.CreatingRoot.md create mode 100644 doc/manual/19.RPKI.CA.Configuration.CreatingRoot.wiki create mode 100644 doc/manual/20.RPKI.CA.Configuration.web_portal.md create mode 100644 doc/manual/20.RPKI.CA.Configuration.web_portal.wiki create mode 100644 doc/manual/21.RPKI.CA.Configuration.autoconf.md create mode 100644 doc/manual/21.RPKI.CA.Configuration.autoconf.wiki create mode 100644 doc/manual/22.RPKI.CA.Configuration.Tests.md create mode 100644 doc/manual/22.RPKI.CA.Configuration.Tests.wiki create mode 100644 doc/manual/23.RPKI.CA.Configuration.DifferentServer.md create mode 100644 doc/manual/23.RPKI.CA.Configuration.DifferentServer.wiki create mode 100644 doc/manual/24.RPKI.CA.MySQLSetup.md create mode 100644 doc/manual/24.RPKI.CA.MySQLSetup.wiki create mode 100644 doc/manual/25.RPKI.CA.OOBSetup.md create mode 100644 doc/manual/25.RPKI.CA.OOBSetup.wiki create mode 100644 doc/manual/26.RPKI.CA.UI.md create mode 100644 doc/manual/26.RPKI.CA.UI.wiki create mode 100644 doc/manual/27.RPKI.CA.UI.rpkic.md create mode 100644 doc/manual/27.RPKI.CA.UI.rpkic.wiki create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.00.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.01.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.02.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.03.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.04.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.05.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.06.jpg create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.md create mode 100644 doc/manual/28.RPKI.CA.UI.GUI.wiki create mode 100644 doc/manual/29.RPKI.CA.UI.GUI.Installing.md create mode 100644 doc/manual/29.RPKI.CA.UI.GUI.Installing.wiki create mode 100644 doc/manual/30.RPKI.CA.UI.GUI.Upgrading.md create mode 100644 doc/manual/30.RPKI.CA.UI.GUI.Upgrading.wiki create mode 100644 doc/manual/31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.md create mode 100644 doc/manual/31.RPKI.CA.UI.GUI.Upgrading.BeforeMigration.wiki create mode 100644 doc/manual/32.RPKI.CA.UI.GUI.Configuring.md create mode 100644 doc/manual/32.RPKI.CA.UI.GUI.Configuring.wiki create mode 100644 doc/manual/33.RPKI.CA.UI.GUI.Configuring.Apache.md create mode 100644 doc/manual/33.RPKI.CA.UI.GUI.Configuring.Apache.wiki create mode 100644 doc/manual/34.RPKI.CA.UI.GUI.UserModel.md create mode 100644 doc/manual/34.RPKI.CA.UI.GUI.UserModel.wiki create mode 100644 doc/manual/35.RPKI.CA.Protocols.LeftRight.md create mode 100644 doc/manual/35.RPKI.CA.Protocols.LeftRight.wiki create mode 100644 doc/manual/36.RPKI.Utils.md create mode 100644 doc/manual/36.RPKI.Utils.wiki create mode 100644 doc/manual/37.RPKI.Protocols.md create mode 100644 doc/manual/37.RPKI.Protocols.wiki create mode 100644 doc/manual/38.RPKI.Protocols.OOB.00.svg create mode 100644 doc/manual/38.RPKI.Protocols.OOB.md create mode 100644 doc/manual/38.RPKI.Protocols.OOB.wiki create mode 100644 doc/manual/38.RPKI.Protocols.OOB.zip create mode 100644 doc/manual/39.RPKI.Protocols.Up-Down.00.svg create mode 100644 doc/manual/39.RPKI.Protocols.Up-Down.md create mode 100644 doc/manual/39.RPKI.Protocols.Up-Down.wiki create mode 100644 doc/manual/39.RPKI.Protocols.Up-Down.zip create mode 100644 doc/manual/README create mode 100644 doc/manual/pubd-bpki.dot create mode 100644 doc/manual/rpki-wiki-to-markdown.py create mode 100644 doc/manual/rpkid-bpki.dot delete mode 100644 doc/pubd-bpki.dot delete mode 100644 doc/rpki-wiki-to-markdown.py delete mode 100644 doc/rpkid-bpki.dot diff --git a/doc/00.RPKI.md b/doc/00.RPKI.md deleted file mode 100644 index 30a830e1..00000000 --- a/doc/00.RPKI.md +++ /dev/null @@ -1,41 +0,0 @@ -# RPKI Tools Manual - -This collection of tools implements both the production (CA) and relying party -(RP) sides of an RPKI environment. - -Source code for the entire project is available on [GitHub][]. - -## Download and Install - -Full source code is available, as are binary packages for a few platforms. - -See the [installation instructions][Installation] for how -to download the code and install it once you've downloaded it. - -## Relying Party Tools - -If you operate routers and want to use RPKI data to help secure them, you -should look at the [relying party tools][RP]. - -## CA Tools - -If you control RPKI resources and need an engine let you request certificates, -issue ROAs, or issue certificates to other entities, you should look at the -[CA tools][CA]. - -## Thanks - -From 2006 through 2008, this work was funded by [ARIN][]. - -From 2009 through 2016, this work was funded by [DHS][]. - -Special thanks to Michael Elkins, who wrote the web GUI and generally -served as a second brain and second set of eyeballs on a long list of -thorny technical problems. - -[GitHub]: https://github.com/dragonresearch/rpki.net -[Installation]: 01.RPKI.Installation.md -[RP]: 05.RPKI.RP.md -[CA]: 11.RPKI.CA.md -[ARIN]: http://www.arin.net/ -[DHS]: http://www.dhs.gov/ diff --git a/doc/00.RPKI.wiki b/doc/00.RPKI.wiki deleted file mode 100644 index aaf59d4e..00000000 --- a/doc/00.RPKI.wiki +++ /dev/null @@ -1,39 +0,0 @@ -[[TracNav(doc/RPKI/TOC)]] -[[PageOutline]] - -= RPKI Tools Manual = - -This collection of tools implements both the production (CA) and -relying party (RP) sides of an RPKI environment. - -The Subversion repository for the entire project is available for -(read-only) anonymous access at https://subvert-rpki.hactrn.net/. - -If you just want to browse the code you might find the -[[http://trac.rpki.net/browser/|Trac source code browser interface]] -more convenient. - -== Download and Install == - -Full source code is available, as are binary packages for a few platforms. - -See the [[wiki:doc/RPKI/Installation|installation instructions]] for -how to download the code and install it once you've downloaded it. - -== Relying Party Tools == - -If you operate routers and want to use RPKI data to help secure them, -you should look at the [[./RP|relying party tools]]. - -== CA Tools == - -If you control RPKI resources and need an engine let you request -certificates, issue ROAs, or issue certificates to other entities, you -should look at the [[./CA|CA tools]]. - -== Thanks == - -This work was funded from 2006 through 2008 by -[[http://www.arin.net/|ARIN]], in collaboration with the other -Regional Internet Registries. Current work is funded by -[[http://www.dhs.gov/|DHS]]. diff --git a/doc/01.RPKI.Installation.md b/doc/01.RPKI.Installation.md deleted file mode 100644 index c530ee7e..00000000 --- a/doc/01.RPKI.Installation.md +++ /dev/null @@ -1,47 +0,0 @@ -# Download and Installation - -There are a few different ways to install the RPKI code, depending on what the -platform on which you're trying to install. - -## Debian and Ubuntu - -On Ubuntu 16.04 LTS ("Xenial") or Debian 8 ("Jessie"), you can use -[Debian binary packages][Debian]. - -## Simple RPKI Cache Install - -If you want to install a simple RPKI cache to feed routers from a Ubuntu 14.04 -system, here is a one page ten minute recipe. - -## Install a CA and a cache on a Ubuntu 14.04 with a rootd CA - -If you want to install a CA and a cache on a Ubuntu 14.04 with a rootd CA, -here is a one page hack. It will take less than an hour. - -## Try the rrdp testbed CA and RP on Ubuntu Xenial - -If you are feeling adventurous and want to try the rrdp testbed CA and RP on -Ubuntu Xenial 16.04 here is a one page hack. It supports a much simpler root -CA. - -## FreeBSD - -On FreeBSD, you can use [FreeBSD ports][FreeBSD]. - -## Other Platforms - -On all other platforms, or on the above platforms if the pre-packaged versions -don't suit your needs, you will have to -[install from source code][Source]. - -Once you've finished installing the code, you will need to configure it. Since -CAs are generally also relying parties (if only so that they can check the -results of their own actions), you will generally want to start by configuring -[the relying party tools][RP], then configure [the CA tools][CA] -if you're planning to use them. - -[Debian]: 02.RPKI.Installation.DebianPackages.md -[FreeBSD]: 03.RPKI.Installation.FreeBSDPorts.md -[Source]: 04.RPKI.Installation.FromSource.md -[RP]: 05.RPKI.RP.md -[CA]: 11.RPKI.CA.md diff --git a/doc/01.RPKI.Installation.wiki b/doc/01.RPKI.Installation.wiki deleted file mode 100644 index 89b9225b..00000000 --- a/doc/01.RPKI.Installation.wiki +++ /dev/null @@ -1,38 +0,0 @@ -[[PageOutline]] - -[[TracNav(doc/RPKI/TOC)]] - -= Download and Installation = - -There are a few different ways to install the RPKI code, depending on -what the platform on which you're trying to install. - -* On Ubuntu 12.04 LTS ("Precise Pangolin"), Ubuntu 14.04 ("Trusty Tahir"), or Debian 7 ("Wheezy"), you can use [wiki:doc/RPKI/Installation/DebianPackages Debian binary packages]. - -== Simple RPKI Cacha Install == - -if you want to install a simple RPKI cache to feed routers from a Ubuntu 14.04 system, [wiki:doc/RPKI/Installation/UbuntuRP here is a one page ten minute recipe]. - -== install a CA and a cache on a Ubuntu 14.04 with a rootd CA == - -If you want to install a CA and a cache on a Ubuntu 14.04 with a rootd CA, [wiki:doc/RPKI/Installation/UbuntuRootd here is a one page hack]. It will take less than an hour. - -== Try the rrdp testbed CA and RP on Ubuntu Xenial == - -If you are feeling adventurous and want to try the rrdp testbed CA and RP on Ubuntu Xenial 16.04 [wiki:RRDPtestbed here is a one page hack.] It supports a much simpler root CA. - -== FreeBSD == - -On FreeBSD, you can use [wiki:doc/RPKI/Installation/FreeBSDPorts FreeBSD ports]. - -== Other Platforms == - -On all other platforms, or on the above platforms if the -pre-packaged versions don't suit your needs, you will have to -[wiki:doc/RPKI/Installation/FromSource install from source code]. - -Once you've finished installing the code, you will need to configure -it. Since CAs are generally also relying parties (if only so that -they can check the results of their own actions), you will generally -want to start by configuring the [[RP|relying party tools]], then -configure the [[CA|CA tools]] if you're planning to use them. diff --git a/doc/02.RPKI.Installation.DebianPackages.md b/doc/02.RPKI.Installation.DebianPackages.md deleted file mode 100644 index 4ac60d65..00000000 --- a/doc/02.RPKI.Installation.DebianPackages.md +++ /dev/null @@ -1,66 +0,0 @@ -# Installation Using Debian Packages on Debian and Ubuntu Systems - -Precompiled binary packages for Ubuntu 12.04 LTS ("Precise Pangolin") and -Debian 7 ("Wheezy") are available from download.rpki.net using the Debian -Advanced Package Tools (APT). To use these, you need to configure APT on your -machine to know about our APT repository, but once you've done this you should -be able to install and update these packages like any other precompiled -package. - -## Initial APT Setup - -You should only need to perform these steps once for any particular machine. - - * Add the GPG public key for this repository (optional, but APT will whine unless you do this): - - wget -q -O - https://download.rpki.net/APT/apt-gpg-key.asc | sudo apt-key add - - - * Configure APT to use this repository (for Ubuntu Trusty systems): - - sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.trusty.list - - * Configure APT to use this repository (for Ubuntu Precise systems): - - sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.precise.list - - * Configure APT to use this repository (for Debian Wheezy systems): - - sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.wheezy.list - -## Installation Using APT Tools - -These instructions assume that you're using apt-get. Other APT tools such as -aptitude should also work. - - * Update available packages: - - sudo apt-get update - - * Install the software: - - sudo apt-get install rpki-rp rpki-ca - - * Customize the default `rpki.conf` for your environment as necessary. In particular, you want to change `handle` and `rpkid_server_host`. There are [obsessively detailed instructions][Configuration]. - - sudo emacs /etc/rpki.conf - -> Again, you want to change `handle` and `rpkid_server_host` at the minimum. - - * If you changed anything in `rpki.conf`, you should restart the RPKI CA service: - - sudo service rpki-ca restart - -## Upgrading - -Once you've performed the steps above you should be able to upgrade to newer -version of the code using the normal APT upgrade process, eg: - - sudo apt-get update - sudo apt-get upgrade - -Or, if you only want to update the RPKI tools: - - sudo apt-get update - sudo apt-get upgrade rpki-ca rpki-rp - -[Configuration]: 12.RPKI.CA.Configuration.md diff --git a/doc/02.RPKI.Installation.DebianPackages.wiki b/doc/02.RPKI.Installation.DebianPackages.wiki deleted file mode 100644 index fdf5b1d3..00000000 --- a/doc/02.RPKI.Installation.DebianPackages.wiki +++ /dev/null @@ -1,90 +0,0 @@ -[[TracNav(doc/RPKI/TOC)]] -[[PageOutline]] - -= Installation Using Debian Packages on Debian and Ubuntu Systems = - -Precompiled binary packages for Ubuntu 12.04 LTS ("Precise Pangolin") and -Debian 7 ("Wheezy") are available from download.rpki.net using the Debian -Advanced Package Tools (APT). To use these, you need to configure APT on your -machine to know about our APT repository, but once you've done this you should -be able to install and update these packages like any other precompiled package. - -== Initial APT Setup == - -You should only need to perform these steps once for any particular -machine. - -* Add the GPG public key for this repository (optional, but APT will whine unless you do this): -{{{ -#!sh -wget -q -O - https://download.rpki.net/APT/apt-gpg-key.asc | sudo apt-key add - -}}} - -* Configure APT to use this repository (for Ubuntu Trusty systems): -{{{ -#!sh -sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.trusty.list -}}} - -* Configure APT to use this repository (for Ubuntu Precise systems): -{{{ -#!sh -sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.precise.list -}}} - -* Configure APT to use this repository (for Debian Wheezy systems): -{{{ -#!sh -sudo wget -q -O /etc/apt/sources.list.d/rpki.list https://download.rpki.net/APT/rpki.wheezy.list -}}} - -== Installation Using APT Tools == - -These instructions assume that you're using apt-get. Other APT tools -such as aptitude should also work. - -* Update available packages: -{{{ -#!sh -sudo apt-get update -}}} - -* Install the software: -{{{ -#!sh -sudo apt-get install rpki-rp rpki-ca -}}} - -* Customize the default `rpki.conf` for your environment as necessary. In - particular, you want to change `handle` and `rpkid_server_host`. - There are [[CA/Configuration|obsessively detailed instructions]]. -{{{#!sh -sudo emacs /etc/rpki.conf -}}} - - Again, you want to change `handle` and `rpkid_server_host` at the minimum. - -* If you changed anything in `rpki.conf`, you should restart the RPKI CA service: -{{{ -#!sh -sudo service rpki-ca restart -}}} - -== Upgrading == - -Once you've performed the steps above you should be able to upgrade -to newer version of the code using the normal APT upgrade process, eg: - -{{{ -#!sh -sudo apt-get update -sudo apt-get upgrade -}}} - -Or, if you only want to update the RPKI tools: - -{{{ -#!sh -sudo apt-get update -sudo apt-get upgrade rpki-ca rpki-rp -}}} diff --git a/doc/03.RPKI.Installation.FreeBSDPorts.md b/doc/03.RPKI.Installation.FreeBSDPorts.md deleted file mode 100644 index d4690425..00000000 --- a/doc/03.RPKI.Installation.FreeBSDPorts.md +++ /dev/null @@ -1,68 +0,0 @@ -# Installation Using FreeBSD Ports - -Port skeletons are available for FreeBSD from download.rpki.net. To use these, -you need to download the port skeletons then run them using your favorite -FreeBSD port installation tool. - -## Manual Download - -To download the port skeletons manually and install from them, do something -like this: - - for port in rpki-rp rpki-ca - do - fetch https://download.rpki.net/FreeBSD_Packages/${port}-port.tgz - tar xf ${port}-port.tgz - cd ${port} - make install - cd .. - rm -rf ${port} - done - -After performing initial installation, you should customize the default -`rpki.conf` for your environment as necessary. In particular, you want to -change `handle` and `rpkid_server_host`. There are [obsessively detailed -instructions][Configuration]. - - emacs /usr/local/etc/rpki.conf - -Again, you want to change `handle` and `rpkid_server_host` at the minimum. - -To upgrade, you can perform almost the same steps, but the FreeBSD ports -system, which doesn't really know about upgrades, will require you to use the -`deinstall` and `reinstall` operations instead of plain `install`: - - for port in rpki-rp rpki-ca - do - fetch https://download.rpki.net/FreeBSD_Packages/${port}-port.tgz - tar xf ${port}-port.tgz - cd ${port} - make deinstall - make reinstall - cd .. - rm -rf ${port} - done - -After an upgrade, you may want to check the newly-installed -`/usr/local/etc/rpki.conf.sample` against your existing -`/usr/local/etc/rpki.conf` in case any important options have changed. We -generally try to keep options stable between versions, and provide sane -defaults where we can, but if you've done a lot of customization to your -`rpki.conf` you will want to keep track of this. - -## Automated Download and Install with portmaster - -There's a [script][portmaster] you can use to automate the download steps above and -perform the updates using portmaster. First, download the script: - - fetch https://download.rpki.net/FreeBSD_Packages/rpki-portmaster.sh - -Then, to install or upgrade, just execute the script: - - sh rpki-portmaster.sh - -As with manual download (above) you should customize `rpki.conf` after initial -installation. - -[Configuration]: 12.RPKI.CA.Configuration.md -[portmaster]: https://download.rpki.net/FreeBSD_Packages/rpki-portmaster.sh diff --git a/doc/03.RPKI.Installation.FreeBSDPorts.wiki b/doc/03.RPKI.Installation.FreeBSDPorts.wiki deleted file mode 100644 index bff99b78..00000000 --- a/doc/03.RPKI.Installation.FreeBSDPorts.wiki +++ /dev/null @@ -1,124 +0,0 @@ -[[TracNav(doc/RPKI/TOC)]] -[[PageOutline]] - -= Installation Using FreeBSD Ports = - -Port skeletons are available for FreeBSD from download.rpki.net. To -use these, you need to download the port skeletons then run them using -your favorite FreeBSD port installation tool. - -== Manual Download == - -To download the port skeletons manually and install from them, do -something like this: - -{{{ -#!sh -for port in rpki-rp rpki-ca -do - fetch https://download.rpki.net/FreeBSD_Packages/${port}-port.tgz - tar xf ${port}-port.tgz - cd ${port} - make install - cd .. - rm -rf ${port} -done -}}} - -After performing initial installation, you should customize the -default `rpki.conf` for your environment as necessary. In particular, -you want to change `handle` and `rpkid_server_host`. There are -[[CA/Configuration|obsessively detailed instructions]]. - -{{{ -#!sh -emacs /usr/local/etc/rpki.conf -}}} - -Again, you want to change `handle` and `rpkid_server_host` at the minimum. - -To upgrade, you can perform almost the same steps, but the FreeBSD -ports system, which doesn't really know about upgrades, will require -you to use the `deinstall` and `reinstall` operations instead of plain -`install`: - -{{{ -#!sh -for port in rpki-rp rpki-ca -do - fetch https://download.rpki.net/FreeBSD_Packages/${port}-port.tgz - tar xf ${port}-port.tgz - cd ${port} - make deinstall - make reinstall - cd .. - rm -rf ${port} -done -}}} - -After an upgrade, you may want to check the newly-installed -`/usr/local/etc/rpki.conf.sample` against your existing -`/usr/local/etc/rpki.conf` in case any important options have changed. -We generally try to keep options stable between versions, and provide -sane defaults where we can, but if you've done a lot of customization -to your `rpki.conf` you will want to keep track of this. - -== Automated Download and Install with portmaster == - -There's a -[[https://download.rpki.net/FreeBSD_Packages/rpki-portmaster.sh|script]] -you can use to automate the download steps above and perform the -updates using portmaster. First, download the script: - -{{{ -#!sh -fetch https://download.rpki.net/FreeBSD_Packages/rpki-portmaster.sh -}}} - -Then, to install or upgrade, just execute the script: - -{{{ -#!sh -sh rpki-portmaster.sh -}}} - -As with manual download (above) you should customize `rpki.conf` after -initial installation. - -== Automated Download and Install with portupgrade == - -There's a -[[https://download.rpki.net/FreeBSD_Packages/rpki-portupgrade.sh|script]] -you can use to automate the download steps above and perform the -updates using portupgrade. First, download the script: - -{{{ -#!sh -fetch https://download.rpki.net/FreeBSD_Packages/rpki-portupgrade.sh -}}} - -Next, you will need to add information about the RPKI ports to two -variables in `/usr/local/etc/pkgtools.conf` before portupgrade will -know how to deal with these ports: - -{{{ -#!ruby -EXTRA_CATEGORIES = [ - 'rpki', -] - -ALT_INDEX = [ - ENV['PORTSDIR'] + '/INDEX.rpki', -] -}}} - -Once you have completed these steps, you can just execute the script -to install or upgrade the RPKI code: - -{{{ -#!sh -sh rpki-portupgrade.sh -}}} - -As with manual download (above) you should customize `rpki.conf` after -initial installation. diff --git a/doc/04.RPKI.Installation.FromSource.md b/doc/04.RPKI.Installation.FromSource.md deleted file mode 100644 index 71d77821..00000000 --- a/doc/04.RPKI.Installation.FromSource.md +++ /dev/null @@ -1,208 +0,0 @@ -# Installing From Source Code - -At present, the entire RPKI tools collection is a single source tree with a -shared autoconf configuration. This may change in the future, but for now, -this means that the build process is essentially the same regardless of which -tools one wants to use. Some of the tools have dependencies on external -packages, although we've tried to keep this to a minimum. - -Most of the tools require an [RFC-3779][]-aware version of the [OpenSSL][] -libraries. If necessary, the build process will generate its own private copy -of the OpenSSL libraries for this purpose. - -Other than OpenSSL, most of the relying party tools are fairly self-contained. -The CA tools have a few additional dependencies, described below. - -Note that initial development of this code has been on FreeBSD, so -installation will probably be easiest on FreeBSD. We do, however, test on -other platforms, such as Fedora, Ubuntu, Debian, and MacOSX. - -## Downloading the Source Code - -The recommended way to obtain the source code is via [Subversion][]. To -download, do: - - $ svn checkout https://subvert-rpki.hactrn.net/trunk/ - -Code snapshots are also available from as xz- -compressed tarballs. - -## Prerequisites - -Before attempting to build the tools from source, you will need to install any -missing prerequisites. - -Some of the relying party tools and most of the CA tools are written in -Python. Note that the Python code requires Python version 2.6 or 2.7. - -On some platforms (particularly MacOSX) the simplest way to install some of -the Python packages may be the "easy_install" or "pip" tools that comes with -Python. - -Packages you will need: - - * You will need a C compiler. gcc is fine, others such as Clang should also work. - * , the Python interpreter, libraries, and sources. On some platforms the Python sources (in particular, the header files and libraries needed when building Python extensions) are in a separate "development" package, on other platforms they are all part of a single package. If you get compilation errors trying to build the POW code later in the build process and the error message says something about the file "Python.h" being missing, this is almost certainly your problem. - * FreeBSD: - * /usr/ports/lang/python27 (python) - * Debian & Ubuntu: - * python - * python-dev - * python-setuptools - - * , a Pythonic interface to the Gnome LibXML2 libraries. lxml in turn requires the LibXML2 C libraries; on some platforms, some of the LibXML2 utilities are packaged separately and may not be pulled in as dependencies. - * FreeBSD: /usr/ports/devel/py-lxml (py27-lxml) - * Fedora: python-lxml.i386 - * Debian & Ubuntu: - * python-lxml - * libxml2-utils - * , MySQL client and server. How these are packaged varies by platform, on some platforms the client and server are separate packages, on others they might be a single monolithic package, or installing the server might automatically install the client as a dependency. On MacOSX you might be best off installing a binary package for MySQL. The RPKI CA tools have been tested with MySQL 5.0, 5.1, and 5.5; they will probably work with any other reasonably recent version. - * FreeBSD: - * /usr/ports/databases/mysql55-server (mysql55-server) - * /usr/ports/databases/mysql55-client (mysql55-client) - * Debian & Ubuntu: - * mysql-client - * mysql-server - * , the Python "db" interface to MySQL. - * FreeBSD: /usr/ports/databases/py-MySQLdb (py27-MySQLdb) - * Fedora: MySQL-python.i386 - * Debian & Ubuntu: python-mysqldb - * , the Django web user interface toolkit. The GUI interface to the CA tools requires this. Django 1.4 is required. - * FreeBSD: /usr/ports/www/py-django (py27-django) - * Debian: python-django - * Ubuntu: **Do not use the python-django package (Django 1.3.1) in 12.04 LTS, as it is known not to work.** -Instead, install a recent version using easy_install or pip: - - $ sudo pip install django==1.4.5 - - * , a Python library for parsing VCards. The GUI uses this to parse the payload of RPKI Ghostbuster objects. - * FreeBSD: /usr/ports/deskutils/py-vobject (py27-vobject) - * Debian & Ubuntu: python-vobject - * Several programs (more as time goes on) use the Python argparse module. This module is part of the Python standard library as of Python 2.7, but you may need to install it separately if you're stuck with Python 2.6. Don't do this unless you must. In cases where this is necessary, you'll probably need to use pip: - - $ python -c 'import argparse' 2>/dev/null || sudo pip install argparse - - * . Several of the test programs use PyYAML to parse a YAML description of a simulated allocation hierarchy to test. - * FreeBSD: /usr/ports/devel/py-yaml (py27-yaml) - * Debian & Ubuntu: python-yaml - * . Some of the test code uses xsltproc, from the Gnome LibXSLT package. - * FreeBSD: /usr/ports/textproc/libxslt (libxslt) - * Debian & Ubuntu: xsltproc - * . The relying party tools use this to generate graphics which you may find useful in monitoring the behavior of your validator. The rest of the software will work fine without rrdtool, you just won't be able to generate those graphics. - * FreeBSD: /usr/ports/databases/rrdtool (rrdtool) - * Debian & Ubuntu: rrdtool - * If you intend to run the GUI with wsgi, its default configuration, you will need to install mod_wsgi v3 - * FreeBSD: /usr/ports/www/mod_wsgi3 (app22-mod_wsgi) - * Debian & Ubuntu: libapache2-mod-wsgi - * Django South 0.7.6 or later. This tool is used to ease the pain of changes to the web portal database schema. - * FreeBSD: /usr/ports/databases/py-south (py27-south) - * Debian: python-django-south - * Ubuntu: **Do not use the python-django-south 0.7.3 package in 12.04 LTS, as it is known not to work.** -Instead, install a recent version using easy_install or pip: - - pip install South>=0.7.6 - -## Configure and build - -Once you have the prerequesite packages installed, you should be able to build -the toolkit. cd to the top-level directory in the distribution, run the -configure script, then run "make": - - $ cd $top - $ ./configure - $ make - -This should automatically build everything, in the right order, including -building a private copy of the OpenSSL libraries with the right options if -necessary and linking the POW module against either the system OpenSSL -libraries or the private OpenSSL libraries, as appopriate. - -In theory, `./configure` will complain about any required packages which might -be missing. - -If you don't intend to run any of the CA tools, you can simplify the build and -installation process by telling `./configure` that you only want to build the -relying party tools: - - $ cd $top - $ ./configure --disable-ca-tools - $ make - -## Testing the build - -Assuming the build stage completed without obvious errors, the next step is to -run some basic regression tests. - -Some of the tests for the CA tools require MySQL databases to store their -data. To set up all the databases that the tests will need, run the SQL -commands in `ca/tests/smoketest.setup.sql`. The MySQL command line client is -usually the easiest way to do this, eg: - - $ cd $top/ca - $ mysql -u root -p