!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
ATTENTION: Sage is no longer distributed as a VMware Virtual Appliance.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
This is the SAGE VMware Virtual Appliance. For more about SAGE,
see http://www.sagemath.org
REQUIREMENTS: This can be used on any operating system that supports
VMware or the free VMware player, for example Microsoft Windows. Your
computer must have 2.5GB (!) free disk space and 512MB RAM.
INSTALLATION:
Installing SAGE should take 15 to 20 minutes, less than 2GB hard drive
space, and be painless.
1. Download sage-vmware-3.0.zip
2. Extract it anywhere you want:
(This will take about 15 minutes
despite anything Windows tells you. Do *not* stop the
extract halfway through and think SAGE will still work.)
3. Make sure you have installed the free VMware program:
http://www.vmware.com/products/player/
4. Double click on sage_vmx in the sage-vmware-3.0
directory to run SAGE.
USING SAGE:
1. When SAGE starts up, click in the window (and possibly press
Control-G on some computers), then type "notebook" at the prompt to
start the SAGE notebook server.
2. Now you can use SAGE via your web browser from Windows
(it's best to use Firefox).
3. List available optional packages with the optional_packages()
command and type install_package("exact package name") to install a
package. You do this from an input box in the notebook.
4. You can also login to SAGE using ssh (e.g., with putty or cygwin's
openssh) by ssh'ing to the address that you use to view the
notebook:
login name: login
password: sage
5. If you have problems, get free tech support by subscribing to
sage-support:
http://groups.google.com/group/sage-support
How to be a SAGE Developer (more advanced):
Some UNIX familiarity is assumed below. If you've never used anything
but Windows, some of this won't make sense.
1. Install an ssh client, e.g., putty.
2. ssh to the same ip address as the Sage Notebook. E.g., if when you
run notebook it says:
Open Firefox to the address http://172.16.248.137
It may take up to about 10 seconds for the server to start. Press refresh.
(Click here and press control-C twice to stop the notebook server)
then you should ssh to 172.16.248.137. Use the login "login" and the
password "sage".
3. To have permission to change files, become the root user by typing "sudo su":
login@sage:~$ sudo su
root@sage:/home/login#
4. Change to the SAGE_ROOT directory:
root@sage:/home/login# cd /usr/local/sage
root@sage:/usr/local/sage#
5. To actually edit files you'll perhaps want to install the editor
of your choice. E.g., to install emacs do this:
root@sage:/usr/local/sage# apt-get install emacs
...
6. Now type, e.g.,
root@sage:/usr/local/sage# cd devel/sage/sage/rings/
root@sage:/usr/local/sage/devel/sage/sage/rings# emacs arith.py
[edit the file]
7. Save the file, and type "sage -br" to build the changes and install them.
root@sage:/usr/local/sage/devel/sage/sage/rings# sage -br
----------------------------------------------------------
sage: Building and installing modified SAGE library files.
...
----------------------------------------------------------------------
| SAGE Version 3.0, Release Date: ......... |
| Type notebook() for the GUI, and license() for information. |
----------------------------------------------------------------------
sage:
8. Try out your modified Sage!
9. Other options, for those who know a lot about Linux, etc.:
* Install an X server in Windows, e.g., via Cygwin, and window back emacs.
* Install a window manager into the Sage virtual machine and use it.
* Upgrade to the non-free VMware workstation and use a shared filesystem (untested).
10. Upgrading: Type "sage -upgrade" at the command prompt:
root@sage:~# sage -upgrade
...
takes about 20 minutes
This *will* merge your changes to /usr/local/sage/devel/ with the
latest version of Sage and build everything.
WARNING: This will use up more disk space...
11. To save changes and share them with others, be sure to read the
chapter "Mercurial: The SAGE Source Control System" in the programming
guide: http://www.sagemath.org/doc/html/prog/. Once you have
saved a particular banch bundle foo.hg, you need to get it out of
the vmware virtual machine somehow. Options include:
1. Install a program such as http://winscp.net which will allow
you to easily drag and drop windows between the vmware sage virtual
machine and your windows desktop. Be sure to connect to
the ip address using the same login name and password as you
used for ssh before.
2. Type "scp foo.hg username@computer" at the command prompt, e.g.,
root@sage # scp foo.hg wstein@math.washington.edu: