Repository: incubator-systemml Updated Branches: refs/heads/master 67395b832 -> bdc1f4edb
[SYSTEMML-498] Troubleshooting Guide with commons-math3 issue Closes #104. Project: http://git-wip-us.apache.org/repos/asf/incubator-systemml/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-systemml/commit/bdc1f4ed Tree: http://git-wip-us.apache.org/repos/asf/incubator-systemml/tree/bdc1f4ed Diff: http://git-wip-us.apache.org/repos/asf/incubator-systemml/diff/bdc1f4ed Branch: refs/heads/master Commit: bdc1f4edb5dd1f1713a99338e640a4a73500dc78 Parents: 67395b8 Author: Deron Eriksson <[email protected]> Authored: Thu Apr 7 10:13:05 2016 -0700 Committer: Deron Eriksson <[email protected]> Committed: Thu Apr 7 10:13:05 2016 -0700 ---------------------------------------------------------------------- docs/_layouts/global.html | 1 + docs/index.md | 4 +++ docs/troubleshooting-guide.md | 52 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 57 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-systemml/blob/bdc1f4ed/docs/_layouts/global.html ---------------------------------------------------------------------- diff --git a/docs/_layouts/global.html b/docs/_layouts/global.html index c359559..f2c74bd 100644 --- a/docs/_layouts/global.html +++ b/docs/_layouts/global.html @@ -62,6 +62,7 @@ <li class="divider"></li> <li><b>Other:</b></li> <li><a href="contributing-to-systemml.html">Contributing to SystemML</a></li> + <li><a href="troubleshooting-guide.html">Troubleshooting Guide</a></li> </ul> </li> </ul> http://git-wip-us.apache.org/repos/asf/incubator-systemml/blob/bdc1f4ed/docs/index.md ---------------------------------------------------------------------- diff --git a/docs/index.md b/docs/index.md index 3d80042..56f4ed4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -82,3 +82,7 @@ machine learning algorithms included with SystemML in detail. command-line interface. * [IDE Guide](developer-tools-systemml.html) - Useful IDE Guide for Developing SystemML. +## Other + +* [Contributing to SystemML](contributing-to-systemml.html) - Describes ways to contribute to SystemML. +* [Troubleshooting Guide](troubleshooting-guide.html) - Troubleshoot various issues related to SystemML. http://git-wip-us.apache.org/repos/asf/incubator-systemml/blob/bdc1f4ed/docs/troubleshooting-guide.md ---------------------------------------------------------------------- diff --git a/docs/troubleshooting-guide.md b/docs/troubleshooting-guide.md new file mode 100644 index 0000000..f8cc745 --- /dev/null +++ b/docs/troubleshooting-guide.md @@ -0,0 +1,52 @@ +--- +layout: global +title: Troubleshooting Guide +description: Troubleshooting Guide +--- +<!-- +{% comment %} +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 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +{% endcomment %} +--> + +* This will become a table of contents (this text will be scraped). +{:toc} + +<br/> + + +## ClassNotFoundException for commons-math3 + +The Apache Commons Math library is utilized by SystemML. The commons-math3 +dependency is included with Spark and with newer versions of Hadoop. Running +SystemML on an older Hadoop cluster can potentially generate an error such +as the following due to the missing commons-math3 dependency: + + java.lang.ClassNotFoundException: org.apache.commons.math3.linear.RealMatrix + +This issue can be fixed by changing the commons-math3 `scope` in the pom.xml file +from `provided` to `compile`. + + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-math3</artifactId> + <version>3.1.1</version> + <scope>compile</scope> + </dependency> + +SystemML can then be rebuilt with the `commons-math3` dependency using +Maven (`mvn clean package -P distribution`). +
