Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added a section on increasing the number of open files on Ubuntu in order to allow the REEF unit tests to run.

...

Code Block
languagepowershell
titlePowerShell command to view JAVA_HOME
$env:JAVA_HOME

Test Environment Configuration

The REEF unit tests require a large number of simultaneously open files to successfully complete. This may or may not be allowed by your platform administrator.

Ubuntu

The default number of open files in an Ubuntu shell is 1024. You can verify this by typing the following command at the shell prompt.

Code Block
languagebash
firstline1
titleulimit
myuser@build> ulimit -n
1024

If you have sudo privileges, you can temporarily increase the number of open files by starting a shell as root, increasing the limit, and then starting a new shell with your login name.

Code Block
languagebash
titleIncrease Ulimit I
sudo bash
ulimit -n 40960
sudo -u myuser bash
mvn clean install

A more permanent fix requires changing values in system files. If the following lines exist in the /etc/security/limits.conf file, update them to a size of at least 40960. If these line do not exist, add them to the end of the file.

Code Block
languagebash
titlelimits.conf
*  soft nofile 40960
*  soft nofile 40960
root soft nofile  40960
root soft nofile 40960

If the following line does not exist in the /etc/pam.d/common-session file, add it.

Code Block
languagebash
titlepam.d
session required pam_limits.so

Reboot your machine.

Now type "ulimit -n" at the shell prompt and you should get return a value of 40960 which should be sufficient to run the REEF unit tests.

Compiling

Java build instructions

...