Creative assets management

MySQL
Install Guide
Contact
Extensis
1800 SW First Avenue,
Suite 500
Portland, OR 97201
Toll Free: (800) 796-9798
Phone: (503) 274-2020
Fax: (503) 274-0530
http://www.extensis.com
Extensis Europe
First Floor, Century House
The Lakes
Northampton NN4 7SJ
United Kingdom
Phone: +44(0)1604 636 300
Fax +44 (0)1604 636 366
info@extensis.co.uk
© 2006 Extensis, a division of Celartem, Inc. This document and the
software described in it are copyrighted with all rights reserved. This
document or the software described may not be copied, in whole or part,
without the written consent of Extensis, except in the normal use of the
software, or to make a backup copy of the software. This exception does
not allow copies to be made for others. Licensed under U.S. patents issued
and pending.
Extensis is a registered trademark of Extensis. The Extensis logo, Extensis
Library, Font Reserve, Font Reserve Server, Font Vault, and Font Sense,
Portfolio, Portfolio Server, Portfolio NetPublish, NetPublish, Suitcase
and Suitcase Server are all trademarks of Extensis. Celartem, Celartem,
Inc., the Celartem logo, PixelLive and PixelSafe are trademarks of
Celartem, Inc. Adobe, Acrobat, Illustrator, Photoshop, and PostScript
are trademarks of Adobe Systems, Incorporated. Apple, AppleScript,
Bonjour, FontSync, Macintosh, Mac OS 9, Mac OS X, PowerPC,
and QuickDraw are registered trademarks of Apple Computer, Inc.
Microsoft, Internet Explorer, Windows, Windows XP, Windows 2000,
Windows NT, Windows ME and Windows 98 are registered trademarks
of Microsoft Corporation. Intel is a registered trademark of Intel.
All other trademarks are the property of their respective owners.
Portions of this product use software components developed through
various open source projects. The licenses and availability of source
Celartem, Inc.
Email: sales_ap@celartem.com
http://www.celartem.com/jp/
Press Contact
Phone: (503) 274-2020 x129
Email: press@extensis.com
Customer Service
Web/email: http://www.extensis.com/customerservice/
Phone: (800) 796-9798
Technical Support
Web/email: http://www.extensis.com/support/
Documentation Feedback
Web/email: http://www.extensis.com/helpfeedback/
code for such components are specified in the copyright notice file,
LICENSES.TXT delivered with this product. Please refer to these
licenses for information regarding use of these software components.
Extensis warrants the disks on which the software is recorded to be free
from defects in materials and faulty workmanship under normal use for
a period of thirty (30) days from the original date of purchase. If you
purchased this product directly from Extensis, and if a defect occurs
during the 30-day period, you may return the disks to Extensis for a free
replacement. All products submitted for replacement must be registered
with Extensis before replacement. Extensis products purchased from
resellers are warranted by the reseller and are covered by the reseller’s
return policy. This warranty is limited to replacement and shall not
encompass any other damages, including but not limited to loss of profit,
and special, incidental, or other similar claims. This software is provided
on an “as is” basis. Except for the express warranty set forth above,
Extensis makes no other warranties, either explicit or implied, regarding
the enclosed software’s quality, performance, merchantability, or fitness
for a particular purpose.

Installing MySQL on Mac OS X
This installation procedure is detailed, and as
of this writing, necessary to properly install
MySQL 4.1.20, MyODBC 3.51.12 and create your
SQL catalog. Due to the nature of open source
software, this procedure may be simplified in the
future as upgrades are implemented to installers
and the source code.
These installation instructions assume that you are
running Mac OS X 10.4 Server (Tiger) or later.
For the most current MySQL setup and
installation instructions please visit:
http://www.extensis.com/downloads/
To manually check if MySQL is installed:
Install Portfolio
Before you install the MySQL database engine, you
need to first install Portfolio Client, Server and SQL
Connect. SQL Connect is automatically installed
when you install Portfolio Server. Installers can be
found on your product CD, or downloaded directly
from the Extensis website http://www.extensis.com.
To install on an Intel based Macintosh, you will
also need the Extensis custom ODBC driver. Use the
contact information on your service agreement to
contact your priority support representative for this
driver.
To manually remove a MySQL installation:
Remove any previous MySQL installation
Based on your version of Mac OS X, you may need
to remove a previous installation of MySQL.
Mac OS X Server comes with MySQL automatically
installed.
Portfolio SQL Connect User Guide

Adobe Version Cue uses a version of MySQL. To
provide a clean installation, disable Version Cue
before proceeding with the installation.
• For Mac OS X 10.4 (Tiger) Server, the default
installation of MySQL is in a unique location, and will
not interfere with your new installation. Unless you
have previously installed a new version of MySQL, you
can go on to install MySQL.
• For all other versions of Mac OS X, use the
procedure below to manually ensure that there aren’t
any previous versions of MySQL installed.
1. Launch the Terminal.
2. Type cd/usr/local
3. Type ls
4. If you see any references to MySQL, you have a
previous version of MySQL installed. Use the script
from the following website to remove the installation:
http://www.entropy.ch/software/macosx/mysql/remove-old-
mysql.html
If desired, you can also use the manual method below
to remove the previous install.
1. Launch the Terminal.
2. Type sudo rm -rf /usr/local/mysql*
3. At the prompt, enter your administrator password.
 User Guide MySQL Installation and Setup


Install MySQL [mysqld]

default-character-set=utf8
1. Download the MySQL installer from
http://dev.mysql.com/downloads/ [client]
default-character-set=utf8
Portfolio SQL Connect 8 has been fully tested
with MySQL versions 4.1.12 and 4.1.13. Use
newer versions of MySQL at your own risk.

2. Double-click downloaded file to mount the disk

image.

3. To install MySQL, double-click the installer package.

Follow the installer instructions to complete the
installation.

4. When the MySQL installation is complete, double-

click MySQLStartupItem.pkg installer package to
install it as well.

Configure the database server

If the /etc/my.cnf file is not empty, but has some
1. Log in to Mac OS X as any user with Admin privileges. configuration settings already specified, just
look for the sections [mysqld] and [client] and
2. Launch the Terminal utility from the add the default-character-set=utf8 option to
/Applications/Utilities folder. each section if not already present.

3. At the $ prompt, enter the following command to 6. Press Ctrl-X to exit Pico. At the prompt, press Y to
edit the my.cnf file: save your changes to the file.

sudo pico /etc/my.cnf

4. At the Password prompt, enter your user password.

The password must be an Admin level password.

5. When Pico launches, you are presented with an

empty file. Add the following lines to the file:

Starting the MySQL Server
Every time you restart the computer, you must
restart the MySQL database server.
1. Launch the Terminal application,
if is not already open.
2. Use the following command to start the
MySQL server:
sudo /Library/StartupItems/MySQLCOM/
MySQLCOM start
If prompted, enter your user password. The password
must be an Admin level password.
Connecting to the server and
creating a database
You must create an initial database for MySQL to
serve. Use the following procedure to create and
serve databases as needed.
1. Log in to Mac OS X as any user with Admin privileges.
2. Launch the Terminal utility from the This returns the following:
Hard Disk/Applications/Utilities folder.
4. Launch the MySQL client with the following
command:
sudo /usr/local/mysql/bin/mysql -u root
At the Password prompt, enter your user password.
The password must be an Admin level password.
This launches the MySQL client.
You should see a mysql> prompt.
Portfolio SQL Connect User Guide

5. Create the database with the following command.
Replace <databasename> with an alphanumeric
database name.
create database <databasename>;
Remember to end all MySQL commands with a
semicolon (;).
Database names can be 31 characters long, and
names can only use alphanumeric characters.
Do not use underscores “_” or any other
characters in database names. While names are
not case sensitive, it is best to keep the name all
in one case, upper or lower.
6. At the mysql> prompt type the following
commands. Substitute dbname with your
database name and dbpassword with a
password of your choice. Press Return after the
semi-colon at the end of each command:
GRANT ALL PRIVILEGES ON dbname.* TO
‘portsql’@’localhost’ IDENTIFIED BY
‘dbpassword’ WITH GRANT OPTION;
Query OK, 0 rows affected (0.00sec)
MySQL>
 User Guide MySQL Installation and Setup

Now, enter the next command:
GRANT ALL PRIVILEGES ON dbname.* TO
‘portsql’@’%’ IDENTIFIED BY ‘dbpassword’
WITH GRANT OPTION;
This returns the following:
Query OK, 0 rows affected (0.00sec) Install MyODBC
MySQL>
This creates a new user named portsql and gives
them full privileges to your database.
Now, enter the final command:
FLUSH PRIVILEGES;
This tells the server to reload the grant privileges.
7. When finished creating the database, enter the
following command to stop the MySQL client:
quit;
8. To test the new user and connection
to the database, enter the following
command in the Terminal window:
/usr/local/mysql/bin/mysql -u portsql -p
Enter the password for the portsql user that you
created in the previous step.
If the MySQL monitor launches and you see the
mysql> prompt, you have successfully connected to
the server with the new user.
9. Enter the following command to stop the
MySQL client:
quit;
10. It is now safe to close the Terminal window.
The Connector/MyODBC driver allows SQL Connect
to communicate with the MySQL database.
The Connector/MyODBC driver must be installed
on the server that will run Portfolio Server.
To install Connector/MyODBC on Intel-based systems:
1. For Intel-based systems, request the most current
MyODBC driver from your Extensis Priority Support
representative. Use the contact information found
on your Annual Service Agreement (ASA) to contact
your representative. Place a copy of this driver on
your server.
SQL Connect 8 for Mac OS X 10.4 (Tiger) Server
has been fully tested with 3.51.12 on PowerPC-
based systems and the custom Extensis MyODBC
driver on Intel-based systems. Use newer versions
of MyODBC at your own risk.
2. Launch the Terminal.
3. Type
cd/<location of custom Extensis
Connector>
4. Type copy libmyodbc3.dylib /usr/lib
If this command fails, type the following command:
sudo cp libmyodbc3.dylib /usr/lib

5. To confirm that everyone has permission to execute
the driver, enter the following command:
sudo chmod 755 /usr/lib/libmyodbc3.dylib
6. Launch the ODBC Administrator utility from the
Hard Disk/Applications/Utilities folder.
7. From the Drivers tab, select the current MySQL driver
and click Remove.
8. Click Add.
9. In the Add dialog box, enter the new driver
description of “MySQL” (minus the quote marks). This
description must be entered precisely or the driver
will not function properly.
10. Click Choose and select the new driver,
or type in the location of the new driver: 5. Click the Add button four times to add four
/usr/lib/libmyodbc3.dylib
11. Click OK and then click Apply.
12. The ODBC Administrator utility can sometimes fail
to save your settings.
To ensure that the settings are saved, close the
ODBC Administrator utility, and then relaunch it. If
the settings were not saved, return to step 5 of this
procedure.
To install the Connector / MyODBC on
PowerPC- based systems:
1. Download the Connector / MyODBC version 3.51.12
installer from the MySQL website: Various versions of the MyODBC installer can
http://dev.mysql.com/downloads/
2. Double click the installer package and follow the
instructions.
Portfolio SQL Connect User Guide

Create the DSN file
1. Launch the ODBC Administrator utility from the
Hard Disk/Applications/Utilities folder.
2. Click the lock icon in the lower-left hand corner of
the ODBC Administrator window and enter your
Mac OS X username and password when prompted.
3. From the User DSN tab, click Add, select the ODBC
driver name and click OK.
4. In the Data Source Name (DSN) field, enter
a name for your new DSN. This will be the
name of your Portfolio catalog. Underscores
and spaces are not allowed in the DSN name.
You may also enter a description if desired.
new keywords.
6. Double-click each Keyword and Value and edit them
to match the following values. Use the database
name that your created earlier in the setup process,
and the password value for the portsql user.
Keyword Value
SERVER localhost
USER portsql
DATABASE <yourdatabasename>
PASSWORD <portsqlpassword>
create default keywords that can interfere with
the correct operation of SQL Connect. If by
default there are additional keywords in the
DSN, remove those keywords.
 User Guide MySQL Installation and Setup


The MySQL Administrator application

7. Click OK to save the DSN and associated keywords.
8. Click Apply to apply the newly created DSN and
ODBC settings.
For convenience, and easy maintenance, you may
wish to use the MySQL Administrator application.
This application provides a graphical interface
for many common tasks that you would typically
accomplish via the command line. This application
is useful for creating databases, checking table
structure, assigning users as well as backing up and
restoring.
Download the most current Administrator
application from the following location:
http://dev.mysql.com/downloads/administrator/

If you intend to serve multiple Portfolio catalogs,

you must create a DSN with a unique name for each
catalog.

9. Close the ODBC Administrator.

Adding the server and

serving the catalog
After installing MySQL, the MyODBC/Connector,
creating the database and the DSN, you are ready
to connect to your catalog from the Portfolio
Client. Please see the Portfolio Server User Guide for
complete instructions about how to connect to a
Portfolio Server and serve an MySQL catalog.
 Portfolio SQL Connect User Guide


Installing MySQL on Windows

Installing MySQL on Windows is a process of 4. Choose the Typical option as the setup type and
installing the MySQL database server, MyODBC, click Next.
creating a database, creating a DSN and then
installing SQL Connect. Use the following
procedures to correctly configure MySQL to work
with Portfolio on Windows.

Install the MySQL Database Server

These instructions are for version 4.1.12 and 4.1.13.
SQL Connect 8 has been fully tested with MySQL
versions 4.1.12 and 4.1.13. Use newer versions of
MySQL at your own risk.

1. Download the current version of MySQL from

http://dev.mysql.com.
5. Click Install.
The Windows Essentials (x86)
or Windows (x86) version can be used.

2. Double-click setup.exe to launch the installer.

3. At the Welcome screen of the Setup Wizard

click Next.
 User Guide MySQL Installation and Setup
10

6. At this point you are prompted to create an account 8. At the Welcome screen of the MySQL Server
on the MySQL.com website. If you would like to do Instance Configuration Wizard, click Next.
so, choose the appropriate option and follow the
instructions.

Otherwise, choose the Skip Sign-up option and

click Next.

9. Choose the Detailed Configuration option and

click Next.

7. The MySQL Server Database Engine is now installed.

At this point the server must be configured, choose
the Configure the MySQL Server now option and
click Finish.
 Portfolio SQL Connect User Guide
11

10. Choose the Server Machine option and click Next.

13. This step of the Wizard allows you to help

11. Choose the database usage type that best describes optimize the database for the number of concurrent
your installation. If you are unsure, choose the connections that you expect to have to a Portfolio
Multifunctional Database option and click Next. catalog.

If you are not sure how many concurrent users you

will have, choose the Online Transaction Processing
(OLTP) option and click Next.

12. Choose a location that will house the database

tablespace and click Next. If the current machine
will be used to store the Portfolio catalog, the default
location will work fine.
 User Guide MySQL Installation and Setup
12

14. Choose the Enable TCP/IP Networking option and

click Next.

17. In this step you choose enable the root user and
choose a password. Check the Modify Security
15. Choose the Best Support for Multilingualism Settings option, then enter and confirm the new root
option and click Next. user password. When finished, click Next.

16. Extensis recommends running the MySQL server as

a service. To do so, check the Install as a Windows
Service option and choose a Service Name. It is
also recommended to launch the MySQL Service
automatically, choose the appropriate option and
click Next.
 Portfolio SQL Connect User Guide
13

18. Click Execute to configure the MySQL instance. Install MyODBC

Use the following procedure to install and configure
MyODBC on Windows.

1. Download MySQL Connector/ODBC 3.51.11 driver

installer from http://dev.mysql.com/downloads/

These instructions are for the 3.51.11 version of the

MySQL Connector/ODBC driver. SQL Connect 8
has been fully tested with the Connector/ODBC
driver versions 3.51.11. Use newer versions at your
own risk.

2. Close any programs that you have running.

19. Click Finish to close the Wizard. 3. Double click to launch the installer.

4. At the Welcome step of the Installation Wizard,

click Next.
 User Guide MySQL Installation and Setup
14

5. Accept the GNU general public license and

click Next.

8. Click Finish to close the installer.

6. Scan the ReadMe Information and click Next.

7. Click Next to install MyODBC.

 Portfolio SQL Connect User Guide
15

Create the Database and DSN 8. In the Create New Data Source dialog box, click to
highlight the MySQL ODBC 3.51 driver and click
1. From the Start menu, choose Start > MySQL > Finish.
MySQL Server 4.1 > MySQL Command Line Client

2. Enter the root user password that you set in step 17 of

the MySQL database engine installation.

3. Type the following command to create a database.

create database <databasename>;

Replace <databasename> with the desired name of

your SQL database.

9. In the Connector/ODBC - Add Data Source Name

dialog box, to create the DSN, enter the following
information on the Login tab:

4. Type exit to close the command line client.

5. Choose Start > Control Panel.

6. Open Administrative Tools and double click

Data Sources.

7. In the ODBC Data Source Administrator, from the

System DSN tab, click Add.

Data Source Name — this is the Portfolio catalog

name.

Description — general description of the catalog.

 User Guide MySQL Installation and Setup
16

Server — enter the IP Address of where the MySQL
database engine is installed.
User — enter a username that has full access rights to
the MySQL database. Often the root user is specified.
To do so, enter root in this field.
Password — enter a password for the user above.
Database — choose the databasename that you
created in step 3
The MySQL Administrator application
For convenience, and easy maintenance, you may
wish to use the MySQL Administrator application.
This application provides a graphical interface
for many common tasks that you would typically
accomplish via the command line. This application
is useful for creating databases, checking table
structure, assigning users as well as backing up and
restoring.

10. Click Test to test the connection to the database.
After successfully connecting to the database, click
OK to accept the Connector/ODBC settings.
Download the most current Administrator
application from the following location:
http://dev.mysql.com/downloads/administrator/

11. Click OK in the ODBC Data Source Administrator

dialog box.

Finish installation
After you have completed the above steps, you
can proceed to installing Portfolio Sever and SQL
Connect. For further instructions, see the Portfolio
Server User Guide.