HPE Intelligent Management Center

Transcription

1 HPE Intelligent Management Center MySQL 5.6 Installation and Configuration Guide (for Linux) Abstract This document provides installation and configuration information for MySQL. It includes 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. Part number: Software version: IMC PLAT 7.2 (E0403) Document version: 5P

2 Copyright 2015 Hewlett-Packard Enterprise Development LP The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise 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. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or copying. Consistent with FAR and , Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor s standard commercial license. Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website. i

3 Contents Overview 1 Prerequisites 2 Installing the required software packages 2 Removing the built-in MariaDB 2 Copying the installation programs to the Linux server 3 Installation 5 Installing the MySQL server 5 Installing the MySQL client 5 Querying the current password 6 IMC with a local database 6 IMC with a remote database 7 Customizing MySQL file directories 8 Startup and stop 9 Starting and stopping the MySQL service 9 Automatic startup 9 Configuring the MySQL server 11 Setting security options 11 Changing the database password 13 Creating a remote root user account 15 Creating MySQL configuration files 15 Configuring parameters in the my.cnf file 16 Changing the log and database file directory 18 Uninstallation 19 IMC with a local database 19 IMC with a remote database 19 FAQ 20 About HPE IMC documents 22 Document conventions 25 Support and other resources 26 Accessing Hewlett Packard Enterprise Support 26 Accessing updates 26 Websites 27 Customer self repair 27 Remote support 27 Documentation feedback 27 ii

4 Overview This document describes how to install and configure the MySQL 5.6 database in 64-bit Red Hat Enterprise Linux 7.0 before you install IMC. The installation procedures for MySQL databases of other versions might vary. For information about installing databases of other versions, see their respective installation and configuration guides. Perform all procedures in this document as a Linux root user, unless instructed to do otherwise. This document uses the installation program MySQL-server el7.x86_64.rpm and MySQL-client el7.x86_64.rpm 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. 1

5 Prerequisites Before installing the MySQL 5.6 database, install the required software packages and remove the built-in MariaDB. Installing the required software packages Install the following software packages in the Red Hat Enterprise Linux 7.0 environment: glibc el7.i686.rpm libaio el7.i686.rpm libgcc el7.i686.rpm libstdc el7.i686.rpm nss-softokn-freebl el7.i686.rpm To ensure that these 32-bit software packages can be installed successfully in the 64-bit Linux system, run the following commands as a root user: rpm i -nodeps glibc el7.i686.rpm rpm i -nodeps libaio el7.i686.rpm rpm i -nodeps libgcc el7.i686.rpm rpm i --nodeps libstdc el7.i686.rpm rpm -i --nodeps nss-softokn-freebl el7.i686.rpm Figure 1 Installing the required software packages Removing the built-in MariaDB Before you install the MySQL 5.6 database, you must remove the built-in MariaDB built in Red Hat Enterprise Linux Query the installed MariaDB and related programs. rpm qa grep mariadb 2

6 2. Remove the software packages. rpm e mariadb-server el7.x86_64 rpm e mariadb el7.x86_64 rpm e mariadb-libs el7.x86_64 3. Remove the dependent packages if you receive a mariadb-server el7.x86_64 and rpm e mariadb-libs el7.x86_64 package dependency message. rpm e - nodeps mariadb-server el7.x86_64 rpm e - nodeps mariadb-libs el7.x86_64 Figure 2 Removing the built-in MariaDB 4. Query the installed MySQL database and related programs. rpm qa grep MySQL 5. Remove the software package. rpm e perl-dbd-mysql el7.x86_64 Copying the installation programs to the Linux server Before installing the MySQL database, copy the installation programs to the Linux server. This document uses the installation programs MySQL-server el7.x86_64.rpm and MySQL-client el7.x86_64.rpm. 3

7 Figure 3 MySQL installation programs on Linux If the database and IMC are installed on the same server, install both MySQL-server el7.x86_64.rpm and MySQL-client el7.x86_64.rpm on the IMC server. If IMC is installed on a server other than the database server, install MySQL-client el7.x86_64.rpm on the IMC server and install MySQL-server el7.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. 4

8 Installation In the following procedures, root user refers to the MySQL database root user, not the Linux root user, unless specified otherwise. Installing the MySQL server 1. Go to the directory where the MySQL installation programs are located and install the MySQL server. rpm -ivh MySQL-server el7.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 has started (3306 is the default port). netstat nat grep 3306 Figure 5 shows that the MySQL service has started. Figure 5 Checking the MySQL service status 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). Go to the directory where the MySQL installation programs are located and install the MySQL client. rpm -ivh MySQL-client el7.x86_64.rpm 5

9 Figure 6 Installing the MySQL client Querying the current password After the MySQL client is installed, verify that 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. Query the current password in the.mysql_secret file in the /root directory. vi /root/.mysql_secret Figure 7 Opening the.mysql_secret file Figure 8 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, the MySQL client was installed successfully. 6

10 Figure 9 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 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." Figure 10 Verifying the connection between the MySQL client and server In the output, is the IP address of the MySQL server, and root is the remote root user account. The prompt mysql indicates that the client has connected successfully to the MySQL server. 7

11 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 "Changing the log and database file directory." 8

12 Startup and stop Starting and stopping the MySQL service MySQL is configured automatically as the system service after the MySQL server is installed. You can start or stop the MySQL service as a common system service. Figure 11 Start and stop commands You can also use the following command to stop the MySQL service: /usr/bin/mysqladmin u root p shutdown Figure 12 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 starts automatically when the system boots. Figure 13 shows how to determine whether the MySQL service is on the automatic startup list. 9

13 Figure 13 Determining whether the MySQL service is on the automatic startup list The output shows that the MySQL service starts automatically in Linux run levels 2 through 5. Table 2 describes the run levels. Table 2 Run levels Run level Name Description 0 Halt Shuts down the system. 1 Single-user Mode Mode for administrative tasks. 2 Multi-user Mode Does not configure network interfaces and does not export network services. 3 Multi-user Mode with Networking Starts the system normally. 4 Not used/user-definable For special purposes. 5 Start the system normally with appropriate display manager (with GUI) Starts the system normally with display manager. 6 Reboot Reboots the system. 10

14 Configuring the MySQL server Setting security options 1. Run the mysql_secure_installation program. perl /usr/bin/mysql_secure_installation 2. Enter the root user password to set security options, such as setting a root user password, removing anonymous users, and removing a test database. Figure 14 Setting the root user password 3. Enter n when the system asks you to change the root password. Figure 15 Choosing not to change the root user password 4. Remove anonymous users and the database named test. If you want to use IMC with a local database, you must disable remote root login. 11

15 Figure 16 Configuring anonymous users, remote access, and the 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." 6. Reload the privilege tables to make the changes take effect. 12

16 Figure 17 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 18 Entering the MySQL command line interface 13

17 3. Change the root user password. This example uses TLoTR123 as the new password. SET PASSWORD = PASSWORD('TLoTR123'); Figure 19 shows that the password has been changed successfully. Figure 19 Changing the root user password Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 3. Otherwise, the password is not recognized during IMC installation. For information about creating a database user account, see "Error! Reference source not found.." Table 3 Special characters Character name Ampersand Apostrophe At sign Back quote Symbol & ` Backslash \ Caret ^ Dollar sign $ Exclamation point! Left angle bracket < Left parenthesis ( Quotation marks " Right angle bracket > Right parenthesis ) Semicolon ; Slash / 14

18 Character name Symbol Vertical bar Creating a remote root user account By default, the MySQL server has only one local root user account. 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 'imc123' with grant option; This example uses imc123 as the remote root user password. Figure 20 Creating a remote root user account IMPORTANT: Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 3. Otherwise, the password is not 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 generated automatically by the installation program. 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 15

19 Figure 21 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 22 Opening the my.cnf file 3. Enter i to enter edit mode. Figure 23 Entering edit mode 4. Add parameters under [mysqld]. Table 4 describes the parameters that you can configure in the my.cnf file. 16

20 [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 This example uses latin1. To prevent garbled characters from appearing in IMC, choose the character set for your operating system language. If you change the character set after IMC has been deployed, you must reinstall IMC. Figure 24 Adding parameters under [mysqld] Table 4 File parameters Parameter max_connections character-set-server default-storage-engine innodb_buffer_pool_size innodb_additional_mem_pool_size lower_case_table_names Description Maximum number of connections permitted by the MySQL server. You can modify this 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 set required by the MySQL database. The character set for English is latin1. 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. 0 Yes 1 No 17

21 Parameter max_allowed_packet Description Maximum allowed size for a packet. 5. Search for the log-bin parameter under [mysqld] in the my.cnf file and comment it out. (This parameter is commented out by default.) [mysqld] # log-bin Figure 25 Commenting out the log-bin parameter 6. Press Esc to return to common mode, and then enter :wq to save the my.cnf file and quit the vi editor. Changing the log and database file directory Change the log and database file directory as needed. 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 then 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 the my.cnf file, and then quit the vi editor. 6. Start the MySQL service. service mysql start 18

22 Uninstallation IMC with a local database 1. Stop the MySQL service. service mysql stop 2. Uninstall the MySQL database. rpm e MySQL-client el7.x86_64 rpm e MySQL-server el7.x86_64 You can use the following command to query the component name: rpm -qa grep MySQL Figure 26 Uninstalling the MySQL database 3. Manually remove the database files in the default directory /var/lib/mysql 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 el7.x86_64 Figure 27 Searching for the MySQL component 19

23 FAQ Why do garbled characters appear in the database table? During the installation of the MySQL server and client, configure a correct database character set that matches the operating system language. If they do not match, garbled characters might appear in the database table. If you use an English operating system, set the character set to latin1. For more information, see "Configuring parameters in the my.cnf file." If your operating system language is different, see the related MySQL documentation for the correct character set. How do I update the database password for the IMC server? If the password of the account that IMC uses to connect to a database is changed, the IMC server fails to connect to the database. To resolve this problem, modify the database user password saved in IMC: 1. Click the Environment tab of the intelligent deployment monitoring agent, and click Change Password below the Database Space Usage area. Figure 28 Intelligent Deployment Monitoring Agent 2. On the Input database user password dialog box that appears, enter the new password. 20

24 Figure 29 Entering database user password 3. Click OK. 21

25 About HPE IMC documents The following are the documents available for HPE IMC: Documents Purpose Hardware specifications and installation HPE IMC Getting Started Guide HPE IMC Centralized Deployment Guide with Embedded Database HPE IMC Centralized Deployment Guide with Local Database HPE IMC Centralized Deployment Guide with Remote Database HPE IMC Distributed Deployment Guide with Local Database HPE IMC Distributed Deployment Guide with Remote Database HPE IMC Probe Installation Guide HPE IMC RSM Installation Guide HPE IMC ihatool Installation Guide SQL Server 2008 Installation and Configuration Guide SQL Server 2008 R2 Installation and Configuration Guide SQL Server 2012 Installation and Configuration Guide SQL Server 2014 Installation and Configuration Guide Oracle 11g Installation and Configuration Guide(for Linux) Oracle 11g R2 Installation and Configuration Guide(for Linux) Oracle 12c Installation and Configuration Guide(for Linux) MySQL 5.5 Installation and Configuration Guide (for Windows) MySQL 5.5 Installation and Configuration Guide (for Linux) MySQL 5.6 Installation and Configuration Guide (for Windows) Quickly guides you through the IMC main features and troubleshooting common problems. Provides a complete guide to IMC platform and components installation and centralized deployment using embedded database. Provides a complete guide to IMC platform and components installation and centralized deployment using local database. Provides a complete guide to IMC platform and components installation and centralized deployment using remote database. Provides a complete guide to IMC platform and components installation and distributed deployment using local database. Provides a complete guide to IMC platform and components installation and distributed deployment using remote database. Provides a complete guide to IMC Probe installation and deployment. Provides a complete guide to IMC RSM installation and deployment. Provides a complete guide to IMC ihatool installation. Guides you through installing SQL Server 2008 for IMC. Guides you through installing SQL Server 2008 R2 for IMC. Guides you through installing SQL Server 2012 for IMC. Guides you through installing SQL Server 2014 for IMC. Guides you through installing Oracle 11g on Linux for IMC. Guides you through installing Oracle 11g R2 on Linux for IMC. Guides you through installing Oracle 12c on Linux for IMC. Guides you through installing MySQL 5.5 on Windows for IMC. Guides you through installing MySQL 5.5 on Linux for IMC. Guides you through installing MySQL 5.6 on Windows for IMC. 22

26 Documents Red Hat Enterprise Linux 6.4 Installation Guide Red Hat Enterprise Linux 7.0 Installation Guide Purpose Guides you through installing Red Hat Enterprise Linux 6.4 for IMC. Guides you through installing Red Hat Enterprise Linux 7.0 for IMC. Software configuration HPE IMC Enterprise and Standard Platform Administrator Guide HPE IMC Quality of Service Manager Administrator Guide HPE IMC Resource Automation Manager Administrator Guide HPE IMC Service Health Manager Administrator Guide HPE IMC VAN Connection Manager Administrator Guide HPE IMC VAN Software Defined Network Manager Administrator Guide HPE IMC VAN Fabric Manager Administrator Guide HPE IMC Application Manager Administrator Guide HPE IMC Branch Intelligent Management System Administrator Guide HPE IMC Business Service Performance Administrator Guide HPE IMC IPsec VPN Manager Administrator Guide HPE IMC MPLS VPN Manager Administrator Guide HPE IMC Network Traffic Analyzer Administrator Guide HPE IMC Service Operation Manager Administrator Guide HPE IMC User Behavior Auditor Administrator Guide HPE IMC UC Health Manager Admin Guide HPE IMC Wireless Service Manager Administrator Guide HPE IMC User Access Manager Administrator Guide HPE IMC TACACS+ Authentication Manager Administrator Guide HPE IMC EAD Security Policy Administrator Guide Online Help Describes operation procedures on the IMC platform. Describes operation procedures on the IMC Quality of Service Manager. Describes operation procedures on the Resource Automation Manager. Describes operation procedures on the Service Health Manager. Describes operation procedures on the IMC VAN Connection Manager. Describes operation procedures on the IMC VAN Software Defined Network Manager. Describes operation procedures on the IMC VAN Fabric Manager. Describes operation procedures on the IMC Application Manager. Describes operation procedures on the IMC Branch Intelligent Management System. Describes operation procedures on the IMC Business Service Performance. Describes operation procedures on the IMC IPsec VPN Manager. Describes operation procedures on the IMC MPLS VPN Manager. Describes operation procedures on the IMC Network Traffic Analyzer. Describes operation procedures on the IMC Service Operation Manager. Describes operation procedures on the IMC User Behavior Auditor. Describes operation procedures on the IMC UC Health Manager. Describes operation procedures on the IMC Wireless Service Manager. Describes operation procedures on the IMC User Access Manager. Describes operation procedures on the IMC TACACS+ Authentication Manager. Describes operation procedures on the IMC EAD Security Policy Manager. Helps you properly use IMC. 23

27 Documents Purpose Operations and maintenance Readme Provides most recent IMC release information. 24

28 Document conventions This section describes the conventions used in the documentation. Port numbering in examples The port numbers in this document are for illustration only and might be unavailable on your device. Command conventions Convention Boldface Italic Description Bold text represents commands and keywords that you enter literally as shown. Italic text represents arguments that you replace with actual values. # A line that starts with a pound (#) sign is comments. GUI conventions Convention Boldface > Description Window names, button names, field names, and menu items are in Boldface. For example, the New User window appears; click OK. Multi-level menus are separated by angle brackets. For example, File > Create > Folder. Symbols Convention WARNING! CAUTION: IMPORTANT: NOTE: TIP: Description An alert that calls attention to important information that if not understood or followed can result in personal injury. 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. An alert that calls attention to essential information. An alert that contains additional or supplementary information. An alert that provides helpful information. 25

29 Support and other resources Accessing Hewlett Packard Enterprise Support For live assistance, go to the Contact Hewlett Packard Enterprise Worldwide website: To access documentation and support services, go to the Hewlett Packard Enterprise Support Center website: Information to collect Technical support registration number (if applicable) Product name, model or version, and serial number Operating system name and version Firmware version Error messages Product-specific reports and logs Add-on products or components Third-party products or components Accessing updates Some software products provide a mechanism for accessing software updates through the product interface. Review your product documentation to identify the recommended software update method. To download product updates, go to either of the following: Hewlett Packard Enterprise Support Center Get connected with updates page: Software Depot website: To view and update your entitlements, and to link your contracts, Care Packs, and warranties with your profile, go to the Hewlett Packard Enterprise Support Center More Information on Access to Support Materials page: IMPORTANT: Access to some updates might require product entitlement when accessed through the Hewlett Packard Enterprise Support Center. You must have an HP Passport set up with relevant entitlements. 26

30 Websites Website Link Networking websites Hewlett Packard Enterprise Networking Information Library Hewlett Packard Enterprise Networking website Hewlett Packard Enterprise Networking My Support General websites Hewlett Packard Enterprise Information Library Hewlett Packard Enterprise Support Center Contact Hewlett Packard Enterprise Worldwide Subscription Service/Support Alerts Software Depot Customer Self Repair (not applicable to all devices) Insight Remote Support (not applicable to all devices) Customer self repair Hewlett Packard Enterprise customer self repair (CSR) programs allow you to repair your product. If a CSR part needs to be replaced, it will be shipped directly to you so that you can install it at your convenience. Some parts do not qualify for CSR. Your Hewlett Packard Enterprise authorized service provider will determine whether a repair can be accomplished by CSR. For more information about CSR, contact your local service provider or go to the CSR website: Remote support Remote support is available with supported devices as part of your warranty, Care Pack Service, or contractual support agreement. It provides intelligent event diagnosis, and automatic, secure submission of hardware event notifications to Hewlett Packard Enterprise, which will initiate a fast and accurate resolution based on your product s service level. Hewlett Packard Enterprise strongly recommends that you register your device for remote support. For more information and device support details, go to the following website: Documentation feedback Hewlett Packard Enterprise 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@hpe.com). When submitting your feedback, include the document title, part number, edition, and publication date located on the front cover of the document. For online help content, include the product name, product version, help edition, and publication date located on the legal notices page. 27