|
E.3 Unix installation instructions
The possibilities for installing SINGULAR on a Unix or Linux system range from
a purely manual installation over a convenient installation of RPM or DEB
packages up to a completely automated installation via a package tool like
apt or yum.
For a Linux system with RPM (like Redhat/Fedora, Mandrake/Mandriva, SuSE etc.),
or with DEB (like Debian, Ubuntu etc.) one should follow
the intructions at http://www.singular.uni-kl.de/UNIX/.
The manual installation (for all other Unix systems) is described below:
To install SINGULAR on a
Unix
platform, you need the following two
archives:
a:
- Singular-3-1-6-share.tar.gz
contains architecture independent data like documentation and libraries.
b:
- Singular-3-1-6-uname.tar.gz
contains architecture dependent executables, like the SINGULAR
program.
uname is a description of the processor and operating system
for which SINGULAR is compiled (e.g, ix86-Linux ). Please contact us if
you cannot find an appropriate architecture dependent archive.
You can obtain these (and other) archives from
To install SINGULAR
Make sure that you have approximately 20 MByte of free disk space and follow
these steps.
-
Simply change to the directory in which you wish to install
SINGULAR (usually wherever you install 3rd-party software), for example:
| cd /usr/local
or
mkdir install;cd install
(you do not need root privileges in this case)
|
SINGULAR specific subdirectories will be created in such a way
that multiple versions and multiple architecture dependent files
of SINGULAR can peaceably coexist under the same /usr/local
tree.
-
Unpack the archives:
| gzip -dc <path_to>/Singular-3-1-6-uname.tar.gz | tar -pxf -
gzip -dc <path_to>/Singular-3-1-6-share.tar.gz | tar -pxf -
|
This creates the directory Singular/3-1-6 with
(sub)directories |
which contain
|
uname |
Singular and ESingular executables
|
LIB |
SINGULAR libraries (*.lib files)
|
emacs |
files for the SINGULAR Emacs user interface
|
info |
info files of SINGULAR manual
|
html |
html files of SINGULAR manual
|
doc |
miscellaneous documentation files
|
examples |
SINGULAR examples (*.sing files)
|
For the executable to work, the directory layout must look pretty much
like this; the executable will look for "sibling" directories at run-time
to figure out where its SINGULAR libraries and on-line
documentation files are. These constraints on the local directory layout
are necessary to avoid having to hard-code pathnames into the
executables, or require that environment variables be set before
running the executable. In particular, you must not move or copy
the SINGULAR executables to another place, but use soft-links
instead.
The following steps are optional:
-
Arrange that typing
Singular at the shell prompt starts up the
installed SINGULAR executable.
If you have root permission, do:
| ln -s `pwd`/Singular/3-1-6/uname/Singular /usr/local/bin/Singular-3-1-6
ln -s `pwd`/Singular/3-1-6/uname/ESingular /usr/local/bin/ESingular-3-1-6
ln -s /usr/local/bin/Singular-3-1-6 /usr/local/bin/Singular
ln -s /usr/local/bin/ESingular-3-1-6 /usr/local/bin/ESingular
|
Otherwise, append the directory
`pwd`/Singular/3-1-6/uname/ to your $PATH
environment variable. For the csh (or, tcsh ) shell do:
| set path=(`pwd`/Singular/3-1-6/uname $path)
| For the bash (or, ksh ) shell do:
| export PATH=`pwd`/Singular/3-1-6/uname/:$PATH
|
You also might want to adjust your personal start-up files
(~/.cshrc for csh , ~/.tcshrc for tcsh , or
~/.profile for bash ) accordingly,
so that the $PATH variable is set automatically each time you login.
IMPORTANT: Do never move or copy the file
Singular/3-1-6/uname/Singular to another
place, but use soft-links instead.
-
If you wish to use any of the following features of
SINGULAR, make sure that the respective programs are installed on your system:
Feature | Requires |
running ESingular , or Singular within Emacs |
Emacs version
20 or higher, or, XEmacs version 20.3 or
higher (ESingular is only included in the Linux distribution.
On other Unix platforms you can download the
SINGULAR emacs lisp files but we give no warranties for specific platforms).
|
on-line html help |
any web browser
|
on-line info help |
info, or
tkinfo texinfo browser programs
|
TAB completion and history mechanism of ASCII-terminal interface |
shared readline
library, i.e. /usr/lib/libreadline.so
|
visualization of curves and surfaces |
surfer
Setup executable for the visualization tool surfer.
|
You may download most of these programs from
- Customize the on-line help system:
By default, on-line help is displayed in html format using
a web browser.
However, this behavior can be customized in several ways
using the SINGULAR commands system("--browser",<browser>)
and system("--allow-net", 1) (or, by starting up SINGULAR
with the respective command line options).
In particular, creating the file
Singular/3-1-6/LIB/.singularrc and putting the
SINGULAR command
| system("--allow-net", 1);
| in it, allows the on-line help system to fetch its html pages
from Singular's WWW
home site
in case its local html pages are not found. That is, you may delete your
local html pages, after setting this option.
See also
The online help system, Command line options, and
Startup sequence,
for more details on customizing the on-line help system.
-
Add the line
| * Singular:(singular.hlp). A system for polynomial computations
| to your system-wide dir file (usually /usr/info/dir or
/usr/local/info/dir and copy or soft-link the file
Singular/3-1-6/info/singular.hlp
to the directory of your dir file.
This assures that the
SINGULAR manual can be accessed from stand-alone texinfo
browser programs such as info or Emacs .
(This is not a prerequisite for using the help system from within Singular .)
Troubleshooting
|