components/ruby/puppet/files/UPDATE_README.txt

   1 When updating puppet to a newer version one of the required update
   2 steps is to update the puppet SMF configuration file.  To aid in
   3 that process the update_smf.py utility can be used to automate the
   4 regeneration of this file.  To use this utility follow the outlined
   5 steps below.
   6
   7
   8 1. Update the puppet release and perform all update activities
   9    associated with it.
  10
  11 2. Generate and install the puppet release on a system.
  12
  13 3. Execute the following puppet command
  14
  15 $ puppet agent --genconfig > puppet.conf
  16
  17 4. Copy or make available the puppet.conf file created in step 3
  18    to the system with the userland tree
  19
  20 5. Execute the following commands:
  21
  22 $ cd <userland>/components/puppet/files
  23 $ python update_smf.py -c <path>/puppet.conf -s puppet.xml
  24       -v <puppet_version> -o puppet.new.xml
  25
  26 6. Perform a quick check of the resulting SMF file puppet.new.xml
  27    to make sure everything looks correct.
  28
  29 7. Update the current puppet.xml file with the new version
  30
  31 $ mv puppet.new.xml puppet.xml
  32
  33