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 5c5145f47 Site checkin for project PLC4X: Jenkins Tools
5c5145f47 is described below
commit 5c5145f47cd5ceb649bc9c58c55a2d41d3b84d54
Author: jenkins <bui...@apache.org>
AuthorDate: Fri May 17 14:17:26 2024 +0000
Site checkin for project PLC4X: Jenkins Tools
---
developers/preparing/index.html | 76 ++++++++++----
developers/preparing/linux.html | 113 ++++++++++++++++----
developers/preparing/macos.html | 68 +++++++++---
developers/preparing/windows.html | 212 ++++++++++++++++----------------------
4 files changed, 296 insertions(+), 173 deletions(-)
diff --git a/developers/preparing/index.html b/developers/preparing/index.html
index 90b84c577..74322c356 100644
--- a/developers/preparing/index.html
+++ b/developers/preparing/index.html
@@ -244,33 +244,65 @@
<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 PLC4X there are some requirements the build is
expecting you to have provided.
-However, this greatly depends on which parts you want to build.
-The <code>Java</code> modules hereby probably have the least demanding
requirements.</p>
+<p>We usually test the PLC4X build on the following systems:</p>
</div>
<div class="paragraph">
-<p>In order to build most Java parts of <code>PLC4X</code> you are required to
have at least <code>Java 9</code> installed on your machine.
-Some integration modules and some other languages however may add some
additional constraints to this.</p>
+<p>width=100%]</p>
</div>
-<div class="admonitionblock tip">
-<table>
+<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="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-We have tested the build with Java 11 up to Java 18 (Latest version at the
time of writing this document).
-</td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Operating
System</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">CPU
Architecture</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Linux</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">x86_64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Most
computers</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Linux</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">aarch64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Linux
running on Macs with M processors (Paralells)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Windows</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">x86_64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Most
computers</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Windows</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">aarch64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Windows
running on Macs with M processors (Paralells)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Mac</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">x86_64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Older
Macs</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Mac</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">aarch64</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Newer Macs
with M processors (Paralells)</p></td>
+</tr>
+</tbody>
</table>
+<div class="paragraph">
+<p>However, when building PLC4X there are some requirements the build is
expecting you to have provided.
+These greatly depend on which parts you want to build.</p>
</div>
<div class="paragraph">
-<p>If a new version comes out, please give us a little time to verify and
handle any related issues.
-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>
+<p>If you’re just building the <code>Java</code> modules, these probably
have the least demanding requirements.
+Also, should the <code>Go</code> parts generally work without any additional
installations as the maven build should automatically pull the required
packages.</p>
</div>
<div class="paragraph">
-<p>Also will PLC4X build with any Maven version starting with <code>Maven
3.3.0</code> however the <code>with-c</code> profile requires at least
<code>Maven 3.6</code> as the <code>cmake-maven-plugin</code> requires this.</p>
+<p>In order to build all Java parts of <code>PLC4X</code> you are required to
have at least <code>Java 11</code> installed on your machine.</p>
</div>
<div class="admonitionblock tip">
<table>
@@ -279,11 +311,19 @@ However, in the past with Oracle’s new release
strategy, there have been a
<div class="title">Tip</div>
</td>
<td class="content">
-Currently, Maven 3.6 and above is required for being able to build all parts
of PLC4X.
+We have tested the build with Java 11 up to Java 21 (Latest version at the
time of writing this document).
</td>
</tr>
</table>
</div>
+<div class="paragraph">
+<p>If a new version comes out, please give us a little time to verify and
handle any related issues.
+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>
+<div class="paragraph">
+<p>Also will PLC4X build with any Maven version starting with <code>Maven
3.6.0</code>.</p>
+</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;"/>
diff --git a/developers/preparing/linux.html b/developers/preparing/linux.html
index 6b411eceb..507c5a617 100644
--- a/developers/preparing/linux.html
+++ b/developers/preparing/linux.html
@@ -240,6 +240,19 @@
<div class="sect1">
<h2 id="linux">Linux</h2>
<div class="sectionbody">
+<div class="paragraph">
+<p>As tracking down issues which result from missing or outdated third party
tools such as compilers are always hard do diagnose, we have extended the build
of PLC4X with a <code>prerequisiteCheck</code> that automatically checks if
required tools are installed and if a required minimum version is available.</p>
+</div>
+<div class="paragraph">
+<p>If any of the prerequisites are not met, the build fails with an error
message that will help finding out what’s wrong.</p>
+</div>
+<div class="paragraph">
+<p>The number of checks is highly dependent on which profiles are enabled.
+So for example the availability and version of the C compiler is only checked
if the <code>with-c</code> profile is enabled.</p>
+</div>
+<div class="paragraph">
+<p>If the check is reporting any issues, please feel free to follow the
corresponding steps in this guide to install the tools.</p>
+</div>
<div class="sect2">
<h3 id="git">Git</h3>
<div class="paragraph">
@@ -258,7 +271,7 @@
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install git</pre>
+<pre>sudo apt install git</pre>
</div>
</div>
<div class="paragraph">
@@ -271,13 +284,40 @@
</div>
</div>
<div class="sect2">
-<h3 id="libpcap">LibPCAP</h3>
+<h3 id="java">Java</h3>
+<div class="paragraph">
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>java --version</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you get successful output indicating at least Java 11, 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 install openjdk-21-jdk</pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="optional_and_other_language_support">Optional and other language
support</h3>
+<div class="paragraph">
+<p>Git an Java should be all you need for building the Java part of PLC4X.</p>
+</div>
+<div class="sect3">
+<h4 id="libpcap_for_raw_ethernet_support">LibPCAP (For raw-ethernet
support)</h4>
<div class="paragraph">
<p>Apt-based systems:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install libpcap-dev</pre>
+<pre>sudo apt install libpcap-dev</pre>
</div>
</div>
<div class="paragraph">
@@ -293,20 +333,41 @@
</div>
<div class="literalblock">
<div class="content">
-<pre>setcap cap_net_raw,cap_net_admin=eip /path/to/java</pre>
+<pre>sudo setcap cap_net_raw,cap_net_admin=eip /path/to/java</pre>
</div>
</div>
<div class="paragraph">
-<p>Sometimes I had to set the uid to execute the java executable with the
permissions of the owner (root) …​ however this is quite
sub-optimal solution.</p>
+<p><code>/path/to/java</code> however needs to be a real file and not a
symlink.
+So on my Ubuntu 22.04 system, where I installed java as described above the
command is as follows:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>chmod 4755 /path/to/java</pre>
+<pre>sudo setcap cap_net_raw,cap_net_admin=eip
/usr/lib/jvm/java-21-openjdk-arm64/bin/java</pre>
</div>
</div>
+<div class="paragraph">
+<p>Sometimes I had to set the uid to execute the java executable with the
permissions of the owner (root) …​ however this is quite suboptimal
solution.</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>sudo chmod 4755 /path/to/java</pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="gcc_for_plc4c">gcc (For PLC4C)</h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+It seems that when running Linux on <code>aarch64</code> (Apple’s
Silicon Chips), that there are issues …​ we’re working on
that. Feel free to watch <a href="https://github.com/apache/plc4x/issues/1582";
class="bare">https://github.com/apache/plc4x/issues/1582</a> on updates to this.
+</td>
+</tr>
+</table>
</div>
-<div class="sect2">
-<h3 id="gcc">gcc</h3>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -323,7 +384,7 @@
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install gcc</pre>
+<pre>sudo apt install gcc</pre>
</div>
</div>
<div class="paragraph">
@@ -335,8 +396,8 @@
</div>
</div>
</div>
-<div class="sect2">
-<h3 id="dotnet">dotnet</h3>
+<div class="sect3">
+<h4 id="dotnet_for_plc4net">dotnet (For PLC4Net)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -358,17 +419,28 @@
<div class="content">
<pre>wget -q
https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
-sudo apt-get install apt-transport-https
-sudo apt-get update
-sudo apt-get install dotnet-sdk-6.0</pre>
+sudo apt install apt-transport-https
+sudo apt update
+sudo apt install dotnet-sdk-6.0</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 class="paragraph">
+<p>If, when checking the version again after installing, you are getting an
error:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>A fatal error occurred. The folder [/usr/share/dotnet/host/fxr] does not
exist</pre>
+</div>
</div>
-<div class="sect2">
-<h3 id="python">python</h3>
+<div class="paragraph">
+<p>Then please have a look at this Stackoverflow post (the accepted solution)
<a
href="https://stackoverflow.com/questions/73753672/a-fatal-error-occurred-the-folder-usr-share-dotnet-host-fxr-does-not-exist";
class="bare">https://stackoverflow.com/questions/73753672/a-fatal-error-occurred-the-folder-usr-share-dotnet-host-fxr-does-not-exist</a></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="python_for_plc4py">python (For PLC4Py)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -385,7 +457,7 @@ sudo apt-get install dotnet-sdk-6.0</pre>
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install python3</pre>
+<pre>sudo apt install python3</pre>
</div>
</div>
<div class="paragraph">
@@ -397,8 +469,8 @@ sudo apt-get install dotnet-sdk-6.0</pre>
</div>
</div>
</div>
-<div class="sect2">
-<h3 id="python_venv">Python venv</h3>
+<div class="sect3">
+<h4 id="python_venv_for_plc4py">Python venv (For PLC4Py)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -416,7 +488,8 @@ It seems that this manually needs to be installed on some
systems.</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>sudo apt-get install python3-venv</pre>
+<pre>sudo apt install python3-venv</pre>
+</div>
</div>
</div>
</div>
diff --git a/developers/preparing/macos.html b/developers/preparing/macos.html
index 0e74b46f2..8463a0324 100644
--- a/developers/preparing/macos.html
+++ b/developers/preparing/macos.html
@@ -241,6 +241,16 @@
<h2 id="mac_os">Mac OS</h2>
<div class="sectionbody">
<div class="paragraph">
+<p>As tracking down issues which result from missing or outdated third party
tools such as compilers are always hard do diagnose, we have extended the build
of PLC4X with a <code>prerequisiteCheck</code> that automatically checks if
required tools are installed and if a required minimum version is available.</p>
+</div>
+<div class="paragraph">
+<p>If any of the prerequisites are not met, the build fails with an error
message that will help finding out what’s wrong.</p>
+</div>
+<div class="paragraph">
+<p>The number of checks is highly dependent on which profiles are enabled.
+So for example the availability and version of the C compiler is only checked
if the <code>with-c</code> profile is enabled.</p>
+</div>
+<div class="paragraph">
<p>Most libraries on Mac are installed using <code>Homebrew</code>.</p>
</div>
<div class="paragraph">
@@ -248,7 +258,7 @@
</div>
<div class="literalblock">
<div class="content">
-<pre>/usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"</pre>
+<pre>/bin/bash -c "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</pre>
</div>
</div>
<div class="sect2">
@@ -265,7 +275,11 @@
<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>
+<p>If you are running this command on a really fresh and clean system, it
might be that you are asked to finish installing the XCode commandline tools.
+If this happens, just follow the process and re-try after it has finished.</p>
+</div>
+<div class="paragraph">
+<p>If you get a response that indicates that git needs to be installed, please
execute the following command:</p>
</div>
<div class="literalblock">
<div class="content">
@@ -274,9 +288,36 @@
</div>
</div>
<div class="sect2">
-<h3 id="libpcap">LibPCAP</h3>
+<h3 id="java">Java</h3>
+<div class="paragraph">
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>java --version</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you get successful output indicating at least Java 11, 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>brew install openjdk</pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="optional_and_other_language_support">Optional and other language
support</h3>
+<div class="paragraph">
+<p>Git an Java should be all you need for building the Java part of PLC4X.</p>
+</div>
+<div class="sect3">
+<h4 id="libpcap_for_raw_ethernet_support">LibPCAP (For raw-ethernet
support)</h4>
<div class="paragraph">
-<p>The libpcap version bundled with Mac OS is currently 1.9.1.
+<p>The libpcap version bundled with macOS is currently 1.9.1.
This version causes exceptions.
So it’s best to update to a newer version using brew:</p>
</div>
@@ -286,8 +327,8 @@ So it’s best to update to a newer version using
brew:</p>
</div>
</div>
</div>
-<div class="sect2">
-<h3 id="gcc">gcc</h3>
+<div class="sect3">
+<h4 id="gcc_for_plc4c">gcc (For PLC4C)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -300,11 +341,11 @@ So it’s best to update to a newer version using
brew:</p>
<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>
+<p>It seems macOS comes with a version of gcc which is good enough for our use
cases.</p>
</div>
</div>
-<div class="sect2">
-<h3 id="dotnet">dotnet</h3>
+<div class="sect3">
+<h4 id="dotnet_for_plc4net">dotnet (For PLC4Net)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -317,7 +358,7 @@ So it’s best to update to a newer version using
brew:</p>
<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>
+<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 class="paragraph">
<p>Alternatively you can also install it via homebrew:</p>
@@ -328,8 +369,8 @@ So it’s best to update to a newer version using
brew:</p>
</div>
</div>
</div>
-<div class="sect2">
-<h3 id="python">python</h3>
+<div class="sect3">
+<h4 id="python_for_plc4py">python (For PLC4Py)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -371,7 +412,7 @@ So it’s best to update to a newer version using
brew:</p>
<div class="literalblock">
<div class="content">
<pre>echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval
"$(pyenv init -)"\nfi' >> ~/.zshrc
-$ echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval
"$(pyenv init -)"\nfi' >> ~/.bash_profile</pre>
+echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv
init -)"\nfi' >> ~/.bash_profile</pre>
</div>
</div>
<div class="paragraph">
@@ -384,6 +425,7 @@ $ echo -e 'if command -v pyenv 1>/dev/null 2>&1;
then\n eval "$(pyenv
</div>
</div>
</div>
+</div>
</div>
</main>
<footer class="pt-4 my-md-5 pt-md-5 w-100 border-top">
diff --git a/developers/preparing/windows.html
b/developers/preparing/windows.html
index 6986547d6..605c45edb 100644
--- a/developers/preparing/windows.html
+++ b/developers/preparing/windows.html
@@ -240,6 +240,22 @@
<div class="sect1">
<h2 id="windows">Windows</h2>
<div class="sectionbody">
+<div class="paragraph">
+<p>As tracking down issues which result from missing or outdated third party
tools such as compilers are always hard do diagnose, we have extended the build
of PLC4X with a <code>prerequisiteCheck</code> that automatically checks if
required tools are installed and if a required minimum version is available.</p>
+</div>
+<div class="paragraph">
+<p>If any of the prerequisites are not met, the build fails with an error
message that will help finding out what’s wrong.</p>
+</div>
+<div class="paragraph">
+<p>The number of checks is highly dependent on which profiles are enabled.
+So for example the availability and version of the C compiler is only checked
if the <code>with-c</code> profile is enabled.</p>
+</div>
+<div class="paragraph">
+<p>As in the past keeping the documentation up to date has been quite
challenging, as the projects providing and packaging some of the needed tools
have been born and dying like weed, we’ll start using Chocolatey as
something similar to Homebrew on Mac or Apt on Linux.</p>
+</div>
+<div class="paragraph">
+<p>So first be sure to install Chocolatey from here: <a
href="https://community.chocolatey.org/";
class="bare">https://community.chocolatey.org/</a> and follow the most recent
instructions on that page in order to install it.</p>
+</div>
<div class="sect2">
<h3 id="git">Git</h3>
<div class="paragraph">
@@ -254,77 +270,107 @@
<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>
+<p>If above command is not successful, simply install it via Chocolatey:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>choco install git</pre>
+</div>
</div>
</div>
<div class="sect2">
-<h3 id="libpcap">LibPCAP</h3>
+<h3 id="java">Java</h3>
<div class="paragraph">
-<p>A special version of LibPCAP is available for Windows, which is called
Npcap.
-It is available from <a href="https://npcap.com/";>here</a>.</p>
+<p>Checking:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>java --version</pre>
+</div>
</div>
<div class="paragraph">
-<p>So in order to install things correctly:</p>
+<p>If you get successful output, check that the version reported is at least
Java 11.
+If you need to install or update Java, unfortunately this doesn’t seem
to be available via Chocolatey, but needs to be installed directly from a
distribution.</p>
</div>
-<div class="olist arabic">
-<ol class="arabic">
+<div class="paragraph">
+<p>For Oracles OpenJDK 21 this would be from here: <a
href="https://learn.microsoft.com/de-de/java/openjdk/download";
class="bare">https://learn.microsoft.com/de-de/java/openjdk/download</a>
+If you are using a Windows VM on <code>aarch64</code> (Apple M1 or M2 virtual
machine), the download available from Microsoft build seem to be one of the few
options you have. When installing make sure to select the option to configure
the "JAVA_HOME" environment variable (deactivated per default).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="optional_and_other_language_support">Optional and other language
support</h3>
+<div class="paragraph">
+<p>Git an Java should be all you need for building the Java part of PLC4X.</p>
+</div>
+<div class="sect3">
+<h4 id="libpcap_for_raw_ethernet_support">LibPCAP (For raw-ethernet
support)</h4>
+<div class="paragraph">
+<p>In order to use the raw ethernet transport capabilities of PLC4X, we need
to ensure the NPcap library is installed.</p>
+</div>
+<div class="paragraph">
+<p>In order to check if NPcap is installed, check the following
directories:</p>
+</div>
+<div class="paragraph">
+<p>64-bit versions:</p>
+</div>
+<div class="ulist">
+<ul>
<li>
-<p>install the version Npcap from above location.</p>
+<p>C:\Windows\System32\packet.dll</p>
</li>
<li>
-<p>Add <code>%SystemRoot%\System32\Npcap\</code> to your System’s
<code>PATH</code></p>
+<p>C:\Windows\System32\wpcap.dll</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>32-bit versions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>C:\Windows\SysWOW64\packet.dll</p>
</li>
<li>
-<p>Possibly reboot</p>
+<p>C:\Windows\SysWOW64\wpcap.dll</p>
</li>
-</ol>
+</ul>
</div>
<div class="paragraph">
-<p>After this all should be working.</p>
+<p>If none of these can be found, install it by downloading the installer from
<a href="https://npcap.com/#download";
class="bare">https://npcap.com/#download</a></p>
</div>
-<div class="paragraph">
-<p>If not, have a look here for possible help: <a
href="https://github.com/kaitoy/pcap4j#about-native-library-loading";>here</a></p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-If you had WinPcap installed, you need to uninstall this and make sure the
files <code>Packet.dll</code> and <code>wpcap.dll</code> are deleted in the
<code>%SystemRoot%\System32\</code> directory. Otherwise <code>pcap4j</code>
will incorrectly detect a wrong version.
-</td>
-</tr>
-</table>
</div>
+<div class="sect3">
+<h4 id="gcc_for_plc4c">gcc (For PLC4C)</h4>
<div class="paragraph">
-<p>An alternative is to use the version that comes with nmap</p>
+<p>Checking:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>choco install -y nmap</pre>
+<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="sect2">
-<h3 id="gcc">gcc</h3>
<div class="paragraph">
-<p>Checking:</p>
+<p>If above command fails, please install MinGW from an Administrative console
with the following command:</p>
</div>
<div class="literalblock">
<div class="content">
-<pre>gcc --version</pre>
+<pre>choco install mingw</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>
+<p><a
href="https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/";
class="bare">https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/</a>
+Download:
+<a
href="https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/cmake-binaries-3.27.7-b1-windows-arm_64.jar";
class="bare">https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/cmake-binaries-3.27.7-b1-windows-arm_64.jar</a>
+Deploy as:
+<a
href="https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/cmake-binaries-3.27.7-b1-windows-arm64.jar";
class="bare">https://repo.maven.apache.org/maven2/com/googlecode/cmake-maven-project/cmake-binaries/3.27.7-b1/cmake-binaries-3.27.7-b1-windows-arm64.jar</a></p>
</div>
</div>
-<div class="sect2">
-<h3 id="dotnet">dotnet</h3>
+<div class="sect3">
+<h4 id="dotnet_for_plc4net">dotnet (For PLC4Net)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -340,12 +386,11 @@ If you had WinPcap installed, you need to uninstall this
and make sure the files
<p>Usually this is already installed on Windows machines.</p>
</div>
<div class="paragraph">
-<p>Download the installer from <a
href="https://dotnet.microsoft.com/download/dotnet-core/3.1";>here</a>
-(Be sure to download an installer from the second column labeled <code>Build
apps - SDK</code>)</p>
+<p>Download the installer from <a
href="https://dotnet.microsoft.com/en-us/download";>here</a></p>
</div>
</div>
-<div class="sect2">
-<h3 id="python">python</h3>
+<div class="sect3">
+<h4 id="python_for_plc4py">python (For PLC4Py)</h4>
<div class="paragraph">
<p>Checking:</p>
</div>
@@ -358,96 +403,19 @@ If you had WinPcap installed, you need to uninstall this
and make sure the files
<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>
+<p>You can get Python from <a
href="https://www.python.org/downloads/windows/";>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="winbuilds">WinBuilds</h3>
-<div class="paragraph">
-<p>We 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="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-When installing in virtual machines. Make sure to run the installer from a
path referring to a local hard-disk <code>C:</code>, <code>D:</code>
…​ when using Paralells the location of the <code>Downloads</code>
or <code>Desktop</code> is a shared directory on your Mac.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-When installing in virtual machines. Please <strong>don’t</strong>
install to any of Windows' <code>Program Files</code> directories. Strange
things will happen.
-</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>When running the setup, be sure to leave the setting on the <code>line
ending conversions</code> on <code>Checkout Windows-style, commit Unix-style
line endings</code>, this will cause specially in the generated code, a lot of
false-dirty files, however when selecting other options that check out the code
with Unix line endings (the repo is in this state) the build will fail.</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 class="sect2">
-<h3 id="openssl">OpenSSL</h3>
-<div class="paragraph">
-<p>It is encouraged to build them yourself, but binaries can be downloaded
from sites like:
-<a href="https://slproweb.com/products/Win32OpenSSL.html";>this</a></p>
-</div>
<div class="paragraph">
-<p>Usually I download the 64Bit installer.</p>
+<p><a href="https://visualstudio.microsoft.com/de/visual-cpp-build-tools/";
class="bare">https://visualstudio.microsoft.com/de/visual-cpp-build-tools/</a></p>
</div>
<div class="paragraph">
-<p>Be sure to add the <code>bin</code> directory to the systems Path.</p>
+<p>PLC4PY Build doesn’t work on Aarch64 on Windows</p>
</div>
</div>
-<div class="sect2">
-<h3 id="clang">Clang</h3>
-<div class="paragraph">
-<p>Pre-Compiled Clang executables seem to be shipped with <code>Visual Studio
Community</code> edition. So if you have this installed, just make sure the
executables are available on the path.</p>
-</div>
-<div class="paragraph">
-<p>If not, it’s a little tricky to find pre-compiled binaries for
windows.</p>
-</div>
-<div class="paragraph">
-<p>Seem the versions available <a
href="https://releases.llvm.org/download.html";>here</a> to the trick.
-Download and install the <code>LLVM</code> package.</p>
-</div>
-<div class="paragraph">
-<p>Select to add the LLVM to the path (doesn’t matter if just for the
current user or for all)</p>
-</div>
</div>
</div>
</div>
