INSTALL-FROM-WEB-FILES.txt 20 Feb 2004 Aaron Sloman http://www.cs.bham.ac.uk/~axs/ ------------------------------ Modified: 16 Jan 2005: Most people no longer need to read this file 23 Dec 2004: openmotif rpm no longer provided 15 Mar 2004: termcap no longer needed. This file is http://www.cs.bham.ac.uk/research/poplog/linux-cd/INSTALL-FROM-WEB-FILES.txt You can check whether there are likely to be problems with the installation if you fetch this file (also included in the tar file mentioned below). http://www.cs.bham.ac.uk/research/poplog/linux-cd/CHECK_LINUX_FACILITIES make it executable chmod 755 CHECK_LINUX_FACILITIES then run it ./CHECK_LINUX_FACILITIES If there problems it will report them. It can fix some minor problems itself if run as 'super-user' (root). If there are no insuperable problems, you can follow the simple instructions in this file: The easiest way to install poplog is to follow the instructions in this file http://www.cs.bham.ac.uk/research/poplog/linux-cd/SHORT-CUT-INSTALLATION.txt In most cases that will cover everything and you need not read this file, which was written before the current installation scripts were available. In that case you can ignore the rest of this file. ======================================================================= FETCHING FILES FOR LINUX PC POPLOG FROM THE WEB The instructions below are for people who wish to fetch individual files from the poplog web site. Instructions for using the files available on the web at http://www.cs.bham.ac.uk/research/poplog/linux-cd ======================================================================= CONTENTS -- STEP 0: Run the script to check whether there are problems -- STEP 1: Create "source" directory in which to install files -- STEP 2: Fetch files from the web site -- -- Optional files -- -- After fetching the files you need and optional files -- STEP 3. Change to the source directory -- Step 4: Check that you hae the linux-poplog.tar.gz file -- Step 5: untar the linux-poplog.tar.gz file -- Step 6: Change to the linux-poplog sub-directory -- Step 7. READ INSTALL-FINAL.txt and follow instructins -- Step 8. (Optional) Install optional files. -- STEP 0: Run the script to check whether there are problems CHECK_LINUX_FACILITIES Fetch and run this as described above. -- STEP 1: Create "source" directory in which to install files Recommended location: /usr/local/poplog/src/ You may choose a different location if you wish. Poplog can be installed in any location. If you choose a different location, modify the instructions accordingly. Make a new directory for poplog SOURCE files used for installation. mkdir -p /usr/local/poplog/src/linux-poplog/ That will actually create two directories, both of which are used later: /usr/local/poplog/src/ /usr/local/poplog/src/linux-poplog/ The core poplog system itself and a "local" extension will go into additional sub-directories in /usr/local/poplog/ -- STEP 2: Fetch files from the web site Fetch and put the following files in your directory /usr/local/poplog/src/linux-poplog Fetch the main PC linux-poplog file (between 12.5 and 13 Mbytes): http://www.cs.bham.ac.uk/research/poplog/linux-cd/linux-poplog.tar.gz or, if you prefer to use ftp ftp://ftp.cs.bham.ac.uk/pub/dist/poplog/linux-cd/linux-poplog.tar.gz Move that file (but not the others) into the main poplog src directory: (When unpacked it will put more files in the linux-poplog/ subdirectory) Also fetch these documentation files: http://www.cs.bham.ac.uk/research/poplog/linux-cd/INSTALL-FROM-WEB-FILES.txt (this file) http://www.cs.bham.ac.uk/research/poplog/linux-cd/CHECK_LINUX_FACILITIES@ http://www.cs.bham.ac.uk/research/poplog/linux-cd/AREADME.motifcheck.txt Helps you decide whether you need to fetch and install motif. http://www.cs.bham.ac.uk/research/poplog/linux-cd/INSTALL-FINAL.txt Final installation instructions after going through steps in the other files. http://www.cs.bham.ac.uk/research/poplog/linux-cd/INSTALL-OPTIONS.txt Describes some optional extra files you may wish to fetch and install. http://www.cs.bham.ac.uk/research/poplog/linux-cd/AREADME.txt Optional overview file. Much of this is now unnecessary as scripts are provided to do most of the work. -- -- Optional files The following files are optional. Fetch them now or later, if you want them, and put them, along with other files that will come from the linux tar file, in your directory: /usr/local/poplog/src/linux-poplog/ http://www.cs.bham.ac.uk/research/poplog/linux-cd/newkit.tar.gz The Poprulebase system and SimAgent toolkit, described here: http://www.cs.bham.ac.uk/~axs/cogaff/simagent.html http://www.cs.bham.ac.uk/research/poplog/linux-cd/simworld.tar.gz The Simworld simulation package developed by Matthias Scheutz, based on SimAgent and described here: http://www.nd.edu/%7Eairolab/simworld/index.html http://www.cs.bham.ac.uk/research/poplog/linux-cd/brait.tar.gz A "Braitenberg vehicles" tutorial package also based on SimAgent. http://www.cs.bham.ac.uk/research/poplog/linux-cd/popvision.tar.gz The popvision system for research and teaching on vision (mainly low level vision) developed by David Young at Sussex University. http://www.cs.bham.ac.uk/research/poplog/linux-cd/vedgn.tar.gz A package for reading and posting news, based on the VED or XVed editor available in Poplog. http://www.cs.bham.ac.uk/research/poplog/linux-cd/neural.tar.gz A neural net tutorial pacakge based on Poplog, developed by Sussex University and Integral Solutions Ltd. Additional packages may become available and will be described here: http://www.cs.bham.ac.uk/research/poplog/freepoplog.html Further information is in AREADME.txt -- -- After fetching the files you need and optional files The instructions below assume you have followed preliminary steps described above. So the directory /usr/local/poplog is assumed to exist though it may actually be a link to a directory on a different partition. -- STEP 3. Change to the source directory Change to the new directory -- i.e. make it your current working directory: cd /usr/local/poplog/src (This is NOT where poplog will be installed: it is merely a place to hold the files used to install poplog. By default the installation will be in the directory /usr/local/poplog, though you can choose another place by editing the installation scripts if you wish). You are now ready to extract the files from the tar file. After that you can use them to install poplog -- Step 4: Check that you hae the linux-poplog.tar.gz file Assuming you have copied it, as suggested above, to the directory /usr/local/poplog/src/linux-poplog/ you should be ale to see it if you give this directory listing command: ls -l linux-poplog It should show this file a bit over 12 mbytes in size: linux-poplog.tar.gz -- Step 5: untar the linux-poplog.tar.gz file Now untar that file which will put more things in the linux-poplog sub-directory, first making sure that you are in the right directory: cd /usr/local/poplog/src zcat linux-poplog/linux-poplog.tar.gz | tar xf - or tar xfz linux-poplog/linux-poplog.tar.gz [Unpacking the tar file will put the contents into the sub-directory linux-poplog. This is why you need to give the unpack command in the super directory.] -- Step 6: Change to the linux-poplog sub-directory cd linux-poplog List its contents: ls -l This should list several files. The number may change from time to time, depending on how poplog is packaged. It should include this file (INSTALL-FROM-WEB-FILES.txt) and several other files of different sorts including files you fetched in Step 2, above. The files whose names end '.txt' are instruction files. See what's there: ls -l *.txt The files whose names start 'INSTALL' but do not end in '.txt' are shell scripts that you can run to do the installation, as described below. List them: ls -l INSTALL* | grep -v txt There should be at least two of them. (The number may change.) Some of the other files are essential for poplog in any form. Some are essential for the core Birmingham poplog setup. The file linuxstuff.html gives descriptions of the various files. Check where you are, by giving the print working directory command: pwd That should print out something like: /usr/local/poplog/src/linux-poplog you should find a file called INSTALL-FINAL.txt check with this command ls -l INSTALL-FINAL.txt That is the basic instruction file for installing poplog after you have extracted all the required files from the CD and unpacked the main tar files. The instructions may change as new versions of Poplog are produced. The instructions are automated in the default installation scripts. -- Step 7. READ INSTALL-FINAL.txt and follow instructins You can read the file online with the command more INSTALL-FINAL.txt (press space bar to get another page, press "b" to go back to previous page). You may find it helpful to print that file before proceeding. You can then make notes of the steps you go through and what happens, in case there is a problem and you have to ask for help. If you are happy to proceed with installation, follow the instructions in there. -- Step 8. (Optional) Install optional files. Follow instructions in this file for installing optional files. INSTALL-OPTIONS.txt [end]