PS8B-NASQL-1105

MySQL Install Guide

Creative assets management

ContactExtensis

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

Celartem, Inc.Email: sales_ap@celartem.com http://www.celartem.com/jp/

Press ContactPhone: (503) 274-2020 x129 Email: press@extensis.com

Customer Service Web/email: http://www.extensis.com/customerservice/ Phone: (800) 796-9798

Technical SupportWeb/email: http://www.extensis.com/support/

Documentation FeedbackWeb/email: http://www.extensis.com/helpfeedback/

© 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

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.

Bonjour

�

User GuidePortfolio SQL Connect

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/

Install PortfolioBefore 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.

Remove any previous MySQL installationBased 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.

Adobe Version Cue uses a version of MySQL. To provide a clean installation, disable Version Cue before proceeding with the installation.

• ForMac OS X 10.4 (Tiger) Server,thedefaultinstallationofMySQLisinauniquelocation,andwillnotinterferewithyournewinstallation.UnlessyouhavepreviouslyinstalledanewversionofMySQL,youcangoontoinstallMySQL.

• Forall other versions of Mac OS X,usetheprocedurebelowtomanuallyensurethattherearen’tanypreviousversionsofMySQLinstalled.

To manually check if MySQL is installed:

1.LaunchtheTerminal.

2.Typecd/usr/local

3.Typels

4.IfyouseeanyreferencestoMySQL,youhaveapreviousversionofMySQLinstalled.Usethescriptfromthefollowingwebsitetoremovetheinstallation:

http://www.entropy.ch/software/macosx/mysql/remove-old-mysql.html

Ifdesired,youcanalsousethemanualmethodbelowtoremovethepreviousinstall.

To manually remove a MySQL installation:

1.LaunchtheTerminal.

2.Typesudo rm -rf /usr/local/mysql*

3.Attheprompt,enteryouradministratorpassword.

Installing MySQL on Mac OS X

�

User Guide MySQL Installation and Setup

Install MySQL 1.DownloadtheMySQLinstallerfrom

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

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

3.ToinstallMySQL,double-clicktheinstallerpackage.Followtheinstallerinstructionstocompletetheinstallation.

4.WhentheMySQLinstallationiscomplete,double-clickMySQLStartupItem.pkginstallerpackagetoinstallitaswell.

Configure the database server1.LogintoMacOSXasanyuserwithAdminprivileges.

2.LaunchtheTerminalutilityfromthe/Applications/Utilitiesfolder.

3.Atthe$prompt,enterthefollowingcommandtoeditthemy.cnffile:

sudopico/etc/my.cnf

4.AtthePasswordprompt,enteryouruserpassword.ThepasswordmustbeanAdminlevelpassword.

5.WhenPicolaunches,youarepresentedwithanemptyfile.Addthefollowinglinestothefile:

[mysqld] default-character-set=utf8

[client] default-character-set=utf8

If the /etc/my.cnf file is not empty, but has some configuration settings already specified, just look for the sections [mysqld] and [client] and add the default-character-set=utf8 option to each section if not already present.

6.PressCtrl-XtoexitPico.Attheprompt,pressY tosaveyourchangestothefile.

�

User GuidePortfolio SQL Connect

Starting the MySQL Server

Every time you restart the computer, you must restart the MySQL database server.

1.LaunchtheTerminalapplication,ifisnotalreadyopen.

2.UsethefollowingcommandtostarttheMySQLserver:

sudo/Library/StartupItems/MySQLCOM/MySQLCOMstart

Ifprompted,enteryouruserpassword.ThepasswordmustbeanAdminlevelpassword.

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

2.LaunchtheTerminalutilityfromtheHardDisk/Applications/Utilitiesfolder.

4.LaunchtheMySQLclientwiththefollowingcommand:

sudo/usr/local/mysql/bin/mysql-uroot

AtthePasswordprompt,enteryouruserpassword.ThepasswordmustbeanAdminlevelpassword.

ThislaunchestheMySQLclient.Youshouldseeamysql>prompt.

5.Createthedatabasewiththefollowingcommand.Replace<databasename>withanalphanumericdatabasename.

createdatabase<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.Atthemysql>prompttypethefollowingcommands.Substitutedbnamewithyourdatabasenameanddbpasswordwithapasswordofyourchoice.PressReturnafterthesemi-colonattheendofeachcommand:

GRANTALLPRIVILEGESONdbname.*TO‘portsql’@’localhost’IDENTIFIEDBY‘dbpassword’WITHGRANTOPTION;

Thisreturnsthefollowing:QueryOK,0rowsaffected(0.00sec)MySQL>

�

User Guide MySQL Installation and Setup

Now,enterthenextcommand:

GRANTALLPRIVILEGESONdbname.*TO‘portsql’@’%’IDENTIFIEDBY‘dbpassword’WITHGRANTOPTION;

Thisreturnsthefollowing:QueryOK,0rowsaffected(0.00sec)MySQL>

Thiscreatesanewusernamedportsqlandgivesthemfullprivilegestoyourdatabase.

Now,enterthefinalcommand:

FLUSHPRIVILEGES;

Thistellstheservertoreloadthegrantprivileges.

7.Whenfinishedcreatingthedatabase,enterthefollowingcommandtostoptheMySQLclient:

quit;

8.Totestthenewuserandconnectiontothedatabase,enterthefollowingcommandintheTerminalwindow:

/usr/local/mysql/bin/mysql-uportsql-p

Enterthepasswordfortheportsqluserthatyoucreatedinthepreviousstep.

IftheMySQLmonitorlaunchesandyouseethemysql>prompt,youhavesuccessfullyconnectedtotheserverwiththenewuser.

9.EnterthefollowingcommandtostoptheMySQLclient:

quit;

10.ItisnowsafetoclosetheTerminalwindow.

Install MyODBCThe 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.ForIntel-basedsystems,requestthemostcurrentMyODBCdriverfromyourExtensisPrioritySupportrepresentative.UsethecontactinformationfoundonyourAnnualServiceAgreement(ASA)tocontactyourrepresentative.Placeacopyofthisdriveronyourserver.

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

3.Typecd/<locationofcustomExtensisConnector>

4.Typecopylibmyodbc3.dylib/usr/lib

Ifthiscommandfails,typethefollowingcommand:sudocplibmyodbc3.dylib/usr/lib

�

User GuidePortfolio SQL Connect

5.Toconfirmthateveryonehaspermissiontoexecutethedriver,enterthefollowingcommand:sudochmod755/usr/lib/libmyodbc3.dylib

6.LaunchtheODBC AdministratorutilityfromtheHardDisk/Applications/Utilitiesfolder.

7.FromtheDriverstab,selectthecurrentMySQLdriverandclickRemove.

8.ClickAdd.

9.IntheAdddialogbox,enterthenewdriverdescriptionof“MySQL”(minusthequotemarks).Thisdescriptionmust be entered precisely orthedriverwillnotfunctionproperly.

10.ClickChooseandselectthenewdriver,ortypeinthelocationofthenewdriver:/usr/lib/libmyodbc3.dylib

11.ClickOKandthenclickApply.

12.TheODBCAdministratorutilitycansometimesfailtosaveyoursettings.

Toensurethatthesettingsaresaved,closetheODBCAdministratorutility,andthenrelaunchit.Ifthesettingswerenotsaved,returntostep5ofthisprocedure.

To install the Connector / MyODBC on PowerPC- based systems:

1.DownloadtheConnector/MyODBCversion3.51.12installerfromtheMySQLwebsite:http://dev.mysql.com/downloads/

2.Doubleclicktheinstallerpackageandfollowtheinstructions.

Create the DSN file1.LaunchtheODBC Administratorutilityfromthe

HardDisk/Applications/Utilitiesfolder.

2.Clickthelockiconinthelower-lefthandcorneroftheODBCAdministratorwindowandenteryourMacOSXusernameandpasswordwhenprompted.

3.FromtheUserDSNtab,clickAdd,selecttheODBCdrivernameandclickOK.

4.IntheDataSourceName(DSN)field,enteranameforyournewDSN.ThiswillbethenameofyourPortfoliocatalog.UnderscoresandspacesarenotallowedintheDSNname.Youmayalsoenteradescriptionifdesired.

5.ClicktheAddbuttonfourtimestoaddfournewkeywords.

6.Double-clickeachKeywordandValueandeditthemtomatchthefollowingvalues.Usethedatabasenamethatyourcreatedearlierinthesetupprocess,andthepasswordvaluefortheportsqluser.

Keyword Value

SERVER localhost

USER portsql

DATABASE <yourdatabasename>

PASSWORD <portsqlpassword>

Various versions of the MyODBC installer can 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

7.ClickOKtosavetheDSNandassociatedkeywords.

8.ClickApplytoapplythenewlycreatedDSNandODBCsettings.

IfyouintendtoservemultiplePortfoliocatalogs,youmustcreateaDSNwithauniquenameforeachcatalog.

9.ClosetheODBC 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.

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.

Download the most current Administrator application from the following location: http://dev.mysql.com/downloads/administrator/

�

User GuidePortfolio SQL Connect

Installing MySQL on Windows is a process of installing the MySQL database server, MyODBC, 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.DownloadthecurrentversionofMySQLfromhttp://dev.mysql.com.

TheWindows Essentials (x86)orWindows (x86)versioncanbeused.

2.Double-clicksetup.exetolaunchtheinstaller.

3.AttheWelcomescreenoftheSetupWizardclickNext.

4.ChoosetheTypicaloptionasthesetuptypeandclickNext.

5.ClickInstall.

Installing MySQL on Windows

10

User Guide MySQL Installation and Setup

6.AtthispointyouarepromptedtocreateanaccountontheMySQL.comwebsite.Ifyouwouldliketodoso,choosetheappropriateoptionandfollowtheinstructions.

Otherwise,choosetheSkip Sign-upoptionandclickNext.

7.TheMySQLServerDatabaseEngineisnowinstalled.Atthispointtheservermustbeconfigured,choosetheConfigure the MySQL Server nowoptionandclickFinish.

8.AttheWelcomescreenoftheMySQL Server Instance Configuration Wizard,clickNext.

9.ChoosetheDetailed ConfigurationoptionandclickNext.

11

User GuidePortfolio SQL Connect

10.ChoosetheServer MachineoptionandclickNext.

11.Choosethedatabaseusagetypethatbestdescribesyourinstallation.Ifyouareunsure,choosetheMultifunctional DatabaseoptionandclickNext.

12.ChoosealocationthatwillhousethedatabasetablespaceandclickNext.IfthecurrentmachinewillbeusedtostorethePortfoliocatalog,thedefaultlocationwillworkfine.

13.ThisstepoftheWizardallowsyoutohelpoptimizethedatabaseforthenumberofconcurrentconnectionsthatyouexpecttohavetoaPortfoliocatalog.

Ifyouarenotsurehowmanyconcurrentusersyouwillhave,choosetheOnline Transaction Processing (OLTP)optionandclickNext.

12

User Guide MySQL Installation and Setup

14.ChoosetheEnable TCP/IP NetworkingoptionandclickNext.

15.ChoosetheBest Support for MultilingualismoptionandclickNext.

16.ExtensisrecommendsrunningtheMySQLserverasaservice.Todoso,checktheInstall as a Windows ServiceoptionandchooseaServiceName.ItisalsorecommendedtolaunchtheMySQLServiceautomatically,choosetheappropriateoptionandclickNext.

17.Inthisstepyouchooseenabletherootuserandchooseapassword.ChecktheModify Security Settings option,thenenterandconfirmthenewrootuserpassword.Whenfinished,clickNext.

1�

User GuidePortfolio SQL Connect

18.ClickExecutetoconfiguretheMySQLinstance.

19.ClickFinishtoclosetheWizard.

Install MyODBC

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

1.DownloadMySQL Connector/ODBC 3.51.11driverinstallerfromhttp://dev.mysql.com/downloads/

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

2.Closeanyprogramsthatyouhaverunning.

3.Doubleclicktolaunchtheinstaller.

4.AttheWelcomestepoftheInstallationWizard,clickNext.

1�

User Guide MySQL Installation and Setup

5.AccepttheGNUgeneralpubliclicenseandclickNext.

6.ScantheReadMeInformationandclickNext.

7.ClickNexttoinstallMyODBC.

8.ClickFinishtoclosetheinstaller.

1�

User GuidePortfolio SQL Connect

Create the Database and DSN

1.FromtheStartmenu,chooseStart > MySQL > MySQL Server 4.1 > MySQL Command Line Client

2.Entertherootuserpasswordthatyousetinstep17oftheMySQLdatabaseengineinstallation.

3.Typethefollowingcommandtocreateadatabase.

createdatabase<databasename>;

Replace<databasename>withthedesirednameofyourSQLdatabase.

4.Typeexittoclosethecommandlineclient.

5.ChooseStart > Control Panel.

6.OpenAdministrative ToolsanddoubleclickData Sources.

7.IntheODBCDataSourceAdministrator,fromtheSystem DSNtab,clickAdd.

8.IntheCreateNewDataSourcedialogbox,clicktohighlighttheMySQL ODBC 3.51 driverandclickFinish.

9.IntheConnector/ODBC-AddDataSourceNamedialogbox,tocreatetheDSN,enterthefollowinginformationontheLogintab:

Data Source Name—thisisthePortfoliocatalogname.

Description—generaldescriptionofthecatalog.

1�

User Guide MySQL Installation and Setup

Server—entertheIPAddressofwheretheMySQLdatabaseengineisinstalled.

User—enterausernamethathasfullaccessrightstotheMySQLdatabase.Oftentherootuserisspecified.Todoso,enterrootinthisfield.

Password—enterapasswordfortheuserabove.

Database—choosethedatabasenamethatyoucreatedinstep3

10.ClickTesttotesttheconnectiontothedatabase.

Aftersuccessfullyconnectingtothedatabase,clickOKtoaccepttheConnector/ODBCsettings.

11.ClickOKintheODBCDataSourceAdministratordialogbox.

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.

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.

Download the most current Administrator application from the following location: http://dev.mysql.com/downloads/administrator/