Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Drop Mac OS X instruction section, which is out of date

...

Info

To create a bootable USB device, you must use a USB storage device exactly 1 gigabyte (GB) or larger.
To create a live USB with Windows, use the OpenSolaris Live USB Creator.
To create a live USB with illumos, Solaris or OpenSolaris, you may use the usbcopy tool.
To create a live USB on any Unix-like system (including OS X):

  1. Download both the standard live USB file and the 1G.header file.
  2. Locate the path to your USB storage device.
    • This will typically be /dev/rdsk/c*t*d* on illumos/Solaris (rmformat -l), /dev/sd* on Linux (fdisk -l), /dev/da* on FreeBSD (camcontrol devlist), or /dev/disk* on OS X (diskutil list).
    • Use the whole device, not including a partition or slice number (sda, not sda1; c0t0d0, not c0t0d0p1).
    • Make sure you identify the correct storage device, as any data on the device will be erased.
  3. Desktops may automatically mount removable devices. Make sure no filesystems located on the device are mounted prior to the next step.
    • Select any desktop icons for the USB device and issue an Eject or Unmount command.
    • Use the mount command to list mounted filesystems. If any filesystems are located on the USB storage device, they must be unmounted.
    • Use umount <path> to unmount a filesystem, or rmumount <path> on illumos/Solaris, and diskutil unmountDisk <path> on OS X.
  4. Run the following command (as root or with appropriate privileges): cat 1G.header <live USB image file> | dd bs=1024k of=<path to raw USB storage device>

...

Info

If you see a "login:" prompt after selecting your keyboard and language and no desktop appears after several seconds, there may be a problem with the drivers for your graphics hardware. Please let us know if this happens. Include error messages you see on the console, and the output of the command svcs -xv and the contents of the file /var/log/Xorg.0.log if possible.

The login for the text session is username jack, password jack. The installer is graphical and requires X11, although it is possible to use it over a network with SSH X forwarding if you enable SSH. For administrative access, prepend your commands with pfexec.

Creating the dd USB Live Image from OS X

Using Mac OS X to create the USB Live Image of OpenIndiana? These instructions may help.

You'll need at least a 2GB USB stick; this example uses a 4GB.

OS X includes all tools needed:

  • cURL - the - excellent! -tool for download (to know it is to love it!: cURL - by Daniel Stenberg)
  • md5 - to checksum the download
  • diskutil - to manage your disks
  • dd - writes the bootable image to USB stick

1. Download the dd image, and the corresponding checksum file. Be sure to download the image 'writable with dd'!

Code Block
$ curl -OL http://dlc.openindiana.org/isos/148/oi-dev-148-x86.usb.writable-with-dd
$ curl -OL http://dlc.openindiana.org/isos/148/oi-dev-148-x86.usb.writable-with-dd.md5

2. Checksum your download - be sure you have a match!

Code Block
$ cat oi-dev-148-x86.usb.writable-with-dd.md5
c2b907c428eaf3aa624fc057e7849c73c2b907c428eaf3aa624fc057e7849c73

$ md5 oi-dev-148-x86.usb.writable-with-dd
MD5 (oi-dev-148-x86.usb.writable-with-dd) = c2b907c428eaf3aa624fc057e7849c73

3. After plugging in the USB device you will use - and assuming it's been formatted, it will appear in diskutil.

In our example, we've used a 4GB USB stick, disk2, with a 1GB FAT_16 partition:

Info

CAUTION: dd will erase all partitions, and all data, on this stick. Be sure of the disk# you are using!

Code Block
$ diskutil list
/dev/disk0
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:      GUID_partition_scheme                        *2.0 TB     disk0
   1:                        EFI                         209.7 MB   disk0s1
   2:                  Apple_HFS iMac                    2.0 TB     disk0s2
/dev/disk2
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:     FDisk_partition_scheme                        *1.0 GB     disk2
   1:                 DOS_FAT_16 DATADISK                1.0 GB     disk2s1

4. unmount the USB stick, if mounted:

Code Block
$ diskutil unmountDisk /dev/disk2
Unmount of all volumes on disk2 was successful

5. Write the image using dd; we timed it:

Code Block
$ time dd if=oi-dev-148-x86.usb.writable-with-dd of=/dev/disk2

2160767+0 records in
2160767+0 records out
1106312704 bytes transferred in 1379.597249 secs (801910 bytes/sec)

real	23m0.001s

Welcome to OpenIndiana! Enjoy!