INSTRUCTIONS FOR INSTALLING LINUX POPLOG VERSION 15.65

• Installing on Ubuntu and other Debian linuxes using 'apt-get install'
• Installing on Fedora and other Redhat-based linuxes using 'yum install'
• Installing on Arch linux using 'pacman'

Prerequisites

NOTE: this is a 32 bit version of Poplog
If you are using a 64 bit version of linux you will need to have a full complement of 32-bit development libraries in order to install 32 bit poplog. In particular your 32 bit libraries should go in /usr/lib and 64 bit libraries in /usr/lib64

Failing that there is a 64 bit version of poplog here (not quite as up to date as the 32 bit version and has a few minor problems):

    http://www.cs.bham.ac.uk/research/projects/poplog/v15.63-amd64/

---

• UBUNTU/DEBIAN USERS
  NEW 21 Apr 2012:
  UPDATED 29 Apr 2012:

  A shell script can be downloaded, made executable and run to install all the pre-requisites on Ubuntu, and then download and install 32-bit poplog.
  Download this file and put it somewhere like /usr/local/poplog-download

  http://www.cs.bham.ac.uk/research/projects/poplog/latest-poplog/get-ubuntu-poplog
  

  Make it executable:

      sudo chmod 755 get-ubuntu-poplog
  

  Run it

      sudo ./get-ubuntu-poplog
  

  Follow the instructions printed out at the end to test the installation using scripts in

      /usr/local/poplog/current-poplog/bin/demos
  

  Report any problems to A.Sloman[AT]cs.bham.ac.uk including the install.log file.

  Suggestions for improving the script and/or the instructions welcome.

  See the video on installing poplog here:
  http://www.cs.bham.ac.uk/research/projects/poplog/cas-ai/vid.html

  As an alternative to running the above script
  Ubuntu users (and other Debian users e.g. Xandros(Not yet tested)) should make sure that they have these packages installed before installing poplog:

      gcc
      build-essential
      tcsh
      libxext-dev
      libx11-dev
      libxt-dev
      EITHER
          libmotif-dev
      OR
          lesstif2-dev
  

  The last two (motif or lesstif2) are desirable but optional, as explained below. (motif may no longer be available, but lesstif should be).

  You can install those packages either using the synaptic package manager, or more simply by using 'apt-get' with this command in an xterm or console window (if you don't wish to type everything in one line you can use the backslash character "\" to indicate that lines must be joined in a single command, as illustrated here):

      sudo apt-get install gcc build-essential tcsh  \
           libxext-dev libx11-dev libxt-dev liblesstif-dev
  

  However, that command may not work until you have extended the set of package repositories. Run the package manager by going to the 'System menu'. Select 'Administration' then 'Synaptic package manager' -- for which you will have to type your password. Then when the package manager starts up, select 'Settings' then 'Repositories'. Click in all the boxes for packages downloadable from the internet, except for the source packages. After that you should be able to download all the packages.

  The instructions for setting up the extra package repositories and for selecting packages to download are illustrated graphically in David Brooks' web site for Poplog users (though some of the required packages need to be added to his list.) See his web page here:
  http://www.cs.bham.ac.uk/research/projects/poplog/ubuntu/djb

  Make sure that you install everything listed above.

  After installing those 'X' libraries the following should exist as symbolic links:

      /usr/lib/libX11.so
      /usr/lib/libXt.so
      /usr/lib/libXext.so
      /usr/lib/libXm.so      (if you installed motif or lesstif)
  

  Optional
  If you would like to try the linear algebra package included in the popvision library ( $usepop/pop/packages/popvision ) then add this command to install the BLAS and LAPACK linear algebra libraries:

      apt-get install libblas-dev liblapack-dev
  

  That can be done after installing Poplog.

  ---

• RPM USERS (Fedora, Redhat, Scientific Linux, CentOS)
  NEW 29 Apr 2012:
  UPDATED 29 Apr 2012:

  A shell script can be downloaded, made executable and run to install the pre-requisites, and then download and install 32-bit poplog.
  Download this file and put it somewhere like /usr/local/poplog-download

  http://www.cs.bham.ac.uk/research/projects/poplog/latest-poplog/get-fedora-poplog
  

  Make it executable:

      sudo chmod 755 get-fedora-poplog
  

  Run it

      sudo ./get-fedora-poplog
  

  Follow the instructions printed out at the end to test the installation using scripts in

      /usr/local/poplog/current-poplog/bin/demos
  

  Report any problems to A.Sloman[AT]cs.bham.ac.uk including the install.log file.

  Suggestions for improving the script and/or the instructions welcome.

  See the video on installing poplog here:
  http://www.cs.bham.ac.uk/research/projects/poplog/cas-ai/vid.html

  Optional If you would like to try the linear algebra package included in the popvision library ( $usepop/pop/packages/popvision )
  then add this command to install the BLAS and LAPACK linear algebra libraries:

      yum install blas-devel lapack-devel
  

  That can be done after installing Poplog.

  ---

• ARCH LINUX USERS
  NEW 25 May 2012:
  (not yet fully tested)

  I am not an Arch user, so I am grateful to Peter Lewis for advice and suggestions.
  I welcome criticisms and further suggestions from Arch users who try this system.
  
  Peter has produced this script, which may suffice for knowledgable Arch users:
      https://aur.archlinux.org/packages/po/poplog/PKGBUILD
  
  Arch users wishing to get the latest poplog directly from here should be able to install
  it provided that
  (a) if 64-bit arch is in use then the Multilib facilities will have to be enabled
  as described in
      http://www.archlinux.org/news/true-multilib-for-arch-linux-x86_64/
  
  (b) a collection of libraries has been installed, especially xterm, and
      'lib32-libxext' 'lib32-libxt' 'lib32-openmotif' 'lib32-libxp' 'tcsh'
  
  and optionally 'espeak' (useful for some of the demos).
  
  Try downloading and running this script, which will attempt to install
  the above packages, then give you the option to abort or continue, then
  install poplog in /usr/local/poplog (plus a few symbolic links):
  
      http://www.cs.bham.ac.uk/research/projects/poplog/latest-poplog/get-arch-poplog
  
  

---

NOTE: Other versions of linux
People using other versions of linux should check that they have the gcc libraries, csh/tcsh and "development" versions of

    either
        motif

    or
        lesstif

E.g. you should be able to install one of those using 'yum install' in RedHat/Fedora systems:

    yum install motif-devel

or
    yum install lesstif-devel

Make sure that you have the 'devel' packages for the X11 libraries installed. Otherwise the link commands in the poplog installation scripts will fail. E.g. you could use the following, in addition to the commands for installing motif (or lesstif):

    yum install libX11-devel libXt-devel libXext-devel

If you would like to try the linear algebra package included in the popvision library ( $usepop/pop/packages/popvision ) then add this command to install the BLAS and LAPACK linear algebra libraries:

    yum install blas-devel lapack-devel

That can be done after installing Poplog.

(Automatically done if you use one of the "get-and-install" scripts described below.)

25 May 2012 - NOTE: The file CHECK_LINUX_FACILITIES has been improved
Download, make executable, and run this file to check that you have an installation on which poplog can be installed:
http://www.cs.bham.ac.uk/research/poplog/latest-poplog/CHECK_LINUX_FACILITIES
After downloading it do this to make it executable, then run it:

      chmod 755 CHECK_LINUX_FACILITIES
      ./CHECK_LINUX_FACILITIES

NOTE: The following is no longer true, as making symbolic links is not an adequate substitute for installing the 'devel' or 'dev' packages:

If you run it as super user (using sudo on Ubuntu) it may also create directories and links that you will need. Otherwise, it merely reports what it finds.

NOTE: use of 'csh'

Many linux systems now do not provide /bin/csh. Some older poplog scripts may still use that, although an attempt is being made to remove dependency on 'csh', so that everything will work with 'bash', which should be available on all linux systems.

If /bin/csh does not exist on your system, but /bin/tcsh does exist, you can simply, as super-user, create a symbolic link, thus:

    cd /bin
    ln -s tcsh csh

Otherwise try to find and install csh for your system (or tcsh, which is a later, but wholly compatible, version of csh). Ubuntu users, please see instructions above.

NOTE: use of motif/lesstif

The graphical facilities in Poplog are all based on the X window system (sometimes also called X11), described here http://en.wikipedia.org/wiki/X_Window_System

This has the great advantage of supporting remote use of graphical tools: the tools can run on a machine in one location while users are using a machine connected to it by a network. This is now commonplace using web browsers, but the X window system, based on Unix, had the idea long before there were web browsers. Poplog provides a wide range of 2-D graphical facilities based on X. There are some library packages that extend the X facilities and one of those is the 'motif' widget toolkit, which is used by many tools that run on linux and unix. It is described here.
A royalty free version is OpenMotif described here. Some unix distributors object to licence conditions of both Motif and OpenMotif and have switched to using an open source non-proprietary replacement called Lesstif, described here. Lesstif is almost fully compatible with Motif, but not quite, and this has caused minor problems for poplog, now fixed.

NOTE FOR 64-BIT POPLOG USERS.
For unknown reasons, if you include motif or lesstif in a 64 bit poplog if you try to close a window using the window-manager close button that crashes poplog. Closing the window using a pop11 command does not have that effect. This problem does not arise in 32 bit poplog.

You don't need any of Motif, OpenMotif or Lesstif to use Poplog graphical facilities, though it can be useful to have one of them, and this is assumed to be the default when you install Poplog.

The RCLIB graphical extension to Poplog, described here, was designed to work without Motif.

However there are some advantages in the use of Poplog with motif, insofar as the graphical version of the editor, XVed, has menu buttons and a scrollbar if Motif or Lesstif is available.
There is a Poplog_ui toolkit based on Motif, which some users find helpful. So if you can get hold of Motif or Lesstif, that is recommended. You will also need the 'devel' versions (motif-devel or lesstif-devel), as described below in order to be able to run Poplog with Motif extensions.

When you have a choice you should install Motif (or OpenMotif) rather than Lesstif as the former is less likely to cause problems. (This may no longer be true.)

If you cannot or do not wish to install Motif or Lesstif, you can run the poplog install script with the 'nomotif' option. However, the simplified get-and-install scripts described below use 'motif'. It is trivial to edit them to replace that with 'nomotif' before running them.

'Single Script' get and install files for downloading 32-Bit Linux Poplog

There are two small shell scripts available. Choose one of them, after reading about what they do, save it to a directory where you have space to copy at least 20MB files required to install poplog (or 17MB after July 17th 2009). Make it executable, as described below, then run it. You can decide whether you want poplog installed in the default location /usr/local/poplog, or somewhere else. It will need to go into a partition where there is about 80MB of free space. (You may not need all of it: some of the installation can be deleted if you don't need it, e.g. the portions for prolog, common lisp, ML, vision libraries, etc.)

• get-and-install-v15.65-poplog

  Use your browser to save this, then make it executable (chmod ugo+rx filename)
  Running this will fetch installation scripts and the poplog V15.65 tar file, and install the system in the default location /usr/local/poplog

  It will also attempt to set up links for poplog in /usr/local/bin and /usr/local/man, so you will need either to have access to those directories or else run the script as super-user

• get-and-install-v15.65-poplog-here

  Use your browser to save this, then make it executable (chmod ugo+rx filename)
  Running this will fetch installation scripts and the poplog V15.65 tar file, and install the system in a subdirectory of the current directory, called v15.65/pop/

  It does not attempt to install links in /usr/local directories (though you can do that later).

Decide which of those two you wish to use, then download it and put it in a directory on a file partition where you have enough file space. You will need about 17MB for the downloaded shell scripts and the Poplog tar file. In addition you will need about 80MB either in the /usr/local partition or in the partition where you run the 'get-and-install-here' script.

Make the chosen script executable after downloading it. e.g. using one of these two 'chmod' commands:

    chmod ugo+rx get-and-install

    chmod ugo+rx get-and-install-here

You may wish to read the script first, and, if you are a linux expert, change something before running it.

It uses the 'wget' command to fetch the files. If you are using it behind a web proxy server, you will have to set the appropriate environment variable ($http_proxy) to allow 'wget' to get through the server, e.g. something like this (for bash users):

    http_proxy=http://webcache.foo.baz.ac.uk:3128
    export http_proxy

Run the script in an xterm window or other console window.

The time it takes will depend largely on how long it takes you to download the main tar file (less than 19MB) and how long your PC takes to run the installation script. On fairly new PCs the installation could take less than a minute. On older PCs at most a few minutes. A slow internet connection will make the download take longer.

Both scripts produce a log file called v15.65/install.log which can be used to provide information if you have problems.

If the installation triggers linker or other errors they will not go into the log file, but will be displayed on the screen. You'll have to select and paste the messages to include in any report.

For more information on what those scripts do, please see the message posted to pop-forum and comp.lang.pop now available here.

For information about getting help from users see http://www.cs.bham.ac.uk/research/projects/poplog/comp.lang.pop.faq.html

Additional information about the installation can be found in http://www.cs.bham.ac.uk/research/poplog/v15.65/AREADME.txt

NB: If you use Ubuntu or Debian please see instructions on packages you may need to install before you can use poplog here.

Older information

If you are using 64-bit linux e.g. amd64 or x86-64, you may wish to fetch the 64-bit version of Linux Poplog, mentioned above.

The main poplog tar bundle for 32 bit linux poplog (about 18 Mbytes) is here: http://www.cs.bham.ac.uk/research/poplog/bham-linux-poplog-v15.65.tar.gz
It is automatically fetched by the get-and-install scripts.

The script that unpacks and installs that file is
http://www.cs.bham.ac.uk/research/poplog/v15.65/INSTALL_BHAM_LINUX_POPLOG
If the get-and-install scripts do not work, you can try fetching this 5KByte file and install it in the same directory as the tar bundle above, then make it executable and run it twice, the first time to discover the options, the second time with the options you want specified.

This file maintained by:
Aaron Sloman
http://www.cs.bham.ac.uk/~axs/
Last Updated: 5 Aug 2009;22 Jan 2010;12 Aug 2010; 26 Dec 2011; 29 Apr 2012