v7.0 Intelligent Management Center MySQL 5.5 Installation and Configuration Guide (for Windows)

Transcription

1 v7.0 Intelligent Management Center MySQL 5.5 Installation and Configuration Guide (for Windows) 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: Published: IMC PLAT 7.0 (E0202) Published: March 2014 Edition: 1.1

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

3 Contents 1 Overview Prerequisites Installation...6 MySQL server installation...6 MySQL client installation...18 Installing the MySQL client...18 Testing the connectivity MySQL service startup and stop MySQL server configuration...26 Adding an environment variable value...26 Configuring MySQL parameters...29 Creating a database user account Uninstallation FAQ Support and other resources...40 Contacting HP...40 Subscription service...40 Related information...40 Documents...40 Websites...40 Typographic conventions...41 Document conventions...41 GUI conventions...41 Symbols Documentation feedback...42 Index...43 Contents 3

4 1 Overview This document describes how to install and configure the MySQL 5.5 database in Windows Server 2008 R2. The installation procedures for MySQL database of other versions might vary. For information about installing database of other versions, see their respective installation and configuration guides. IMC can be installed only after the MySQL server is installed and started. 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

5 2 Prerequisites Before the installation, copy the installation program to the Windows server. This document uses the mysql-installer-community msi installation program. 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. If the database and IMC are planned to be installed on the same server, install only the MySQL server on the IMC server. If the database and IMC are planned to be installed on different servers, install the MySQL server on the database server and install the MySQL client on each IMC server. IMC can be installed only after the MySQL client is installed on the IMC server. When configuring the remote database, select other server for the database location. Make sure Microsoft.Net Framework 4 has been installed before installing the MySQL server in the Windows server system. 5

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

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

8 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. Figure 4 Choosing a setup type 5. Select Server only. 6. Select Installation Path and Data Path. The default installation path and data path are C:\Program Files\MySQL and C:\ProgramData\MySQL\MySQL Server 5.5, respectively. 7. Click Next. The Check Requirements dialog box appears. 8 Installation

9 Figure 5 Check Requirements 8. Click Next. The Installation Progress dialog box appears. Figure 6 Installation progress MySQL server installation 9

10 9. Click Execute. To view detailed information about the installation progress, click Show Details. Figure 7 Viewing detailed information about the installation progress 10. Click Next after the installation is complete. The Configuration Overview dialog box appears. 10 Installation

11 Figure 8 Configuration Overview 11. Click Next. Figure 9 Configuring the MySQL server MySQL server installation 11

12 12. Configure the following parameters for the MySQL server: Server Configuration Type Select Server Machine from the Config Type list. Options are Development Machine, Server Machine, and Dedicated Machine. The drop-down list provides description for each configuration type. When installing the MySQL server, select Server Machine or Dedicated Machine. When installing the MySQL client server, select Development Machine. Enable TCP/IP Networking This option must be selected. Port Number Enter the port number used by the MySQL server (3306 in this example is the default port). Make sure the port number is not used by other applications. Open Firewall port for network access Select this option to prevent the firewall from blocking the MySQL database connection. Show Advanced Options Select this option to configure advanced server options. 13. Click Next. Figure 10 Configuring the 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 Symbol Character name Symbol Ampers and sign & Apostrophe ' At Back quote ` Back slash \ Caret ^ 12 Installation

13 Table 1 Special characters (continued) Character name Symbol Character name Symbol Dollar sign $ Exclamation point! Left angle bracket < Left parenthesis ( Quotation marks " Right angle bracket > Right parenthesis ) Semicolon ; Slash / Vertical bar If the password of the root user has to contain characters above, you must create a user with root user privileges fot IMC, and make sure that its password does not contain any of the previous characters. 15. You can create 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 is installed, see "Creating a database user account." Figure 11 Adding a MySQL user account Configure the following parameters for a new user account: Username Enter the user name. Host Select <All Hosts(%)>. Options are localhost and <All Hosts (%)>. To create a local database user account, select localhost to allow the user to access the database only from the local host. To create a remote database user account, select <All Hosts (%)> to allow the user to access the database from any hosts. Role Select DB Admin to create an account with the same right as the root user account. Figure 12 shows the available user roles and their corresponding rights. Authentication The only option is MySQL. Password Enter the password for the new user account. If this account is a super user account used by IMC, make sure the password does not include spaces, tabs (\t), or any characters in Table 1. Confirm Password Re-enter the password. MySQL server installation 13

14 Figure 12 Database user roles 16. Click OK. The new user account appears in the MySQL User Accounts area. 14 Installation

15 Figure 13 Viewing the user accounts 17. Click Next. The Windows Service Details dialog box appears. Figure 14 Windows Service Details MySQL server installation 15

16 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 20. Select General Log and Slow Query Log. Do not select Bin Log. Keep the paths for storing logs unchanged. 21. Click Next. The Configuration Overview dialog box appears. 16 Installation

17 Figure 16 Configuration Overview 22. Click Next after the installation is complete. The Installation Complete dialog box appears. Figure 17 Installation Complete 23. Click Finish. MySQL server installation 17

18 MySQL client installation Installing the MySQL client If the database and IMC are planned to be installed on different servers, install the MySQL client on each IMC server after installing the MySQL server on the database server. IMC can be installed only after the MySQL client is installed on the IMC server. When configuring the remote database, select other server for the database location. IMPORTANT: Make sure Microsoft.Net Framework 4 has been installed before installing the MySQL client in the Windows server system. 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. 18 Installation

19 Figure 19 License Agreement 3. Select I accept the terms and click Next. The Find latest products dialog box appears. Figure 20 Finding latest products MySQL client installation 19

20 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. Figure 21 Choosing a setup type 5. Select Custom. 6. Set Installation Path and Data Path. The default installation path and data path are C:\Program Files\MySQL and C:\ProgramData\MySQL\MySQL Server 5.5, respectively. 7. Click Next. The Feature Selection dialog box appears. 20 Installation

21 Figure 22 Feature Selection 8. Select Client Programs and click Next. The Check Requirements dialog box appears. Figure 23 Check Requirements MySQL client installation 21

22 9. Click Next. The Installation Progress dialog box appears. Figure 24 Installation Progress 10. Click Execute. 11. Click Next after the installation is complete. The Installation Complete dialog box appears. 22 Installation

23 Figure 25 Installation Complete 12. Click Finish. Testing the connectivity After the MySQL client is installed, add the MySQL client installation path as a Path environment variable value. For information about adding an environment variable value, see "Adding an environment variable value." After the installation path is added 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 server: 1. Select Start > Run. In the Run dialog box, enter cmd and click OK. MySQL client installation 23

24 2. In the CLI window, test the connectivity between the client and the server. mysql h uimctest pimc123 P3306 In this command, is the IP address of the database server, imctest is the remote MySQL user name (for information about creating a remote MySQL user account, see "Creating a database user account"), imc123 is the password of the root user, and 3306 is the default port number of the MySQL database. If you can enter the MySQL CLI mode, the client can correctly connect to the MySQL server. Figure 26 Testing the connectivity between the client and the server 24 Installation

25 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 27 Starting or stopping the MySQL service 2. Right-click the Windows service name (the service name is MySQL4IMC in this example and the default name is MySQL55). A shortcut menu appears. 3. Click Start or Stop to start or stop the service. The Start option is available only when the MySQL4IMC service is not started. The Stop option is available only when the MySQL4IMC service is running. 25

26 5 MySQL server configuration Adding an environment variable value To execute the MySQL server management commands such as mysqld, mysqlshow, or mysqladmin in the CLI window, add the MySQL server or client installation path as a Path environment variable value. This section 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 28 Viewing basic information about your computer 2. Click Advanced system settings. The System Properties dialog box appears. 26 MySQL server configuration

27 Figure 29 System properties 3. Click the Advanced tab and click Environment Variables. The Environment Variables dialog box appears. Adding an environment variable value 27

28 Figure 30 Environment Variables 4. In the System variables area, select Path and click Edit. The Edit System Variable dialog box appears. Figure 31 Edit System Variable 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.5\bin. Use a semicolon (;) to separate the path with 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 effective. 28 MySQL server configuration

29 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.5. Parameters in the my.ini file that do not meet the requirements of IMC need to be modified. 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, the ProgramData file folder is a hidden folder. For information about viewing the hidden file folder, see "Why cannot the Programdata file folder be found in the system disk?" 3. Double click the my.ini file. The file is open in Notepad by default. Figure 32 my.ini file Change the parameter values in the [mysql] and [mysqld] sections. Table 2 describes the parameter values in the my.ini file. Change the value of the default-character-set parameter under [mysql] to latin1. 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. Make the following changes under [mysqld]: Add 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. Configuring MySQL parameters 29

30 Change the value of the max_allowed_packet parameter to 200M. Change the value of the max_connections parameter to 400. Table 2 Parameters in the my.ini file Parameters lower_case_table_names default-character-set and character-set-server innodb_buffer_pool_size innodb_additional_mem_pool_size max_allowed_packet max_connections Description Indicates whether or not a table name is case sensitive: 0 Yes. 1 No. 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. Size of the InnoDB buffer pool. Size of the InnoDB additional memory pool. Size of the allowed maximum packet. 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. 4. Save the my.ini file and restart the MySQL server. Creating a database user account You can use a non-default database user account with the same right as the root user account to access the database. IMPORTANT: A database user account can be created only on the MySQL server rather than the MySQL client. 30 MySQL server configuration

31 1. Select Start > All Programs > MySQL > MySQL Server 5.5 > MySQL 5.5 Command Line Client. Figure 33 Opening the MySQL CLI Figure 34 Entering the root user account password 2. Enter the root user account password. Creating a database user account 31

32 Figure 35 MySQL CLI 3. Create database user accounts test1 and test2 and grant them the right the same as the root user. GRANT ALL PRIVILEGES ON *.* TO IDENTIFIED BY 'test4imc' WITH GRANT OPTION; GRANT ALL PRIVILEGES ON *.* TO IDENTIFIED BY 'test4imc' WITH GRANT OPTION; Figure 36 Creating user accounts and granting rights to the accounts This example uses test4imc as the database user account password, make sure the password does not include spaces, tab(\t), or any characters in Table 1. Both accounts, test1 and test2, are super user accounts with full privileges. localhost indicates a local database user account that can access the MySQL server only from the local host. test2@ % indicates a remote database user account that can access the MySQL server from any hosts. 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

33 6 Uninstallation The uninstallation 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 37 Starting the MySQL installer 33

34 Figure 38 MySQL Installer 2. Click Remove MySQL Products. The Remove Products dialog box appears. Figure 39 Removing MySQL products 3. Select MySQL Server and click Execute. A confirmation dialog box appears. 34 Uninstallation

35 Figure 40 Confirming whether to remove the selected product 4. Click Yes. Figure 41 Viewing the progress of removing the product 5. Click Next after the uninstallation is complete. The Clean existing data dialog box appears. 35

36 Figure 42 Cleaning existing data 6. Select Remove server datafiles and Uninstall the MySQL Installer as needed. In this example, select both options and click Finish. A confirmation dialog box appears. Figure 43 Confirming whether to remove the data files 7. Click Yes. A confirmation dialog box appears. Figure 44 Confirming again whether to remove the data files 8. Click Yes. 36 Uninstallation

37 7 FAQ Why cannot the Programdata file folder be found in the system disk? The ProgramData file folder in the system disk is a hidden folder. 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 45 Opening the Folder Options window 3. Click the View tab, and in the Advanced settings area, select Files and Folders > Hidden files and folders > Show hidden files, folders, and drives. 37

38 Figure 46 Displaying the hidden file folder 4. Click OK. 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 may appear in the database table. If garbled characters appear, change the values of the default-character-set and character-set-server parameters. For more information, see "Configuring MySQL parameters." Table 3 lists character sets for three languages. If the operating system language is other than English, Chinese, and Japanese, see the related documentations from MySQL for the correct character set. Table 3 Character sets for English, Chinese, and Japanese Language English Chinese Japanese Character set latin 1 gbk sjis 38 FAQ 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.bat (located at \imc_install\deploy) to obtain passwords in plaintext or save the new passwords in ciphertext to the file. You can use the database management tool to change the database

39 password of an IMC component. After the change, you must use the pwdmgr.bat 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. Figure 47 Updating the password on the IMC server The dbpasswd string indicates the new database password of the imc_config user. The config_db string indicates the database name. The 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. 39

40 8 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: Before contacting HP, collect the following information: Product model names and number Technical support registration number (if applicable) Product serial numbers Error messages 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: After registering, you will receive notification of product enhancements, new driver versions, firmware updates, and other product resources. Related information Documents Websites To find related documents, browse to the Manuals page of the HP Business Support Center website: 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: HP Networking: HP manuals: HP download drivers and software: HP software depot HP Education 40 Support and other resources

41 Typographic conventions This section describes the conventions used in this documentation set. Document conventions Table 4 Document conventions Convention Blue text: Table 4 Blue, underlined text: Description Cross-reference links and 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 5 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 41

42 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 Include the document title and part number, version number, or the URL when submitting your feedback. 42 Documentation feedback

43 Index C contacting HP, 40 D database passwords, 37 documentation, 40 typographic conventions, 41 documentation, providing feedback on, 42 U uninstallation, 33 updating database passwords, 37 W websites, 40 F FAQs, 37 G garbled characters, 37 H help obtaining, 40 HP technical support, 40 I installing MySQL client installation, 18 MySQL server, 5 L license agreement, 7 M MySQL client, 18 MySQL client installation, 18 MySQL server, 5 MySQL server configuration, 26 MySQL server installation, 5 MySQL service, 25 R registering product, 40 subscription service, 40 S setup program, 8 start and stop MySQL service, 25 T technical support, 40 HP, 40 typographic conventions documentation, 41 symbols, 41 text GUI conventions, 41 43