From 26a196eb723563b59f37c1239a0cb79a634c3741 Mon Sep 17 00:00:00 2001 From: Scott Lanning Date: Mon, 14 Aug 2017 14:37:19 +0200 Subject: [PATCH 1/2] document Ubuntu packages needed for `make test` When running `make test`: The "java" and "local_example" tests failed due to not having `mvn`, so I needed to install the "maven" package. The "vtctld_web" test failed due to "Can't start Xvfb ... No such file or directory" and "WebDriverException: Message: unknown error: cannot find Chrome binary, so I needed to install the "xvfb" and "chromium-browser" packages. --- docs/getting-started/local-instance.html | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/getting-started/local-instance.html b/docs/getting-started/local-instance.html index d29512af3e2..02e1eeca832 100644 --- a/docs/getting-started/local-instance.html +++ b/docs/getting-started/local-instance.html @@ -430,6 +430,10 @@

Ubuntu and Debian

  • If you decided to use ZooKeeper in step 3, you also need to install a Java Runtime, such as OpenJDK.

    $ sudo apt-get install openjdk-7-jre
    +
    + +

    To run the tests, also install:

    +
    $ sudo apt-get install chromium-browser mvn xvfb
     
  • From 153f1c9b728e7e7d78abc42ad45e017f271a7331 Mon Sep 17 00:00:00 2001 From: Scott Lanning Date: Tue, 15 Aug 2017 14:47:07 +0200 Subject: [PATCH 2/2] moved to "Run Tests" section and the proper file in "doc" directory changes requested by @michael-berlin --- doc/GettingStarted.md | 6 ++++++ docs/getting-started/local-instance.html | 4 ---- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/doc/GettingStarted.md b/doc/GettingStarted.md index f590371022f..c30e558cdff 100644 --- a/doc/GettingStarted.md +++ b/doc/GettingStarted.md @@ -289,6 +289,12 @@ simulate a small Vitess cluster by launching many servers on the local machine. To do so, they require a lot of resources; a minimum of 8GB RAM and SSD is recommended to run the tests. +Some tests require extra packages. For example, on Ubuntu: + +``` sh +$ sudo apt-get install chromium-browser mvn xvfb +``` + If you want only to check that Vitess is working in your environment, you can run a lighter set of tests: diff --git a/docs/getting-started/local-instance.html b/docs/getting-started/local-instance.html index 02e1eeca832..d29512af3e2 100644 --- a/docs/getting-started/local-instance.html +++ b/docs/getting-started/local-instance.html @@ -430,10 +430,6 @@

    Ubuntu and Debian

  • If you decided to use ZooKeeper in step 3, you also need to install a Java Runtime, such as OpenJDK.

    $ sudo apt-get install openjdk-7-jre
    -
    - -

    To run the tests, also install:

    -
    $ sudo apt-get install chromium-browser mvn xvfb