~ubuntu-branches/ubuntu/saucy/cloud-init/saucy

« back to all changes in this revision

Viewing changes to doc/sources/smartos/README.rst

  • Committer: Scott Moser
  • Date: 2013-09-27 23:47:33 UTC
  • mfrom: (1.4.7)
  • Revision ID: smoser@ubuntu.com-20130927234733-d6g4ngz3lyfclq9a
* New upstream snapshot.
  * fixes to disk_setup config module and enabling of partition
    creation and filesystem creation on Azure.

Show diffs side-by-side

added added

removed removed

Lines of Context:
73
73
        (i.e. /etc/cloud/cloud.cfg.d) that sets which values should not be
74
74
        base64 decoded.
75
75
 
76
 
ephemeral_disk:
 
76
disk_aliases and ephemeral disk:
77
77
---------------
78
 
 
79
 
In order to instruct Cloud-init which disk to auto-mount. By default,
80
 
SmartOS only supports a single ephemeral disk.
81
 
 
82
 
The default SmartOS configuration will prepare the ephemeral disk and format
83
 
it for you. SmartOS does not, by default, prepare the ephemeral disk for you.
84
 
 
85
 
If you change ephemeral_disk, you should also consider changing
86
 
the default disk formatting parameters. See
87
 
doc/examples/cloud-config-disk-setup.txt for information on using this.
 
78
By default, SmartOS only supports a single ephemeral disk.  That disk is
 
79
completely empty (un-partitioned with no filesystem).
 
80
 
 
81
The SmartOS datasource has built-in cloud-config which instructs the
 
82
'disk_setup' module to partition and format the ephemeral disk.
 
83
 
 
84
You can control the disk_setup then in 2 ways:
 
85
 1. through the datasource config, you can change the 'alias' of
 
86
    ephermeral0 to reference another device. The default is:
 
87
      'disk_aliases': {'ephemeral0': '/dev/vdb'},
 
88
    Which means anywhere disk_setup sees a device named 'ephemeral0'
 
89
    then /dev/vdb will be substituted.
 
90
 2. you can provide disk_setup or fs_setup data in user-data to overwrite
 
91
    the datasource's built-in values.
 
92
 
 
93
See doc/examples/cloud-config-disk-setup.txt for information on disk_setup.