Installation

From FITSH
Revision as of 19:30, 8 September 2016 by Apal (Talk | contribs)

Jump to: navigation, search

By default, the FITSH package does not have any specific dependence. You only have a C compiler (e.g. GCC) and the related standard development headers (that are usually placed in the directory /usr/include) on your system. See also the list of supported operating systems and architectures below.

System-wide installation

The current stable version of the program is 0.9.1, you can browse the available versions here. Instailling the package from the source tarball might go as follows. After extracting the archive, by entering simply (for the latest version):

# cd /usr/src
# wget http://fitsh.net/download/fitsh/fitsh-0.9.1.tar.gz
# tar xvzf fitsh-0.9.1.tar.gz

Then, go to the appropriate sub-directory (fitsh-0.9.1, by issuing cd fitsh-0.9.1), and run the standard configure && make procedure, i.e.:

# ./configure

which is followed by

# make

After a successful compilation, the binaries and some related libraries might be installed into the target filesystem hierarchy location by entering

# make install

The "root" of the filesystem hierarchy is the /usr/local directory by default. In order to place the binaries to another location, use an alternative prefix for ./configure, for instance:

# ./configure --prefix=/opt

Local installation for a single user

If you do not have rights on the computer for system administration, i.e. you cannot install anything under /opt or /usr/local, you can safely use your home directory (or a subdirectory in it) in order to install the package. Supposing that your username is myuser (see also the output of the `whoami` command) and your home directory is /home/myuser, simply type

$ ./configure --prefix=/home/myuser/usr

The installation procedure (see make install above) will then create the subdirectories /home/mysuer/usr/bin, /home/mysuer/usr/lib and /home/mysuer/usr/include where the task binaries, lfit shared objects and lfit module headers are installed, respectively. In this case, you should put the directory /home/mysuer/usr/bin into your path in order to access the FITSH tasks from everywhere (at least, from your account). Follow your shell's guidelines to do so, if you use the bash shell, put something similar into your ~/.bashrc file:

export PATH=/home/mysuer/usr/bin:${PATH}

Install as a Debian package

If the DPKG packaging system and the help2man utility is installed on your system, you can use the target

$ make deb

to create a Debian package. In order to install this newly created package, use the command dpkg:

# dpkg --install ./fitsh_0.9.1_amd64.deb

or use your alternative/favourite Debian package manager. Note that the newly created Debian package is always placed into the root of the source tree. Note also that while the make deb target doesn't require root privileges, the dpkg --install ... does so.

Supported operating systems

During the development of the FITSH package, it was tested under the following operating systems and architectures:

  • Debian GNU/Linux, specifically releases lenny and squeeze, both on i386 and amd64 architectures. This is also the primary development platform of the package.
  • NetBSD, release 5.0.2 on i386 architecture.
  • Mac OS X, release 10.6.8 (``Snow Leopard).

The complier was always the system default C compiler from the GNU Compiler Collection (GCC). Since the primary development platfrom is Debian, some compilation-time warnings may occur on other operating systems (even on the above ones).

Personal tools