HP Intelligent Management Center v7.1 MySQL 5.6 Installation and Configuration Guide (Windows)

HP Intelligent Management Center v7.1 MySQL 5.6 Installation and Configuration Guide (Windows) 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. HP Part Number: 5998-6606 Published: September 2014 Software Version: IMC PLAT 7.1 (E0302) Edition: 1.0

Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, 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. The information contained herein is subject to change without notice. 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. Acknowledgments Windows is a U.S. registered trademark of Microsoft Corporation.

Contents 1 Overview...4 2 Prerequisites...5 3 Installation...6 Installing the MySQL server...6 Installing the MySQL client...17 Testing the connectivity...23 4 MySQL service startup and stop...25 5 MySQL server configuration...26 Adding an environment variable value...26 Configuring MySQL parameters...28 Creating a database user account...30 6 Uninstallation...33 7 FAQ...37 8 Support and other resources...39 Contacting HP...39 Subscription service...39 Related information...39 Documents...39 Websites...39 Conventions...39 Document conventions...39 GUI conventions...40 Symbols...40 9 Documentation feedback...41 Index...42 Contents 3

1 Overview This document describes how to install and configure the MySQL 5.6 database in Windows Server 2008 R2. The installation procedures for MySQL databases of other versions might vary. For more information, see their respective installation and configuration guides. IMPORTANT: Before you install IMC, you must install and start the MySQL server. If IMC is deployed in distributed mode, the master and subordinate IMC servers must use the same MySQL server as the database server. 4 Overview

2 Prerequisites Before the installation, copy the installation program to the Windows server. This document uses the installation program mysql-installer-community-5.6.19.0.msi. The installation procedures for the MySQL server of other versions might vary. For more information, see their respective installation and configuration guides. Make sure Microsoft.Net Framework 4 has been installed before you install the MySQL server or client on the Windows server system. 5

3 Installation If IMC will use a local database, install the MySQL server on the same server where you install IMC. If IMC will use a remote database server, install the MySQL server on the database server and install the MySQL client on the same server as IMC. The MySQL client must be installed before you install IMC. During IMC installation, you must select other server and specify the server address to test the database connection. Installing the MySQL server 1. Double-click the MySQL installation program to start the setup wizard. Figure 1 Welcome dialog box 2. Click Install MySQL Products. The License Agreement dialog box appears. 6 Installation

Figure 2 License Agreement dialog box 3. Select I accept the license terms and click Next. The Find latest products dialog box appears. Figure 3 Find the latest products dialog box Installing the MySQL server 7

4. Click Execute to find the latest product version or skip the check. In this example, select Skip the check for updates (not recommended) and click Next. The Choosing a Setup Type dialog box appears. Figure 4 Choosing a Setup Type dialog box 5. Select Server only. 6. Set the Installation Path and Data Path. The default installation path and data path are C:\Program Files\MySQL and C:\ProgramData\MySQL\MySQL Server 5.6, respectively. 7. Click Next. The Check Requirements dialog box appears. 8 Installation

Figure 5 Check Requirements dialog box 8. Click Next. The Installation Progress dialog box appears. Figure 6 Installation Progress dialog box 9. Click Execute. To view detailed information about the installation progress, click Show Details. Installing the MySQL server 9

Figure 7 Installation Progress dialog box 10. Click Next after the installation is complete. The Configuration Overview dialog box appears. Figure 8 Configuration Overview dialog box 11. Click Next. The MySQL Server Configuration dialog box appears. 10 Installation

Figure 9 MySQL Server Configuration dialog box 12. Configure the following parameters for the MySQL server: From the Config Type list, select Server Machine or Dedicated Machine. The list provides a description for each configuration type. Select Enable TCP/IP Networking and enter the port number to be used by the MySQL server. Make sure the port number is not used by other applications. This example uses the default port of 3306. Select Open Firewall port for network access to prevent the firewall from blocking the MySQL database connection. Select Show Advanced Options to configure advanced server options. 13. Click Next. Installing the MySQL server 11

Figure 10 Configure advanced server options 14. Set a password for the root user account. The password must be a string longer than three characters. Make sure the password of the root user does not include spaces, tabs (\t), or any characters in Table 1. Otherwise, the password cannot be recognized during IMC installation. Table 1 Special characters Character name Ampersand sign Apostrophe At sign Back quote Backslash Caret Dollar sign Exclamation point Left angle bracket Left parenthesis Quotation marks Right angle bracket Right parenthesis Semicolon Slash Vertical bar Symbol & ' @ ` \ ^ $! < ( " > ) ; / 12 Installation

If the password of the root user contains any of the characters in Table 1, you must create a user with root user privileges for IMC, and make sure its password does not contain any of these characters. 15. You can create a user in the MySQL User Accounts area. Click Add User to add a user account. For information about adding a user account after the MySQL server has been installed, see Figure 11. Figure 11 Adding a MySQL user account Configure the following parameters for a new user account: In the Username field, enter the name of the user. From the Host list, select localhost or <All Hosts(%)>. The localhost option allows the user to access the database only from the local host. The <All Hosts (%)> option allows the user to access the database from any hosts. Figure 11 uses <All Hosts (%)>. From the Role list, select DB Admin to create an account with the same rights as the root user account. Figure 12 shows the available user roles and the rights they have. Click MySQL for Authentication. In the Password and Confirm Password fields, configure the password for the new user account. If this account is a superuser account used by IMC, make sure the password does not include spaces, tabs (\t), or any characters in Table 1. Installing the MySQL server 13

Figure 12 Database user roles 16. Click OK. The new user account appears in the MySQL User Accounts area. Figure 13 Viewing the user accounts 17. Click Next. The Windows Service Details dialog box appears. 14 Installation

Figure 14 Windows Service Details dialog box 18. Enter the Windows service name and select Start the MySQL Server at System Startup. In the Run Windows Service as area, select Standard System Account. 19. Click Next. The Logging Options dialog box appears. Figure 15 Setting log options Installing the MySQL server 15

20. Select General Log and Slow Query Log. Do not select Bin Log. Do not change the paths for storing logs. 21. Click Next. The Configuration Overview dialog box appears. Figure 16 Configuration Overview dialog box 22. Click Next after the installation is complete. The Installation Complete dialog box appears. 16 Installation

Figure 17 Installation Complete dialog box 23. Click Finish. Installing the MySQL client If the database and IMC will be installed on different servers, install the MySQL client on each IMC server after installing the MySQL server on the database server. The MySQL client must be installed on the IMC server before you install IMC. When configuring the remote database, select other server for the database location. IMPORTANT: Make sure Microsoft.Net Framework 4 has been installed before you install the MySQL client on the Windows server system. Installing the MySQL client 17

1. Double-click the MySQL installation program to start the setup wizard. Figure 18 MySQL Installer 2. Click Install MySQL Products. The License Agreement dialog box appears. Figure 19 License Agreement dialog box 18 Installation

3. Select I accept the license terms and click Next. The Find latest products dialog box appears. Figure 20 Find latest products 4. Click Execute to find the latest product version or skip the check. In this example, select Skip the check for updates (not recommended) and click Next. The Choosing a Setup Type dialog box appears. Figure 21 Choosing a Setup Type dialog box Installing the MySQL client 19

5. Select Custom. 6. Set the Installation Path and Data Path. The default installation path and data path are C:\Program Files\MySQL and C:\ProgramData\MySQL\MySQL Server 5.6, respectively. 7. Click Next. The Feature Selection dialog box appears. Figure 22 Feature Selection dialog box 8. Select Client Programs and click Next. The Check Requirements dialog box appears. 20 Installation

Figure 23 Check Requirements dialog box 9. Click Next. The Installation Progress dialog box appears. Figure 24 Installation Progress dialog box 10. Click Execute to install the MySQL client on the server. Installing the MySQL client 21

11. Click Next after the installation is complete. The Configuration Overview dialog box appears. Figure 25 Configuration Overview dialog box 12. Click Next. The Installation Complete dialog box appears. 22 Installation

Figure 26 Installation Complete dialog box 13. Click Finish. Testing the connectivity After the MySQL client is installed, add the MySQL client installation path as a PATH environment variable value. For more information, see "Adding an environment variable value." After adding the installation path as an environment variable value, make sure the MySQL server on the remote database server has been started. To test the connectivity between the MySQL client and the server: 1. Select Start > Run. 2. In the Run dialog box, enter cmd and click OK. Installing the MySQL client 23

3. In the CLI window, enter the following command: mysql h192.168.40.162 test2 ptest4imc P3306 In this command, 192.168.40.162 is the IP address of the database server, test2 is the remote MySQL user name (see "Creating a database user account" for information about creating a remote MySQL user account), test4imc is the password of the user test2, and 3306 is the default port number of the MySQL database. If you can enter the MySQL CLI mode, the client can connect to the MySQL server. Figure 27 Testing the connectivity between the MySQL client and server 24 Installation

4 MySQL service startup and stop 1. On the navigation tree in the Server Manager window of the MySQL server, select Configuration > Services. The Services page appears. Figure 28 Starting or stopping the MySQL service 2. Right-click the Windows service name. The default name is MySQL56. A shortcut menu appears. 3. Click Start or Stop to start or stop the service, respectively. The Start option is available only when the MySQL56 service is not running. The Stop option is available only when the MySQL56 service is running. 25

5 MySQL server configuration Adding an environment variable value To execute the MySQL server management commands (for example, mysqld, mysqlshow, and mysqladmin) in the CLI window, add the MySQL server or client installation path as a PATH environment variable value. This procedure uses the MySQL server installation path as an example. 1. Select Start > Control Panel > System and Security > System. The View basic information about your computer page appears. Figure 29 Viewing basic information about your computer 2. Click Advanced system settings. The System Properties dialog box appears. 26 MySQL server configuration

Figure 30 System Properties dialog box 3. Click the Advanced tab and click Environment Variables. The Environment Variables dialog box appears. Figure 31 Environment Variables dialog box 4. In the System variables area, select Path and click Edit. The Edit System Variable dialog box appears. Adding an environment variable value 27

Figure 32 Edit System Variable dialog box 5. In the Variable value field, add the storage path for the programs in the MySQL installation directory. The default path is C:\Program Files\MySQL\MySQL Server 5.6\bin. Use a semicolon (;) to separate the path from the preceding variable values. 6. Click OK in the Edit System Variable, Environment Variables, and System Properties dialog boxes to save the configuration. 7. Restart the operating system to make the new environment variable value take effect. Configuring MySQL parameters The default configuration file my.ini in the data path for the MySQL server determines the functions and performance of the MySQL server. The default data path for the my.ini file is C:\ProgramData\MySQL\MySQL Server 5.6. You must modify any parameters in the my.ini file that do not meet the IMC requirements. To modify the parameters: 1. Stop the MySQL service. For information about stopping the MySQL service, see "MySQL service startup and stop." 2. Enter the data path for storing the MySQL data files. If the data path is the default path, ProgramData is a hidden file folder. For information about viewing the hidden file folder, see "Why can't I find the???title??? file folder on the system disk?." 28 MySQL server configuration

3. Double-click the my.ini file. The file opens in Notepad by default. Figure 33 my.ini file Change the parameter values in the [mysql] and [mysqld] sections. Table 2 describes the parameters in the my.ini file. a. Under [mysql], change the value of the default-character-set parameter to match your operating system language. This example uses latin1. If you change the character set after IMC has been deployed, you will need to reinstall IMC. b. Under [mysqld], make the following changes: Add the parameter lower_case_table_names=1. Change the value of the character-set-server parameter to latin1. Change the value of the innodb_buffer_pool_size parameter to 512M. Change the value of the innodb_additional_mem_pool_size parameter to 16M. Change the value of the max_allowed_packet parameter to 200M. Change the value of the max_connections parameter to 400. Table 2 File parameters Parameters lower_case_table_names default-character-set and character-set-server Description Indicates whether a table name is case sensitive. 0 Yes 1 No Character sets required by the MySQL database. The character set for English is latin1. Configuring MySQL parameters 29

Table 2 File parameters (continued) Parameters innodb_buffer_pool_size innodb_additional_mem_pool_size max_allowed_packet max_connections Description Size of the InnoDB buffer pool. Size of the InnoDB additional memory pool. Maximum allowed size for a packet. Maximum number of connections allowed 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. 4. Save the my.ini file and restart the MySQL server. Creating a database user account You can use a nondefault database user account with the same rights as the root user account to access the database. IMPORTANT: Create a database user account on the MySQL server, not the MySQL client. 1. Select Start > All Programs > MySQL > MySQL Server 5.6 > MySQL 5.6 Command Line Client. Figure 34 Opening the MySQL CLI 2. Enter the root user account password. 30 MySQL server configuration

Figure 35 Entering the root user account password Figure 36 MySQL CLI Creating a database user account 31

3. Create database user accounts test1 and test2, and then grant them the same rights as the root user. GRANT ALL PRIVILEGES ON *.* TO test1@'localhost' IDENTIFIED BY 'test4imc' WITH GRANT OPTION; GRANT ALL PRIVILEGES ON *.* TO test2@'%' IDENTIFIED BY 'test4imc' WITH GRANT OPTION; Figure 37 Creating user accounts and granting them rights In this example, test4imc is the database user account password. The password must not include spaces, tabs (\t), or any characters in Table 1. Both test1 and test2 are superuser accounts with full privileges. test1@'localhost is a local database user account that can access the MySQL server only from the local host. test2@'%' is a remote database user account that can access the MySQL server from any host. A local database user account is applicable to IMC with a local database. A remote database user account is applicable to IMC with a remote database. 32 MySQL server configuration

6 Uninstallation The uninstall methods for the MySQL server and client are similar. To uninstall the MySQL server: 1. Select Start > All Programs > MySQL > MySQL Installer > MySQL Installer. Figure 38 Starting the MySQL Installer 33

Figure 39 MySQL Installer 2. Click Remove MySQL Products. The Remove Products dialog box appears. Figure 40 Removing MySQL products 34 Uninstallation

3. Select MySQL Server 5.6.19 and click Execute. A confirmation dialog box appears. Figure 41 Confirming removal of the selected product 4. Click Yes. Figure 42 Viewing the product removal progress 5. Click Next after the uninstallation is complete. The Clean existing data dialog box appears. 35

Figure 43 Cleaning existing data 6. Select Remove server datafiles and Uninstall the MySQL Installer, as needed. In this example, select both options and click Finish. Figure 44 Confirming removal of the data files 7. Click Yes in the confirmation dialog box. Figure 45 Re-confirming removal of the data files 8. Click Yes in the confirmation dialog box. 36 Uninstallation

7 FAQ Why can't I find the ProgramData file folder on the system disk? ProgramData is a hidden file folder on the system disk. To view the folder: 1. Open any folder in Windows Server 2008 R2. 2. Select Organize > Folder and search options. The Folder Options window appears. Figure 46 Displaying the Folder and search options window 3. In the Folder Options window, click the View tab. In the Advanced settings area, select Files and Folders > Hidden files and folders > Show hidden files, folders, and drives. Figure 47 Displaying the hidden file folder 4. Click OK. 37

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 values of the default-character-set and character-set-server parameters to latin1. For more information, see "Configuring MySQL parameters." 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 will fail to connect to the database. To resolve this problem, you must 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 48 Intelligent Deployment Monitoring Agent 2. On the Input database user password dialog box that appears, enter the new password. Figure 49 Entering database user password 3. Click OK. 38 FAQ

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: Product model names and number Technical support registration number (if applicable) Product serial numbers Product identification number Error message Operating system type and revision level Detailed questions 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. Related information Documents Websites Conventions 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 This section describes the conventions used in this documentation set. Document conventions Table 3 Document conventions Convention Blue text: Table 3 Blue, underlined text: http:// www.hp.com Description Cross-reference links and email addresses Website addresses Contacting HP 39

Table 3 Document conventions (continued) Convention Description 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 4 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. 40 Support and other resources

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. 41

Index A adding environment variable value, 26 C configuring MySQL parameters, 28 connectivity testing, 23 contacting HP, 39 creating database user account, 30 D database passwords updating, 37 database user account creating, 30 documentation, 39 typographic conventions, 40 documentation, providing feedback on, 41 E environment variable value adding, 26 F FAQ, 37 P prerequisites installation, 5 R registering product, 39 subscription service, 39 S start and stop MySQL service, 25 T technical support, 39 HP, 39 testing the connectivity, 23 typographic conventions documentation, 39 symbols, 40 text GUI conventions, 40 U uninstallation, 33 updating database passwords, 37 W websites, 39 G garbled characters, 37 H help obtaining, 39 HP technical support, 39 I installation prerequisites, 5 installing MySQL client, 17 MySQL server, 6 M MySQL client, 17 MySQL client installation, 17 MySQL parameters configuring, 28 MySQL server, 6 MySQL server configuration, 26 MySQL server installation, 6 MySQL service startup and stop, 25 42 Index