{{Frodo updated}}{{:HOW-TO:Sync multiple libraries/Contents}}
You'll need to choose which of your computers, XBMC devices, or [[NAS]] will be the MySQL server. The server needs to be on 24/7 or have wake-on-lan (preferably the former), and needs to have a local static IP. You will probably want the XBMC device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required.
{{-}}

<big>{{notice|Users are reporting issues with '''MySQL 5.6'''. Use '''MySQL 5.5''' instead.}}</big>
MySQL can be installed on just about every major OS:

=Ubuntu Linux=
'''Ubuntu Linux:'''
#<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/10.04/serverguide/C/mysql.html )''
#Create a password when asked
#To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/my.cnf'' and change the bind-address directive to the server's IP address:
##from: <code>bind-address = 127.0.0.1</code>
##to: <code>bind-address = 192.168.0.5</code>
#*Note: Replace 192.168.0.5 with the appropriate address.
#*Note: To allow local and remote access try comment out bind-address using a hash(#) or use <code>bind-address = 0.0.0.0</code>
#Restart your MySQL server. <code>$sudo restart mysql</code>
#Get into the MySQL command line utility: <code>$mysql -u root -p</code>
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=Arch Linux=
'''Arch Linux:'''
*Please note: Arch, along with many other distributions, has migrated to the faster and more open MariaDB. It is a drop in replacement to MySQL and, thus, XBMC will require no modifications to work with it.
#Install MariaDB: <code>$ sudo pacman -S mariadb</code>
#Start the service: <code>$ sudo systemctl start mysqld</code>
#To have it automatically launch at startup: <code>$ sudo systemctl enable mysqld</code>
#Create a password: <code>$ /usr/bin/mysql_secure_installation</code> ''This will also clean up the demo database.''
#Get into the MariaDB command line utility: <code>$ mysql -u root -p</code>
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=RedHat based Linux=
'''RedHat based Linux (RHEL, CentOS, Fedora):'''
#<code>$sudo yum install mysql-server</code>
#Create a password when asked
#To configure MySQL to listen for connections only from network hosts, edit ''/etc/mysql/my.cnf'' and add the bind-address directive to the server's IP address: <code>bind-address = 192.168.0.5</code>
#*Note: Replace 192.168.0.5 with the appropriate address.
#*Note: Alternatively you can leave this file as is to allow local and remote access.
#Restart your MySQL server. <code>$sudo /sbin/service mysqld restart</code>
#*Recommended - Set your MySQL root password with <code>/usr/bin/mysqladmin -u root password 'new-password'</code>
#Get into the MySQL command line utility: <code>$mysql -u root -p</code>
#*Enter your MySQL root password as set above, or just press enter if you didn't set one to log in with a blank password
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=Mac OS X=
'''Mac OS X:'''
#Download a copy of MySQL server from http://dev.mysql.com/downloads/mysql/
#In Mac OS X, go to System Preferences -> MySQL, and click on “Start MySQL Server”. You’ll also want to tick to enable the “Automatically … on Startup” option.
#Now to set up the "xbmc" user in MySQL and give it access. Launch Terminal.app on your Mac and issue the following commands, one line at a time:
##<code>sudo /usr/local/mysql/bin/mysql</code>
##<code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code>
##<code>GRANT ALL ON *.* TO 'xbmc';</code>
##<code>exit</code>
#Remain in Terminal.app. Now you'll be giving other computers on your network access to MySQL. Enter the next set of commands, one line at a time:
##<code>cd /usr/local/mysql/support-files/</code>
##<code>sudo cp my-huge.cnf /etc/my.cnf</code>
##:''The command line will ask for your Mac OS X user password. Enter it and press return. No text will show when you type your password in, this is normal.
##<code>cd /etc</code>
##<code>sudo nano my.cnf</code>
##:''This opens a file in a command line text editor''
##Scroll down to the [mysqld] section and add or edit the following line so that it appears as:
##:<code>bind-address = ***.***.***.***</code>
##Save and exit from the command line text editor
#Reboot the Mac, or restart the MySQL service from the System Preferences pane you installed earlier

*Alternative guide for Mac OS X: http://forum.xbmc.org/showthread.php?tid=151631

=Windows=
'''Windows:'''
#Download a copy of MySQL server from http://dev.mysql.com/downloads/mysql/
#Select ''Standard configuration''
#Create a password when asked
#Select that you want the database to have network access when prompted during installation.
#Open the "MySQL Command Line Client" from the MySQL start menu
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool
#In '''Windows 7''', you may need to make an exception in the "Windows Firewall"
##Go to control panel and open windows firewall
##Click on advanced settings
##Click on Inbound Rules, then new rule
##Chose the port option, click next
##Then type in the port number you set mysql to use(Default is 3306)
##Make sure Allow the connection is checked then click next
##Name it MYSQL Inbound(or whatever you want) then click finish
##Use these same steps to set up the Outbound exception then name it MYSQL Outbound(or whatever you want) then you're finished.
#:You may or may not have to set up both in and outbound, someone with more knowledge please edit this if you know.
#In '''Windows XP''', you may need to make an exception in the "Windows Firewall"
##Open Control Panel and Set to 'Classic View'
##Double Click on Windows Firewall
##Click on Exception-->Add Port
##Name It MySQL XBMC or whatever you want
##Then type in the port number you set mysql to use(Default is 3306)
#:{{Note|You must do this twice:Once for UDP and once for TCP}}

{{Note|If XBMC is unable to connect to the MySQL server, returning an error code [1130]:}} 
If this occurs to you, try amending Step 2 above to read <code>GRANT ALL ON *.* TO 'xbmc'@'xxx.xxx.xxx.%';</code> where xxx.xxx.xxx is the first three quadrants of your home network's IP address (192.168.1 for example) and % as the last quadrant to allow addresses on the same subnet to connect.

=NAS=
MySQL can also be installed on some [[w:network-attached storage|network-attached storage (NAS)]] device devices. Here are some guides for various NAS devices that can have a MySQL server installed:

*Devices running Arch Linux ARM (such as the PogoPlug, Dockstar, etc) can use the [[HOW-TO:Share libraries using MySQL/Setting up MySQL/ALARM|Arch Linux instructions]] on this page.
*[http://quixventure.com/2011/12/configure-a-synology-nas-as-mysql-server-for-xbmc/ Synology NAS as MySQL server for XBMC]
*http://www.robvanhamersveld.nl/2013/02/05/share-your-xbmc-12-0-library-on-a-synology-ds-or-other-nas/ Synology DS with MySQL guide based on Frodo
*http://forum.xbmc.org/showthread.php?tid=172548 - unRAID

=FreeNAS and BSD=

Currently DRAFT and incomplete!

http://www.freenas.org/

FreeNas is a FreeBSD based NAS system that can be run on most hardware - it utilises ZFS for disk and file management.
99% of tasks can be done via the web interface.

Example below is based on FreeNAS 9.1.1

create a Jail via the FreeNAS webui - if unsure see here http://doc.freenas.org/index.php/Adding_Jails

ssh into FreeNAS (use putty or click the "shell" button in the left of the FreeNAS webui

type the following commands

<code>jls</code>
take note of the JID of the jail you created
<code>jexec n csh</code>
replace n with the number of the jail you just created
You are now inside your jail

<code>pkg_add -r mysql55-server</code>
pkg_add -r mysql55-client

vi /etc/rc.conf
add in to the file
mysql_enable="YES"

service mysql-server start
mysql_secure_installation

mysql -u root -p
#in mysql
CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';
GRANT ALL ON *.* TO 'xbmc';
quit;

<headertabs />

*If your library loads slowly with MySQL then you may wish to check out '''[[HOW-TO:Sync multiple libraries/Advanced notes#MySQL speed-up tweaks|these MySQL speed-up tweaks]]'''.
{{Divbox|green||'''Optional:''' For a more secure MySQL installation use these 2 commands to grant permission only to databases XBMC uses. This is useful if you plan on using your MySQL server for more than just XBMC, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. If you only use the MySQL server for XBMC and that server has non-critical data on it, then this probably not necessary.
#<code>GRANT ALL ON `MyMusic%`.* TO 'xbmc'@'%' IDENTIFIED BY 'xbmc';</code>
#<code>GRANT ALL ON `MyVideos%`.* TO 'xbmc'@'%' IDENTIFIED BY 'xbmc';</code>
Note: these grants do not appear to give the xbmc user permissions to create required TRIGGERs. So either figure out how to do an additional limited grant to create TRIGGERs or use the broader grant *.* statement above. }}

{{Next|[[HOW-TO:Share libraries using MySQL/Setting up XBMC|Setting up XBMC]]}}

MySQL/Setting up MySQL

2013-12-13T21:32:43Z

Rm-r:

{{Frodo updated}}{{:HOW-TO:Sync multiple libraries/Contents}}
You'll need to choose which of your computers, XBMC devices, or [[NAS]] will be the MySQL server. The server needs to be on 24/7 or have wake-on-lan (preferably the former), and needs to have a local static IP. You will probably want the XBMC device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required.
{{-}}

<big>{{notice|Users are reporting issues with '''MySQL 5.6'''. Use '''MySQL 5.5''' instead.}}</big>
MySQL can be installed on just about every major OS:

=Ubuntu Linux=
'''Ubuntu Linux:'''
#<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/10.04/serverguide/C/mysql.html )''
#Create a password when asked
#To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/my.cnf'' and change the bind-address directive to the server's IP address:
##from: <code>bind-address = 127.0.0.1</code>
##to: <code>bind-address = 192.168.0.5</code>
#*Note: Replace 192.168.0.5 with the appropriate address.
#*Note: To allow local and remote access try comment out bind-address using a hash(#) or use <code>bind-address = 0.0.0.0</code>
#Restart your MySQL server. <code>$sudo restart mysql</code>
#Get into the MySQL command line utility: <code>$mysql -u root -p</code>
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=Arch Linux=
'''Arch Linux:'''
*Please note: Arch, along with many other distributions, has migrated to the faster and more open MariaDB. It is a drop in replacement to MySQL and, thus, XBMC will require no modifications to work with it.
#Install MariaDB: <code>$ sudo pacman -S mariadb</code>
#Start the service: <code>$ sudo systemctl start mysqld</code>
#To have it automatically launch at startup: <code>$ sudo systemctl enable mysqld</code>
#Create a password: <code>$ /usr/bin/mysql_secure_installation</code> ''This will also clean up the demo database.''
#Get into the MariaDB command line utility: <code>$ mysql -u root -p</code>
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=RedHat based Linux=
'''RedHat based Linux (RHEL, CentOS, Fedora):'''
#<code>$sudo yum install mysql-server</code>
#Create a password when asked
#To configure MySQL to listen for connections only from network hosts, edit ''/etc/mysql/my.cnf'' and add the bind-address directive to the server's IP address: <code>bind-address = 192.168.0.5</code>
#*Note: Replace 192.168.0.5 with the appropriate address.
#*Note: Alternatively you can leave this file as is to allow local and remote access.
#Restart your MySQL server. <code>$sudo /sbin/service mysqld restart</code>
#*Recommended - Set your MySQL root password with <code>/usr/bin/mysqladmin -u root password 'new-password'</code>
#Get into the MySQL command line utility: <code>$mysql -u root -p</code>
#*Enter your MySQL root password as set above, or just press enter if you didn't set one to log in with a blank password
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool with <code>\q</code>

=Mac OS X=
'''Mac OS X:'''
#Download a copy of MySQL server from http://dev.mysql.com/downloads/mysql/
#In Mac OS X, go to System Preferences -> MySQL, and click on “Start MySQL Server”. You’ll also want to tick to enable the “Automatically … on Startup” option.
#Now to set up the "xbmc" user in MySQL and give it access. Launch Terminal.app on your Mac and issue the following commands, one line at a time:
##<code>sudo /usr/local/mysql/bin/mysql</code>
##<code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code>
##<code>GRANT ALL ON *.* TO 'xbmc';</code>
##<code>exit</code>
#Remain in Terminal.app. Now you'll be giving other computers on your network access to MySQL. Enter the next set of commands, one line at a time:
##<code>cd /usr/local/mysql/support-files/</code>
##<code>sudo cp my-huge.cnf /etc/my.cnf</code>
##:''The command line will ask for your Mac OS X user password. Enter it and press return. No text will show when you type your password in, this is normal.
##<code>cd /etc</code>
##<code>sudo nano my.cnf</code>
##:''This opens a file in a command line text editor''
##Scroll down to the [mysqld] section and add or edit the following line so that it appears as:
##:<code>bind-address = ***.***.***.***</code>
##Save and exit from the command line text editor
#Reboot the Mac, or restart the MySQL service from the System Preferences pane you installed earlier

*Alternative guide for Mac OS X: http://forum.xbmc.org/showthread.php?tid=151631

=Windows=
'''Windows:'''
#Download a copy of MySQL server from http://dev.mysql.com/downloads/mysql/
#Select ''Standard configuration''
#Create a password when asked
#Select that you want the database to have network access when prompted during installation.
#Open the "MySQL Command Line Client" from the MySQL start menu
#Enter the following commands:
##Type in: <code>CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';</code> and press return
##Type in: <code>GRANT ALL ON *.* TO 'xbmc';</code> and press return
#Close out the command line tool
#In '''Windows 7''', you may need to make an exception in the "Windows Firewall"
##Go to control panel and open windows firewall
##Click on advanced settings
##Click on Inbound Rules, then new rule
##Chose the port option, click next
##Then type in the port number you set mysql to use(Default is 3306)
##Make sure Allow the connection is checked then click next
##Name it MYSQL Inbound(or whatever you want) then click finish
##Use these same steps to set up the Outbound exception then name it MYSQL Outbound(or whatever you want) then you're finished.
#:You may or may not have to set up both in and outbound, someone with more knowledge please edit this if you know.
#In '''Windows XP''', you may need to make an exception in the "Windows Firewall"
##Open Control Panel and Set to 'Classic View'
##Double Click on Windows Firewall
##Click on Exception-->Add Port
##Name It MySQL XBMC or whatever you want
##Then type in the port number you set mysql to use(Default is 3306)
#:{{Note|You must do this twice:Once for UDP and once for TCP}}

{{Note|If XBMC is unable to connect to the MySQL server, returning an error code [1130]:}} 
If this occurs to you, try amending Step 2 above to read <code>GRANT ALL ON *.* TO 'xbmc'@'xxx.xxx.xxx.%';</code> where xxx.xxx.xxx is the first three quadrants of your home network's IP address (192.168.1 for example) and % as the last quadrant to allow addresses on the same subnet to connect.

=NAS=
MySQL can also be installed on some [[w:network-attached storage|network-attached storage (NAS)]] device devices. Here are some guides for various NAS devices that can have a MySQL server installed:

*Devices running Arch Linux ARM (such as the PogoPlug, Dockstar, etc) can use the [[HOW-TO:Share libraries using MySQL/Setting up MySQL/ALARM|Arch Linux instructions]] on this page.
*[http://quixventure.com/2011/12/configure-a-synology-nas-as-mysql-server-for-xbmc/ Synology NAS as MySQL server for XBMC]
*http://www.robvanhamersveld.nl/2013/02/05/share-your-xbmc-12-0-library-on-a-synology-ds-or-other-nas/ Synology DS with MySQL guide based on Frodo
*http://forum.xbmc.org/showthread.php?tid=172548 - unRAID

=FreeNAS and BSD=

Currently DRAFT and incomplete!

http://www.freenas.org/

FreeNas is a FreeBSD based NAS system that can be run on most hardware - it utilises ZFS for disk and file management.
99% of tasks can be done via the web interface.

Example below is based on FreeNAS 9.1.1

create a Jail via the FreeNAS webui (example to follow)

ssh into FreeNAS

<code>jexec 1 csh<code>

in jail
pkg_add -r mysql55-server
pkg_add -r mysql55-client

vi /etc/rc.conf
add in to the file
mysql_enable="YES"

service mysql-server start
mysql_secure_installation

mysql -u root -p
#in mysql
CREATE USER 'xbmc' IDENTIFIED BY 'xbmc';
GRANT ALL ON *.* TO 'xbmc';
quit;

<headertabs />

*If your library loads slowly with MySQL then you may wish to check out '''[[HOW-TO:Sync multiple libraries/Advanced notes#MySQL speed-up tweaks|these MySQL speed-up tweaks]]'''.
{{Divbox|green||'''Optional:''' For a more secure MySQL installation use these 2 commands to grant permission only to databases XBMC uses. This is useful if you plan on using your MySQL server for more than just XBMC, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. If you only use the MySQL server for XBMC and that server has non-critical data on it, then this probably not necessary.
#<code>GRANT ALL ON `MyMusic%`.* TO 'xbmc'@'%' IDENTIFIED BY 'xbmc';</code>
#<code>GRANT ALL ON `MyVideos%`.* TO 'xbmc'@'%' IDENTIFIED BY 'xbmc';</code>
Note: these grants do not appear to give the xbmc user permissions to create required TRIGGERs. So either figure out how to do an additional limited grant to create TRIGGERs or use the broader grant *.* statement above. }}

{{Next|[[HOW-TO:Share libraries using MySQL/Setting up XBMC|Setting up XBMC]]}}