Creating a SmartOS Bootable USB Key

{toc}

Download the image from [SmartOS Download|http://wiki.smartos.org/display/DOC/Download+SmartOS] *updated* Feb 11, 2013\!


h2. Macintosh

# Insert your USB key.
(-) All data on the USB key will be replaced.
\\
\\
# Find the USB key's disk identifier.
{noformat}
$ diskutil list
/dev/disk0
#: TYPE NAME SIZE IDENTIFIER
0: GUID_partition_scheme *500.1 GB disk0
1: EFI 209.7 MB disk0s1
2: Apple_HFS Macintosh HD 499.8 GB disk0s2
/dev/disk2
#: TYPE NAME SIZE IDENTIFIER
0: Apple_partition_scheme *998.1 GB disk2
1: Apple_partition_map 32.3 KB disk2s1
2: Apple_HFSX Time Machine Backups 998.1 GB disk2s2
/dev/disk3
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *4.0 GB disk3
1: Windows_FAT_32 NONAME 995.2 MB disk3s1
{noformat}
\\
In this case, the USB key disk identifier {{/dev/disk3}}.
(!) It's likely that your device location will be different.
\\
\\
# Unmount the USB key and copy the image to it. Use {{/dev/rdiskX}} instead of {{/dev/diskX}} with the {{dd}} command to speed the transfer.
\\ (-) Be sure to double check the disk identifier. *The* {{{*}dd{*}}} *command will destroy any existing data on the target disk.*
\\
\\
{noformat}
$ diskutil unmountDisk /dev/disk3
$ bunzip2 smartos-latest-USB.img.bz2 
$ sudo dd bs=1m if=smartos-latest-USB.img of=/dev/rdisk3
{noformat}

$ p
$ w
$ q
{noformat}
\\
# Eject the volume
{noformat}
$ diskutil eject /dev/disk3
{noformat}
\\

h2. Linux


# Insert your USB key.
(-) All data on the USB key will be replaced.
\\
\\
# Find the USB key's disk identifier.
{noformat}
$ fdisk -l
255 heads, 63 sectors/track, 60801 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x7ecb51e2

Device Boot Start End Blocks Id System
/dev/sda1 * 1 52 409600 27 Unknown
Partition 1 does not end on cylinder boundary.
/dev/sda2 52 18959 151870464 7 HPFS/NTFS
/dev/sda3 18959 30432 92158977 f W95 Ext'd (LBA)
/dev/sda4 30432 60802 243944472 7 HPFS/NTFS
/dev/sda5 18959 30432 92158976 83 Linux

Disk /dev/sdb: 7958 MB, 7958691840 bytes
255 heads, 63 sectors/track, 967 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x00000000

Device Boot Start End Blocks Id System
/dev/sdb1 1 243 1951866 c W95 FAT32 (LBA)
{noformat}
\\
In this case, the USB key disk identifier {{/dev/sdb}}.
(!) It's likely that your device location will be different.
\\
\\
# Copy the image to the USB key.
\\
\\ (-) Be sure to double check the disk identifier. *The* {{{*}dd{*}}} *command will destroy any existing data on the target disk.*
\\
{noformat}
$ bunzip2 smartos-$RELEASE-usb.img.bz2
$ dd if=smartos-$RELEASE-usb.img of=/dev/sdb bs=1024
{noformat}
\\
# Flag partition on USB key as bootable.
{noformat}
$ fdisk /dev/sdb

Command (m for help): p

255 heads, 63 sectors/track, 967 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x00000000

Device Boot Start End Blocks Id System
/dev/sdb1 1 243 1951866 c W95 FAT32 (LBA)

Command (m for help): a
Partition number (1-4): 1

Command (m for help): p

255 heads, 63 sectors/track, 967 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x00000000

Device Boot Start End Blocks Id System
/dev/sdb1 * 1 243 1951866 c W95 FAT32 (LBA)

Command (m for help): w
The partition table has been altered!

Calling ioctl() to re-read partition table.

WARNING: Re-reading the partition table failed with error 16: Device or resource busy.
The kernel still uses the old table. The new table will be used at
the next reboot or after you run partprobe(8) or kpartx(8)
Syncing disks.
{noformat}
\\
\\

h2. Windows


# Install Zip Utility
Joyent provides compressed images in the .bz2 file format. 7-Zip [http://www.7-zip.org/] is a free open source utility that supports .bz2 files on Windows.
\\
\\
# Install Disk Imaging Utility
The open-source utility "win32diskimager" [https://wiki.ubuntu.com/Win32DiskImager] from the Ubuntu project will safely and properly burn the .img file.
\\
\\
# Download the .bz2 image from [https://download.joyent.com/pub/iso/].
# Unzip the .bz2 file
Use 7-Zip to extract the .img files from the .bz2 file.
\\
\\
# Insert your USB key.
(-) All data on the USB key will be replaced.
\\
\\
# Burn the .img file
Use win32diskimager to burn the .img file to the USB key.

h2. OpenIndiana

# Insert your USB key.
(-) All data on the USB key will be replaced.

# Find the USB key's disk identifier.
{noformat}
$ rmformat
Looking for devices...
     1. Logical Node: /dev/rdsk/c2t0d0p0
        Physical Node: /pci@0,0/pci-ide@1f,1/ide@0/sd@0,0
        Connected Device: QSI      DVD-RAM SDW-086  ES71
        Device Type: CD Reader
    Bus: IDE
    Size: <Unknown>
    Label: <Unknown>
    Access permissions: <Unknown>
     2. Logical Node: /dev/rdsk/c6t0d0p0
        Physical Node: /pci@0,0/pci104d,8212@1d,7/storage@3/disk@0,0
        Connected Device: Kingston DataTravelerMini PMAP
        Device Type: Removable
    Bus: USB
    Size: 984.0 MB
    Label: USBKEY
    Access permissions: Medium is not write protected.
{noformat}

In this case, the USB key disk identifier {{/dev/rdsk/c6t0d0p0}}.
(!) It's likely that your device location will be different.

# Unmount the USB (if necessary) key and copy the image to it.

(-) Be sure to double check the disk identifier. *The* {{{*}dd{*}}} *command will destroy any existing data on the target disk.*
{noformat}
$ umount /media/USBKEY
$ bunzip2 smartos-$RELEASE-usb.img.bz2
$ dd if=smartos-$RELEASE-usb.img of=/dev/rdsk/c2t0d0p0 bs=1024k
{noformat}

h2. And then...

Stick the USB key in a port and boot from it\!

h3. Discussion List

The smartos-discuss list is a forum for useful questions and answers - see the searchable archives [here|https://www.listbox.com/member/archive/184463/]; sign up [here|http://smartos.org/smartos-mailing-list/].