You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by va...@apache.org on 2022/05/07 21:40:41 UTC
[lucene-site] branch master updated: refreshed requirements and installation instructions
This is an automated email from the ASF dual-hosted git repository.
vajda pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/lucene-site.git
The following commit(s) were added to refs/heads/master by this push:
new 5ccdb9bab refreshed requirements and installation instructions
5ccdb9bab is described below
commit 5ccdb9bab9e9a60a7fa38fd3ea2eb9d46b4badac
Author: Andi Vajda <va...@apache.org>
AuthorDate: Sat May 7 14:40:25 2022 -0700
refreshed requirements and installation instructions
---
content/pages/pylucene/index.md | 5 ++-
content/pages/pylucene/install.md | 17 +++------
content/pages/pylucene/jcc/install.md | 41 ++++++++++++----------
.../pylucene_news/2021-12-15-8-11-0.available.md | 2 +-
.../pylucene_news/2022-04-27-9-1-0-available.md | 2 +-
5 files changed, 32 insertions(+), 35 deletions(-)
diff --git a/content/pages/pylucene/index.md b/content/pages/pylucene/index.md
index ef70f3123..6534b01c2 100644
--- a/content/pages/pylucene/index.md
+++ b/content/pages/pylucene/index.md
@@ -27,9 +27,8 @@ See [here](features.html) for more information and documentation about PyLucene.
PyLucene is supported on macOS, Linux, Solaris and Windows.
PyLucene requires Python 3.x (x >= 3), or Python version 2.x (x >= 3.5), and
-Java x (x >= 8). Building PyLucene requires GNU Make, a recent version of
-[Ant](https://ant.apache.org) capable of building Java
-[Lucene](https://lucene.apache.org/java/) and a C++ compiler. Use of
+Java x (x >= 8 for PyLucene 8 and earlier, x >= 11 for PyLucene 9).
+Building PyLucene requires GNU Make and a C++ compiler. Use of
[setuptools](https://pypi.python.org/pypi/setuptools) is recommended.
See the JCC [installation](jcc/install.html) instructions for more information
diff --git a/content/pages/pylucene/install.md b/content/pages/pylucene/install.md
index 354f3f9b2..006b6beb9 100644
--- a/content/pages/pylucene/install.md
+++ b/content/pages/pylucene/install.md
@@ -10,21 +10,14 @@ PyLucene sources.
## Requirements
-To build PyLucene a Java Development Kit (JDK) and [Ant](https://ant.apache.org)
-are required; use of the resulting PyLucene binaries requires only a Java Runtime
-Environment (JRE).
+To build PyLucene a Java Development Kit is required; use of the resulting PyLucene binaries requires only a Java Runtime Environment (JRE).
+A recent C/C++ compiler is also required.
+**Attention:** Starting with release 9.x, Lucene requires Java 11 or above.<br/>
**Attention:** Starting with release 6.x, Lucene requires Java 1.8.
-On macOS, you will need to install Oracle Java 8, and due to a
-[bug](https://bugs.openjdk.java.net/browse/JDK-7131356) in the JDK for macOS,
-you will **also** need to install Apple's Java 1.6.
-
-On macOS, once installed, a way to make Java 1.8 the default in your bash shell is:<br/>
-```
-$ export JAVA_HOME=\`/usr/libexec/java_home\`
-```
-Be sure to verify that JAVA_HOME value.
+On macos and linux, the [Temurin JDK](https://adoptium.net/) is recommended.
+See "Notes for Linux" at [this page](jcc/install.html) for installation instructions on Linux Debian 11.
On any system, if you're upgrading your Java installation, please rebuild
JCC as well. You must use the same version of Java for both JCC and PyLucene.
diff --git a/content/pages/pylucene/jcc/install.md b/content/pages/pylucene/jcc/install.md
index bd1b15953..b0475695d 100644
--- a/content/pages/pylucene/jcc/install.md
+++ b/content/pages/pylucene/jcc/install.md
@@ -8,8 +8,10 @@ template: lucene/pylucene/jcc/page
JCC's source code is included with PyLucene's. If you've downloaded the PyLucene
source code already, JCC's is to be found in the _jcc_ subdirectory.
-To get the JCC source code only from SVN use:<br/>
-`$ svn co https://svn.apache.org/repos/asf/lucene/pylucene/trunk/jcc jcc`
+To get the JCC source code only from SVN use:
+```
+svn co https://svn.apache.org/repos/asf/lucene/pylucene/trunk/jcc jcc
+```
## Building JCC
@@ -31,18 +33,15 @@ compile the extensions it is used to generate code for.
- At the command line, enter:
```
-$ python setup.py build<br/>
-$ sudo python setup.py install<br/>
+python setup.py build
+sudo python setup.py install
```
## Requirements
-JCC requires a Java Development Kit to be present. It uses the Java Native Invocation
-Interface and expects _<jni.h>_ and the Java libraries to be present at build
-and runtime.
+JCC requires a Java Development Kit to be present. It uses the Java Native Invocation (JNI) interface and expects _<jni.h>_ and the Java libraries to be present at build and runtime.
-JCC requires a C++ compiler. A recent C++ compiler for your platform is expected
-to work as expected.
+JCC requires a C++ compiler. A recent C++ compiler for your platform is recommeded and should work as expected.
## Shared Mode: Support for the _--shared_ Flag
@@ -113,21 +112,27 @@ JCC has been built and tested on a variety of Linux distributions, 32- and 64-bi
Getting the java configuration correct is important and is done differently for
every distribution.<br/>For example:
-- On Ubuntu, to install Java 5, these commands may be used:
+- On Debian 11, the commands below install Temurin Java 17, Python 3.9, gcc, g++ and make
+
+install Temurin Java (Adoptium)
```
- $ sudo apt-get install sun-java5-jdk<br/>
- $ sudo update-java-alternatives -s java-1.5.0-sun<br/>
+sudo -s
+apt install wget apt-transport-https gnupg
+wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | apt-key add -
+echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
```
-The samples flags for Linux in JCC's setup.py should be close to correct.
-- On Gentoo, the _java-config_ utility should be used to locate, and possibly
-change, the default java installation. The sample flags for Linux in JCC's
-_setup.py_ should be changed to reflect the root of the Java installation which
-may be obtained via:
+install gcc, g++ and make
```
- $ java-config -O
+sudo apt install gcc-x86-64-linux-gnu g++-x86-64-linux-gnu make
```
+install Python 3.9 with development, virtual environment and setuptools support
+```
+sudo apt install python3.9-dev python3-venv python3-setuptools
+```
+
+The samples flags for Linux in JCC's setup.py should be close to correct.
See earlier section about [Shared Mode](#shared) for Linux support.
## Notes for Solaris 11 with Sun Studio C++ 12
diff --git a/content/pylucene/pylucene_news/2021-12-15-8-11-0.available.md b/content/pylucene/pylucene_news/2021-12-15-8-11-0.available.md
index 49b3434f5..77c8e899f 100644
--- a/content/pylucene/pylucene_news/2021-12-15-8-11-0.available.md
+++ b/content/pylucene/pylucene_news/2021-12-15-8-11-0.available.md
@@ -3,6 +3,6 @@ category: pylucene/news
URL:
save_as:
-This release tracks Lucene Core's 8.11.0 <a href="https://lucene.apache.org/core/corenews.html">release</a>.<br/>
+This release tracks Lucene Core's 8.11.0 <a href="https://lucene.apache.org/core/corenews.html">release</a> and requires Java 8.<br/>
See <a href="https://svn.apache.org/repos/asf/lucene/pylucene/tags/pylucene_8_11_0/CHANGES">PyLucene 8.11.0 CHANGES</a> and <a href="https://svn.apache.org/repos/asf/lucene/pylucene/tags/pylucene_8_11_0/jcc/CHANGES">JCC 3.11 CHANGES</a> for details.<br/>
Source distributions are available <a href="https://www.apache.org/dyn/closer.lua/lucene/pylucene/">here</a>.<br/>
diff --git a/content/pylucene/pylucene_news/2022-04-27-9-1-0-available.md b/content/pylucene/pylucene_news/2022-04-27-9-1-0-available.md
index a52516de6..3769add24 100644
--- a/content/pylucene/pylucene_news/2022-04-27-9-1-0-available.md
+++ b/content/pylucene/pylucene_news/2022-04-27-9-1-0-available.md
@@ -3,6 +3,6 @@ category: pylucene/news
URL:
save_as:
-This release tracks Lucene Core's 9.1.0 <a href="https://lucene.apache.org/core/corenews.html">release</a>.<br/>
+This release tracks Lucene Core's 9.1.0 <a href="https://lucene.apache.org/core/corenews.html">release</a> and requires Java 11.<br/>
See <a href="https://svn.apache.org/repos/asf/lucene/pylucene/tags/pylucene_9_1_0/CHANGES">PyLucene 9.1.0 CHANGES</a> and <a href="https://svn.apache.org/repos/asf/lucene/pylucene/tags/pylucene_9_1_0/jcc/CHANGES">JCC 3.12 CHANGES</a> for details.<br/>
Source distributions are available <a href="https://www.apache.org/dyn/closer.lua/lucene/pylucene/">here</a>.<br/>