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:
unameis 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
Important: Please see
for license information on SINGULAR. Please register yourself as a
SINGULAR user by using the registration form on the SINGULAR
If for some reason you cannot access the registration form, you can also
register by sending an email to firstname.lastname@example.org
with subject line
register and body containing the following data:
your name, email address, organisation, country and platform(s).
Make sure that you have approximately 20 MByte of free disk space and follow these steps.
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
gzip -dc <path_to>/Singular-3-1-4-uname.tar.gz | tar -pxf - gzip -dc <path_to>/Singular-3-1-4-share.tar.gz | tar -pxf -
This creates the directory Singular/3-1-4 with
|| SINGULAR libraries (|
||files for the SINGULAR Emacs user interface|
||info files of SINGULAR manual|
||html files of SINGULAR manual|
||miscellaneous documentation files|
|| SINGULAR examples (|
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:
Singularat the shell prompt starts up the installed SINGULAR executable.
If you have root permission, do:
ln -s `pwd`/Singular/3-1-4/uname/Singular /usr/local/bin/Singular-3-1-4 ln -s `pwd`/Singular/3-1-4/uname/ESingular /usr/local/bin/ESingular-3-1-4 ln -s /usr/local/bin/Singular-3-1-4 /usr/local/bin/Singular ln -s /usr/local/bin/ESingular-3-1-4 /usr/local/bin/ESingular
$PATHenvironment variable. For the
tcsh) shell do:
set path=(`pwd`/Singular/3-1-4/uname $path)
ksh) shell do:
You also might want to adjust your personal start-up files
so that the
$PATH variable is set automatically each time you login.
IMPORTANT: Do never move or copy the file
Singular/3-1-4/uname/Singular to another
place, but use soft-links instead.
||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).|
||any web browser|
||info, or tkinfo texinfo browser programs|
|TAB completion and history mechanism of ASCII-terminal interface|| shared readline
library, i.e. |
|visualization of curves and surfaces||surfer Setup executable for the visualization tool surfer.|
You may download most of these programs from
By default, on-line help is displayed in
html format using
However, this behavior can be customized in several ways
using the SINGULAR commands
system("--allow-net", 1) (or, by starting up SINGULAR
with the respective command line options).
In particular, creating the file
Singular/3-1-4/LIB/.singularrc and putting the
htmlpages 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 sections The online help system, Command line options, and Startup sequence in the SINGULAR manual for more details on customizing the on-line help system.
* Singular:(singular.hlp). A system for polynomial computations
/usr/local/info/dirand copy or soft-link the file
Singular/3-1-4/info/singular.hlpto the directory of your
Emacs. (This is not a prerequisite for using the help system from within
cdto the directory where you unpacked SINGULAR, and do (as root, if necessary):
chmod -R a+rX Singular
system("Singular");. If this does not return the correct and expanded location of the SINGULAR executable, then you found a bug in SINGULAR, which we ask you to report (see below).
$bindirdenotes the directory where the SINGULAR executable resides, then SINGULAR looks for library files as follows:
infofiles need to be at
You can inspect the found library and
directories by starting up SINGULAR with the
--version option, or by issuing the SINGULAR command
/dev/pty*of the standard SuSE distribution (starting from version 6.3 on). The problem may still be present when working with the latest SuSE-Linux release. As root, do one of the following: Either
chmod 666 /dev/pty*
chmod g+s $(which emacs) chgrp tty $(which emacs) chmod g+s $(which xemacs) chgrp tty $(which xemacs)
Can not find shared library ...
ln -s /usr/lib/libncurses.so /usr/lib/libncurses.so.4.
infoprogram of the system is not GNU's texinfo browser which is used to display the on-line documentation in the
infoformat. Therefore, the distribution of the AIX executable already contains the
infobrowser program. If you remove this program, make sure that the GNU
infoprogram is executed if you call '
info' from your shell.
-voption, and a description of your machine (issue the command
uname -aon your shell) in your report.
GOOD LUCK and ENJOY! Your SINGULAR team.