*'' '''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
**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.6|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)|
|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 22|text editor|
|>|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]
You can save your own environment into Floppy Disk and/or USB flash. ~
Note: Existing data on these media will be lost.
You *MUST* back up your data before this operation.

''To save in USB flash. '' ~
Following explanation is to newly create the individual USB flashdrive to
save user data. ~
If you wish save user data to FuguIta-installed USB flashdirve, 
Jump to step 5 ''Save data''.
+Do fdisk 
 # fdisk -e sd0
If your fdisk cannot get disk geometry info from USB-BIOS,
make sure the size of your USB flash from dmesg output. ~
For example, you know your USB flash has 248MB according to dmsg,
you can fdisk with options specifying Cyl/Head/Sec explicitly.
 # fdisk -c 248 -h 64 -s 16 -e sd0
In fdisk editor mode, you will specify OpenBSD FFS as the partition ID ``A6''.
+Make then partition ``d'' by disklabel.
 # disklabel -E sd0
The procedure is normal. Refer disklabel(8).
+Format sd0d
 # newfs -b 4096 -f 512 -i 1024 /dev/rsd0d
+Make the directory which saves the data.
 # mount /dev/sd0d /mnt
 # mkdir /mnt/livecd-config
 # umount /dev/sd0d
+Save data. ~
++To save data, the script ``usbfadm'' are in the system.
 # /boottmp/usbfadm
 Welcome to USB flash maintenance tool.
 
 Boot mode: manual
 
 Type ? for help.
 
 ?:? ->
++Detect USB device by rescan subcommand.
    ?:? -> rescan
    Rescanning USB flash
    Please make sure the device inserted.
    Then press ENTER -->
 
    USB flash memory found as sd0
++Name the set of data which you will save by dsn (data set name) subcommand.
The default value of dsn is the FQDN of this host.
 /dev/sd0d:? -> dsn
 
 Enter data set name [nimbus5.localnet] -> emgproxy
 
 Now data set name is set to ``emgproxy''.
++Save the data by sync subcommand.
 /dev/sd0d:emgproxy -> sync
 
 Sync current mfs as emgproxy, OK? -> y
 
 building file list ... done
 created directory /mnt/livecd-config/emgproxy
 ./
 etc/
 etc/bgpd.conf
 etc/boot.conf
   :
   :
 var/yp/Makefile.yp
 var/yp/Makefile.yp.dist
 var/yp/README
 
 sent 16455591 bytes  received 232568 bytes  180412.53 bytes/sec
 total size is 15492096  speedup is 0.93
++Make sure the data saved by info subcommand.
 /dev/sd0d:emgproxy -> info
 
 Filesystem     Size    Used   Avail Capacity  Mounted on
 /dev/sd0d      218M   18.9M    179M   9.6%    /mnt
 
 scanning...
 
 18.9M   emgproxy
++If OK, exit this utility.
 /dev/sd0d:emgproxy -> bye
 #

''To save a floppy disk''
-Perform low-level formatting on floppy disk.
-Use /boottmp/fdadm to save data.
***Adding other softwares [#c2de4582]
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   New Page list Search Recent changes   Help   RSS of recent changes