https://github.com/korniichuk/sagecell
The SageMathCell installer
https://github.com/korniichuk/sagecell
Last synced: 4 months ago
JSON representation
The SageMathCell installer
- Host: GitHub
- URL: https://github.com/korniichuk/sagecell
- Owner: korniichuk
- License: unlicense
- Created: 2015-06-15T14:40:36.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2016-02-26T00:11:59.000Z (over 9 years ago)
- Last Synced: 2025-06-14T05:04:52.617Z (4 months ago)
- Language: Python
- Homepage:
- Size: 236 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
.. contents:: Table of contents
:depth: 3
Introduction
============
Yep, you can use this `NOT simple installation `_. Oops, does not work. Use the SageMathCell installer, because it is just easier :).
Portability
===========
The SageMathCell installer tested on **Ubuntu Server 14.04 LTS**, **Ubuntu Desktop 14.04 LTS**, **Ubuntu Desktop 15.04** and **Debian 7.8**.
Installation
============
Install the sagecell from PyPI
------------------------------
::
$ sudo pip install sagecell
Install the sagecell from GitHub
--------------------------------
::
$ sudo pip install git+git://github.com/korniichuk/sagecell#egg=sagecell
Upgrade the sagecell from PyPI
------------------------------
::
$ sudo pip install -U sagecell
or::
$ sudo pip install --upgrade sagecell
Uninstall the sagecell
----------------------
::
$ sudo pip uninstall sagecell
Development installation
========================
::
$ git clone git://github.com/korniichuk/sagecell.git
$ cd sagecell
$ sudo pip install .
Quickstart
==========
**First**, install the SageMathCell::
$ sagecell install
**Second**, make sure that you can login to a localhost without entering password::
$ ssh localhost
.. note:: You can `setup SSH for auto login to localhost without a password`_ like this: ``$ sagecell ssh``.
**Third**, start the SageMathCell::
$ sagecell start
.. important:: Do not close the current terminal.
**Fourth**, open a new terminal for the next command::
$ sagecell open
This command open browser with the SageMathCell.
Express
-------
::
$ sagecell install
$ sagecell ssh
$ sagecell start
# In a new terminal
$ sagecell open
User guide
==========
Help
----
The standard output for –help::
$ sagecell -h
or::
$ sagecell --help
For information on using subcommand "SUBCOMMAND", do::
$ sagecell SUBCOMMAND -h
or::
$ sagecell SUBCOMMAND --help
Example::
$ sagecell install -h
Version
-------
The standard output for –version::
$ sagecell -v
or::
$ sagecell --version
Install the SageMathCell
------------------------
::
$ sagecell install
Start the SageMathCell
----------------------
::
$ sagecell start
Open browser with the SageMathCell
----------------------------------
::
$ sagecell open
.. image:: ./img/user_guide-_open_browser_with_the_sagemathcell_0001_728px.png
:alt: user guide: open browser with the sagemathcell [prtscn]
Setup SSH for auto login to localhost without a password
--------------------------------------------------------
::
$ sagecell ssh
If you are familiar with `ssh-keygen `_, `ssh-copy-id `_ and `ssh-add `_, this code also setup SSH for auto login to localhost without a password [1]_::
$ ssh-keygen -t rsa -b 4096 -N '' -f ~/.ssh/id_rsa
$ ssh-copy-id localhost
$ eval "$(ssh-agent -s)"
$ ssh-add ~/.ssh/id_rsa
Start the SageMathCell automatically on boot
--------------------------------------------
With the SageMathCell installer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
$ sagecell auto
.. note:: The default port number is 8888.
For changing a port number. First, open the ``/usr/local/bin/sagecellscript`` file::
$ sudo nano /usr/local/bin/sagecellscript
or::
$ su -c "nano /usr/local/bin/sagecellscript"
Second, change the last line from::
../sage/sage web_server.py
to::
../sage/sage web_server.py -p PORT_NUMBER
Where:
* ``PORT_NUMBER`` -- a port number.
Example::
../sage/sage web_server.py -p 6363
Without the SageMathCell installer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
First, install `screen `_::
$ sudo apt-get install screen
or::
$ su -c "apt-get install screen"
Second, create the ``/usr/local/sbin/sagecellscript`` file::
#! /bin/sh
cd ~/sc_build/sagecell
../sage/sage web_server.py
or::
#! /bin/sh
cd ~/sc_build/sagecell
../sage/sage web_server.py -p PORT_NUMBER
Where:
* ``PORT_NUMBER`` -- a port number.
.. note:: The default port number is 8888.
Example::
#! /bin/sh
cd ~/sc_build/sagecell
../sage/sage web_server.py -p 6363
Third, make the ``/usr/local/sbin/sagecellscript`` file executable::
$ sudo chmod 755 /usr/local/sbin/sagecellscript
or::
$ su -c "chmod 755 /usr/local/sbin/sagecellscript"
Fourth, open the ``/etc/rc.local`` file::
$ sudo nano /etc/rc.local
or::
$ su -c "nano /etc/rc.local"
Add the next command below the comment, but leave the line ``exit 0`` at the end, then save the file and exit::
sudo -u USERNAME screen -dmS sagecell /usr/local/sbin/sagecellscript
or::
su USERNAME -c "screen -dmS sagecell /usr/local/sbin/sagecellscript"
Where:
* ``USERNAME`` -- a username.
Example::
sudo -u albert screen -dmS sagecell /usr/local/sbin/sagecellscript
or::
su albert -c "screen -dmS sagecell /usr/local/sbin/sagecellscript"
Transfer a short temporary links
--------------------------------
Replace the ``~/sc_build/sagecell/sqlite.db`` file with a `shortened temporary links `_::
$ scp SOURCE_FILE REMOTE_USERNAME@REMOTE_HOST:~/sc_build/sagecell/sqlite.db
Example::
$ scp ~/Downloads/sqlite4transfer.db \
albert@192.168.0.1:~/sc_build/sagecell/sqlite.db
Disable the terms of service requirement
----------------------------------------
For disabling the terms of service requirement. First, open the ``~/sc_build/sagecell/config.py`` file::
$ nano ~/sc_build/sagecell/config.py
Second, change the line of code from::
requires_tos = True
to::
requires_tos = False
Third, reboot a server from command line::
$ reboot
.. rubric:: Footnotes
.. [1] https://help.github.com/articles/generating-ssh-keys/