Differences

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

--- installation [2022/07/26 10:48] – [Prerequisites] vanessa
+++ installation [2023/05/12 18:05] (current) – [Quickstart with Docker] arthur
@@ Line 1: / Line 1: @@
 ====== CRAM installation ======
+===== Quickstart with Docker =====
+For a quick peek into CRAM, check out [[https://github.com/cram2/cram_teaching|the Docker setup]] and the [[ https://seafile.zfn.uni-bremen.de/f/04e12809b4d347bebf71/| visual setup procedure]].
 ===== Prerequisites =====
 == OS and ROS ==
-The recommended setup is Ubuntu 18.04 LTS with ROS Melodic. \\
+The recommended setup is Ubuntu 20.04 LTS with ROS Noetic. \\
 This is the setup under which the CRAM team is working and it is best supported.
@@ Line 34: / Line 37: @@
 You will need those for setting up the ROS workspace and checking out code.
-.04 / Melodic:
+__**18.04 / Melodic:**__
 <code bash>
 $ sudo apt-get install python-rosinstall python-wstool
 </code>
-:04 / Noetic:
+__**20:04 / Noetic:**__
 <code bash>
 $ sudo apt-get install python3-wstool
@@ Line 170: / Line 173: @@
 <code bash>
   source $HOME/workspace/ros/devel/setup.bash
+</code>
+=== CRAM and dependencies installation (ROS Noetic Ubuntu 20.04) ===
+Please checkout the [[https://github.com/cram2/cram/blob/devel/README.md|README]] on the devel branch of the [[https://github.com/cram2/cram/tree/devel|CRAM github repository]] for the most recent installation instructions. The noetic support is currently still in development.
+<code bash>
+$ sudo apt install ros-noetic-roslisp-repl
+$ sudo apt-get install python-rosinstall python-wstool
+$ cd ~/workspace/src
+$ wstool init
+$ wstool merge https://raw.githubusercontent.com/cram2/cram/devel/cram-20.04.rosinstall
+$ wstool update
+$ cd ~/workspace/
+$ rosdep update
+$ rosdep install --ignore-src --from-paths src/ -r
+$ catkin_make
 </code>
@@ Line 261: / Line 282: @@
 If something went wrong consult the [[/support|Support page]] or feel free to drop an email to the person maintaining this page (check the "Last edited by" part of the footer).
+==== Windows Install ====
+  - Enable Hardware Virtualization in your BIOS settings
+  - [[https://medium.com/javarevisited/using-wsl-2-with-x-server-linux-on-windows-a372263533c3|Install, configure and launch VcXsrv]]
+  - Enable the WSL 2 feature in ''Turn Windows features on or off''
+  - Set Firewall to allow WSL comunication. Easiest way is by disabling Firewall for public networks, or add a rule for WSL.
+  - [[https://seafile.zfn.uni-bremen.de/f/8960a515395f4a96b97b/|Download the WSL image]]
+  - Import the image into WSL from Powershell with <code> wsl --import Ubuntu-20.04-Cram C:\Users\$env:UserName\Documents\Ubuntu-20.04-Cram C:\Users\$env:UserName\Downloads\Ubuntu2004RosCramJupyter.tar </code>
+  - Set the image as default with <code>wsl --set-default Ubuntu-20.04-Cram</code>
+  - Launch Ubuntu-20.04 from the windows menu. The username and password is ''cram''
+  - ''glxgears'' will test the x-forwarding to VcXsrv. If nothing happens, check the VcXsrv setup and Firewall rules.
+  - ''roslisp_repl &'' will launch Emacs.
+Happy hacking!
+=== How to launch the Jupyter Notebook ===
+  - ''roslaunch cram_pr2_pick_place_demo sandbox.launch &''
+  - ''jupyter-lab --allow-root --no-browser --port 8888''
+  - Open the URL in your browser
 ===== Get ready for development =====