Changeset 08254fc for content/databases/mysql.xml

Timestamp:

06/12/2004 11:57:50 PM (20 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

0931098

Parents:

d3edf27

Message:

New XML - Part VII

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2306 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• content/databases/mysql.xml (modified) (1 diff)

content/databases/mysql.xml

@@ +1 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY mysql-download-http "http://mysql.he.net/Downloads/MySQL-4.0/mysql-&mysql-version;.tar.gz">
+  <!ENTITY mysql-download-ftp  "ftp://mirror.mcs.anl.gov/pub/mysql/Downloads/MySQL-4.0/mysql-&mysql-version;.tar.gz">
+  <!ENTITY mysql-size          "13.5 MB">
+  <!ENTITY mysql-buildsize     "98.7 MB">
+  <!ENTITY mysql-time          "3.43 SBU">
+]>
+
 <sect1 id="mysql" xreflabel="MySQL-&mysql-version;">
 <?dbhtml filename="mysql.html"?>
 <title>MySQL-&mysql-version;</title>
 
-&mysql-intro;
-&mysql-inst;
+<sect2>
+<title>Introduction to <application>My<acronym>SQL</acronym></application></title>
+
+<para><application>My<acronym>SQL</acronym></application> is a widely used and fast 
+<acronym>SQL</acronym> database server. It is a client/server 
+implementation that consists of a server daemon and many different 
+client programs and libraries.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&mysql-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&mysql-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &mysql-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &mysql-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &mysql-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>My<acronym>SQL</acronym></application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="readline"/>, <xref linkend="openssl"/> and
+<xref linkend="tcpwrappers"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>My<acronym>SQL</acronym></application></title>
+
+<para>For security reasons, running the server as an unprivileged user 
+and group is strongly encouraged:</para>
+
+<screen><userinput><command>groupadd mysql &amp;&amp;
+useradd -c mysql -d /dev/null -g mysql -s /bin/false mysql</command></userinput></screen>
+
+<para>Build and install <application>My<acronym>SQL</acronym></application> by running the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
+    --libexecdir=/usr/sbin --localstatedir=/var/lib/mysql \
+    --enable-thread-safe-client --enable-local-infile \
+    --enable-assembler --without-debug --without-bench &amp;&amp;
+make testdir=/usr/lib/mysql/mysql-test &amp;&amp;
+make testdir=/usr/lib/mysql/mysql-test install</command></userinput></screen>
+
+<para>Packages that depend on <application>MySQL</application> need the shared
+libraries available at run-time:</para>
+
+<screen><userinput><command>cd /usr/lib &amp;&amp;
+ln -sf mysql/libmysqlclient{,_r}.so* .</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application>My<acronym>SQL</acronym></application></title>
+
+<sect3>
+<title>Config files</title>
+
+<para><filename>/etc/my.cnf</filename>, <filename>~/.my.cnf</filename></para>
+
+</sect3>
+
+<sect3>
+<title>Configuration Information</title>
+
+<para>There are several default configuration files available in
+<filename class="directory">/usr/share/mysql</filename> which you can
+use.  Create <filename>/etc/my.cnf</filename> using the following
+command:</para>
+
+<screen><userinput><command>cp /usr/share/mysql/my-medium.cnf /etc/my.cnf</command></userinput></screen>
+
+<para>You can now install a database and change the ownership to the
+unprivileged user and group.</para>
+
+<screen><userinput><command>mysql_install_db &amp;&amp;
+chown -R mysql:mysql /var/lib/mysql</command></userinput></screen>
+
+<para>Further configuration requires that the mysql server be running:</para>
+
+<screen><userinput><command>mysqld_safe --user=mysql 2&gt;&amp;1 &gt;/dev/null &amp;</command></userinput></screen>
+
+<para>A default installation does not setup a password for the
+administrator, so use the following command to set one. Replace <replaceable>[new-password]</replaceable>
+with your own.</para>
+
 <!--
-&mysql-exp;
+<screen><userinput><command>mysql -uroot mysql</command></userinput>
+Welcome to the MySQL monitor.  Commands end with ; or \g.
+Your MySQL connection id is 2 to server version: 3.23.51-log
+
+Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
+
+<prompt>mysql&gt;</prompt> <userinput><command>UPDATE user SET password=password('<replaceable>new-password</replaceable>') WHERE user='root';</command></userinput>
+Query OK, 2 rows affected (0.00 sec)
+Rows matched: 2  Changed: 2  Warnings: 0
+
+<prompt>mysql&gt;</prompt> <userinput><command>FLUSH PRIVILEGES;</command></userinput>
+Query OK, 0 rows affected (0.00 sec)
+
+<prompt>mysql&gt;</prompt> <userinput><command>EXIT;</command></userinput>
+bye
+</screen>
 -->
-&mysql-config;
-&mysql-desc;
+
+<screen><userinput><command>mysqladmin -u root password <replaceable>[new-password]</replaceable></command></userinput></screen>
+
+<para>Configuration of the server is now finished. Shut the server down
+using the following command:</para>
+
+<screen><userinput><command>mysqladmin -p shutdown</command></userinput></screen>
+
+<para>Install the <filename>/etc/rc.d/init.d/mysql</filename>
+init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
+                                                                                                                
+<screen><userinput><command>make install-mysql</command></userinput></screen>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>My<acronym>SQL</acronym></application> package contains <command>
+comp_err</command>, <command>
+isamchk</command>, <command>
+isamlog</command>, <command>
+make_win_src_distribution</command>, <command>
+msql2mysql</command>, <command>
+my_print_defaults</command>, <command>
+myisamchk</command>, <command>
+myisamlog</command>, <command>
+myisampack</command>, <command>
+mysql</command>, <command>
+mysql_config</command>, <command>
+mysql_convert_table_format</command>, <command>
+mysql_explain_log</command>, <command>
+mysql_find_rows</command>, <command>
+mysql_fix_extensions</command>, <command>
+mysql_fix_privilege_tables</command>, <command>
+mysql_install</command>, <command>
+mysql_install_db</command>, <command>
+mysql_secure_installation</command>, <command>
+mysql_setpermission</command>, <command>
+mysql_tableinfo</command>, <command>
+mysql_waitpid</command>, <command>
+mysql_zap</command>, <command>
+mysqlacess</command>,<command>
+mysqladmin</command>, <command>
+mysqlbinlog</command>, <command>
+mysqlbug</command>, <command>
+mysqlcheck</command>, <command>
+mysqld</command>, <command>
+mysqld_multi</command>, <command>
+mysqld_safe</command>, <command>
+mysqldump</command>, <command>
+mysqldumpslow</command>, <command>
+mysqlhotcopy</command>, <command>
+mysqlimport</command>, <command>
+mysqlmanager</command>, <command>
+mysqlmanager-pwgen</command>, <command>
+mysqlmanagerc</command>, <command>
+mysqlshow</command>, <command>
+mysqltest</command>, <command>
+pack_isam</command>, <command>
+perror</command>, <command>
+replace</command>, <command>
+resolve_stack_dump</command>, <command>
+resolveip</command>, <filename class="libraryfile">
+libdbug</filename>, <filename class="libraryfile">
+libheap</filename>, <filename class="libraryfile">
+libmerge</filename>, <filename class="libraryfile">
+libmyisam</filename>, <filename class="libraryfile">
+libmyisammrg</filename>, <filename class="libraryfile">
+libmysqlclient</filename>, <filename class="libraryfile">
+libmystrings</filename>, <filename class="libraryfile">
+libmysys</filename>, <filename class="libraryfile">
+libnisam</filename> and <filename class="libraryfile">
+libvio</filename>.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<para>A package listing would be several pages long, we suggest
+consulting the <application>My<acronym>SQL</acronym></application> documentation for full details, instead.</para>
+
+<para>Certain <application>My<acronym>SQL</acronym></application>
+support programs may require the <application>Perl</application> DBI modules to be installed to function properly.</para>
+
+</sect2>
 
 </sect1>