IPython notebook - Revision history

Admin: Better ordering procedure

2016-10-05T13:32:12Z

Better ordering procedure

← Older revision		Revision as of 13:32, 5 October 2016
Line 1:		Line 1:
	IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.		IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.


	~~=Set the environment=~~
	~~IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.~~

	* To load from the custom build [deprecated] :
	~~<pre>source /software/sources/latestEnvironment.source</pre>~~

	* To load from CVMFS :
	~~See [[IceCube Software Cluster#CVMFS]]~~

	=Launch a notebook=		=Launch a notebook=

	~~first, connect~~ to the cluster.		# Connect to the cluster.
	~~Set~~ the ~~correct environment~~ and ~~launch~~ a notebook to which you will later connect to from your laptop:		# Load an environment :
			#:IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.
	<pre>		#:* To load from the custom build [deprecated] :
	ipython notebook --no-browser --pylab inline</pre>		#:*:<pre>source /software/sources/latestEnvironment.source</pre>
			#:* To load from CVMFS :
			#:*:See [[IceCube Software Cluster#CVMFS]]
	When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.		# Launch a notebook to which you will later connect to from your laptop:
	The launcher reports this port in the following way:		#:<pre>ipython notebook --no-browser --pylab inline</pre>
	<pre>		#:When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.
	The IPython Notebook is running at: http://127.0.0.1:8888/		#:The launcher reports this port in the following way:
	</pre>		#:<pre>The IPython Notebook is running at: http://127.0.0.1:8888/</pre>
	The port number you need it the number coming after the colon (:).		#:*The port number [PORT_NUMBER] you need is the number coming after the colon (:).
			#:*The m-machine [M-MACHINE] is the machine where you launched the notebook.
	~~Now, open~~ a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:		# Open a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:
			#:<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER M-MACHINE.iihe.ac.be</pre>
	<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER ~~uixx~~.iihe.ac.be</pre>		# The tunneled notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER

	The ~~tunnelled~~ notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER

	=Links=		=Links=
	http://ipython.org/		http://ipython.org/

Admin: /* Where is it */

2016-10-05T13:11:18Z

Where is it

← Older revision		Revision as of 13:11, 5 October 2016
Line 2:		Line 2:


	=~~Where is it~~=		=Set the environment=
	IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.		IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.

Admin: Remove latestenv in example

2016-10-05T13:10:44Z

Remove latestenv in example

← Older revision		Revision as of 13:10, 5 October 2016
Line 17:		Line 17:

	<pre>		<pre>
	~~source /software/sources/latestEnvironment.source~~
	ipython notebook --no-browser --pylab inline</pre>		ipython notebook --no-browser --pylab inline</pre>

Admin at 12:25, 5 October 2016

2016-10-05T12:25:34Z

← Older revision		Revision as of 12:25, 5 October 2016
Line 6:		Line 6:

	* To load from the custom build [deprecated] :		* To load from the custom build [deprecated] :
	<pre>source /software/sources/latestEnvironment</pre>		<pre>source /software/sources/latestEnvironment.source</pre>

	* To load from CVMFS :		* To load from CVMFS :
Line 12:		Line 12:

	=Launch a notebook=		=Launch a notebook=
	~~When launching the notebook, the system will create a dedicated server listening to localhost (default) running on a specific port.~~

	~~Launch~~ the notebook ~~(it~~ will ~~choose an available port)~~		first, connect to the cluster.
	~~<pre>ipython notebook --no-browser --pylab inline</pre>~~		Set the correct environment and launch a notebook to which you will later connect to from your laptop:

	~~Create~~ a tunnel ~~from your~~ machine ~~(see output of previous~~ command ~~for PORT_NUMBER)~~		<pre>
			source /software/sources/latestEnvironment.source
			ipython notebook --no-browser --pylab inline</pre>


			When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.
			The launcher reports this port in the following way:
			<pre>
			The IPython Notebook is running at: http://127.0.0.1:8888/
			</pre>
			The port number you need it the number coming after the colon (:).

			Now, open a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:

	<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>		<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>

	~~Open the~~ tunnelled notebook in your browser by opening the url : http://localhost:PORT_NUMBER		The tunnelled notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER

	=Links=		=Links=
	http://ipython.org/		http://ipython.org/

Admin: /* Launch a notebook */

2016-10-05T12:06:15Z

Launch a notebook

← Older revision		Revision as of 12:06, 5 October 2016
Line 15:		Line 15:

	Launch the notebook (it will choose an available port)		Launch the notebook (it will choose an available port)
	<pre>ipython notebook --pylab inline</pre>		<pre>ipython notebook --no-browser --pylab inline</pre>

	Create a tunnel from your machine (see output of previous command for PORT_NUMBER)		Create a tunnel from your machine (see output of previous command for PORT_NUMBER)

Admin: /* Launch a notebook */

2016-10-05T12:05:04Z

Launch a notebook

← Older revision		Revision as of 12:05, 5 October 2016
Line 14:		Line 14:
	When launching the notebook, the system will create a dedicated server listening to localhost (default) running on a specific port.		When launching the notebook, the system will create a dedicated server listening to localhost (default) running on a specific port.

	Launch the notebook ~~with a chosen~~ port ~~number~~		Launch the notebook (it will choose an available port)
	<pre>ipython notebook ~~--port=PORT_NUMBER~~ --pylab inline</pre>		<pre>ipython notebook --pylab inline</pre>

			Create a tunnel from your machine (see output of previous command for PORT_NUMBER)

	~~Create a tunnel from your machine~~
	<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>		<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>

Admin: /* Where is it */

2016-10-05T11:55:51Z

Where is it

← Older revision		Revision as of 11:55, 5 October 2016
Line 5:		Line 5:
	IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.		IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.

	To load from the custom build :		* To load from the custom build [deprecated] :
	<pre>source /software/sources/latestEnvironment</pre>		<pre>source /software/sources/latestEnvironment</pre>

	To load from CVMFS :		* To load from CVMFS :
	See [[IceCube Software Cluster#CVMFS]]		See [[IceCube Software Cluster#CVMFS]]

Admin at 11:55, 5 October 2016

2016-10-05T11:55:13Z

@@ Line 14: / Line 14: @@
 When launching the notebook, the system will create a dedicated server listening to localhost (default) running on a specific port.
-==Access from the outside==
+Launch the notebook with a chosen port number
 <pre>ipython notebook --port=PORT_NUMBER --pylab inline</pre>

Admin: /* Access via SSH tunnel */

2014-11-17T13:50:56Z

Access via SSH tunnel

← Older revision		Revision as of 13:50, 17 November 2014
Line 32:		Line 32:

	Create a tunnel from your machine		Create a tunnel from your machine
	<pre>ssh -L PORT_NUMBER:uixx.iihe.ac.be~~:PORT_NUMBER~~</pre>		<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>

	Open the tunnelled notebook in your browser by opening the url : http://localhost:PORT_NUMBER		Open the tunnelled notebook in your browser by opening the url : http://localhost:PORT_NUMBER

Admin at 13:45, 17 November 2014

2014-11-17T13:45:12Z

← Older revision		Revision as of 13:45, 17 November 2014
Line 1:		Line 1:
	IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.		IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.
	~~When launching the notebook, the system will create a dedicated server running on a specific port.~~

	~~=How to launch it=~~
	~~IPython notebook is available on the cluster in 2 environment : the custom build and cvmfs.~~

	To load the custom build :		=Where is it=
			IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.

			To load from the custom build :
	<pre>source /software/sources/latestEnvironment</pre>		<pre>source /software/sources/latestEnvironment</pre>

Line 11:		Line 11:
	See [[IceCube Software Cluster#CVMFS]]		See [[IceCube Software Cluster#CVMFS]]

			=Launch a notebook=
			When launching the notebook, the system will create a dedicated server listening to localhost (default) running on a specific port.

			==Access from the outside==
	To launch your notebook and access it from the outside (your browser) :		To launch your notebook and access it from the outside (your browser) :

	<pre>ipython notebook --ip=UI_URL --port=PORT_NUMBER --pylab inline</pre>		<pre>ipython notebook --ip=UI_URL --port=PORT_NUMBER --pylab inline</pre>

	Where UI_URL is the ui url where you launched the command (eg. ui01.iihe.ac.be) and PORT_NUMBER is a custom defined port that you have to choose (between 1025 and 65635)		Where UI_URL is the ui url where you launched the command (eg. ui01.iihe.ac.be) and PORT_NUMBER is a custom defined port that you have to choose (between 1025 and 65635)
	Then, open the url http://UI_URL:PORT_NUMBER from your web browser.		Then, open the url http://UI_URL:PORT_NUMBER from your web browser.

	WARNING :		WARNING :
	Using this method will expose your notebook to the outside (internet), that means if someone ~~get the PORT_NUMBER~~, he can do whatever he wants on ~~this notebook~~. The safest way is to use a SSH tunnel.		Using this method will expose your notebook to the outside (internet), that means if someone open your notebook, he can do whatever he wants on it. The safest way is to use a SSH tunnel.

			==Access via SSH tunnel==
			This way is more secure but a bit more complex

			Launch the notebook only on localhost
			<pre>ipython notebook --port=PORT_NUMBER --pylab inline</pre>

			Create a tunnel from your machine
			<pre>ssh -L PORT_NUMBER:uixx.iihe.ac.be:PORT_NUMBER</pre>

			Open the tunnelled notebook in your browser by opening the url : http://localhost:PORT_NUMBER

	=Links=		=Links=
	http://ipython.org/		http://ipython.org/