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 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/ 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. 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. Portions of this product use software components developed through various open source projects. The licenses and availability of source
Portfolio SQL Connect 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. Install Portfolio For the most current MySQL setup and installation instructions please visit: http://www.extensis.com/downloads/ 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. 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. 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. To manually check if MySQL is 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-oldmysql.html If desired, you can also use the manual method below to remove the previous install. To manually remove a MySQL installation: 1. Launch the Terminal. 2. Type sudo rm -rf /usr/local/mysql* 3. At the prompt, enter your administrator password.
MySQL Installation and Setup Install MySQL 1. Download the MySQL installer from 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. [mysqld] default-character-set=utf8 [client] default-character-set=utf8 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, doubleclick MySQLStartupItem.pkg installer package to install it as well. Configure the database server 1. Log in to Mac OS X as any user with Admin privileges. 2. Launch the Terminal utility from the /Applications/Utilities folder. 3. At the $ prompt, enter the following command to edit the my.cnf file: 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. Press Ctrl-X to exit Pico. At the prompt, press Y to 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:
Portfolio SQL Connect 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 Hard Disk/Applications/Utilities folder. 4. Launch the MySQL client with the following command: 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; This returns the following: Query OK, 0 rows affected (0.00sec) MySQL> 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.
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) MySQL> This creates a new user named portsql and gives them full privileges to your database. Now, enter the final command: 9. Enter the following command to stop the MySQL client: quit; 10. It is now safe to close the Terminal window. Install MyODBC 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. 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 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 PowerPCbased 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 Enter the password for the portsql user that you created in the previous step. If this command fails, type the following command: sudo cp libmyodbc3.dylib /usr/lib If the MySQL monitor launches and you see the mysql> prompt, you have successfully connected to the server with the new user.
Portfolio SQL Connect 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: /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: http://dev.mysql.com/downloads/ 2. Double click the installer package and follow the instructions. 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. 5. Click the Add button four times to add four 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 SERVER USER DATABASE PASSWORD Value localhost portsql <yourdatabasename> <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.
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 for complete instructions about how to connect to a Portfolio Server and serve an MySQL catalog.
Portfolio SQL Connect Installing MySQL on Windows 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. 4. Choose the Typical option as the setup type and click Next. 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. The Windows Essentials (x86) or Windows (x86) version can be used. 5. Click Install. 2. Double-click setup.exe to launch the installer. 3. At the Welcome screen of the Setup Wizard click Next.
10 MySQL Installation and Setup 6. At this point you are prompted to create an account on the MySQL.com website. If you would like to do so, choose the appropriate option and follow the instructions. 8. At the Welcome screen of the MySQL Server Instance Configuration Wizard, click Next. 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 11 10. Choose the Server Machine option and click Next. 11. Choose the database usage type that best describes your installation. If you are unsure, choose the Multifunctional Database option and click Next. 13. This step of the Wizard allows you to help optimize the database for the number of concurrent connections that you expect to have to a Portfolio 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.
12 MySQL Installation and Setup 14. Choose the Enable TCP/IP Networking option and click Next. 15. Choose the Best Support for Multilingualism option and click Next. 17. In this step you choose enable the root user and choose a password. Check the Modify Security Settings option, then enter and confirm the new root 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 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.
14 MySQL Installation and Setup 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 15 Create the Database and DSN 1. From the Start menu, choose Start > MySQL > MySQL Server 4.1 > MySQL Command Line Client 8. In the Create New Data Source dialog box, click to highlight the MySQL ODBC 3.51 driver and click Finish. 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.
16 MySQL Installation and Setup 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 10. Click Test to test the connection to the database. After successfully connecting to the database, click OK to accept the Connector/ODBC settings. 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/ 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.