Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Installing MySQL in a Mac OS X environment

Install and configure a MySQL database

To install the database, you don't need to install Microsoft .NET Framework 3.5. If you run into any issues installing and configuring the database, look at the README.txt file included in the DMG Archive for some useful tips.

  1. Download MySQL Community Server 5.5 DMG Archive.
  2. Double-click the DMG Archive, and then double-click the .pkg file that starts with mysql-5.5. Follow the instructions to install the MySQL server.
  3. Double-click the MySQLStartupItem.pkg file, and follow the instructions in the setup wizard. The wizard installs the MySQL server as an auto-startup item.
  4. Double-click the MySQL.prefPane file. The file installs the MySQL control panel into the System Preferences application so that you can control the MySQL server.
  5. Open the System Preferences application, and perform the following actions:
    1. In the Other section, click the MySQL icon.
    2. Click Start MySQL server to start the server.
    3. At the bottom of the control panel, you can also configure the MySQL server to run automatically on startup.
  6. To make it easier to access the mysql and mysqladmin programs, you can modify the PATH environment variable by performing the following actions:
    1. From a terminal window in your home directory, type the following command:
      open -a TextEdit .profile
    2. Add the following statement to your existing PATH environment variable, or create a new entry if a PATH variable isn't already defined:
      export PATH=/usr/local/mysql/bin:$PATH 
    3. Close the current terminal window, and open a new one for the changes to the PATH variable to take effect.
  7. From the terminal window, type the following command to set the root password:
    mysqladmin -u root password "newpwd"
  8. Change some of the default configuration values for MySQL so that they're more suitable for the Push Service SDK by performing the following actions:
    1. From a terminal window, type the following commands to copy one of the sample MySQL configuration files so that you can modify it:
      cd /usr/local/mysql/support-files
      cp my-medium.cnf ~/my.cnf
    2. Open the configuration file by typing the following command:
      open -a TextEdit ~/my.cnf
    3. Add the following statements to the [mysqld] section of my.cnf file:
      sql_mode=”TRADITIONAL”
      character_set_server=utf8 
      collation_server=utf8_bin
      init_connect='SET NAMES utf8'
      skip-character-set-client-handshake

      The first statement configures the database so that it behaves like a traditional SQL database management system. The remaining statements configure the database so that it uses a UTF-8 character encoding.

      If you want to use a case-insensitive collation instead of a case-sensitive one, change collation_server to utf8_unicode_ci.

    4. Copy the modified my.cnf to /etc by typing the following command:
      sudo cp ~/my.cnf /etc/my.cnf
    5. Open the System Preferences application, and in the Other section, click the MySQL icon.
    6. Stop the MySQL server, and then start it again for the changes to take effect.

Create a server instance

  1. Download MySQL Workbench 5.2.
  2. On the Home screen for the MySQL Workbench, in the Server Administration section, click New Server Instance.
  3. Specify your root password by clicking Store In Keychain. Leave the remaining configuration values as they are.
  4. On the Create the Instance Profile screen, type the server instance name (for example, pushsdk).

Create the database schema

  1. On the Home screen for the MySQL Workbench, in the SQL Development section, double-click the database connection that you created when you created the server instance for the database.
  2. Click the dummy database in the Schema section, and then right-click and choose Create Schema.
  3. In the Name field, specify a name for the database schema (for example, pushsdk).
  4. In the Default Collation drop-down list, click utf8_bin for a case-sensitive collation type, or utf8_unicode_ci for a case-insensitive collation type.
  5. Click Apply twice.
  6. Click Close.

Create a user account for the database schema

The user account that you set up in this task is the user account that you use to access the database tables through a Push Initiator.

  1. On the Home screen for the MySQL Workbench, in the Server Administration section, double-click the server instance that you created.
  2. From the Management panel on the left, click Users and Privileges.
  3. Click Add Account at the bottom.
  4. Click the Login tab, and specify a login name and password for the user.
  5. In the Limit Connectivity to Hosts Matching field, type one or more names and host machines that the user can connect from (for example, localhost).
  6. Click Apply.
  7. On the Schema Privileges tab, in the Users column, click the user account you created.
  8. Click Add Entry.
  9. In the Host section, select the Selected host option.
  10. In the Selected Host drop-down list, click the host machine that you want to define the privileges for (for example, localhost).
  11. In the Schema section, select the Selected schema option.
  12. In the Selected schema list, click the database schema that you created and that you want to define the privileges for.
  13. Click OK.
  14. Select the newly created entry in the list, and click Select "ALL" to assign the user all privileges for this database schema.
  15. Click Save Changes.

Create a new connection to the database schema

  1. On the Home screen for the MySQL Workbench, in the SQL Development section, click New Connection.
  2. In the Connection Name field, type a name for the connection.
  3. In the Hostname field, type the name of the host machine that the server instance is installed on (for example, localhost).
  4. In the Port field, type 3306.
  5. In the Username field, type the name of the user that you created for the database schema.
  6. In the Password field, click Store in Keychain .
  7. Type the password of the user that you created for the database schema.
  8. In the Default Schema field, type the name of the database schema that you created.
  9. Click OK.