v7.0 HP Intelligent Management Center MySQL 5.6 Installation and Configuration Guide (for Linux)

v7.0 HP Intelligent Management Center MySQL 5.6 Installation and Configuration Guide (for Linux) Abstract This document is intended to be the installation and configuration guide for MySQL in addition to the procedures for upgrading, removing, registering, and backup and restore. This document is intended for use by network engineers or system administrators responsible for installing network software and components. HP Part Number: 5998-4712 Published: IMC PLAT 7.0 (E0202) Published: March 2014 Edition: 1.1

Copyright 2014 Hewlett-Packard Development Company, L.P. No part of this documentation may be reproduced or transmitted in any form or by any means without prior written consent of Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Contents 1 Overview...4 2 Prerequisites...5 Installing required software packages...5 Removing the built-in MySQL database...5 Copying the installation programs to the Linux server...6 3 Installation...7 Installing the MySQL server...7 Installing the MySQL client...7 Querying the current password...8 IMC with a local database...9 IMC with a remote database...9 Customizing MySQL file directories...10 4 Startup and stop...11 Starting and stopping the MySQL service...11 Automatic startup...11 5 Configuring the MySQL server...13 Setting security options...13 Changing the database password...15 Creating a database user account...16 Creating a remote root user account...16 Creating a local user account...17 Creating MySQL configuration files...18 Configuring parameters in the my.cnf file...18 (Optional) Changing the log and database file directory...21 6 Uninstallation...22 IMC with a local database...22 IMC with a remote database...22 7 FAQ...23 8 Support and other resources...24 Contacting HP...24 Subscription service...24 New and changed information in this edition...24 Related information...24 Documents...24 Websites...24 Typographic conventions...25 Document conventions...25 GUI conventions...25 Symbols...25 9 Documentation feedback...26 Index...27 Contents 3

1 Overview This document describes how to install and configure the MySQL 5.6 database in 64-bit Red Hat Enterprise Linux 6.4 before you install IMC. The installation procedures for MySQL databases of other versions might vary. For information about installing database of other versions, see their respective installation and configuration guides. Perform all operations in this document as a Linux root user, unless otherwise specified. This document uses MySQL-server-5.6.12-1.el6.x86_64.rpm and MySQL-client-5.6.12-1.el6.x86_64.rpm installation programs as examples. The installation procedures for the MySQL server of other versions might vary. For information about installing the MySQL server of other versions, see their respective installation and configuration guides. 4 Overview

2 Prerequisites Before installing the MySQL 5.6 database, install required software packages and remove the built-in MySQL database. Installing required software packages Install the following software packages in the Red Hat Enterprise Linux 6.4 environment: glibc-2.12-1.132.el6.i686.rpm libaio-0.3.107-10.el6.i686.rpm libgcc-4.4.7-4.el6.i686.rpm libstdc++-4.4.7-4.el6.i686.rpm To make sure these 32-bit software packages can be successfully installed in the 64-bit Linux system, run the following commands as a root user: rpm -i --nodeps glibc-2.12-1.132.el6.i686.rpm rpm -i --nodeps libaio-0.3.107-10.el6.i686.rpm rpm -i --nodeps libgcc-4.4.7-4.el6.i686.rpm rpm -i --nodeps libstdc++-4.4.7-4.el6.i686.rpm Figure 1 Installing required software packages Removing the built-in MySQL database To correctly install the MySQL 5.6 database, you must first remove the MySQL database built in the Red Hat Enterprise Linux 6.4. 1. Query the installed MySQL database and related programs. rpm qa grep mysql 2. Remove the software package. rpm e mysql-devel-5.1.66-2.el6_0.1.x86_64 rpm e mysql-5.1.66-2.el6_0.1.x86_64 rpm e mysql-libs-5.1.66-2.el6_0.1.x86_64 Installing required software packages 5

3. Remove the dependent package if you receive a mysql-libs-5.1.66-2.el6_0.1.x86_64 package dependency message. rpm e - nodeps mysql-libs-5.1.66-2.el6_0.1.x86_64 Figure 2 Removing the built-in MySQL database Copying the installation programs to the Linux server Before installing the MySQL database, copy the installation programs to the Linux server. This document uses MySQL-server-5.6.12-1.el6.x86_64.rpm and MySQL-client-5.6.12-1.el6.x86_64.rpm installation programs. Figure 3 MySQL installation programs on Linux If the database and IMC are installed on the same server, install both MySQL-server-5.6.15-1.el6.x86_64.rpm and MySQL-client-5.6.15-1.el6.x86_64.rpm on the IMC server. If IMC is installed on a server other than the database server, install MySQL-client-5.6.15-1.el6.x86_64.rpm on the IMC server and install MySQL-server-5.6.15-1.el6.x86_64.rpm on the database server. You must select other server for the database location and enter the server IP address during IMC installation. 6 Prerequisites

3 Installation The root user in this section and the following sections refers to the MySQL database root user rather than the Linux root user, unless otherwise specified. Installing the MySQL server 1. Enter the directory where the MySQL installation programs are located and install the MySQL server. rpm -ivh MySQL-server-5.6.15-1.el6.x86_64.rpm Figure 4 Installing the MySQL server 2. Start the MySQL service after the installation is complete. service mysql start 3. Verify that the MySQL service is started (3306 in the command is the default port). netstat nat grep 3306 Figure 5 Checking the MySQL service status Figure 5 shows that the MySQL service is started. Installing the MySQL client The MySQL client provides tools for MySQL management and user interaction, for example, mysqladmin and mysql. You must install the MySQL client on the IMC server to communicate with the MySQL server, local or remote. Enter the directory where the MySQL installation programs are located and install the MySQL client. rpm -ivh MySQL-client-5.6.15-1.el6.x86_64.rpm Installing the MySQL server 7

Figure 6 Installing the MySQL client Querying the current password After the MySQL client is installed, verify whether or not it can connect to the MySQL server. The initial password of default user root can be found in the.mysql_secret file in the /root directory. Figure 7 Password storage path Query the current password in the.mysql_secret file in the /root directory. vi /root/.mysql_secret Figure 8 Opening the.mysql_secret file 8 Installation

Figure 9 Querying the password assigned by the MySQL server IMC with a local database The MySQL server is installed on the IMC server. After the MySQL client is installed, run the following command and enter the root user password found in the.mysql_secret file at the prompt Enter password. mysql u root p If the MySQL command line interface is displayed, then the MySQL client is installed successfully. Figure 10 Verifying the MySQL client installation IMC with a remote database The IMC server is installed with the MySQL client only. Run the following command and enter the new root user password at the prompt Enter password. mysql -h 192.168.1.163 u root -p Before verifying the MySQL client installation, make sure a remote root user account has been created on the MySQL server. For information about how to create a remote root user account, see "Creating a remote root user account." Installing the MySQL client 9

Figure 11 Verifying the connection between the MySQL client and server In the output, 192.168.1.163 is the IP address of the MySQL server and root is the remote root user account. The prompt mysql shows that the client has successfully connected to the MySQL server. Customizing MySQL file directories After the MySQL server and client are installed, the database files, configuration files, and command files are saved in different directories. Table 1 Default MySQL file directories Directory /usr/bin /usr/sbin /var/lib/mysql /usr/share/mysql /etc/init.d/ /etc Contents Client programs and scripts. MySQL service program named mysqld. Logs and database files. Configuration files, error messages, and character set files. The mysql file used to start scripts. Configuration file for MySQL startup. The file is named my.cnf, includes instances, and determines the MySQL performance. To customize the directories, modify the datadir parameter in the my.cnf file in the /etc directory. For example: datadir=/root/mysql_data For more information about changing the directories of MySQL database files, see "(Optional) Changing the log and database file directory." 10 Installation

4 Startup and stop Starting and stopping the MySQL service MySQL is automatically configured as the system service after the MySQL server is installed. You can start or stop the MySQL service as a common system service. Figure 12 Start and stop commands You can also use the following command to stop the MySQL service. /usr/bin/mysqladmin u root p shutdown Figure 13 Stopping the MySQL service The /usr/bin directory stores the MySQL client programs and scripts. Enter the new root user password at the prompt Enter password. Automatic startup The MySQL service automatically starts when the system boots up. Figure 14 shows how to check whether the MySQL service is on the automatic startup list. Figure 14 Checking whether the MySQL service is on the automatic startup list The output shows that the MySQL service automatically starts in Linux run levels 2 through 5. For more information about run level, see Table 2. Table 2 Run level Run level 0 1 Name Halt Single-user Mode Description Shuts Down the System. Mode for administrative tasks. Starting and stopping the MySQL service 11

Table 2 Run level (continued) Run level 2 3 4 5 6 Name Multi-user Mode Multi-user Mode with Networking Not used/user-definable Start the system normally with appropriate display manager (with GUI) Reboot Description Does not configure network interfaces and does not export network services. Starts the system normally. For special purposes. Starts the system normally with display manager. Reboots the system. 12 Startup and stop

5 Configuring the MySQL server Setting security options 1. Run the mysql_secure_installation program. perl /usr/bin/mysql_secure_installation Figure 15 Setting the root user password 2. Enter the root user password to set security options, such as setting a root user password, removing anonymous users, and removing test database. 3. Enter n when the system asks you to change the root password. Figure 16 Choosing not to change the root user password Setting security options 13

4. Remove anonymous users and database test, as shown in Figure 17. If you want to use IMC with a local database, remote root user accounts must be disabled. Figure 17 Removing anonymous users, disabling remote root user accounts, and removing test database 5. When installing IMC to use a remote database, you must create a remote root user account. For information about how to create a remote root user account, see "Creating a remote root user account." 14 Configuring the MySQL server

6. Reload the privilege tables to make the changes effective. Figure 18 Reloading the privilege tables Changing the database password 1. Log in to the database with the password. mysql u root p 2. Enter the password at the prompt Enter password. The prompt mysql is displayed. Figure 19 Entering MySQL command line interface Changing the database password 15

3. Change the root user password. This example uses TLoTR123 as the new password. SET PASSWORD = PASSWORD( TLoTR123 ); Figure 20 Changing the root user password Figure 20 shows that the password has been changed successfully. Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 3. Otherwise, the password cannot be recognized during IMC installation. For information about creating a database user account, see "Creating a local user account." Table 3 Special characters Character name Symbol Character name Symbol Back quote ` Apostrophe ' Quotation marks " Exclamation point! Left parenthesis ( Right parenthesis ) Ampersand sign & Vertical bar Back slash \ Dollar sign $ Semi-colon ; At sign @ Left angle bracket < Right angle bracket > Slash / Caret ^ Creating a database user account Creating a remote root user account MySQL server only has a local root user account by default. If you want to use IMC with a remote database, install MySQL client and configure a remote root user account on the database server. Create a remote root user account on the MySQL server. grant all privileges on *.* to root@ % identified by TLoTR123 with grant option; 16 Configuring the MySQL server

Figure 21 Creating a remote root user account This example uses TLoTR123 as the remote root user password. IMPORTANT: Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 3. Otherwise, the password cannot be recognized during IMC installation. Creating a local user account Create a database user account and grant the user privileges to manage and operate the database. grant all privileges on *.* to Gandalf@ localhost identified by Sauron with grant option; Figure 22 Creating a database user account Creating a local user account 17

This example uses Gandalf as the user name and Sauron as the password. IMPORTANT: Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 3. Otherwise, the password cannot be recognized during IMC installation. Creating MySQL configuration files The default configuration file /etc/my.cnf determines the performance and behavior of the MySQL server. The file is not automatically generated by the installation program, but you must copy the my-default.cnf file from the /usr/share/mysql directory to the /etc directory and rename it my.cnf. cp /usr/share/mysql/my-default.cnf /etc/my.cnf Figure 23 Copying the default configuration file Configuring parameters in the my.cnf file 1. Stop the MySQL service. 2. Open the my.cnf file. vi /etc/my.cnf Figure 24 Opening the my.cnf file 3. Press i to enter the edit mode 18 Configuring the MySQL server

Figure 25 Entering the edit mode 4. Add parameters under [mysqld]. Table 4 describes the parameters that can be configured in the my.cnf file. [mysqld] character-set-server = latin1 default-storage-engine = INNODB innodb_buffer_pool_size = 512M innodb_additional_mem_pool_size = 16M max_allowed_packet = 200M max_connections = 400 lower_case_table_names = 1 The latin1 is used as an example here. To prevent garbled characters appearing in imc, please choose a character set according to your operating system language. If you change the character set of MySQL after IMC has been deployed, you have to reinstall IMC. Configuring parameters in the my.cnf file 19

Figure 26 Adding parameters under [mysqld] Table 4 Parameters in the my.cnf file Parameters max_connections character-set-server default-storage-engine innodb_buffer_pool_size innodb_additional_mem_pool_size lower_case_table_names max_allowed_packet Description Maximum number of connections permitted by the MySQL server. You can modify this maximum number based on the number of deployed IMC components. For the maximum number allowed for each component or subcomponent, see IMC Getting Started Guide. Character sets required by the MySQL database. For example, the character sets for English, Chinese, Russian, and Japanese are latin1, gbk, cp866, and sjis, respectively. Type of the MySQL database engine: MyISAM InnoDB MEMORY MERGE Size of the InnoDB buffer pool. Size of the InnoDB additional memory pool. Indicates whether a table name is case sensitive or not. 0 Yes 1 No Size of the allowed maximum packet. 5. Search for the log-bin parameter under [mysqld] in the my.cnf file and comment out this parameter. This parameter is commented out by default. [mysqld] # log-bin 20 Configuring the MySQL server

Figure 27 Commenting out the log-bin parameter 6. Press Esc to return to the common mode, and enter :wq to save the my.cnf file and quit the vi editor. (Optional) Changing the log and database file directory The log and database file directory can be changed by the following steps: 1. Stop the MySQL service. service mysql stop 2. Create a path for storing logs and database files. The directory is /data/mysql_data in this example. mkdir p /data/mysql_data 3. Copy all files from the default directory to the new directory and change ownership of the files. cp R /var/lib/mysql/* /data/mysql_data/ chown R mysql:mysql /data/mysql_data 4. Add the new directory to the [mysqld] section in the my.cnf file of the MySQL database. vi /etc/my.cnf datadir=/data/mysql_data 5. Save and quit the vi editor. 6. Start the MySQL service. service mysql start (Optional) Changing the log and database file directory 21

6 Uninstallation IMC with a local database 1. Stop the MySQL service. service mysql stop 2. Uninstall the MySQL database. rpm e MySQL-client-5.6.15-1.el6.x86_64 rpm e MySQL-server-5.6.15-1.el6.x86_64 The following command can be used to query the component name. rpm -qa grep MySQL Figure 28 Uninstalling the MySQL database 3. Manually remove database files in the default /var/lib/mysql directory after uninstallation. rm -rf /var/lib/mysql After the directory is removed, the MySQL database is removed successfully. IMC with a remote database Uninstall the MySQL database. rpm -qa grep MySQL rpm e MySQL-client-5.6.15-1.el6.x86_64 Figure 29 Searching for the MySQL component 22 Uninstallation

7 FAQ Why do garbled characters appear in the database table? Configure the correct character set when you install the MySQL server and client. Otherwise, garbled characters can appear in the database table. For more information, see Table 4. How do I update the database password for the IMC server? The user names and passwords used by IMC components are stored in ciphertext in the /common/conf/server-addr.xml file in the IMC installation directory. You can use the./pwdmgr command to obtain passwords in plain text or save the new passwords in ciphertext to the file You can use the database management tool to change the database password of an IMC component. After the change, you must use the./pwdmgr command to update the corresponding password in the server-addr.xml file to make sure IMC can communicate with the database. If IMC is deployed in distributed mode, you must update the database password on every IMC server. [root@daemon8829 ~]# cd /opt/imc/deploy/ [root@daemon8829 deploy]#./pwdmgr.sh modify 127.0.0.1 config_db imc_config dbpasswd Change password successfully The dbpasswd string indicates the new database password of the imc_config user. The config_db string indicates the database name. The 127.0.0.1 string indicates the database IP address. To obtain the IP address and name of a MySQL database, view information about the corresponding user in the $IMCROOT/common/conf/server-addr.xml file. 23

8 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.com/support Before contacting HP, collect the following information: Technical support registration number (if applicable) Product serial numbers Product model names and number Product identification number Applicable error message Add-on boards or hardware Third-party hardware or software Operating system type and revision level Subscription service HP recommends that you register your product at the Subscriber's Choice for Business website: http://www.hp.com/go/wwalerts After registering, you will receive email notification of product enhancements, new driver versions, firmware updates, and other product resources. New and changed information in this edition The following additions and changes have been made for this edition: A new "Support and other resources" chapter has been added. Related information Documents Websites To find related documents, browse to the Manuals page of the HP Business Support Center website: http://www.hp.com/support/manuals For related documentation, navigate to the Networking section, and select a networking category. For a complete list of acronyms and their definitions, see HP FlexNetwork Technology Acronyms. HP.com: http://www.hp.com HP Networking: http://www.hp.com/go/networking HP download drivers and software: http://www.hp.com/support/downloads 24 Support and other resources

Typographic conventions This section describes the conventions used in this documentation set. Document conventions Table 5 Document conventions Convention Blue text: Table 5 Blue, underlined text: http:// www.hp.com Description Cross-reference links and email addresses Website addresses Bold text Keys that are pressed Text typed into a GUI element, such as a box GUI elements that are clicked or selected, such as menu and list items, buttons, tabs, and check boxes Italic text Text emphasis Monospace text File and directory names System output Code Commands, their arguments, and argument values Monospace, italic text Code variables Command variables Monospace, bold text Emphasized monospace text GUI conventions Table 6 GUI conventions Convention Boldface > Description Window names, button names, field names, and menu items are in bold text. For example, the New User window appears; click OK. Multi-level menus are separated by angle brackets. For example, File > Create > Folder. Symbols WARNING! An alert that calls attention to important information that if not understood or followed can result in personal injury. CAUTION: An alert that calls attention to important information that if not understood or followed can result in data loss, data corruption, or damage to hardware or software. IMPORTANT: An alert that calls attention to essential information. NOTE: An alert that contains additional or supplementary information. Typographic conventions 25

9 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback. 26 Documentation feedback

Index A acronym definitions, 23 C contacting HP, 24 D database passwords, 23 documentation, 24 typographic conventions, 25 documentation, providing feedback on, 26 F FAQ, 23 G garbled characters, 23 H help obtaining, 24 HP technical support, 24 P product registration, 23 R registering product, 24 subscription service, 24 registering product, 23 T technical support, 24 HP, 24 typographic conventions documentation, 25 symbols, 25 text GUI conventions, 25 U updating, 23 updating database passwords, 23 W websites, 24 27