HPE Intelligent Management Center

Transcription

1 HPE Intelligent Management Center MySQL 5.5 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: R 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 1 Installing the required software packages 1 Removing the built-in MariaDB 1 Copying the installation programs to the Linux server 2 Installation 4 Installing the MySQL server 4 Installing the MySQL client 5 Customizing MySQL file directories 6 Startup and stop 7 Starting and stopping the MySQL service 7 Automatic startup 7 Configuring the MySQL server 9 Setting security options 9 Creating a remote root user account 11 Configuring MySQL configuration files 11 Configuring the maximum number of connections 12 Configuring the character set 12 Configuring the engine type 12 Configuring case-insensitive table names 13 Disabling log-bin settings 13 Setting innodb buffer sizes 13 Setting the max_allowed_packet size 14 Changing the log and database file directory 14 Uninstallation 15 FAQ 16 About HPE IMC documents 18 Document conventions 21 Support and other resources 22 Accessing Hewlett Packard Enterprise Support 22 Accessing updates 22 Websites 23 Customer self repair 23 Remote support 23 Documentation feedback 23

4 Overview This document describes how to install and configure the MySQL 5.5 database for use with IMC. The procedures also apply to MySQL 5.1. Perform all procedures in this document as a Linux root user, unless otherwise specified. The installation procedures for the MySQL server for other versions might vary. For more information about installing other versions, see the installation and configuration guides. IMPORTANT: Before you install IMC, you must install and start the database service. 1

5 Prerequisites Before you install MySQL on Red Hat Enterprise Linux 7.0, install necessary Linux packages and remove the built-in MariaDB. Installing the required software packages 1. Prepare the following Linux packages: glibc el7.i686.rpm libaio el7.i686.rpm libgcc el7.i686.rpm libstdc el7.i686.rpm nss-softokn-freebl el7.i686.rpm 2. Install the packages. 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 Removing the built-in MariaDB Before you install the MySQL 5.5 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. 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 1

6 Figure 1 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 you install the MySQL server, 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 shown in Figure 2. In this example, the MySQL installation programs are located in the directory /mysql. Figure 2 MySQL installation programs on the Linux operating system NOTE: Install both MySQL-server el7.x86_64.rpm and 2

7 MySQL-client el7.x86_64.rpm on the database server. Install only MySQL-client el7.x86_64.rpm on the IMC server that uses a remote database. During IMC installation, select other server for the database location, and then enter the server address. 3

8 Installation Installing the MySQL server 1. Go to the directory where the MySQL installation programs are located. 2. Launch the MySQL server installation, as shown in Figure 3. Figure 3 Installing the MySQL server 3. Start the MySQL service after the installation is complete. service mysql start 4. Verify that the MySQL service has started, as shown in Figure 4. netstat nat grep 3306 By default, the MySQL server uses port number Figure 4 Checking the MySQL service status 4

9 Installing the MySQL client The MySQL client provides tools for MySQL management and user interaction, for example, mysqladmin and mysql. To install the MySQL client: 1. Go to the directory where the MySQL installation programs are located. 2. Launch the MySQL client installation, as shown in Figure 5. Figure 5 Installing the MySQL client 3. Verify the installation. If the MySQL server is installed on the local server, log in to the server by using the mysql command. Figure 6 shows that the MySQL client is installed successfully. Figure 6 Entering the mysql command If the MySQL server is installed on a remote server, verify that the client can connect to the MySQL server, as shown in Figure 7. Make sure the MySQL server contains your root user account. For information about how to create a remote root user account, see "Creating a remote root user account." 5

10 Figure 7 Verifying the connection to the MySQL server The output shows that is the IP address of the MySQL server, and root is the root user account. The mysql prompt indicates that the client has connected successfully 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, as described in Table 1. Table 1 Default MySQL file directories Directory /usr/bin /usr/sbin /var/lib/mysql /usr/share/mysql /etc/init.d/ /etc Connector Client programs and scripts mysqld (MySQL service program) Logs and database files Configuration files, error messages, and character set files Enables script mysql my.cnf To customize the directories, modify the datadir parameter in the /etc/my.cnf file. datadir=/root/mysql_data The total size of logs and database files can become large. It is restricted by the maximum size allowed by the operating system. You can change the directory to a disk drive with a large capacity. For more information about changing the directories for the MySQL database files, see "Changing the log and database file directory." 6

11 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, as shown in Figure 8. Figure 8 Start and stop commands You can also use the mysqladmin command to stop the MySQL server, as shown in Figure 9. Figure 9 mysqladmin command You must enter the password for your root user account. If the MySQL server is installed for the first time, the password is empty. Press Enter. Automatic startup The MySQL service starts automatically when the system boots. Figure 10 shows how to determine whether the MySQL service is on the automatic startup list. Figure 10 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. 7

12 Run level Name Description 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. 8

13 Configuring the MySQL server Disable the MySQL service before you perform the tasks described in this chapter, except "Setting security options" and "Creating a remote root user account." Setting security options Run the mysql_secure_installation program to set security options, such as setting a root user password, as shown in Figure 11, and removing anonymous users or the test database, as shown in Figure 12. In the following procedures, the root user refers to the MySQL database root user, not the Linux root user. Figure 11 Setting the root user password IMPORTANT: For IMC to correctly identify the root user password during installation, ensure that the password does not contain spaces, tabs (\t), or any of the following characters: ` ' "! ( ) & \ $ < > / ^ 9

14 Figure 12 Configuring anonymous users, remote root access, and the test database The output shows that remote root access is disabled. For information about configuring the remote root user, see "Creating a remote root user account." The privilege tables are reloaded, as shown in Figure 13. Figure 13 Reloading the privilege tables After the privilege tables are reloaded, the configuration is complete, and the MySQL server is secure. 10

15 Creating a remote root user account When you install IMC to use a remote database, you must log in to the database as a remote root user. To create a remote root user account: 1. Log in to MySQL. mysql -uroot -pimc Create a remote root user account on the MySQL server. grant all privileges on *.* to root@'%' identified by 'imc123' with grant option; In Figure 14, the first imc123 string is the password for the root user, and the second imc123 string is the password for the remote root user. You can change the password for the remote root user. Figure 14 Creating a remote root user account IMPORTANT: For IMC to correctly identify the password during installation, ensure that the password does not contain spaces, tabs (\t), or any of the following characters: ` ' "! ( ) & \ $ < > / ^ Configuring MySQL configuration files At startup, MySQL server uses the default configuration file /etc/my.cnf, which determines the performance and behavior of the MySQL server. The file is not generated automatically. Select the proper settings from /usr/share/mysql. The my-huge.cnf file is required to support IMC. Copy the file, and then save it to the my.cnf file, as shown in Figure

16 Figure 15 Copying the my-huge.cnf file to my.cnf Configuring the maximum number of connections 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Add the max_connections parameter under [mysqld]. If this parameter already exists, modify the value as needed. [mysqld] max_connections=400 You can set the maximum number of connections according to the installed modules. For more information about the maximum number of connections for different IMC modules, see HP IMC Getting Started Guide. 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq 6. Start the MySQL service. Configuring the character set The English character set is latin1. To configure the character set: 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Add the character-set-server parameter under [mysqld]. If this parameter already exists, you can change the value. vi /etc/my.cnf [mysqld] character-set-server=latin1 The latin1 character set is used as an example. 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. 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Configuring the engine type 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 12

17 2. Enter i to enter edit mode. 3. Add the default-storage-engine parameter under [mysqld]. If this parameter already exists, you can change the value. vi /etc/my.cnf [mysqld] default-storage-engine = INNODB 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Configuring case-insensitive table names 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Add the lower_case_table_names parameter under [mysqld]. If this parameter already exists, you can change the value. vi /etc/my.cnf [mysqld] lower_case_table_names=1 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Disabling log-bin settings 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Search the log-bin parameter under [mysqld]. If this parameter already exists, comment it out. vi /etc/my.cnf [mysqld] #log-bin=mysql-bin 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Setting innodb buffer sizes 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Add the innodb_buffer_pool_size and innodb_additional_mem_pool_size parameters under [mysqld]. If the parameters already exist, you can change the values. [mysqld] innodb_buffer_pool_size=512m 13

18 innodb_additional_mem_pool_size=16m 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Setting the max_allowed_packet size 1. Open the my.cnf file in vi editor. vi /etc/my.cnf 2. Enter i to enter edit mode. 3. Add the max_allowed_packet parameter under [mysqld]. If the parameter already exists, you can change the value. [mysqld] max_allowed_packet = 200M 4. Press Esc to exit edit mode. 5. Save the file and exit the vi editor. :wq Changing the log and database file directory 1. Stop the MySQL service. service mysql stop 2. Create a storage path for logs and database files. In this example, the path is /data/mysql_data. 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 a R /var/lib/mysql/* /data/mysql_data/ chown R mysql:mysql /data/mysql_data 4. Add the directory in the configuration file of the MySQL database. vi /etc/my.cnf [mysqld] datadir=/data/mysql_data 5. Enable the MySQL service. service mysql start 14

19 Uninstallation 1. Uninstall the MySQL server and client, as shown in Figure 16. Figure 16 Uninstalling the MySQL server and client 2. Check the component names, as shown in Figure 17. Figure 17 Checking MySQL components 3. Manually remove the database files after uninstallation. By default, the database files are saved in /var/lib/mysql. Use the rm rf command to remove the mysql directory. 15

20 FAQ Why do garbled characters appear in the database table? During the installation of the MySQL server and client, configure a 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. If your operating system language is different, see MySQL documentation for the correct character set. How do I update the database passwords for IMC? If the password for 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 that is saved in IMC: 1. In the Intelligent Deployment Monitoring Agent, click the Environment tab, and then click Change Password under the Database Space Usage area, as shown in Figure 18. Figure 18 Intelligent Deployment Monitoring Agent 2. On the Input database user password dialog box that appears, enter the new password, as shown in Figure

21 Figure 19 Entering the new password 3. Click OK. 17

22 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.6 Installation and Configuration Guide (for Linux) 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.6 on Linux for IMC. 18

23 Documents MySQL 5.6 Installation and Configuration Guide (for Windows) Red Hat Enterprise Linux 6.4 Installation Guide Red Hat Enterprise Linux 7.0 Installation Guide Purpose Guides you through installing MySQL 5.6 on Windows for IMC. 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 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. 19

24 Documents HPE IMC EAD Security Policy Administrator Guide Online Help Purpose Describes operation procedures on the IMC EAD Security Policy Manager. Helps you properly use IMC. Operations and maintenance Readme Provides most recent IMC release information. 20

25 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. 21

26 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. 22

27 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. 23