license: | Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
To build SparkR on Windows, the following steps are required
Make sure bash
is available and in PATH
if you already have a built-in bash
on Windows. If you do not have, install Cygwin.
Install R (>= 3.5) and Rtools. Make sure to include Rtools and R in PATH
.
Install JDK that SparkR supports (see R/pkg/DESCRIPTION
), and set JAVA_HOME
in the system environment variables.
Download and install Maven. Also include the bin
directory in Maven in PATH
.
Set MAVEN_OPTS
as described in Building Spark.
Open a command shell (cmd
) in the Spark directory and build Spark with Maven and include the -Psparkr
profile to build the R package. For example to use the default Hadoop versions you can run
mvn.cmd -DskipTests -Psparkr package
Note that .\build\mvn
is a shell script so mvn.cmd
on the system should be used directly on Windows. Make sure your Maven version is matched to maven.version
in ./pom.xml
.
Note that it is a workaround for SparkR developers on Windows. Apache Spark does not officially support to build on Windows yet whereas it supports to run on Windows.
To run the SparkR unit tests on Windows, the following steps are required —assuming you are in the Spark root directory and do not have Apache Hadoop installed already:
Create a folder to download Hadoop related files for Windows. For example, cd ..
and mkdir hadoop
.
Download the relevant Hadoop bin package from steveloughran/winutils. While these are not official ASF artifacts, they are built from the ASF release git hashes by a Hadoop PMC member on a dedicated Windows VM. For further reading, consult Windows Problems on the Hadoop wiki.
Install the files into hadoop\bin
; make sure that winutils.exe
and hadoop.dll
are present.
Set the environment variable HADOOP_HOME
to the full path to the newly created hadoop
directory.
Run unit tests for SparkR by running the command below. You need to install the needed packages following the instructions under Running R Tests first:
.\bin\spark-submit2.cmd --conf spark.hadoop.fs.defaultFS="file:///" R\pkg\tests\run-all.R