"Fossies" - the Fresh Open Source Software Archive

Member "geoserver-2.19.0/src/README.txt" (18 Mar 2021, 2511 Bytes) of package /linux/www/geoserver-2.19.0.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 This README helps you getting started with GeoServer development. It will guide you through the process of checking out the source code, compiling it, and running.
    2 
    3 GeoServer Development requires Java 8, Maven, and git. Due to subtle changes in Java class libraries we require development on Java 8 at this time (although the result is tested on Java 11).
    4 
    5 
    6 Further readings:
    7   http://docs.geoserver.org/latest/en/developer/index.html
    8 
    9 == Linux ==
   10 
   11 1) Install prerequisites
   12 
   13 Obtain OpenJDK 8, Maven and git from your Linux distribution.
   14 
   15 
   16 == macOS ==
   17 
   18 1) Install Java Runtime Environment
   19 
   20 Download and install Java 8 runtime environment, as provided by AdoptOpenJDK macOS installers.
   21 https://adoptopenjdk.net
   22 
   23 Update your shell environment with:
   24   export JAVA_HOME=/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home
   25   
   26 The system /usr/bin/java makes use of JAVA_HOME setting above.
   27 
   28 2) Download and install git
   29 https://git-scm.com/download/mac
   30 
   31 3) Download and install Maven 3
   32 http://maven.apache.org/download.html
   33 
   34 == Windows ==
   35 
   36 1) Install Java Runtime Environment
   37 Download and install Java 8 runtime environment, as provided by AdoptOpenJDK windows installers.
   38 https://adoptopenjdk.net
   39 
   40 Update Windows *Environment Variables*:
   41 
   42 
   43 * Create an environment variable JAVA_HOME and point it to your Java SDK directory.
   44 * Modify the PATH variable and add: ;%JAVA_HOME%/bin
   45 
   46 2) Download and install git
   47 https://git-scm.com/download/windows
   48 
   49 3) Download and install Maven 3
   50 http://maven.apache.org/download.html
   51 
   52 == OS independent tasks ==
   53 
   54 1) Get the source code
   55 Go to the command line and run:
   56   git clone https://github.com/geoserver/geoserver.git
   57 
   58 2) Build the source code
   59 Go to the command line and navigate to the folder you just checked out. Now run:
   60   cd geoserver
   61   cd src
   62   mvn clean install
   63 
   64 3) Running locally
   65   cd web/app
   66   mvn jetty:run
   67 
   68 == Troubleshooting ==
   69 
   70 The build process may fail because of several reasons:
   71 
   72 * Unavailable dependencies - Maven tries to download dependencies which might not be available on the server side yet.
   73 Solution: Try again in some minutes.
   74 
   75 * Failing tests - Maven runs existing tests automatically. If some of them fail, the build fails.
   76 Solution: You can tell maven not to run the tests. This is discouraged.
   77 Bug the developers instead or fix the test and send a patch, thanks!
   78 If you really just want to disable the test, run maven like so:
   79   mvn -DskipTests=true install