This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/plc4x-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 55c099b Site checkin for project PLC4X: Jenkins Tools
55c099b is described below
commit 55c099b445d19a90cc64c1704fa31827bde2787e
Author: jenkins <[email protected]>
AuthorDate: Thu Feb 13 06:35:03 2020 +0000
Site checkin for project PLC4X: Jenkins Tools
---
developers/building.html | 13 +-
developers/code-gen/index.html | 13 +-
developers/code-gen/language/freemarker.html | 13 +-
developers/code-gen/protocol/df1.html | 13 +-
developers/code-gen/protocol/mspec.html | 13 +-
developers/conferences.html | 13 +-
developers/contributing.html | 13 +-
developers/decisions.html | 13 +-
developers/index.html | 13 +-
developers/infrastructure/ci.html | 13 +-
developers/infrastructure/index.html | 13 +-
developers/infrastructure/issues.html | 13 +-
developers/infrastructure/sonar.html | 13 +-
developers/infrastructure/vm.html | 13 +-
developers/infrastructure/vpn.html | 13 +-
developers/infrastructure/website.html | 13 +-
developers/infrastructure/wiki.html | 13 +-
developers/jqassistant.html | 13 +-
developers/maturity.html | 13 +-
developers/preparing.html | 955 ---------------------
.../validation.html => preparing/index.html} | 187 ++--
.../vm.html => preparing/linux.html} | 246 ++++--
.../vm.html => preparing/macos.html} | 168 ++--
.../vm.html => preparing/windows.html} | 197 +++--
developers/release/build-tools.html | 13 +-
developers/release/index.html | 13 +-
developers/release/release.html | 13 +-
developers/release/validation.html | 13 +-
developers/team.html | 13 +-
developers/tutorials/index.html | 13 +-
developers/tutorials/writing-driver.html | 13 +-
sitemap.html | 10 +-
32 files changed, 829 insertions(+), 1272 deletions(-)
diff --git a/developers/building.html b/developers/building.html
index 0326f1b..400534b 100644
--- a/developers/building.html
+++ b/developers/building.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/code-gen/index.html b/developers/code-gen/index.html
index 6016306..a813a2d 100644
--- a/developers/code-gen/index.html
+++ b/developers/code-gen/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/code-gen/language/freemarker.html
b/developers/code-gen/language/freemarker.html
index 723fa05..b4909d7 100644
--- a/developers/code-gen/language/freemarker.html
+++ b/developers/code-gen/language/freemarker.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a
href="../../../developers/preparing/windows.html" class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/code-gen/protocol/df1.html
b/developers/code-gen/protocol/df1.html
index 65c3ef3..3221f3e 100644
--- a/developers/code-gen/protocol/df1.html
+++ b/developers/code-gen/protocol/df1.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a
href="../../../developers/preparing/windows.html" class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/code-gen/protocol/mspec.html
b/developers/code-gen/protocol/mspec.html
index 3497147..547193e 100644
--- a/developers/code-gen/protocol/mspec.html
+++ b/developers/code-gen/protocol/mspec.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a
href="../../../developers/preparing/windows.html" class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/conferences.html b/developers/conferences.html
index 5d42d06..e997a84 100644
--- a/developers/conferences.html
+++ b/developers/conferences.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/contributing.html b/developers/contributing.html
index efcf99a..a98dfde 100644
--- a/developers/contributing.html
+++ b/developers/contributing.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/decisions.html b/developers/decisions.html
index 38e3209..ada36b5 100644
--- a/developers/decisions.html
+++ b/developers/decisions.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/index.html b/developers/index.html
index 5f82ab8..34111e7 100644
--- a/developers/index.html
+++ b/developers/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/ci.html
b/developers/infrastructure/ci.html
index 7bd3162..922d8c1 100644
--- a/developers/infrastructure/ci.html
+++ b/developers/infrastructure/ci.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/index.html
b/developers/infrastructure/index.html
index 7bf1b6c..e8e9008 100644
--- a/developers/infrastructure/index.html
+++ b/developers/infrastructure/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/issues.html
b/developers/infrastructure/issues.html
index 31b94e3..3ff251d 100644
--- a/developers/infrastructure/issues.html
+++ b/developers/infrastructure/issues.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/sonar.html
b/developers/infrastructure/sonar.html
index 3d97839..f8957b6 100644
--- a/developers/infrastructure/sonar.html
+++ b/developers/infrastructure/sonar.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/vm.html
b/developers/infrastructure/vm.html
index 6625df5..96d6796 100644
--- a/developers/infrastructure/vm.html
+++ b/developers/infrastructure/vm.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/vpn.html
b/developers/infrastructure/vpn.html
index 5b5a53c..b4209eb 100644
--- a/developers/infrastructure/vpn.html
+++ b/developers/infrastructure/vpn.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/website.html
b/developers/infrastructure/website.html
index 5cddab1..6a5780b 100644
--- a/developers/infrastructure/website.html
+++ b/developers/infrastructure/website.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/infrastructure/wiki.html
b/developers/infrastructure/wiki.html
index e049fa7..1e5192c 100644
--- a/developers/infrastructure/wiki.html
+++ b/developers/infrastructure/wiki.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/jqassistant.html b/developers/jqassistant.html
index edc3a8e..fa10162 100644
--- a/developers/jqassistant.html
+++ b/developers/jqassistant.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/maturity.html b/developers/maturity.html
index a6167ee..c845786 100644
--- a/developers/maturity.html
+++ b/developers/maturity.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/preparing.html b/developers/preparing.html
deleted file mode 100644
index c78071d..0000000
--- a/developers/preparing.html
+++ /dev/null
@@ -1,955 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
- <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
-<head>
- <meta http-equiv="Content-Type"
content="text/html; charset=UTF-8"/>
- <title>PLC4X – </title>
- <script src="../js/jquery.slim.min.js" type="javascript"></script>
- <!--script src="../js/popper.min.js" type="javascript"></script-->
- <script src="../js/bootstrap.bundle.min.js" type="javascript"></script>
- <!-- FontAwesome -->
- <link rel="stylesheet" href="../css/all.min.css" type="text/css"/>
- <!-- Bootstrap -->
- <link rel="stylesheet" href="../css/bootstrap.min.css" type="text/css"/>
- <!-- Some Maven Site defaults -->
- <link rel="stylesheet" href="../css/maven-base.css" type="text/css"/>
- <link rel="stylesheet" href="../css/maven-theme.css" type="text/css"/>
- <!-- The PLC4X version of a bootstrap theme -->
- <link rel="stylesheet" href="../css/themes/plc4x.css" type="text/css"
id="pagestyle"/>
- <!-- A custom style for printing content -->
- <link rel="stylesheet" href="../css/print.css" type="text/css"
media="print"/>
-
- <meta http-equiv="Content-Language" content="en"/>
-
-</head>
-<body class="composite">
-<nav class="navbar navbar-light navbar-expand-md bg-faded
justify-content-center border-bottom">
- <!--a href="/" class="navbar-brand d-flex w-50 mr-auto">Navbar 3</a-->
- <a href="https://plc4x.apache.org/"; id="bannerLeft"><img
src="../images/apache_plc4x_logo_small.png" alt="Apache PLC4X"/></a>
- <button class="navbar-toggler" type="button" data-toggle="collapse"
data-target="#collapsingNavbar3">
- <span class="navbar-toggler-icon"></span>
- </button>
- <div class="navbar-collapse collapse w-100" id="collapsingNavbar3">
- <ul class="navbar-nav w-100 justify-content-center">
- <li class="nav-item">
- <a class="nav-link" href="../index.html">Home</a>
- </li>
-
<li class="nav-item">
- <a class="nav-link"
href="../users/index.html">Users</a>
- </li>
- <li class="nav-item active">
- <a class="nav-link"
href="../developers/index.html">Developers</a>
- </li>
- <li class="nav-item">
- <a class="nav-link"
href="../apache/index.html">Apache</a>
- </li>
- </ul>
- <ul class="nav navbar-nav ml-auto justify-content-end">
- <li class="nav-item row valign-middle">
- <a href="https://www.apache.org/events/current-event.html";
class="col"><img src="https://www.apache.org/events/current-event-234x60.png";
alt="Apache Events"/></a>
- <div class="col">
- <a href="https://www.apache.org/"; id="bannerRight"><img
src="../images/apache_logo_small.png" alt="Apache Software Foundation"/></a>
- </div>
- </li>
- </ul>
- </div>
-</nav>
-<div class="container-fluid">
- <div class="row h-100">
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<nav class="col-sm-push col-md-2 pt-3 sidebar">
- <div class="sidebar-sticky">
- <ul class="nav flex-column">
- <li
class="nav-item">
- <a href="../developers/index.html"
class="nav-link">Section Home</a>
- </li>
-
-
- <li
class="nav-item">
- <strong class="nav-link">Preparing your
Computer</strong>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/building.html"
class="nav-link">Building</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/contributing.html"
class="nav-link">Contributing</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/tutorials/index.html"
class="nav-link">Tutorials</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a
href="../developers/tutorials/writing-driver.html" class="nav-link">Writing
Drivers</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/code-gen/index.html"
class="nav-link">Code Generation</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a
href="../developers/code-gen/protocol/mspec.html" class="nav-link">Protocol:
MSpec Format</a>
- </li>
- <li class="nav-item">
- <a
href="../developers/code-gen/language/freemarker.html"
class="nav-link">Language: Apache Freemarker</a>
- </li>
- <li class="nav-item">
- <a href="../developers/code-gen/protocol/df1.html"
class="nav-link">Example: DF1 MSpec</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/infrastructure/index.html"
class="nav-link">Infrastructure</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../developers/infrastructure/ci.html"
class="nav-link">Continuous Integration</a>
- </li>
- <li class="nav-item">
- <a href="../developers/infrastructure/issues.html"
class="nav-link">Bug & Issue Tracker</a>
- </li>
- <li class="nav-item">
- <a href="../developers/infrastructure/sonar.html"
class="nav-link">Code Analysis</a>
- </li>
- <li class="nav-item">
- <a href="../developers/infrastructure/wiki.html"
class="nav-link">Wiki</a>
- </li>
- <li class="nav-item">
- <a href="../developers/infrastructure/vm.html"
class="nav-link">Build VM</a>
- </li>
- <li class="nav-item">
- <a
href="../developers/infrastructure/website.html" class="nav-link">Website</a>
- </li>
- <li class="nav-item">
- <a href="../developers/infrastructure/vpn.html"
class="nav-link">IoT VPN</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/release/index.html"
class="nav-link">Releasing</a>
- <ul class="flex-column pl-4 nav">
- <li class="nav-item">
- <a href="../developers/release/release.html"
class="nav-link">Releasing</a>
- </li>
- <li class="nav-item">
- <a href="../developers/release/validation.html"
class="nav-link">Validating</a>
- </li>
- <li class="nav-item">
- <a href="../developers/release/build-tools.html"
class="nav-link">Releasing Build-Tools</a>
- </li>
- </ul>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/team.html"
class="nav-link">Team</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/decisions.html"
class="nav-link">Decision Making</a>
- </li>
-
-
- <li
class="nav-item">
- <a href="../developers/maturity.html"
class="nav-link">Maturity</a>
- </li>
-
-
-
-
-
-
-
-
-
-
- </ul>
- </div>
- </nav>
- <main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
- <div class="sect1">
-<h2 id="preparing_your_computer">Preparing your Computer</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Building a project like Apache PLC4X on multiple target operating-systems
is quite a challenge, but I think we managed to make it as simple as
possible.</p>
-</div>
-<div class="paragraph">
-<p>However when building any of the parts of PLC4X there are some requirements
the build is expecting you to have provided.</p>
-</div>
-<div class="paragraph">
-<p>In order to build at all you are required to have <code>Java 8</code>
installed on your machine.
-We have tested the build with Java 8 up to Java 13.
-If a new version comes out, please give us a little time to handle any related
issues, but we’ll probably fix them as soon as possible.
-However in the past with Oracle’s new release strategy, there have been
a few bumps on the road.</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;"/>
-<col style="width: 33.3333%;"/>
-<col style="width: 33.3334%;"/>
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Profile</p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Requirements</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Builds
Java API, drivers, integrations, examples</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>Git</p>
-</li>
-<li>
-<p>LibPCAP (Optional)</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-cpp</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Builds C++
API, drivers, integrations, examples</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>gcc</p>
-</li>
-<li>
-<p>g++</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-dotnet</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Builds C#
and .Net API, drivers, integrations, examples</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>dotnet</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-python</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Builds
Python API, drivers, integrations, examples</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>python (2.7)</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-proxies</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Adds proxy
modules to each enabled language</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>bison</p>
-</li>
-<li>
-<p>flex</p>
-</li>
-<li>
-<p>python</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">`with-docker `</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Adds
building of Docker images</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
-<ul>
-<li>
-<p>docker</p>
-</li>
-</ul>
-</div></div></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p>The following chapters will describe how to provide these requirements
sorted by operating system.</p>
-</div>
-<div class="sect2">
-<h3 id="linux">Linux</h3>
-<div class="sect3">
-<h4 id="git">Git</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>git --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install git</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install git</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="libpcap">LibPCAP</h4>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install libpcap-dev</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install libpcap-devel</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gcc">gcc</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>gcc --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install gcc</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install gcc</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="g">g++</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>g++ --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install g++</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install g++</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="dotnet">dotnet</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>dotnet --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Microsoft has documented what is needed to install <code>.Net SDK</code> <a
href="https://dotnet.microsoft.com/download/linux-package-manager/rhel/sdk-2.2.203";>here</a></p>
-</div>
-<div class="paragraph">
-<p>For Ubuntu this would be:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>wget -q
https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
-sudo dpkg -i packages-microsoft-prod.deb</pre>
-</div>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install apt-transport-https
-sudo apt-get update
-sudo apt-get install dotnet-sdk-2.2</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For other distributions, please select the distribution in the drop-down
menu and follow the instructions there.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="python">python</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>python --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a version of 2.7 or higher reported, you probably don’t
need to do anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install python-dev</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>yum install gcc
-cd /usr/src
-wget https://www.python.org/ftp/python/2.7.10/Python-2.7.10.tgz
-tar xzf Python-2.7.10.tgz
-cd Python-2.7.10
-./configure
-make altinstall</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="bison">bison</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>bison --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a version above 2.3 output, you don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install bison</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install bison-devel</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="flex">flex</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>flex --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Apt-based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install flex</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Yum based systems:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo yum install flex</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="macos">MacOS</h3>
-<div class="paragraph">
-<p>Most libraries on Mac are installed using <code>Homebrew</code>.</p>
-</div>
-<div class="paragraph">
-<p>Make sure <code>Homebrew</code> ist installed in order to install most of
these.</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>/usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"</pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="git_2">Git</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>git --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>In order to install it, please execute the following command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>brew install git</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="libpcap_2">LibPCAP</h4>
-
-</div>
-<div class="sect3">
-<h4 id="gcc_2">gcc</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>gcc --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>It seems macOS comes with a version of gcc which is good enough for our
usecases.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="g_2">g++</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>g++ --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>It seems macOS comes with a version of g++ which is good enough for our
usecases.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="dotnet_2">dotnet</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>dotnet --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Microsoft is offering an installer for MacOS which is available from <a
href="https://dotnet.microsoft.com/download/dotnet-core/2.2";>here</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="python_2">python</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>python --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a version of 2.7 or higher reported, you probably don’t
need to do anything.</p>
-</div>
-<div class="paragraph">
-<p>In order to install it, please execute the following command:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>brew install python@2</pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="bison_2">bison</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>python --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get a version above 2.3 output, you don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>macOS comes with a pre-installed version of bison, however this version is
2.3 and hereby too old.
-So you need to update to a more recent version:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>brew install bison
-brew link bison --force
-echo 'export PATH="/usr/local/opt/bison/bin:$PATH"' >>
~/.bash_profile</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Be sure to reboot or at least restart your IDE or commandline in order for
the changes to become effective.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="flex_2">flex</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>flex --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>It seems macOS comes with a version of flex which is good enough for our
usecases.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="windows">Windows</h3>
-<div class="sect3">
-<h4 id="git_3">Git</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>git --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>In order to install it, please download end execute the installer from <a
href="https://git-scm.com/download/win";>here</a> and make sure to have it add
the git executable to your systems <code>PATH</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="libpcap_3">LibPCAP</h4>
-<div class="paragraph">
-<p>A special version of LibPCAP is available for Windows, which is called
WinPCAP.
-It is available from <a href="https://www.winpcap.org/";>here</a>.</p>
-</div>
-<div class="paragraph">
-<p>However this is a based on a very old version (1.0) of LibPCAP and in order
to read PCAPNG files we require a libpcap version 1.1.0 or greater.
-A patched windows version can be found here: <a
href="https://sourceforge.net/projects/winpcap413-176/";
class="bare">https://sourceforge.net/projects/winpcap413-176/</a>
-(At this location is a patched version based on libpcap 1.7.4)</p>
-</div>
-<div class="paragraph">
-<p>So in order to install things correctly:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>install the version WinPCP from above location.</p>
-</li>
-<li>
-<p>Then download the patched version from the sourceforge link and unpack it
somewhere.</p>
-</li>
-<li>
-<p>After that copy bin\x64\wpcap.dll from archive to \Windows\System32</p>
-</li>
-<li>
-<p>Copy bin\wpcap.dll from archive to \Windows\SysWOW64</p>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>After this all should be working.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gcc_3">gcc</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>gcc --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>On windows we will be using something called WinBuilds, which is sort of a
package consisting of a typical build environment consisting of multiple build
tools. So please look at the WinBuilds chapter at the end of the Windows
section.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="g_3">g++</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>g++ --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>On windows we will be using something called WinBuilds, which is sort of a
package consisting of a typical build environment consisting of multiple build
tools. So please look at the WinBuilds chapter at the end of the Windows
section.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="dotnet_3">dotnet</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>dotnet --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Usually this is already installed on Windows machines.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="python_3">python</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>python --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>You can get Python from <a
href="https://www.python.org/downloads/release/python-2716/";>here</a>.</p>
-</div>
-<div class="paragraph">
-<p>Make sure directory containing <code>python.exe</code> is added to your
systems <code>PATH</code>.
-Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="bison_3">bison</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>bison --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>For Bison, please download the Setup installer version from <a
href="http://gnuwin32.sourceforge.net/packages/bison.htm";>here</a> (When using
the zip version the bison.exe couldn’t find some DLL files)
-It seems the official 2.4.1 version has issues when installed in a directory
which’s path contains spaces. Please make sure you replace the exe with a
patched version form <a
href="http://marin.jb.free.fr/bison/bison-2.4.1-modified.zip";>here</a>
-(More infos on this issue <a
href="https://sourceforge.net/p/gnuwin32/bugs/473/";>here</a>)</p>
-</div>
-<div class="paragraph">
-<p>It seems there are issues if these tools are installed in paths with spaces.
-So if it is for example installed in the 32 bit <code>Programs (x86)</code>
directory, the build will probably fail.</p>
-</div>
-<div class="paragraph">
-<p>Make sure all tools <code>bin</code> directories are added to your systems
<code>PATH</code>.
-For tools like OpenSSL be sure to add the directory containing the
<code>openssl.exe</code> (Usually the root directory).
-Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="flex_3">flex</h4>
-<div class="paragraph">
-<p>Checking:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>flex --version</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you get any successful output, you probably don’t need to do
anything.</p>
-</div>
-<div class="paragraph">
-<p>Please download the Flex compiler from <a
href="http://gnuwin32.sourceforge.net/packages/flex.htm";>here</a> (Ideally
download the binary zip distribution)</p>
-</div>
-<div class="paragraph">
-<p>Make sure it’s <code>bin</code> directory is added to your systems
<code>PATH</code>.
-Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="winbuilds">WinBuilds</h4>
-<div class="paragraph">
-<p>He have tested WinBuilds with the bundle found <a
href="http://win-builds.org/doku.php/download_and_installation_from_windows";>here</a>.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-Please use the installer. When using the zip distribution and manually adding
that to the <code>PATH</code> the build will fail without a log output as some
binaries can’t find some of the DLL files.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>When running the installer, make sure to select the options:
-- Native Windows
-- x86_64
-Not quite sure which elements are really needed, better just install all of
them.</p>
-</div>
-<div class="paragraph">
-<p>Make sure it’s <code>bin</code> directory is added to your systems
<code>PATH</code>, however the installer should have taken care of this.
-Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
- </main>
- <footer class="pt-4 my-md-5 pt-md-5 w-100 border-top">
- <div class="row justify-content-md-center" style="font-size: 13px">
- <div class="col col-6 text-center">
- Copyright © 2017–2020 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>.
-All rights reserved.<br/>
- Apache PLC4X, PLC4X, Apache, the Apache feather logo, and
the Apache PLC4X project logo are either registered trademarks or trademarks of
The Apache Software Foundation in the United States and other countries. All
other marks mentioned may be trademarks or registered trademarks of their
respective owners.
- <br/><div
style="text-align:center;">Home screen image taken from <a
- href="https://flic.kr/p/chEftd";>Flickr</a>, "Tesla
Robot Dance" by Steve Jurvetson, licensed
- under <a
href="https://creativecommons.org/licenses/by/2.0/";>CC BY 2.0 Generic</a>,
image cropped
- and blur effect added.</div>
- </div>
- </div>
- </footer>
- </div>
-</div>
-
-<!-- Bootstrap core JavaScript
-================================================== -->
-<!-- Placed at the end of the document so the pages load faster -->
-<script src="../js/jquery.slim.min.js"></script>
-<script src="../js/popper.min.js"></script>
-<script src="../js/bootstrap.min.js"></script>
-<script type="text/javascript">
- $('.carousel .carousel-item').each(function(){
- var next = $(this).next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
-
- for (let i = 0; i < 3; i++) {
- next=next.next();
- if (!next.length) {
- next = $(this).siblings(':first');
- }
- next.children(':first-child').clone().appendTo($(this));
- }
- });
-</script>
-</body>
-</html>
\ No newline at end of file
diff --git a/developers/release/validation.html
b/developers/preparing/index.html
similarity index 76%
copy from developers/release/validation.html
copy to developers/preparing/index.html
index 66952a2..ac6c53c 100644
--- a/developers/release/validation.html
+++ b/developers/preparing/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <strong class="nav-link">Preparing your
Computer</strong>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
</li>
+ </ul>
+ </li>
<li
class="nav-item">
@@ -158,7 +169,7 @@
<a href="../../developers/release/release.html"
class="nav-link">Releasing</a>
</li>
<li class="nav-item">
- <strong class="nav-link">Validating</strong>
+ <a href="../../developers/release/validation.html"
class="nav-link">Validating</a>
</li>
<li class="nav-item">
<a
href="../../developers/release/build-tools.html" class="nav-link">Releasing
Build-Tools</a>
@@ -195,124 +206,128 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="validating_a_staged_release">Validating a staged release</h2>
+<h2 id="preparing_your_computer">Preparing your Computer</h2>
<div class="sectionbody">
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-On MacOS and Linux the first 4 steps can be automated. For details please read
the section about tooling after this chapter.
-</td>
-</tr>
-</table>
+<div class="paragraph">
+<p>Building a project like Apache PLC4X on multiple target operating-systems
is quite a challenge, but I think we managed to make it as simple as
possible.</p>
</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Download all staged artifacts under the url specified in the release vote
email into a directory we’ll now call <code>download-dir</code>.</p>
-</li>
-<li>
-<p>Verify the signature is correct:</p>
-<div class="listingblock">
-<div class="content">
-<pre>gpg --verify apache-plc4x-0.7.0-source-release.zip.asc
apache-plc4x-#0.7.0-source-release.zip</pre>
+<div class="paragraph">
+<p>However when building any of the parts of PLC4X there are some requirements
the build is expecting you to have provided.</p>
</div>
+<div class="paragraph">
+<p>In order to build at all you are required to have <code>Java 8</code>
installed on your machine.
+We have tested the build with Java 8 up to Java 13.
+If a new version comes out, please give us a little time to handle any related
issues, but we’ll probably fix them as soon as possible.
+However in the past with Oracle’s new release strategy, there have been
a few bumps on the road.</p>
</div>
-</li>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 33.3333%;"/>
+<col style="width: 33.3333%;"/>
+<col style="width: 33.3334%;"/>
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Profile</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Requirements</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Builds
Java API, drivers, integrations, examples</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<ul>
<li>
-<p>Check if the check is successful.</p>
+<p>Git</p>
</li>
<li>
-<p>Check if the signature references an Apache email address.</p>
+<p>LibPCAP (Optional)</p>
</li>
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-cpp</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Builds C++
API, drivers, integrations, examples</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<ul>
<li>
-<p>Verify the SHA512 hashes:</p>
-<div class="listingblock">
-<div class="content">
-<pre>shasum -a512 apache-plc4x-0.7.0-source-release.zip</pre>
-</div>
-</div>
+<p>gcc</p>
</li>
<li>
-<p>Unzip the archive:</p>
-<div class="listingblock">
-<div class="content">
-<pre>unzip apache-plc4x-0.7.0-source-release.zip</pre>
-</div>
-</div>
+<p>g++</p>
</li>
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-dotnet</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Builds C#
and .Net API, drivers, integrations, examples</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<ul>
<li>
-<p>Verify the existence of <code>LICENSE</code>, <code>NOTICE, `README</code>,
<code>RELEASE_NOTES</code> files in the extracted source bundle.</p>
+<p>dotnet</p>
</li>
-<li>
-<p>Verify the content of <code>LICENSE</code>, <code>NOTICE</code>,
<code>README</code>, `RELEASE_NOTES files in the extracted source bundle.</p>
-<div class="ulist">
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-python</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Builds
Python API, drivers, integrations, examples</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
<ul>
<li>
-<p>(Especially pay attention to the year in the <code>NOTICE</code> file if
this is the first release of the year)</p>
+<p>python (2.7)</p>
</li>
</ul>
-</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>with-proxies</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Adds proxy
modules to each enabled language</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<ul>
+<li>
+<p>bison</p>
</li>
<li>
-<p>[RM] Verify the staged source README, RELEASE_NOTE files correspond to
those in the extracted source bundle.</p>
+<p>flex</p>
</li>
<li>
-<p>[RM] Run RAT externally to ensure there are no surprises.</p>
-<div class="ulist">
+<p>python</p>
+</li>
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">`with-docker `</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Adds
building of Docker images</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
<ul>
<li>
-<p>TODO: Document this.</p>
+<p>docker</p>
</li>
</ul>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The following pages will describe how to provide these requirements sorted
by operating system.</p>
</div>
-</li>
+<div class="ulist">
+<ul>
<li>
-<p>Search for <code>SNAPSHOT</code> references:</p>
-<div class="listingblock">
-<div class="content">
-<pre>find . -type f -name 'pom.xml' -exec grep -l "SNAPSHOT" {} \;</pre>
-</div>
-</div>
+<p><a href="linux.html">Linux</a></p>
</li>
<li>
-<p>Build the project according to the information in the README.md file.</p>
-<div class="ulist">
-<ul>
+<p><a href="macos.html">Mac OS</a></p>
+</li>
<li>
-<p>[RM] Build the project with all <code>with-xyz</code> profiles and tests
enabled and an empty maven local repo: by appendng
<code>-Dmaven.repo.local=../.m2</code>.</p>
+<p><a href="windows.html">Windows</a></p>
</li>
</ul>
</div>
-</li>
-</ol>
-</div>
-<div class="sect2">
-<h3 id="release_tooling">Release Tooling</h3>
-<div class="paragraph">
-<p>In the <code>tools</code> directory we have a little script that can help
downloading and checking the hashes and signatures automatically.</p>
-</div>
-<div class="paragraph">
-<p>In order to execute this, please change directories into the projects base
directory and execute the following command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>tools/download_staged_release.sh 0.7.0 1</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This will download all the files into a directory:
<code>downloaded-plc4x-0.7.01</code>.</p>
-</div>
-<div class="paragraph">
-<p>After that it will calculate the SHA512 hash and compare it with the staged
hash.</p>
-</div>
-<div class="paragraph">
-<p>Last not least it will validate the PGP key and print out some information
on it.</p>
-</div>
-</div>
</div>
</div>
</main>
diff --git a/developers/infrastructure/vm.html b/developers/preparing/linux.html
similarity index 75%
copy from developers/infrastructure/vm.html
copy to developers/preparing/linux.html
index 6625df5..81403fa 100644
--- a/developers/infrastructure/vm.html
+++ b/developers/preparing/linux.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <strong class="nav-link">Liunx</strong>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
@@ -139,7 +150,7 @@
<a
href="../../developers/infrastructure/wiki.html" class="nav-link">Wiki</a>
</li>
<li class="nav-item">
- <strong class="nav-link">Build VM</strong>
+ <a href="../../developers/infrastructure/vm.html"
class="nav-link">Build VM</a>
</li>
<li class="nav-item">
<a
href="../../developers/infrastructure/website.html" class="nav-link">Website</a>
@@ -195,147 +206,246 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="the_plc4x_project_vm">The PLC4X Project VM</h2>
+<h2 id="linux">Linux</h2>
<div class="sectionbody">
+<div class="sect2">
+<h3 id="git">Git</h3>
<div class="paragraph">
-<p>As, especially for the raw socket functionality of PLC4X, our project had
higher demands on the infrastructure as other projects.
-Apache Infra kindly provided us with a dedicated VM.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>git --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>This is included as build agent into Apache’s Jenkins with the label
<code>plc4x1</code> and is marked for exclusive usage by our project.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>The host name of this machine is: <code>plc4x-vm.apache.org</code></p>
+<p>Apt-based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install git</pre>
+</div>
</div>
<div class="paragraph">
-<p>On this machine we can even <code>sudo</code> to perform operations only
available to <code>root</code>.</p>
+<p>Yum based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo yum install git</pre>
</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="libpcap">LibPCAP</h3>
<div class="paragraph">
-<p>Project members can request access to the machine.</p>
+<p>Apt-based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install libpcap-dev</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Yum based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo yum install libpcap-devel</pre>
+</div>
+</div>
</div>
<div class="sect2">
-<h3 id="requesting_access">Requesting access</h3>
+<h3 id="gcc">gcc</h3>
<div class="paragraph">
-<p>In order to be able to login, users need to add their SSH public key to
their Apache ID first.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>gcc --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>This is done under the following url: <a href="https://id.apache.org/";
class="bare">https://id.apache.org/</a></p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>Here just add the content in the follwoing format to one of the <code>SSH
Key (authorized_keys line)</code> fields:</p>
+<p>Apt-based systems:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh-rsa
AAAAB3NzaC1yc2EAAAADAQABAAACAQDd10ykYAZLxHJVTER71IrrVVpyR8OBdlJd1aVwb67Ts+ueJjzo8ofQKLASaQw9EQOSfprGZW0sfzhepeJvbX0n1IfsRexoyIGlD8WzyX/UoLiRLPHFv+eSGJVlN90x/l+zps+yo3lq6qfuIqkXQQvB4aJBYsYC/jifpMLvx06zaUBPfdWIaGiBgaWbX/59Q0QsSpX5r8tgdA+XLw/8Zg5AbKazuS2Cm/soJCfQQ7km4bd/WtF5R5xvakVbyILMT8Dk9Hs9OfVL/RFGLYqX4bjy5uCTwPBrwlWqFyq1u7JR39i870XNgn+bIeChaZU098BGyBH/cWMGt7bTJQSKxksF2SZAHjt8Ga2Pl+J6MTW6/EPzIYENgvfOBVSlVaz9SlM26nel1+SHDND9dK/4gRNbujbmzHZLfTjMk7oc4R+WPCBIw99CFeShTKHSxhJKz/3
[...]
+<pre>sudo apt-get install gcc</pre>
</div>
</div>
<div class="paragraph">
-<p>(I just had to copy this line from my <code>~/.ssh/id_rsa.pub</code>
file)</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-Note, the Email Address in the end doesn’t seem to matter, I simply
added it for the sake of completeness. So if this doesn’t match your
Apache email, this is not a problem.
-</td>
-</tr>
-</table>
+<p>Yum based systems:</p>
</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo yum install gcc</pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="g">g++</h3>
<div class="paragraph">
-<p>As soon as that’s done, access needs to be requested from Apache
Infra.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>g++ --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>This is done using the Infra Jira at: <a
href="https://issues.apache.org/jira";
class="bare">https://issues.apache.org/jira</a></p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>Here make sure to select the Project <code>Infrastructure
(INFRA)</code>.</p>
+<p>Apt-based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install g++</pre>
+</div>
</div>
<div class="paragraph">
-<p>As soon as that’s handled by the Infra team, you should be ready to
log-in on the machine.</p>
+<p>Yum based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo yum install g++</pre>
+</div>
</div>
</div>
<div class="sect2">
-<h3 id="login_to_the_machine">Login to the machine</h3>
+<h3 id="dotnet">dotnet</h3>
<div class="paragraph">
-<p>Using SSH we should now be able to login to the VM.</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh [email protected]</pre>
+<pre>dotnet --version</pre>
</div>
</div>
<div class="paragraph">
-<p>Be sure to use the username matching your Apache ID or the login will
fail.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>If all wen’t well you should now be able to login to the machine
using your apache user.</p>
+<p>Microsoft has documented what is needed to install <code>.Net SDK</code> <a
href="https://dotnet.microsoft.com/download/linux-package-manager/rhel/sdk-2.2.203";>here</a></p>
+</div>
+<div class="paragraph">
+<p>For Ubuntu this would be:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>wget -q
https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
+sudo dpkg -i packages-microsoft-prod.deb</pre>
+</div>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install apt-transport-https
+sudo apt-get update
+sudo apt-get install dotnet-sdk-2.2</pre>
</div>
</div>
-<div class="sect2">
-<h3 id="doing_things_as_root">Doing things as <code>root</code></h3>
<div class="paragraph">
-<p>Apache Infra is great at keeping things safe.
-Providing a sudo password directly would increase the danger of having this
intercepted, therefore they are using a tool called <code>opiepasswd</code>.</p>
+<p>For other distributions, please select the distribution in the drop-down
menu and follow the instructions there.</p>
</div>
+</div>
+<div class="sect2">
+<h3 id="python">python</h3>
<div class="paragraph">
-<p>Instead of now entering a password, a challenge is displayed:</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>myid@plc4x-vm:~$ sudo apt-get update
-otp-md5 496 pl8230
-Password:</pre>
+<pre>python --version</pre>
</div>
</div>
<div class="paragraph">
-<p>If you now enter your normal password, you’ll simply get
<code>permission denied</code> errors.</p>
+<p>If you get a version of 2.7 or higher reported, you probably don’t
need to do anything.</p>
</div>
<div class="paragraph">
-<p>In order to execute operations as root on the machine, you need to use an
opie client.</p>
+<p>Apt-based systems:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>otp-md5 496 pl8230</pre>
+<pre>sudo apt-get install python-dev</pre>
</div>
</div>
<div class="paragraph">
-<p>into OPIE client’s <code>challenge</code> field.</p>
+<p>Yum based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>yum install gcc
+cd /usr/src
+wget https://www.python.org/ftp/python/2.7.10/Python-2.7.10.tgz
+tar xzf Python-2.7.10.tgz
+cd Python-2.7.10
+./configure
+make altinstall</pre>
</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="bison">bison</h3>
<div class="paragraph">
-<p>In the <code>password</code> field you provide your Apache LDAP
password.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>bison --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>When hitting enter or clicking on <code>Compute</code> the tool should
automatically generate a response.</p>
+<p>If you get a version above 2.3 output, you don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>Now all you need to do is copy & paste that as password into your SSH
client session.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-As with the latest version of Mac Catalina the existing clients no longer work
and using a public web service is a really bad idea, Apache has a service to
calculate:
-<a href="https://selfserve.apache.org/otp-md5.html";
class="bare">https://selfserve.apache.org/otp-md5.html</a>
-</td>
-</tr>
-</table>
+<p>Apt-based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install bison</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Yum based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo yum install bison-devel</pre>
+</div>
</div>
</div>
<div class="sect2">
-<h3 id="required_software">Required software</h3>
+<h3 id="flex">flex</h3>
+<div class="paragraph">
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>flex --version</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
+</div>
+<div class="paragraph">
+<p>Apt-based systems:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo apt-get install flex</pre>
+</div>
+</div>
<div class="paragraph">
-<p>For being able to build the charts and graphics as part of the site
generation, we need to add some additional packages:</p>
+<p>Yum based systems:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install python-seqdiag
-sudo apt-get install python-nwdiag</pre>
+<pre>sudo yum install flex</pre>
</div>
</div>
</div>
diff --git a/developers/infrastructure/vm.html b/developers/preparing/macos.html
similarity index 76%
copy from developers/infrastructure/vm.html
copy to developers/preparing/macos.html
index 6625df5..cc09ea2 100644
--- a/developers/infrastructure/vm.html
+++ b/developers/preparing/macos.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <strong class="nav-link">Mac OS</strong>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
@@ -139,7 +150,7 @@
<a
href="../../developers/infrastructure/wiki.html" class="nav-link">Wiki</a>
</li>
<li class="nav-item">
- <strong class="nav-link">Build VM</strong>
+ <a href="../../developers/infrastructure/vm.html"
class="nav-link">Build VM</a>
</li>
<li class="nav-item">
<a
href="../../developers/infrastructure/website.html" class="nav-link">Website</a>
@@ -195,148 +206,161 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="the_plc4x_project_vm">The PLC4X Project VM</h2>
+<h2 id="mac_os">Mac OS</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>As, especially for the raw socket functionality of PLC4X, our project had
higher demands on the infrastructure as other projects.
-Apache Infra kindly provided us with a dedicated VM.</p>
+<p>Most libraries on Mac are installed using <code>Homebrew</code>.</p>
</div>
<div class="paragraph">
-<p>This is included as build agent into Apache’s Jenkins with the label
<code>plc4x1</code> and is marked for exclusive usage by our project.</p>
+<p>Make sure <code>Homebrew</code> ist installed in order to install most of
these.</p>
</div>
-<div class="paragraph">
-<p>The host name of this machine is: <code>plc4x-vm.apache.org</code></p>
+<div class="literalblock">
+<div class="content">
+<pre>/usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"</pre>
</div>
-<div class="paragraph">
-<p>On this machine we can even <code>sudo</code> to perform operations only
available to <code>root</code>.</p>
</div>
+<div class="sect2">
+<h3 id="git">Git</h3>
<div class="paragraph">
-<p>Project members can request access to the machine.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>git --version</pre>
+</div>
</div>
-<div class="sect2">
-<h3 id="requesting_access">Requesting access</h3>
<div class="paragraph">
-<p>In order to be able to login, users need to add their SSH public key to
their Apache ID first.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>This is done under the following url: <a href="https://id.apache.org/";
class="bare">https://id.apache.org/</a></p>
+<p>In order to install it, please execute the following command:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>brew install git</pre>
+</div>
</div>
+</div>
+<div class="sect2">
+<h3 id="libpcap">LibPCAP</h3>
+
+</div>
+<div class="sect2">
+<h3 id="gcc">gcc</h3>
<div class="paragraph">
-<p>Here just add the content in the follwoing format to one of the <code>SSH
Key (authorized_keys line)</code> fields:</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh-rsa
AAAAB3NzaC1yc2EAAAADAQABAAACAQDd10ykYAZLxHJVTER71IrrVVpyR8OBdlJd1aVwb67Ts+ueJjzo8ofQKLASaQw9EQOSfprGZW0sfzhepeJvbX0n1IfsRexoyIGlD8WzyX/UoLiRLPHFv+eSGJVlN90x/l+zps+yo3lq6qfuIqkXQQvB4aJBYsYC/jifpMLvx06zaUBPfdWIaGiBgaWbX/59Q0QsSpX5r8tgdA+XLw/8Zg5AbKazuS2Cm/soJCfQQ7km4bd/WtF5R5xvakVbyILMT8Dk9Hs9OfVL/RFGLYqX4bjy5uCTwPBrwlWqFyq1u7JR39i870XNgn+bIeChaZU098BGyBH/cWMGt7bTJQSKxksF2SZAHjt8Ga2Pl+J6MTW6/EPzIYENgvfOBVSlVaz9SlM26nel1+SHDND9dK/4gRNbujbmzHZLfTjMk7oc4R+WPCBIw99CFeShTKHSxhJKz/3
[...]
+<pre>gcc --version</pre>
</div>
</div>
<div class="paragraph">
-<p>(I just had to copy this line from my <code>~/.ssh/id_rsa.pub</code>
file)</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-Note, the Email Address in the end doesn’t seem to matter, I simply
added it for the sake of completeness. So if this doesn’t match your
Apache email, this is not a problem.
-</td>
-</tr>
-</table>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>As soon as that’s done, access needs to be requested from Apache
Infra.</p>
+<p>It seems macOS comes with a version of gcc which is good enough for our
usecases.</p>
+</div>
</div>
+<div class="sect2">
+<h3 id="g">g++</h3>
<div class="paragraph">
-<p>This is done using the Infra Jira at: <a
href="https://issues.apache.org/jira";
class="bare">https://issues.apache.org/jira</a></p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>g++ --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>Here make sure to select the Project <code>Infrastructure
(INFRA)</code>.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>As soon as that’s handled by the Infra team, you should be ready to
log-in on the machine.</p>
+<p>It seems macOS comes with a version of g++ which is good enough for our
usecases.</p>
</div>
</div>
<div class="sect2">
-<h3 id="login_to_the_machine">Login to the machine</h3>
+<h3 id="dotnet">dotnet</h3>
<div class="paragraph">
-<p>Using SSH we should now be able to login to the VM.</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh [email protected]</pre>
+<pre>dotnet --version</pre>
</div>
</div>
<div class="paragraph">
-<p>Be sure to use the username matching your Apache ID or the login will
fail.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>If all wen’t well you should now be able to login to the machine
using your apache user.</p>
+<p>Microsoft is offering an installer for MacOS which is available from <a
href="https://dotnet.microsoft.com/download/dotnet-core/2.2";>here</a>.</p>
</div>
</div>
<div class="sect2">
-<h3 id="doing_things_as_root">Doing things as <code>root</code></h3>
-<div class="paragraph">
-<p>Apache Infra is great at keeping things safe.
-Providing a sudo password directly would increase the danger of having this
intercepted, therefore they are using a tool called <code>opiepasswd</code>.</p>
-</div>
+<h3 id="python">python</h3>
<div class="paragraph">
-<p>Instead of now entering a password, a challenge is displayed:</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>myid@plc4x-vm:~$ sudo apt-get update
-otp-md5 496 pl8230
-Password:</pre>
+<pre>python --version</pre>
</div>
</div>
<div class="paragraph">
-<p>If you now enter your normal password, you’ll simply get
<code>permission denied</code> errors.</p>
+<p>If you get a version of 2.7 or higher reported, you probably don’t
need to do anything.</p>
</div>
<div class="paragraph">
-<p>In order to execute operations as root on the machine, you need to use an
opie client.</p>
+<p>In order to install it, please execute the following command:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>otp-md5 496 pl8230</pre>
+<pre>brew install python@2</pre>
+</div>
</div>
</div>
+<div class="sect2">
+<h3 id="bison">bison</h3>
<div class="paragraph">
-<p>into OPIE client’s <code>challenge</code> field.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>python --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>In the <code>password</code> field you provide your Apache LDAP
password.</p>
+<p>If you get a version above 2.3 output, you don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>When hitting enter or clicking on <code>Compute</code> the tool should
automatically generate a response.</p>
+<p>macOS comes with a pre-installed version of bison, however this version is
2.3 and hereby too old.
+So you need to update to a more recent version:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>brew install bison
+brew link bison --force
+echo 'export PATH="/usr/local/opt/bison/bin:$PATH"' >>
~/.bash_profile</pre>
+</div>
</div>
<div class="paragraph">
-<p>Now all you need to do is copy & paste that as password into your SSH
client session.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-As with the latest version of Mac Catalina the existing clients no longer work
and using a public web service is a really bad idea, Apache has a service to
calculate:
-<a href="https://selfserve.apache.org/otp-md5.html";
class="bare">https://selfserve.apache.org/otp-md5.html</a>
-</td>
-</tr>
-</table>
+<p>Be sure to reboot or at least restart your IDE or commandline in order for
the changes to become effective.</p>
</div>
</div>
<div class="sect2">
-<h3 id="required_software">Required software</h3>
+<h3 id="flex">flex</h3>
<div class="paragraph">
-<p>For being able to build the charts and graphics as part of the site
generation, we need to add some additional packages:</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install python-seqdiag
-sudo apt-get install python-nwdiag</pre>
+<pre>flex --version</pre>
+</div>
</div>
+<div class="paragraph">
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
+</div>
+<div class="paragraph">
+<p>It seems macOS comes with a version of flex which is good enough for our
usecases.</p>
</div>
</div>
</div>
diff --git a/developers/infrastructure/vm.html
b/developers/preparing/windows.html
similarity index 68%
copy from developers/infrastructure/vm.html
copy to developers/preparing/windows.html
index 6625df5..5106f2c 100644
--- a/developers/infrastructure/vm.html
+++ b/developers/preparing/windows.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <strong class="nav-link">Windows</strong>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
@@ -139,7 +150,7 @@
<a
href="../../developers/infrastructure/wiki.html" class="nav-link">Wiki</a>
</li>
<li class="nav-item">
- <strong class="nav-link">Build VM</strong>
+ <a href="../../developers/infrastructure/vm.html"
class="nav-link">Build VM</a>
</li>
<li class="nav-item">
<a
href="../../developers/infrastructure/website.html" class="nav-link">Website</a>
@@ -195,148 +206,206 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="the_plc4x_project_vm">The PLC4X Project VM</h2>
+<h2 id="windows">Windows</h2>
<div class="sectionbody">
+<div class="sect2">
+<h3 id="git">Git</h3>
<div class="paragraph">
-<p>As, especially for the raw socket functionality of PLC4X, our project had
higher demands on the infrastructure as other projects.
-Apache Infra kindly provided us with a dedicated VM.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>git --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>This is included as build agent into Apache’s Jenkins with the label
<code>plc4x1</code> and is marked for exclusive usage by our project.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>The host name of this machine is: <code>plc4x-vm.apache.org</code></p>
+<p>In order to install it, please download end execute the installer from <a
href="https://git-scm.com/download/win";>here</a> and make sure to have it add
the git executable to your systems <code>PATH</code>.</p>
+</div>
</div>
+<div class="sect2">
+<h3 id="libpcap">LibPCAP</h3>
<div class="paragraph">
-<p>On this machine we can even <code>sudo</code> to perform operations only
available to <code>root</code>.</p>
+<p>A special version of LibPCAP is available for Windows, which is called
WinPCAP.
+It is available from <a href="https://www.winpcap.org/";>here</a>.</p>
</div>
<div class="paragraph">
-<p>Project members can request access to the machine.</p>
+<p>However this is a based on a very old version (1.0) of LibPCAP and in order
to read PCAPNG files we require a libpcap version 1.1.0 or greater.
+A patched windows version can be found here: <a
href="https://sourceforge.net/projects/winpcap413-176/";
class="bare">https://sourceforge.net/projects/winpcap413-176/</a>
+(At this location is a patched version based on libpcap 1.7.4)</p>
</div>
-<div class="sect2">
-<h3 id="requesting_access">Requesting access</h3>
<div class="paragraph">
-<p>In order to be able to login, users need to add their SSH public key to
their Apache ID first.</p>
+<p>So in order to install things correctly:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>install the version WinPCP from above location.</p>
+</li>
+<li>
+<p>Then download the patched version from the sourceforge link and unpack it
somewhere.</p>
+</li>
+<li>
+<p>After that copy bin\x64\wpcap.dll from archive to \Windows\System32</p>
+</li>
+<li>
+<p>Copy bin\wpcap.dll from archive to \Windows\SysWOW64</p>
+</li>
+</ol>
</div>
<div class="paragraph">
-<p>This is done under the following url: <a href="https://id.apache.org/";
class="bare">https://id.apache.org/</a></p>
+<p>After this all should be working.</p>
</div>
+</div>
+<div class="sect2">
+<h3 id="gcc">gcc</h3>
<div class="paragraph">
-<p>Here just add the content in the follwoing format to one of the <code>SSH
Key (authorized_keys line)</code> fields:</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh-rsa
AAAAB3NzaC1yc2EAAAADAQABAAACAQDd10ykYAZLxHJVTER71IrrVVpyR8OBdlJd1aVwb67Ts+ueJjzo8ofQKLASaQw9EQOSfprGZW0sfzhepeJvbX0n1IfsRexoyIGlD8WzyX/UoLiRLPHFv+eSGJVlN90x/l+zps+yo3lq6qfuIqkXQQvB4aJBYsYC/jifpMLvx06zaUBPfdWIaGiBgaWbX/59Q0QsSpX5r8tgdA+XLw/8Zg5AbKazuS2Cm/soJCfQQ7km4bd/WtF5R5xvakVbyILMT8Dk9Hs9OfVL/RFGLYqX4bjy5uCTwPBrwlWqFyq1u7JR39i870XNgn+bIeChaZU098BGyBH/cWMGt7bTJQSKxksF2SZAHjt8Ga2Pl+J6MTW6/EPzIYENgvfOBVSlVaz9SlM26nel1+SHDND9dK/4gRNbujbmzHZLfTjMk7oc4R+WPCBIw99CFeShTKHSxhJKz/3
[...]
+<pre>gcc --version</pre>
</div>
</div>
<div class="paragraph">
-<p>(I just had to copy this line from my <code>~/.ssh/id_rsa.pub</code>
file)</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-Note, the Email Address in the end doesn’t seem to matter, I simply
added it for the sake of completeness. So if this doesn’t match your
Apache email, this is not a problem.
-</td>
-</tr>
-</table>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>As soon as that’s done, access needs to be requested from Apache
Infra.</p>
+<p>On windows we will be using something called WinBuilds, which is sort of a
package consisting of a typical build environment consisting of multiple build
tools. So please look at the WinBuilds chapter at the end of the Windows
section.</p>
+</div>
</div>
+<div class="sect2">
+<h3 id="g">g++</h3>
<div class="paragraph">
-<p>This is done using the Infra Jira at: <a
href="https://issues.apache.org/jira";
class="bare">https://issues.apache.org/jira</a></p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>g++ --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>Here make sure to select the Project <code>Infrastructure
(INFRA)</code>.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>As soon as that’s handled by the Infra team, you should be ready to
log-in on the machine.</p>
+<p>On windows we will be using something called WinBuilds, which is sort of a
package consisting of a typical build environment consisting of multiple build
tools. So please look at the WinBuilds chapter at the end of the Windows
section.</p>
</div>
</div>
<div class="sect2">
-<h3 id="login_to_the_machine">Login to the machine</h3>
+<h3 id="dotnet">dotnet</h3>
<div class="paragraph">
-<p>Using SSH we should now be able to login to the VM.</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>ssh [email protected]</pre>
+<pre>dotnet --version</pre>
</div>
</div>
<div class="paragraph">
-<p>Be sure to use the username matching your Apache ID or the login will
fail.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>If all wen’t well you should now be able to login to the machine
using your apache user.</p>
+<p>Usually this is already installed on Windows machines.</p>
</div>
</div>
<div class="sect2">
-<h3 id="doing_things_as_root">Doing things as <code>root</code></h3>
+<h3 id="python">python</h3>
+<div class="paragraph">
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>python --version</pre>
+</div>
+</div>
<div class="paragraph">
-<p>Apache Infra is great at keeping things safe.
-Providing a sudo password directly would increase the danger of having this
intercepted, therefore they are using a tool called <code>opiepasswd</code>.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>Instead of now entering a password, a challenge is displayed:</p>
+<p>You can get Python from <a
href="https://www.python.org/downloads/release/python-2716/";>here</a>.</p>
+</div>
+<div class="paragraph">
+<p>Make sure directory containing <code>python.exe</code> is added to your
systems <code>PATH</code>.
+Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="bison">bison</h3>
+<div class="paragraph">
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>myid@plc4x-vm:~$ sudo apt-get update
-otp-md5 496 pl8230
-Password:</pre>
+<pre>bison --version</pre>
+</div>
</div>
+<div class="paragraph">
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
+</div>
+<div class="paragraph">
+<p>For Bison, please download the Setup installer version from <a
href="http://gnuwin32.sourceforge.net/packages/bison.htm";>here</a> (When using
the zip version the bison.exe couldn’t find some DLL files)
+It seems the official 2.4.1 version has issues when installed in a directory
which’s path contains spaces. Please make sure you replace the exe with a
patched version form <a
href="http://marin.jb.free.fr/bison/bison-2.4.1-modified.zip";>here</a>
+(More infos on this issue <a
href="https://sourceforge.net/p/gnuwin32/bugs/473/";>here</a>)</p>
+</div>
+<div class="paragraph">
+<p>It seems there are issues if these tools are installed in paths with spaces.
+So if it is for example installed in the 32 bit <code>Programs (x86)</code>
directory, the build will probably fail.</p>
</div>
<div class="paragraph">
-<p>If you now enter your normal password, you’ll simply get
<code>permission denied</code> errors.</p>
+<p>Make sure all tools <code>bin</code> directories are added to your systems
<code>PATH</code>.
+For tools like OpenSSL be sure to add the directory containing the
<code>openssl.exe</code> (Usually the root directory).
+Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
+</div>
</div>
+<div class="sect2">
+<h3 id="flex">flex</h3>
<div class="paragraph">
-<p>In order to execute operations as root on the machine, you need to use an
opie client.</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>otp-md5 496 pl8230</pre>
+<pre>flex --version</pre>
</div>
</div>
<div class="paragraph">
-<p>into OPIE client’s <code>challenge</code> field.</p>
+<p>If you get any successful output, you probably don’t need to do
anything.</p>
</div>
<div class="paragraph">
-<p>In the <code>password</code> field you provide your Apache LDAP
password.</p>
+<p>Please download the Flex compiler from <a
href="http://gnuwin32.sourceforge.net/packages/flex.htm";>here</a> (Ideally
download the binary zip distribution)</p>
</div>
<div class="paragraph">
-<p>When hitting enter or clicking on <code>Compute</code> the tool should
automatically generate a response.</p>
+<p>Make sure it’s <code>bin</code> directory is added to your systems
<code>PATH</code>.
+Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
+</div>
</div>
+<div class="sect2">
+<h3 id="winbuilds">WinBuilds</h3>
<div class="paragraph">
-<p>Now all you need to do is copy & paste that as password into your SSH
client session.</p>
+<p>He have tested WinBuilds with the bundle found <a
href="http://win-builds.org/doku.php/download_and_installation_from_windows";>here</a>.</p>
</div>
-<div class="admonitionblock tip">
+<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
-<div class="title">Tip</div>
+<div class="title">Warning</div>
</td>
<td class="content">
-As with the latest version of Mac Catalina the existing clients no longer work
and using a public web service is a really bad idea, Apache has a service to
calculate:
-<a href="https://selfserve.apache.org/otp-md5.html";
class="bare">https://selfserve.apache.org/otp-md5.html</a>
+Please use the installer. When using the zip distribution and manually adding
that to the <code>PATH</code> the build will fail without a log output as some
binaries can’t find some of the DLL files.
</td>
</tr>
</table>
</div>
-</div>
-<div class="sect2">
-<h3 id="required_software">Required software</h3>
<div class="paragraph">
-<p>For being able to build the charts and graphics as part of the site
generation, we need to add some additional packages:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>sudo apt-get install python-seqdiag
-sudo apt-get install python-nwdiag</pre>
+<p>When running the installer, make sure to select the options:
+- Native Windows
+- x86_64
+Not quite sure which elements are really needed, better just install all of
them.</p>
</div>
+<div class="paragraph">
+<p>Make sure it’s <code>bin</code> directory is added to your systems
<code>PATH</code>, however the installer should have taken care of this.
+Also make sure you restarted your IDE and or console window after changing the
<code>PATH</code> settings for the changes to take effect.</p>
</div>
</div>
</div>
diff --git a/developers/release/build-tools.html
b/developers/release/build-tools.html
index 1df1f80..5680f00 100644
--- a/developers/release/build-tools.html
+++ b/developers/release/build-tools.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/release/index.html b/developers/release/index.html
index a763848..2c334d0 100644
--- a/developers/release/index.html
+++ b/developers/release/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/release/release.html b/developers/release/release.html
index 5354262..bb47bc0 100644
--- a/developers/release/release.html
+++ b/developers/release/release.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/release/validation.html
b/developers/release/validation.html
index 66952a2..332567e 100644
--- a/developers/release/validation.html
+++ b/developers/release/validation.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/team.html b/developers/team.html
index dd86475..b9cc70a 100644
--- a/developers/team.html
+++ b/developers/team.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/tutorials/index.html b/developers/tutorials/index.html
index 0302c68..4a3ac93 100644
--- a/developers/tutorials/index.html
+++ b/developers/tutorials/index.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/developers/tutorials/writing-driver.html
b/developers/tutorials/writing-driver.html
index 57ea68b..99fee21 100644
--- a/developers/tutorials/writing-driver.html
+++ b/developers/tutorials/writing-driver.html
@@ -83,8 +83,19 @@
<li
class="nav-item">
- <a href="../../developers/preparing.html"
class="nav-link">Preparing your Computer</a>
+ <a href="../../developers/preparing/index.html"
class="nav-link">Preparing your Computer</a>
+ <ul class="flex-column pl-4 nav">
+ <li class="nav-item">
+ <a href="../../developers/preparing/linux.html"
class="nav-link">Liunx</a>
+ </li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/macos.html"
class="nav-link">Mac OS</a>
</li>
+ <li class="nav-item">
+ <a href="../../developers/preparing/windows.html"
class="nav-link">Windows</a>
+ </li>
+ </ul>
+ </li>
<li
class="nav-item">
diff --git a/sitemap.html b/sitemap.html
index 68f11d1..b9f3ddc 100644
--- a/sitemap.html
+++ b/sitemap.html
@@ -194,7 +194,15 @@
<li><a href="developers/index.html">Section Home</a></li>
-<li><a href="developers/preparing.html">Preparing your Computer</a></li>
+<li><a href="developers/preparing/index.html">Preparing your Computer</a>
+
+<ul>
+
+<li><a href="developers/preparing/linux.html">Liunx</a></li>
+
+<li><a href="developers/preparing/macos.html">Mac OS</a></li>
+
+<li><a href="developers/preparing/windows.html">Windows</a></li></ul></li>
<li><a href="developers/building.html">Building</a></li>
![https://www.apache.org/events/current-event-234x60.png"](https://www.apache.org/events/current-event-234x60.png"){kind=link}