Portfolio8_Installing_MySQL

8/7/2019 Portfolio8_Installing_MySQL

1/16

MySQLInstall Guide

Creative assets management


2/16

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 HouseThe Lakes

Northampton NN4 7SJ

United Kingdom

Phone: +44(0)1604 636 300

Fax +44 (0)1604 636 366

[email protected]

Celartem, Inc.

Email: [email protected]://www.celartem.com/jp/

Press Contact

Phone: (503) 274-2020 x129

Email: [email protected]

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/

2006 Extensis, a division o C elartem, Inc. This document and the

sotware described in it are copyrighted with all rights reserved. This

document or the sotware described may not be copied, in whole or part,

without the written consent o Extensis, except in the normal use o the

sotware, or to make a backup copy o the sotware. This exception does

not allow copies to be made or others. Licensed under U.S. patents issued

and pending.

Extensis is a registered trademark o Extensis. The Extensis logo, Extensis

Library, Font Reserve, Font Reserve Server, Font Vault, and Font Sense,

Portolio, Portolio Server, Portolio NetPublish, NetPublish, Suitcase

and Suitcase Server are all trademarks o Extensis. Celartem, Celartem,

Inc., the Celartem logo, PixelLive and PixelSae are trademarks o

Celartem, Inc. Adobe, Acrobat, Illustrator, Photoshop, and PostScriptare trademarks o Adobe Systems, Incorporated. Apple, AppleScript,

Bonjour, FontSync, Macintosh, Mac OS 9, Mac OS X, PowerPC,

and QuickDraw are registered trademarks o Apple Computer, Inc.

Microsot, Internet Explorer, Windows, Windows XP, Windows 2000,

Windows NT, Windows ME and Windows 98 are registered trademarks

o Microsot Corporation. Intel is a registered trademark o Intel.

All other trademarks are the property o t heir respective owners.

Portions o this product use sotware components developed through

various open source projects. The licenses and availability o source

code or such components are specifed in the copyright notice fle,

LICENSES.TXT delivered with this product. Please reer to these

licenses or inormation regarding use o these sotware components.

Extensis warrants the disks on which the sot ware is recorded to be ree

rom deects in materials and aulty workmanship under normal use or

a period o thi rty (30) days rom the original date o purchase. I you

purchased this product directly rom Extensis, and i a deect occurs

during the 30-day period, you may return the disks to Extensis or a ree

replacement. All products submitted or replacement must be registered

with Extensis beore replacement. Extensis products purchased rom

resellers are warranted by the reseller and are covered by the resellers

return policy. This warranty is l imited to replacement and shall not

encompass any other damages, including but not limited to loss o proft,and special, incidental, or other similar claims. T his sotware is provided

on an as is basis. Except or the express warranty set orth above,

Extensis makes no other warranties, either explicit or implied, regarding

the enclosed sotwares quality, perormance, merchantability, or ftness

or a particular purpose.
http://www.extensis.com/http://www.celartem.com/jp/http://www.extensis.com/customerservice/http://www.extensis.com/support/http://www.extensis.com/helpfeedback/http://www.extensis.com/helpfeedback/http://www.extensis.com/support/http://www.extensis.com/customerservice/http://www.celartem.com/jp/http://www.extensis.com/


3/16

User GuidePortfolio SQL Connect

This installation procedure is detailed, and as

o this writing, necessary to properly install

MySQL 4.1.20, MyODBC 3.51.12 and create your

SQL catalog. Due to the nature o open source

sotware, this procedure may be simplifed in the

uture as upgrades are implemented to installers

and the source code.

These installation instructions assume that you arerunning Mac OS X 10.4 Server (Tiger) or later.

For the most current MySQL setup andinstallation instructions please visit:

http://www.extensis.com/downloads/

Install Portolio

Beore you install the MySQL database engine, you

need to frst install Portolio Client, Server and SQLConnect. SQL Connect is automatically installed

when you install Portolio Server. Installers can be

ound on your product CD, or downloaded directly

rom 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 inormation on your service agreement to

contact your priority support representative or thisdriver.

Remove any previous MySQL installation

Based on your version o Mac OS X, you may need

to remove a previous installation o MySQL.

Mac OS X Server comes with MySQL automatically

installed.

Adobe Version Cue uses a version o MySQL. Toprovide a clean installation, disable Version Cuebeore proceeding with the installation.

ForMac OS X 10.4 (Tiger) Server,thedeault

installationoMySQLisinauniquelocation,andwill

notintererewithyournewinstallation.Unlessyou

havepreviouslyinstalledanewversionoMySQL,youcangoontoinstallMySQL.

Forall other versions o Mac OS X,usethe

procedurebelowtomanuallyensurethattherearent

anypreviousversionsoMySQLinstalled.

To manually check i MySQL is installed:

1.LaunchtheTerminal.

2.Typecd/usr/local

3.Typels

4.IyouseeanyreerencestoMySQL,youhavea

previousversionoMySQLinstalled.Usethescript

romtheollowingwebsitetoremovetheinstallation:

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

mysql.html

Idesired,youcanalsousethemanualmethodbelowtoremovethepreviousinstall.

To manually remove a MySQL installation:


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

3.Attheprompt,enteryouradministratorpassword.

Installing MySQL on Mac OS X
http://www.extensis.com/downloads/http://www.extensis.com/http://www.entropy.ch/software/macosx/mysql/remove-old-mysql.htmlhttp://www.entropy.ch/software/macosx/mysql/remove-old-mysql.htmlhttp://www.entropy.ch/software/macosx/mysql/remove-old-mysql.htmlhttp://www.entropy.ch/software/macosx/mysql/remove-old-mysql.htmlhttp://www.extensis.com/http://www.extensis.com/downloads/


4/16

User Guide MySQL Installation and Setup

Install MySQL

1.DownloadtheMySQLinstallerromhttp://dev.mysql.com/downloads/

Portolio SQL Connect 8 has been ully testedwith MySQL versions 4.1.12 and 4.1.13. Usenewer versions o MySQL at your own risk.

2.Double-clickdownloadedfletomountthedisk

image.

3.ToinstallMySQL,double-clicktheinstallerpackage.

Followtheinstallerinstructionstocompletethe

installation.

4.WhentheMySQLinstallationiscomplete,double-

clickMySQLStartupItem.pkg installerpackageto

installitaswell.

Confgure the database server

1.LogintoMacOSXasanyuserwithAdminprivileges.

2.LaunchtheTerminalutilityromthe

/Applications/Utilitiesolder.

3.Atthe$prompt,entertheollowingcommandto

editthemy.cnffle:

sudopico/etc/my.cnf

4.AtthePasswordprompt,enteryouruserpassword.

ThepasswordmustbeanAdminlevelpassword.

5.WhenPicolaunches,youarepresentedwithan

emptyfle.Addtheollowinglinestothefle:

[mysqld]

default-character-set=utf8

[client]

default-character-set=utf8

I the/etc/my.cnf fle is not empty, but has someconfguration settings already specifed, justlook or the sections [mysqld] and [client] andadd thedefault-character-set=utf8 option toeach section i not already present.

6.PressCtrl-XtoexitPico.Attheprompt,press Y to

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


5/16


Starting the MySQL Server

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

1.LaunchtheTerminalapplication,

iisnotalreadyopen.

2.Usetheollowingcommandtostartthe

MySQLserver:

sudo/Library/StartupItems/MySQLCOM/

MySQLCOMstart

Iprompted,enteryouruserpassword.Thepassword

mustbeanAdminlevelpassword.

Connecting to the server andcreating a database

You must create an initial database or MySQL to

serve. Use the ollowing procedure to create and

serve databases as needed.

1.LogintoMacOSXasanyuserwithAdminprivileges.

2.LaunchtheTerminalutilityromthe

HardDisk/Applications/Utilitiesolder.

4.LaunchtheMySQLclientwiththeollowing

command:

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

AtthePasswordprompt,enteryouruserpassword.

ThepasswordmustbeanAdminlevelpassword.

ThislaunchestheMySQLclient.

Youshouldseeamysql>prompt.

5.Createthedatabasewiththeollowingcommand.

Replacewithanalphanumeric

databasename.

createdatabase;

Remember to end all MySQL commands with asemicolon (;).

Database names can be 31 characters long, andnames can only usealphanumericcharacters.Do not use underscores _ or any othercharacters in database names. While names arenot case sensitive, it is best to keep the name all

in one case, upper or lower.

6.Atthemysql>prompttypetheollowing

commands.Substitutedbnamewithyour

databasenameanddbpasswordwitha

passwordoyourchoice.PressReturnaterthe

semi-colonattheendoeachcommand:

GRANTALLPRIVILEGESONdbname.*TO

portsql@localhostIDENTIFIEDBY

dbpasswordWITHGRANTOPTION;

Thisreturnstheollowing:QueryOK,0rowsaffected(0.00sec)

MySQL>


6/16


Now,enterthenextcommand:

GRANTALLPRIVILEGESONdbname.*TO

portsql@%IDENTIFIEDBYdbpassword

WITHGRANTOPTION;

Thisreturnstheollowing:QueryOK,0rowsaffected(0.00sec)

MySQL>

Thiscreatesanewusernamedportsqlandgives

themullprivilegestoyourdatabase.

Now,enterthefnalcommand:

FLUSHPRIVILEGES;

Thistellstheservertoreloadthegrantprivileges.

7.Whenfnishedcreatingthedatabase,enterthe

ollowingcommandtostoptheMySQLclient:

quit;

8.Totestthenewuserandconnection

tothedatabase,entertheollowing

commandintheTerminalwindow:

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

Enterthepasswordortheportsqluserthatyou

createdinthepreviousstep.

ItheMySQLmonitorlaunchesandyouseethe

mysql>prompt,youhavesuccessullyconnectedto

theserverwiththenewuser.

9.Entertheollowingcommandtostopthe

MySQLclient:

quit;

10.ItisnowsaetoclosetheTerminalwindow.

Install MyODBC

The Connector/MyODBC driver allows SQL Connect

to communicate with the MySQL database.

The Connector/MyODBC driver must be installedon the server that will run Portolio Server.

To install Connector/MyODBC on Intel-based systems:

1.ForIntel-basedsystems,requestthemostcurrent

MyODBCdriverromyourExtensisPrioritySupport

representative.Usethecontactinormationound

onyourAnnualServiceAgreement(ASA)tocontact

yourrepresentative.Placeacopyothisdriveron

yourserver.

SQL Connect 8 or Mac OS X 10.4 (Tiger) Serverhas been ully tested with 3.51.12 on PowerPC-based systems and the custom Extensis MyODBCdriver on Intel-based systems. Use newer versionso MyODBC at your own risk.


3.Typecd/

4.Typecopylibmyodbc3.dylib/usr/lib

Ithiscommandails,typetheollowingcommand:sudocplibmyodbc3.dylib/usr/lib


7/16


5.Toconfrmthateveryonehaspermissiontoexecute

thedriver,entertheollowingcommand:

sudochmod755/usr/lib/libmyodbc3.dylib

6.LaunchtheODBC AdministratorutilityromtheHardDisk/Applications/Utilitiesolder.

7.FromtheDriverstab,selectthecurrentMySQLdriver

andclickRemove.

8.ClickAdd.

9.IntheAdddialogbox,enterthenewdriver

descriptionoMySQL(minusthequotemarks).This

descriptionmust be entered precisely orthedriver

willnotunctionproperly.

10.ClickChooseandselectthenewdriver,

ortypeinthelocationothenewdriver:/usr/lib/libmyodbc3.dylib

11.ClickOKandthenclickApply.

12.TheODBCAdministratorutilitycansometimesail

tosaveyoursettings.

Toensurethatthesettingsaresaved,closethe

ODBCAdministratorutility,andthenrelaunchit.I

thesettingswerenotsaved,returntostep5othis

procedure.

To install the Connector / MyODBC onPowerPC- based systems:

1.DownloadtheConnector/MyODBCversion3.51.12

installerromtheMySQLwebsite:

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

2.Doubleclicktheinstallerpackageandollowthe

instructions.

Create the DSN fle

1.LaunchtheODBC Administratorutilityromthe

HardDisk/Applications/Utilitiesolder.

2.Clickthelockiconinthelower-lethandcornero

theODBCAdministratorwindowandenteryour

MacOSXusernameandpasswordwhenprompted.

3.FromtheUserDSNtab,clickAdd,selecttheODBC

drivernameandclickOK.

4.IntheDataSourceName(DSN)feld,enter

anameoryournewDSN.Thiswillbethe

nameoyourPortoliocatalog.Underscores

andspacesarenotallowedintheDSNname.Youmayalsoenteradescriptionidesired.

5.ClicktheAddbuttonourtimestoaddour

newkeywords.

6.Double-clickeachKeywordandValueandeditthem

tomatchtheollowingvalues.Usethedatabase

namethatyourcreatedearlierinthesetupprocess,

andthepasswordvalueortheportsqluser.

Key wo rd Value

SERVER localhost

USER portsql

DATABASE

PASSWORD

Various versions o the MyODBC installer can

create deault keywords that can interere withthe correct operation o SQL Connect. I bydeault there are additional keywords in theDSN, remove those keywords.


8/16


7.ClickOKtosavetheDSNandassociatedkeywords.

8.ClickApplytoapplythenewlycreatedDSNand

ODBCsettings.

IyouintendtoservemultiplePortoliocatalogs,

youmustcreateaDSNwithauniquenameoreach

catalog.

9.ClosetheODBC Administrator.

Adding the server andserving the catalog

Ater installing MySQL, the MyODBC/Connector,creating the database and the DSN, you are ready

to connect to your catalog rom the Portolio

Client. Please see the Portolio Server User Guide or

complete instructions about how to connect to a

Portolio 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 interaceor many common tasks that you would typically

accomplish via the command line. This application

is useul or creating databases, checking table

structure, assigning users as well as backing up and

restoring.

Download the most current Administrator

application rom the ollowing location:

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


9/16


Installing MySQL on Windows is a process o

installing the MySQL database server, MyODBC,

creating a database, creating a DSN and then

installing SQL Connect. Use the ollowing

procedures to correctly confgure MySQL to work

with Portolio on Windows.

Install the MySQL Database Server

These instructions are or version 4.1.12 and 4.1.13.SQL Connect 8 has been ully tested with MySQL

versions 4.1.12 and 4.1.13. Use newer versions o

MySQL at your own risk.

1.DownloadthecurrentversionoMySQLrom

http://dev.mysql.com .

TheWindows Essentials (x86)

orWindows (x86)versioncanbeused.

2.Double-clicksetup.exetolaunchtheinstaller.

3.AttheWelcomescreenotheSetupWizard

clickNext.

4.ChoosetheTypicaloptionasthesetuptypeand

clickNext.

5.ClickInstall.

Installing MySQL on Windows
http://dev.mysql.com/http://dev.mysql.com/


10/16

10


6.Atthispointyouarepromptedtocreateanaccount

ontheMySQL.comwebsite.Iyouwouldliketodo

so,choosetheappropriateoptionandollowthe

instructions.

Otherwise,choosetheSkip Sign-upoptionand

clickNext.

7.TheMySQLServerDatabaseEngineisnowinstalled.

Atthispointtheservermustbeconfgured,choose

theConfgure the MySQL Server nowoptionandclickFinish.

8.AttheWelcomescreenotheMySQL Server

Instance Confguration Wizard,clickNext.

9.ChoosetheDetailed Confgurationoptionand

clickNext.


11/16

11


10.ChoosetheServer MachineoptionandclickNext.

11.Choosethedatabaseusagetypethatbestdescribes

yourinstallation.Iyouareunsure,choosethe

Multiunctional DatabaseoptionandclickNext.

12.Choosealocationthatwillhousethedatabase

tablespaceandclickNext.Ithecurrentmachine

willbeusedtostorethePortoliocatalog,thedeault

locationwillworkfne.

13.ThisstepotheWizardallowsyoutohelp

optimizethedatabaseorthenumberoconcurrent

connectionsthatyouexpecttohavetoaPortolio

catalog.

Iyouarenotsurehowmanyconcurrentusersyou

willhave,choosetheOnline Transaction Processing

(OLTP)optionandclickNext.


12/16

12


14.ChoosetheEnable TCP/IP Networkingoptionand

clickNext.

15.ChoosetheBest Support or Multilingualism

optionandclickNext.

16.ExtensisrecommendsrunningtheMySQLserverasaservice.Todoso,checkthe Install as a Windows

ServiceoptionandchooseaServiceName.Itis

alsorecommendedtolaunchtheMySQLService

automatically,choosetheappropriateoptionand

clickNext.

17.Inthisstepyouchooseenabletherootuserand

chooseapassword.ChecktheModiy Security

Settings option,thenenterandconfrmthenewroot

userpassword.Whenfnished,clickNext.


13/16

1


18.ClickExecutetoconfguretheMySQLinstance.

19.ClickFinishtoclosetheWizard.

Install MyODBC

Use the ollowing procedure to install and confgure

MyODBC on Windows.

1.DownloadMySQL Connector/ODBC 3.51.11driver

installerromhttp://dev.mysql.com/downloads/

Theseinstructionsareorthe3.51.11versionothe

MySQLConnector/ODBCdriver.SQL Connect 8

has been ully tested with the Connector/ODBC

driver versions 3.51.11. Use newer versions at your

own risk.

2.Closeanyprogramsthatyouhaverunning.

3.Doubleclicktolaunchtheinstaller.

4.AttheWelcomestepotheInstallationWizard,

clickNext.


14/16

1


5.AccepttheGNUgeneralpubliclicenseand

clickNext.

6.ScantheReadMeInormationandclick Next.

7.ClickNexttoinstallMyODBC.

8.ClickFinishtoclosetheinstaller.


15/16

1


Create the Database and DSN

1.FromtheStartmenu,choose Start > MySQL >

MySQL Server 4.1 > MySQL Command Line Client

2.Entertherootuserpasswordthatyousetinstep17o

theMySQLdatabaseengineinstallation.

3.Typetheollowingcommandtocreateadatabase.

createdatabase;

Replacewiththedesirednameo

yourSQLdatabase.

4.Typeexittoclosethecommandlineclient.

5.ChooseStart > Control Panel.

6.OpenAdministrative Toolsanddoubleclick

Data Sources.

7.IntheODBCDataSourceAdministrator,romthe

System DSNtab,clickAdd.

8.IntheCreateNewDataSourcedialogbox,clickto

highlighttheMySQL ODBC 3.51 driverandclick

Finish.

9.IntheConnector/ODBC-AddDataSourceName

dialogbox,tocreatetheDSN,entertheollowing

inormationontheLogintab:

Data Source NamethisisthePortoliocatalog

name.

Descriptiongeneraldescriptionothecatalog.


16/16

1


ServerentertheIPAddressowheretheMySQL

databaseengineisinstalled.

Userenterausernamethathasullaccessrightsto

theMySQLdatabase.Otentherootuserisspecifed.Todoso,enterrootinthisfeld.

Passwordenterapasswordortheuserabove.

Databasechoosethedatabasenamethatyou

createdinstep3

10.ClickTesttotesttheconnectiontothedatabase.

Atersuccessullyconnectingtothedatabase,click

OKtoaccepttheConnector/ODBCsettings.

11.ClickOKintheODBCDataSourceAdministrator

dialogbox.

Finish installation

Ater you have completed the above steps, you

can proceed to installing Portolio Sever and SQL

Connect. For urther 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 interaceor many common tasks that you would typically

accomplish via the command line. This application

is useul or creating databases, checking table

structure, assigning users as well as backing up and

restoring.

Download the most current Administrator

application rom the ollowing location:http://dev.mysql.com/downloads/administrator/
http://dev.mysql.com/downloads/administrator/http://dev.mysql.com/downloads/administrator/

Portfolio8_Installing_MySQL

Documents