Index of /openssi/dists/1.9.6-lenny-preview

	Name	Last modified	Size	Description
	Parent Directory		-
	Howto.html	27-Jan-2010 14:46	5.8K
	extras/	18-Jan-2010 11:46	-	extra non-ssi packges needed for installation
	install-log.html	16-Apr-2010 09:41	39K	Example log of successful install
	openssi/	16-Feb-2010 11:33	-

If you wany to get an idea about what this process will look like please see the install log.

Please note that you should follow this howto to the letter - missing one simple step can make your installation fail in "interesting" ways. I recommend printing a copy of this document and the install log and checking off each step as you perform it.

The amd64 port has received very little testing and has known bugs.

1. Install Debian Lenny, either for i386 or amd64.  To simplify things install a minimal system, you can install extra stuff later.
   
   
2. Add
   

   deb http://deb.openssi.org/openssi 1.9.6-lenny-preview openssi extras
   deb-src http://deb.openssi.org/openssi 1.9.6-lenny-preview openssi extras
       

   to your sources.list.
   
   
3. Add
   

   Package: *
   Pin: origin deb.openssi.org
   Pin-Priority: 1001
       

   to your /etc/apt/preferences
   
   
4. Create a file /etc/apt/apt.conf.d/90allow-unauthenticated containing:
   

   APT::Get::AllowUnauthenticated "true";
       

5. apt-get update
   

6. apt-get install initrd-tools
   

7. apt-get remove nfs-common
   

   (You can add it back again later if you want it.)
   

8. apt-get remove libc6-amd64
   

   (This package screws up ldd, a bug in the base lenny version).

9. apt-get install openbsd-inetd
   

   (xinetd causes lots of problems by launching atftpd with ipv6 addresses.)
   
   
10. Add the module for your cluster-interconnect nic to /etc/mkinitrd/modules
    (You can find out what it is by doing:

    ls -ld  /sys/class/net/ethX/device/driver/module
    

    where "ethX" is the nic you want to use).
    
    
11. As we're going to remove the running kernel we must modprobe all modules needed to build the initrd or we won't be able to make a bootable system (don't forget this or you'll be stuck with an unbootable system):
    

    modprobe loop
    modprobe ext2
        

12. Install OpenSSI modified packages:
    
    :-(  Warning - your system is unbootable starting from this point
    

    apt-get dist-upgrade
    

    This should replace all the standard versions of the packages by our modified versions and remove the non-SSI kernel (if you are asked to remove the runing kernel do it).

    However under some as yet undefined cicumstances sometimes apt-get seems not to downgrade udev, which will stop almost everything working. After the dist-upgrade check that udev is the correct version with the "apt-cache policy" command:

    apt-cache policy udev
    udev:
      Installed: 0.080-1
      Candidate: 0.080-1
      Version table:
         0.125-7 0
            500 http://ftp.fr.debian.org lenny/main Packages
     *** 0.080-1 0
           1001 http://deb.openssi.org ./ Packages
            100 /var/lib/dpkg/status
    

    If the udev version installed (the one marked with "***") does not come from deb.openssi.org you will need to do:

13. apt-get install udev
    

    If the OpenSSI udev is installed at this point you will be warned that the unning kernel will be removed.  Allow it to happen.
    
    
14. As the udev install is not smart enough to fix it's configuration files after a downgrade we need to do it manualy:

    rm /etc/udev/rules.d/*
    bash -c 'source /var/lib/dpkg/info/udev.postinst abort-deconfigure; create_rules_symlink'
    

15. apt-get install openssi
    

    In previous versions you would configure the node number, cluster interconnect, clustername and root failover here.  At the moment this is broken, don't worry, we'll do it by hand for now:
    
    
16. use the ssi-create command to configure the node number, cluster interconnect, clustername and root failover.
    
    
17. Install an OpenSSI kernel.  This used to be automatic, but since we now have different kernels to use you have to decide which one you want. On i386 you currently have a choice between linux-image-2.6.12-ssi-686-smp and linux-image-2.6.14-ssi-686-smp on amd64 the only available kernel is linux-image-2.6.12-ssi-amd64:

    apt-get install linux-image-2.6.14-ssi-686-smp
    

18. :-)  Your system should now be rebootable.  Reboot it.
    
    
19. The current version of dhcpd has an irritating "bug" - it no longer has a default for the "next-server" option (i.e. the address of the tftp server).  You'll have to add the option:
    

    next-server xxx.xxx.xxx.xxx;
        

    (where xxx.xxx.xxx.xxx is the cluster interconnect address for the initnode) to the file /etc/dhcp3/dhcpd.proto
    
    
20. run:
    

    mkdhcpd.conf

21. run:
    

    invoke-rc.d dhcp3-server restart
        

22. atftpd seems to want tftpboot in /var/lib, but doesn't make it. OpenSSI expects tftpboot in /, so do:

    mv /var/lib/tftpboot /var/lib/tftpboot.dist
    ln -s /tftpboot /var/lib
    

23. Now you can try booting a secondary node with etherboot or PXE, then ssi-addnode as usual