1. freebsd.zip Driver
2. LIESMICH.TXT File Contents

LIESMICH.TXT Driver File Contents (freebsd.zip)

Installationshinweise fuer FreeBSD mit ICP Disk Array Controllern
=================================================================

Dateien
-------
liesmich.txt	diese Datei
icp.ko		ICP Treibermodul fuer die Installation von FreeBSD 4.4/4.5-RELEASE
icp2.ko		ICP Treibermodul fuer die Installation von FreeBSD 5.0-CURRENT
icp-1.1.tgz	ICP Treiber und Tools Package
  kopiert:	icp.c, icp.h, icp_ctrl.c, icp_pci.c to /usr/src/sys/dev/icp
  kopiert:	icp.ko to /
  kopiert:	icpcon, icpd to /usr/sbin
  kopiert:	icpd.sh to /usr/local/etc
  kopiert:	99icpd.sh to /usr/local/etc/rc.d
  kopiert:	icpd.conf, icptrap.mib to /etc
  modifiziert:	/boot/loader.rc (fuegt icp.ko hinzu)
  modifiziert:	/usr/src/sys/conf/files (fügt Quelldateien hinzu)
  erzeugt:	/dev/icp (special device file fuer Tools, z.B.: icpcon)
  erzeugt:	/usr/src/sys/i386/conf/ICP_KERNEL aus GENERIC (mit ICP entry)


ICP Controller als Boot Controller
----------------------------------
1. Host Drive einrichten
   - Treiber unterstuetzt momentan Host Drives 0 bis 99
   - Es wird ein eigener (virtueller) Kanal fuer die Host Drives
     eingerichtet (hinter den physikalischen Kanaelen des Controllers)

2. Von Installations-CD booten
   - CD-ROM Boot im Controller Setup erlauben (falls CD am ICP Controller)
   - Getestet wurde FreeBSD 4.4/4.5-RELEASE und FreeBSD 5.0-CURRENT
   - Bei der Ausgabe:
     "Hit [Enter] to boot immediately, or any other key for command prompt.
      Booting [kernel] in x seconds..."
     Taste druecken, es erscheint Prompt "ok"
   - Mit 'load kernel' Kernel laden und mit
     "load disk1:icp" (5.0-CURRENT: "load disk1:icp2")
     ICP Treiber von Floppy laden (disk0 ist CD, da Floppy Emulation und damit
     ist disk1 die erste Floppy (DOS Format))
   - Mit "boot" Kernel booten

3. Kernel Configuration Menu
   - Mit ENTER weiter booten, nur wenn andere Treiber Probleme bereiten, diese
     in "Start kernel configuration in full-screen visual mode" deaktivieren
   - Kernel bootet, ICP Treiber erkennt Controller und Laufwerke

4. /stand/sysinstall Main Menu
   - Installationsart waehlen (Standard Installation ist sinnvoll)
   - FDISK Partition Menu: z.B.
      A = Use Entire Disk
      Q = Finish
   - FreeBSD Disklabel Editor: z.B.
      C = Create
       Swap Partition einrichten (notwendig!, Groesse speicherabhaengig,
       100-200MB sollten aber reichen)
      C = Create
       Filesystem(e) einrichten (mindestens 1 FS notwendig, Mount Point "/")
      Q = Finish
   - Installationsumfang waehlen
   - Installationsmedium waehlen (CD-ROM)
   - Installation starten

5. System Console Settings -> ja eingeben
   - Keymap waehlen (English, German, ..)
   - Zeitzone einstellen

6. Reboot
   - CD und Floppy aus Laufwerken entfernen

7. Von Hostlaufwerk booten
   - Bootvorgang unterbrechen, ICP Treiber laden (siehe 2.)
     Kommando ist diesmal "load disk0:icp" (5.0-CURRENT: "load disk0:icp2")
     da die CD nicht im Laufwerk ist (damit ist disk0 die erste Floppy)
   - Kernel bootet, ICP Treiber erkennt Laufwerke

8. Treiber-Package installieren
   - File icp-11.tgz von Floppy kopieren, z.B. (DOS-Format):
      mount -t msdos /dev/fd0 /mnt
      cp /mnt/ICP-11.TGZ /tmp/icp-1.1.tgz
      umount /mnt
   - Package installieren mittels
      pkg_add icp-1.1.tgz
   - Package ist fuer FreeBSD 4.1-RELEASE, bei 5.0-CURRENT muss
     entweder der Treiber statisch gelinkt werden (siehe unten) oder
     der passende Modul (icp2.ko) per Hand kopiert werden, und zwar mittels
      mount -t msdos /dev/fd0 /mnt
      cp /mnt/icp2.ko /icp.ko
      umount /mnt

9. Reboot
   - Treiber wird ab jetzt immer automatisch als Modul geladen
   - ICPCON ist installiert

    
ICP Controller als Zweitcontroller
----------------------------------
Vorgehensweise wie bei Bootcontroller, Punkte 8. und 9. (siehe oben)


Treiber statisch linken
-----------------------
Treiber wird von Quellen ausgehend komplett neu uebersetzt, damit auf
jede FreeBSD-Version anpassbar.
Vorgehensweise:

1. Kernelquellen muessen installiert sein
   - Erkennbar an Existenz z.B. des Verzeichnisses /usr/src/sys/conf
   - Nachinstallation:
      ICP Package deinstallieren:
       pkg_delete icp-1.1
      Sysinstall aufrufen:
       /stand/sysinstall
      Menuepunkte "Configure", "Distributions" waehlen,
      Checkboxes "src", "sys" anwaehlen,
      Mit OK bestaetigen, Installationsquelle waehlen (CD-ROM), installieren
      Sysinstall verlassen, ICP Package installieren:
       pkg_add icp-1.1.tgz

2. Konfigurationsfile bearbeiten
   - Package hat Konfig.-File /usr/src/sys/i386/conf/ICP_KERNEL angelegt,
     ICP Treiber ist dort schon eingetragen
     Dort kann der Kernel konfiguriert werden (Treiber entfernen usw.)
   - System-Konfig.-Files anlegen (immer durchfuehren, auch wenn ICP_KERNEL
     unveraendert) mittels
      cd /usr/src/sys/i386/conf
      config ICP_KERNEL

3. Kernel erzeugen
   - Ausgehend von 2. mittels
      cd ../../compile/ICP_KERNEL
      make depend
      make
      make install

4. Reboot
   - Treiber wird ab jetzt immer im Kernel enthalten


Einrichten neuer Festplatten
----------------------------
- Festplatte formatieren (meistens nicht nötig) mit 'camcontrol format da(1,2,..)'
- sysinstall starten mit '/stand/sysinstall'
- 'Index' auswählen
- 'Partition' auswählen
- SCSI Laufwerk mit der Leertaste auswählen (da1,da2,usw.)
- gewünschte Partition einrichten 
  (ganze Laufwerks Kapazität ist nicht immer auswählbar; abhängig von der Plattengröße)
- Partition Editor verlassen und 'Label' auswählen
- File System und Swap Partition erstellen
  File System oder Swap Partition muß min. 100MB groß sein. File System und
  Swap Partition werden automatisch 'gemountet'.  


Mehr als 16 SCSI Disks (ICP Host Drives)
----------------------------------------
   ICP Host Drives werden von FreeBSD als sogenannte "direct access disks" (da0, da1, usw.)
   eingerichtet. Der ICP Treiber unterstuetzt maximal 100 Disks. Mit "dmesg" kann man die
   Anzahl der "da" Devices anzeigen lassen, die das System gefunden hat. Unter FreeBSD gibt
   es normalerweise maximal 16 Device Files (/dev/da0 - /dev/da15). Gibt es mehr als 16
   ICP Host Drives muessen weitere Device Files in /dev erstellt werden. Dies kann wie
   folgt durchgefuehrt werden:
   a) "dmesg | more"
		Zeigt alle vom System gefundenen "da" Devices an.
   b) "cd /dev/ ; sh MAKEDEV da##" (##=16, 17, 18, usw.)
		Der MAKEDEV Script erstellt das Device File mit der entsprechenden
		MAJOR Device Number.
   Die weiteren Host Drives koennen nun ueber die neu erstellten Device Files wie
   bekannt mittels "/stand/sysinstall" konfiguriert werden.


ICP Tools
---------
1. ICPCON - ICP RAID Console
   ICPCON ist ein Konfigurations- und Management-Tool fuer ICP Controller und wird bei
   der Installation des ICP Packages automatisch nach to /usr/sbin kopiert. Um ICPCON
   zu starten einfach 'icpcon' eingeben.

2. ICPD - Remote Management und Notification Service
   Der ICP Service wird ebenfalls automatsich bei der Installation des ICP Packages nach
   /usr/sbin kopiert. ICPD steuert die Fernwartung (remote access), sendet SNMP Traps
   und bietet die Möglichkeit, ein beliebiges Programm zu starten und somit z.B. eine
   Benachrichtigung per Mail einzurichten. Um ICPD zu konfigurieren muss die Datei
   /etc/icpd.conf editiert werden:
	e.g.: 'vi /etc/icpd.conf'
   Um ICPD zu starten, zu beenden oder einen Neustart durchzuführen gibt es einen weiteren
   Script:
	'sh /usr/local/etc/icpd.sh start' (stop, restart)



18.02.2002
ICP vortex Computersysteme GmbH