Differences

This shows you the differences between two versions of the page.

--- user_guide:howto:jupyter [2021/06/03 18:17] – [jupyter] Add more details on prereq, in particular for Ubuntu lkastner
+++ user_guide:howto:jupyter [2021/06/15 09:02] (current) – [jupyter] Try other browser lkastner
@@ Line 11: / Line 11: @@
 if working with the polymake source. Then please use the polymake binary from the folder you installed polymake in.
-If you use a version of polymake installed via your package manager, make sure you have the `polymake-config` binary. Try running
+If you use a version of polymake installed via your package manager, make sure you have the ''polymake-config'' binary. Try running
 <code>
 polymake-config --version
 </code>
-in a terminal. For example for Ubuntu it is not enough to have the `polymake` package installed, you will also need `libpolymake-dev`.
+in a terminal. For example for Ubuntu it is not enough to have the ''polymake'' package installed, you will also need ''libpolymake-dev''.
 ===== Setup =====
@@ Line 62: / Line 62: @@
 ===== Troubleshooting =====
+If the polymake kernel does not start for you, look at the output of jupyter in the terminal and search for any error messages.
+If you experience issues it makes sense to try a different browser.
+==== JuPyMake.PolymakeError: polymake::Main - /usr/lib/polymake/shared is not a symlink ====
+This error sometimes appears with polymake installed by the package manager. It can be fixed by manually setting the symlink
+<code>
+cd /usr/lib/polymake
+sudo ln -s ../../share/polymake shared
+</code>
 ==== polymake configuration ====
-The default configuration used by the jupyter kernel is the one in `$HOME/.polymake`. If you need to reconfigure a rules file, it is easiest to reconfigure it outside of jupyter. Note that the configuration is only saved to `$HOME/.polymake` once polymake gets closed using `exit;`.
+The default configuration used by the jupyter kernel is the one in ''$HOME/.polymake''. If you need to reconfigure a rules file, it is easiest to reconfigure it outside of jupyter. Note that the configuration is only saved to ''$HOME/.polymake'' once polymake gets closed using ''exit;''.
 Advance users can use a different configuration folder in the following way: