Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 117604 - Manual MySQL upgrade guide is ambiguous
Summary: Manual MySQL upgrade guide is ambiguous
Status: RESOLVED WORKSFORME
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Gentoo Linux bug wranglers
URL: http://www.gentoo.org/doc/en/mysql-up...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-01-03 07:38 UTC by Clock
Modified: 2006-01-04 06:50 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Clock 2006-01-03 07:38:04 UTC
The MySQL upgrade guide says:
"Code Listing
Comment 1 Clock 2006-01-03 07:38:04 UTC
The MySQL upgrade guide says:
"Code Listing 3.4: Configure MySQL 4.1 base setup 
# emerge --config =mysql-4.1.<micro_version> 
# /etc/init.d/mysql start"

However it's not clear if the user should only execute these command or also
execute what the output messages of the commands tell him to execute. Particularly
the command "emerge --config =mysql-4.1.14" tells me:
"
PLEASE REMEMBER TO SET A PASSWORD FOR THE MySQL root USER !
To do so, start the server, then issue the following commands:
/usr/bin/mysqladmin -u root password 'new-password'
/usr/bin/mysqladmin -u root -h kestrel password 'new-password'
See the manual for more instructions.
"

I suggest to write "perform these commands and do not perform what they
ask you what to do" or "perform these commands and after each of them
perform what it's output asks you to do" into the manual MySQL upgrade guide.

This is quite serious because is invoked for every user that wants to upgrade
gentoo and has MySQL installed and happens to cross the 4.0-4.1 version boundary.
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2006-01-03 07:49:08 UTC
The whole document is pretty clear to me, if it's unclear to you, then I'd suggest to hire someone to do the job properly for you. The document talks about *upgrading* of mysql install, which assumes that you had mysql set up and running before. The documents does *not* replace MySQL documentation.

For the record, /etc/init.d/mysql start' does not ask for any further actions, don't see what you mean there really.
Comment 3 Clock 2006-01-04 06:50:40 UTC
"For the record, /etc/init.d/mysql start' does not ask for any further actions,
don't see what you mean there really." -> do you read the bugreports at all before you close them down? The response to your question is quotation from the bugreport:

"Particularly
the command "emerge --config =mysql-4.1.14" tells me:
\"
PLEASE REMEMBER TO SET A PASSWORD FOR THE MySQL root USER !
To do so, start the server, then issue the following commands:
/usr/bin/mysqladmin -u root password 'new-password'
/usr/bin/mysqladmin -u root -h kestrel password 'new-password'
See the manual for more instructions.
\""