#include(FuguIta,notitle)
//----*'' '''Fugu'''Ita'' - '' '''Open'''BSD LiveCD/LiveUSB'' [#b073af7c]
//----#contents
//----**Screenshots [#h665312a]
//----(Click a thumbnail image to view a normal size one)
//----
//----''FuguIta at booting'' ~
//----[[&ref(fuguita-boot_s.png,wrap);>http://kaw.ath.cx/openbsd/index.php?plugin=attach&pcmd=open&file=fuguita-boot.png&refer=en%2FLiveCD]] ~
//-----Size for mfs being asked
//--------
//----''Conservative Unix Environment'' ~
//----[[&ref(fuguita-twm_s.png,wrap);>http://kaw.ath.cx/openbsd/index.php?plugin=attach&pcmd=open&file=fuguita-twm.png&refer=en%2FLiveCD]] ~
//-----TWM window manager
//-----kterm (Kanji Terminal)
//-----Mew email client on GNU Emacs
//-----W3M text web browser with inline-images and tab browsing
//-----Transmission BitTorrent client
//--------
//----''Simple Desktop and Clients'' ~
//----[[&ref(fuguita-icewm_s.png);>http://kaw.ath.cx/openbsd/index.php?plugin=attach&pcmd=open&file=fuguita-icewm.png&refer=en%2FLiveCD]] ~
//-----IceWM and ROX-Filer
//-----XV image viewer
//-----MPlayer media player
//-----Riece IRC client on Emacs
//----**Quick Start Guide [#w048cef9]
//----See [[this operation exsample>http://kaw.ath.cx/dl/pub/OpenBSD/LiveCD/0_README.SAMPLE.txt]].
//----**What's this? [#z48eecb3]
//----FuguIta is the LiveCD/LiveUSB which was built from OpenBSD, which has following features;
//----:Similar to HDD installation|This Live CD was intended to be similar to HDD installation as much as possible.~
//----After CD booting, you can login to the environment like the one which was just installed on HDD.~
//----In this environment, many ordinary files have replaced to symbolic links. So you can replace or modify them by yourself.
//----:Portable workplace|You can save your own environment into Floppy Disk and/or USB flashdrive.  Then you will be able to retrieve it at next boot time.
//----:Low hardware requirements|Unless you will use X, this LiveCD requires 40MB of memory to run.
//----:Additional Softwares|Some softwares were added from ports or building from other source packages. See following software list.
//----:Useful for Japanese users|Kernel and Time Zone are set to JST. And some softwares are configured to be able to use Japanese.
//----:Following stable version|We're trying to track the OpenBSD-stable version, and to apply all errata patches.
//----
//----Note: '' '''Fugu'''Ita'' (&ref(fuguita.gif);) stands for "Blowfish Disk" in Japanese. Fugu means blowfish, and Ita means something flat such as a plate, a disk or a board etc... ~
//----Some Japanese might associate those who cook when hearing Ita.
//----For them, so '' '''Fugu'''Ita'' also means "Blowfish Cook" as double meaning.
//----***Software List [#kbfb91ba]
//----|>|CENTER:BGCOLOR(pink):Base System|
//----|OpenBSD 4.7|The Operating System|
//----|>|CENTER:BGCOLOR(pink):Network|
//----|fetchmail|POP/IMAP email client|
//----|procmail|email proccessing filter|
//----|w3m|text-based web browser&br;(images, tables, frames are OK)|
//----|cURL|get files from FTP, Gopher, HTTP or HTTPS servers|
//----|rdesktop|remote desktop client&br; for MS Windows RDP|
//----|rsync|remote file synchronization tool|
//----|Mew|email user agent (works on Emacs)|
//----|Riece|IRC client (works on Emacs)|
//----|Emacs-w3m|web browser which works on Emacs|
//----|Transmission|BitTorrent client|
//----|youtube-dl|YouTube downloader|
//----|DeleGate|multi-purpose proxy server|
//----|>|CENTER:BGCOLOR(pink):Media|
//----|xv|image viewer|
//----|mplayer|media player|
//----|cdparanoia|CDDA reading utility|
//----|lame|lame ain't an MP3 encoder|
//----|>|CENTER:BGCOLOR(pink):Other tools|
//----|bash|Bourne again shell|
//----|bzip2, zip/unzip|file compression/expand tools|
//----|screen|text screen manager|
//----|ttyrec|tty console recorder/player|
//----|IceWM|Window Manager|
//----|ROX-Filer|File Manager|
//----|Ruby|object oriented script language|
//----|Python|object oriented script language|
//----|Gauche|Scheme language interpreter|
//----|Tcl/Tk|Tool Command Language / Tool Kit|
//----|Emacs 23|text editor|
//----|QEMU|multi system emulator|
//----|>|CENTER:BGCOLOR(pink):For Japanese|
//----|kterm|Kanji terminal emulator|
//----|jless|Japanized file pager|
//----|nkf|character code converter|
//----|freefonts,&br;ja-fonts-funet,&br;ja-fonts-gnu|Japanese fonts|
//----|Navi2ch, Mona font|''2ch BBS'' browser|
//----|Migemo|Japanse direct incremental search|
//----**How to use FuguIta [#af76c44d]
//----***Download [#l93cff2f]
//----FuguIta supports two boot medium. One is CD-R/CD-RW, the other is USB flash drive.
//----You must take different ways to create Such two medium.
//----
//----Followings illustrate the each case of create CD or USB flash media.
//----
//-----Download Source~
//----The mirror site are more recommended because of uplink bandwidth.
//------mirror: http://livecd-mirror.ebug.jp/LiveCD/ (100Mbps)
//------master: http://kaw.ath.cx/dl/pub/OpenBSD/LiveCD/ (8Mbps)
//----
//----***Creating FuguIta LiveCD [#ue1e4fc5]
//-----Download the ISO image of FuguIta from the site descripted above.
//---- ftp http://livecd-mirror.ebug.jp/LiveCD/FuguIta-4.X-20YYMMDDN.iso.gz
//----Note that the name of current version must be interpolated to the part ''YYMMDDN'' in this example.
//-----After decompression completed, burn that image into CD-R or CD-RW.
//---- gzip -d FuguIta-4.X-20YYMMDDN.iso.gz
//---- cdio -f /dev/cd0c blank   (blanking media, needed only for CD-RW)
//---- cdio -f /dev/cd0c tao FuguIta-4.X-20YYMMDDN.iso
//----***Createing FuguIta LiveUSB [#n000318d]
//----//There are two ways to do it.
//----///
//----//''a: Using the provided image for USB flash drive'' ~
//----//By this procedure, fixed size of partitions (650MB for FuguIta's system, about //300MB for saving user's data) are set up.
//----//>
//----//-Download the image for USB flash drive
//----// ftp http://livecd-mirror.ebug.jp/LiveCD/FuguIta-4.X-20YYMMDDN.usbimg.gz
//----//-Decompressing that image, and write it into USB storage device.
//----// gzip -dc FuguIta-4.X-20YYMMDDN.usbimg.gz | dd of=/dev/rsd?c bs=16384k
//----///
//----//''b: Generate LiveUSB from LiveCD'' (after version FuguIta-4.6-201001232) ~
//----//By this procedure, the data partition will be automatically allocated. ~
//----//Also, you can specify its size.
//----//>
//-----First, create FuguIta LiveCD according above description, then run it.
//-----Login as root, then execute ''newdrive'' subcommand on the USB management tool ''usbfadm''.
//---- # /boottmp/usbfadm
//---- 
//---- Welcome to usbfadm.
//---- USB flash drive maintenance tool for FuguIta
//---- 
//----      Boot mode: manual
//---- 
//---- Type ? for help.
//---- 
//---- ? : ? --> newdrive
//----Scanning USB devices after pressing ENTER.
//---- Please make sure the device inserted.
//---- Then press ENTER --> 
//----Enter the device name of USB flash drive. ~
//----Contents of system log entries are displayed for your information;
//---- ==== FYI: sd[0-9] on syslog ================================
//----      1  sd0 at scsibus1 targ 1 lun 0: <TOSHIBA, TransMemory, PMAP>
//----      2  sd0: 961MB, 512 bytes/sec, 1968128 sec total
//----      3  sd1 at scsibus2 targ 1 lun 0: <Generic, USB CF Reader, 0.00>
//----      4  sd1: drive offline
//----      5  sd2 at scsibus2 targ 1 lun 1: <Generic, USB SD Reader, 0.00>
//----      6  sd2: drive offline
//----      7  sd3 at scsibus2 targ 1 lun 2: <Generic, Mini SD Reader, 0.00>
//----      8  sd3: drive offline
//----      9  sd4 at scsibus2 targ 1 lun 3: <Generic, USB MS Reader, 0.00>
//----     10  sd4: drive offline
//----     11  sd5 at scsibus2 targ 1 lun 4: <Generic, USB SM Reader, 0.00>
//----     12  sd5: 62MB, 512 bytes/sec, 128000 sec total
//---- ============================================================
//---- Enter name of device which FuguIta will be installed --> sd0
//----Enter ''y'' to set up FuguIta-bootable USB flash drive ((In case of enter ''n'', System of FuguIta will not be transferred to the drive, and only partition for saving user data will be set up)).
//---- Do you make this USB flash drive bootable? [y/n] -> y
//----After transferring the system, by specifying '*', the rest will be allocated as the partition which user will save his data.
//---- Enter size for saving User Data in MB (311MB free).
//---- '*' implies all --> *
//----Otherwise the numeric value should be entered as the size of saving data (MB) ~
//----Room not used as OpenBSD's area will be formatted as FAT. ~
//----For example;
//---- Enter size for saving User Data in MB (311MB free).
//---- '*' implies all --> 250
//----in case of this, 250MB is for saving data of FuguIta user.
//----and 61MB becomes FAT.
//----~
//----Finally, you'll be asked whether the device is that you really intend.
//---- ***THIS IS THE LAST CHANCE***
//---- If you type 'Y' now, all the data on sd0 will be lost.
//---- Are you sure to initialize sd0? [y/N] -> y
//---- 
//---- ========================================
//---- = Clearing MBR BSD disklabel
//---- =
//---- 1+0 records in
//---- 1+0 records out
//---- 1048576 bytes transferred in 0.099 secs (10562763 bytes/sec)
//---- 
//---- ========================================
//---- = Setting up MBR
//---- =
//---- Writing MBR at offset 0.
//---- ...... continues ......
//----After this, formatting filesystems and copying system files are done.
//----Then FuguIta LiveUSB is completed.
//----***Booting FuguIta [#rba5c27f]
//----After booting from CD/USB,
//----some user inputs will be prompted;
//---- 511 MB of memory available for you.
//---- your mfs size in megabytes? [default: 255] -> 
//----Only entering "ENTER", half amount of attached memory is specified by default.
//---- Allocating 255 MB for mfs.
//----Choose the way of boot
//---- Select boot mode;
//----    0: fresh boot (normal)
//----    1: fresh boot (lower memory, faster boot than mode 0)
//----    2: fresh boot (everything on mfs)
//----    3: retrieve user data from USB flash memory
//----    4: retrieve user data from floppy disk
//----    5: interactive shell for debugging
//----  ->0
//----:0 normal fresh boot mode|Like booting just after fresh install. Some parameters are needed to be entered manually. This is the standard fresh boot method.
//----:1 fresh boot with faster and less memory|Same as above. ~
//----But under /usr, all files and directories are ''read only''.
//----:2 ''all on memory'' mode|Same as mode 0. ~
//----All files and directories will have copied on mfs. This mode requires about more than 650--700MB RAM.
//----:3 Restoring user data from USB flashdrive|After CD/USB boot, extract files which were stored in USB flash. (to be more described)
//----:4 Restoring user data from floppy disk|Same as above, but extracting from floppy disk. (to be more described)
//----:5 Interactive shell mode|After CD/USB boot, single user shell invoked. This is intended for system debug.
//----
//----At first, you should enter mode 0 (recommended) or mode 1.
//---- Copying files from CD-ROM to mfs ... done
//---- Linking files from mfs to CD-ROM ... done
//----Choose keyboard type
//---- Set your keyboard type;
//---- tables available for pc-xt/pc-at keyboard: encoding us de de.nodead fr dk 
//---- dk.nodead it uk jp sv sv.nodead no no.nodead us.declk us.dvorak 
//---- us.swapctrlcaps us.iopener jp.swapctrlcaps fr.swapctrlcaps be.swapctrlcaps 
//---- us.swapctrlcaps.dvorak us.swapctrlcaps.iopener es be ru ua sg sg.nodead sf 
//---- sf.nodead pt lt la br tr tr.nodead pl hu si
//---- -> us
//----Enter root password twice
//---- Set your root password.....
//---- Please wait.....
//---- Changing local password for root.
//---- New password:
//---- Retype new password:
//----Setting network parameters.
//---- Setting up network configurations? -> y
//---- your host name (without domain)? -> nimbus5
//---- Setting up IP network configurations? [n, 4, 6 or 46]-> 46
//---- ========================================
//---- lo0: flags=8049<UP,LOOPBACK,RUNNING,MULTICAST> mtu 33224
//----         inet 127.0.0.1 netmask 0xff000000 
//----         inet6 ::1 prefixlen 128
//----         inet6 fe80::1%lo0 prefixlen 64 scopeid 0x5
//---- dc0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500
//----         address: 00:00:39:58:cf:05
//----         media: Ethernet autoselect (100baseTX full-duplex)
//----         status: active
//----         inet6 fe80::200:39ff:fe58:cf05%dc0 prefixlen 64 scopeid 0x1
//---- pflog0: flags=0<> mtu 33224
//---- pfsync0: flags=0<> mtu 2020
//---- enc0: flags=0<> mtu 1536
//---- ========================================
//---- your network interface? -> dc0
//---- your FQDN? -> nimbus5.localnet
//---- your DNS servers?
//---- (up to three IPv4/6 addresses, separated by spaces)
//---- -> 192.168.18.254
//---- your IPv4 addr or "dhcp"? -> 192.168.18.25
//---- your netmask? -> 255.255.255.0
//---- your default gateway? -> 192.168.18.254
//----
//---- Generate cryptographic keys? -> y
//----... then you will see login prompt
//----**Tips [#p324be9d]
//----Details will be written in future.
//----***What can I do after boot? [#p05ab563]
//----Almost same as normal installation on HDD. ~
//----See afterboot manual page by running ''man 8 afterboot''.
//----***How to change TimeZone [#s7282b52]
//----Re-link /etc/localtime;
//---- cd /etc
//---- ln -sf /usr/share/zoneinfo/YOUR-TIME-ZONE localtime
//----Then set system clock if nessesary;
//---- date YOUR-LOCAL-TIME
//----Caution: date command causes your hardware clock changed.
//----***Saving and restoring the modified files [#wb58c8f8]
//----See [[this operation exsample>http://kaw.ath.cx/dl/pub/OpenBSD/LiveCD/0_README.SAMPLE.txt]].
//----***Adding other softwares [#c2de4582]
//----See [[this operation exsample>http://kaw.ath.cx/dl/pub/OpenBSD/LiveCD/0_README.SAMPLE.txt]], too. ~
//----Usual way as in HDD installation. ~
//----Packages and ports are also OK.
//----***Changing window manager [#pdcf6d6f]
//----Edit ~/.xinitrc
//---- 
//---- xset +fp /usr/local/lib/X11/fonts/japanese/:unscaled
//---- xset +fp /usr/local/lib/X11/fonts/mona/:unscaled
//---- 
//---- wm=twm   <---Edit this.
//---- 
//---- case X"$wm" in
//----     Xicewm)
//---- 
//----Edit shell variable ''wm''. ~
//----Available wm's are twm, fvwm, cwm or icewm.
//----***Can I rebuild my own CD-ROM image? [#o9aa148f]
//----Yes. ~
//----Here's a brief description of how to build a LiveCD image;
//----
//-----OpenBSD version of build and target environment ''must be'' the same.
//-----And must be done by root.
//---- 
//----+Get a build tool.
//---- ftp http://kaw.ath.cx/dl/pub/OpenBSD/LiveCD/tools/tools-4.X.tar.gz
//----+Extract it
//---- tar xvzpf tools-4.X.tar.gz
//----+Copy kernel
//---- cd tools-4.X
//---- rm bsd.orig
//---- cp bsd bsd.orig
//----(Or compile your customized kernel using tools-4.0/lib/RDROOT, then copy it to tools-4.X/bsd)~
//----~
//----+Copy your OpenBSD file-tree under tools-4.X/cdroot.dist ~
//----For example;
//---- cd cdroot.dist
//---- (cd YOUR-OPENBSD-FILE-TREE && tar cpf - .) | tar xvpf -
//----+Make an ISO image
//---- make livecd.iso
//----+Burn it.
//---- cdio -f /dev/rcd0c blank             ( <- Only for CD-RW )
//---- cdio -f /dev/rcd0c tao livecd.iso
//----
//----That's all.
//----***Can I install this LiveCD to HDD? [#e32746d7]
//----Yes.
//----+Install OpenBSD to HDD in unusal way.~
//----Allocate partition 'a' with the free size larger than 650MB.
//----+Copy three files from FuguIta's media to the target HDD. ~
//----Here's a sample;
//---- mount -t cd9660 /dev/cd0c /mnt
//---- cp /mnt/bsd-fi /mnt/bsd-fi.mp /mnt/fuguita.ffsimg /
//---- umount /mnt
//----+Then reboot. ~
//----Specify fuguita's kernel as running kernel;
//---- boot> bsd-fi
//----or
//---- boot> bsd-fi.mp
//--------
//----[[FrontPage]]

Front page   Edit Diff History Attach Copy Rename Reload   New Page list Search Recent changes   Help   RSS of recent changes