Issue #9141 has been updated by John Warburton.

Per my database instructions, I'm using the root user for the MySQL database in 
database.yaml, but creating the database as the puppet user so I have no root 
dependencies:

    # Creating new database:
    # puppet@engncfm001% mysql_install_db --user=puppet 
--datadir=/local/puppet/dashboard/db
    # puppet@engncfm001% mysqld_safe --user=puppet 
--datadir=/local/puppet/dashboard/db &
    # puppet@engncfm001% 
/opt/local/pkgs/mysql-5.1.50/bin/mysql_secure_installation
    # Set root password to 'rootpasswd'
    #
    # puppet@engncfm001% vi config/database.yml
    #
    #production:
    #  database: dashboard
    #  username: root
    #  password: rootpasswd
    #  encoding: utf8
    #  adapter: mysql
    #
    #puppet@engncfm001% rake RAILS_ENV=production db:create
    #puppet@engncfm001% rake RAILS_ENV=production db:migrate
    
I found the "old" documentation of using rake much easier, and was surprised to 
see them missing and replace with command line options when everything else was 
a rake call, with a footnote to the rake db:create. I think they should have 
equal billing

Also, the document makes no mention of a **recommended ‘dashboard’ user** for 
the database, apart from the sql to create the dashboard user. It does say 
**Choose database and user names that make sense to you, and a secure 
password**. Maybe that needs clarification

As for finding the footnote - much of the puppet documentation doesn't use 
footnotes, so it comes across as unexpected (I know Daniel Pittman can't help 
himself to have at least 2 footnotes per email - is this his influence :-) - 
its not clear that clicking on the footnote will give you the rake commands - 
which IMHO are easier, and consistent with the rest of the dashboard 
installation process

I use Mozilla Firefox 3.6 at work, and clicking on the footnote link, I drop to 
the bottom of the page, and it takes some searching to see between the massive 
footer (advertising, jobs etc) and the Navigation section to spot the smaller 
font size footnote section of one single line 


----------------------------------------
Bug #9141: Dashbord documentation footnote for creating database via rake based 
isn't correct
https://projects.puppetlabs.com/issues/9141

Author: John Warburton
Status: Needs More Information
Priority: Normal
Assignee: Nick Fagerlund
Category: guides
Target version: 
Keywords: 
Branch: 
Affected URL: 


http://docs.puppetlabs.com/dashboard/manual/1.2/bootstrapping.html#fn:rakedbcreate

I used the rake commands on a completely fresh MySQL database on a brand new 
machine for dashboard 1.2rc6, and was surprised the documentation now said to 
use the command line

I don't think this is correct (at worst), and that the foot note system is 
**really** difficult to read (at best)



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to