MySQL/Setting up MySQL: Difference between revisions
< MySQL
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
(22 intermediate revisions by 13 users not shown) | |||
Line 3: | Line 3: | ||
You'll need to choose which of your computers, Kodi 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 Kodi device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required. | You'll need to choose which of your computers, Kodi 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 Kodi device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required. | ||
{{-}} | {{-}} | ||
{{redv|'''Please Note:'''| Don't create the MySQL databases on your server'''. Simply set up the MySQL server itself, as Kodi will create the specific databases by itself.}} | {{redv|'''Please Note:'''| Don't create the MySQL databases on your server'''. Simply set up the MySQL server itself, as Kodi will create the specific databases by itself.}} | ||
{{redv|'''Also:'''| Some versions of MySQL set their passwords to expire by default, '''even the root password'''! If the password expires, Kodi cannot access the database and the TV Series and Movies libraries will disappear.<br /> | |||
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )}} | |||
MySQL can be installed on just about every major OS: | MySQL can be installed on just about every major OS: | ||
{{redv|'''Important:'''| Please use only supported versions of the MySQL or MariaDB server. As of January 2019, this is MySQL in at least version 5.6 or MariaDB in at least version 5.5.}} | |||
=Ubuntu Linux= | =Ubuntu Linux= | ||
'''Ubuntu Linux:''' | '''Ubuntu Linux:''' | ||
#<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/ | #<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/18.04/serverguide/mysql.html )'' | ||
#Create a password when asked | #Create a password when asked | ||
#To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/ | #To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/mysql.conf.d/mysqld.cnf'' and change the bind-address directive to the server's IP address: | ||
##from: <code>bind-address = 127.0.0.1</code> | ##from: <code>bind-address = 127.0.0.1</code> | ||
##to: <code>bind-address = 192.168.0.5</code> | ##to: <code>bind-address = 192.168.0.5</code> | ||
#*Note: Replace 192.168.0.5 with the appropriate address. | #*Note: Replace 192.168.0.5 with the appropriate address. | ||
#*Note: To allow local and remote access | #*Note: To allow both local and remote access (i.e. from both the MySQL host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | ||
#Restart your MySQL server. <code> | #Restart your MySQL server. <code>sudo service mysql restart</code> | ||
#Get into the MySQL command line utility: <code> | #Get into the MySQL command line utility: <code>mysql -u root -p</code> | ||
#Enter the following commands: | #Enter the following commands: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>\q</code> | #Close out the command line tool with <code>\q</code> | ||
Line 36: | Line 40: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>\q</code> | #Close out the command line tool with <code>\q</code> | ||
Line 52: | Line 57: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>\q</code> | |||
=RaspberryPi Raspbian= | |||
'''RaspberryPi Raspbian:''' | |||
#<code>$sudo apt-get update && sudo apt-get dist-upgrade</code> to ensure that you have the very latest iteration of Raspbian. ''(September 2017 as of writing this)'' | |||
#<code>$sudo apt-get install mysql-server</code> to install ''MYSQL Server''. | |||
#To configure MySQL to listen for connections from network hosts, <code>$sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf</code> 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 both local and remote access (i.e. from both the MySQL host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | |||
#Restart your MySQL server: <code>sudo service mysql restart</code> | |||
#Get into the MySQL command line utility: <code>sudo mysql</code> | |||
#Enter the following commands: | |||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | |||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | |||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>\q</code> | #Close out the command line tool with <code>\q</code> | ||
Line 90: | Line 114: | ||
=== Windows 7/8/8.1 Built-in Firewall === | === Windows 7/8/8.1 Built-in Firewall === | ||
: Run the following command in powershell or execute all the steps below. | : Run the following command in powershell or execute all the steps below. | ||
:::<syntaxhighlight lang="text" enclose="div"> | |||
New-NetFirewallRule -DisplayName "Allow inbound TCP Port 3306 for MySQL" -Direction inbound –LocalPort 3306 -Protocol TCP -Action Allow | |||
</syntaxhighlight> | |||
:#Go to control panel and open Windows Firewall | :#Go to control panel and open Windows Firewall | ||
:#Click on Advanced Settings | :#Click on Advanced Settings | ||
Line 99: | Line 125: | ||
:#For Profile, you can leave it as default (everything checked by default) and hit Next | :#For Profile, you can leave it as default (everything checked by default) and hit Next | ||
:#For Name, set it to '''''MySQL''''' or any name that you will know what it is and click Finished | :#For Name, set it to '''''MySQL''''' or any name that you will know what it is and click Finished | ||
== Setup users in MySQL for Kodi clients == | == Setup users in MySQL for Kodi clients == | ||
Line 114: | Line 132: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool | #Close out the command line tool | ||
Line 123: | Line 142: | ||
*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. | *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] and http://youtu.be/3PmmDtK65ks | *[https://web.archive.org/web/20160329053954/http://quixventure.com/2011/12/configure-a-synology-nas-as-mysql-server-for-xbmc/ Synology NAS as MySQL server for XBMC] and http://youtu.be/3PmmDtK65ks | ||
*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://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.kodi.tv/showthread.php?tid=172548 - unRAID | *http://forum.kodi.tv/showthread.php?tid=172548 - unRAID | ||
After setting up a database server on you NAS, you should create a Kodi user with full administrative privileges. The user should be able to log in from your Kodi devices, so make sure you give the user login access from external machines. | |||
You do not need to create a database as Kodi will create the required databases itself. | |||
{{redv|'''Warning:'''| As you are giving the Kodi user full administrative privileges and external machine access it is recommended that you review your database security. It is highly recommenced that you block internet access to your database using an appropriate firewall. }} | |||
=FreeNAS and freeBSD= | =FreeNAS and freeBSD= | ||
Line 199: | Line 223: | ||
* <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> | * <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> | ||
* <code>GRANT ALL ON *.* TO 'kodi';</code> | * <code>GRANT ALL ON *.* TO 'kodi';</code> | ||
* <code>flush privileges;</code> | |||
* <code>quit;</code> | * <code>quit;</code> | ||
Line 204: | Line 229: | ||
'''Optional:''' '''If you only use the MySQL server for Kodi and that server has non-critical data on it, then this probably not necessary.''' | '''Optional:''' '''If you only use the MySQL server for Kodi and that server has non-critical data on it, then this probably not necessary.''' | ||
For a more secure MySQL installation use these 2 commands to grant permission only to databases Kodi uses. This is useful if you plan on using your MySQL server for more than just Kodi, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. | For a more secure MySQL installation use these 2 commands to grant permission only to databases Kodi uses. This is useful if you plan on using your MySQL server for more than just Kodi, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. | ||
'''Upto MySQL Server 5.7 Server:''' | |||
#<code>GRANT ALL ON `MyVideos%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | |||
#<code>GRANT ALL ON `MyMusic%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | #<code>GRANT ALL ON `MyMusic%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | ||
'''As per MySQL 8.0 Server and upwards:''' | |||
#<code>GRANT ALL PRIVILEGES ON `MyVideos%.*` TO `kodi`@`%`;</code> | |||
''' | #<code>GRANT ALL PRIVILEGES ON `MyMusic%.*` TO `kodi`@`%`;</code> | ||
{{redv|'''Careful'''|The limited grants on this page don't give the kodi user permissions to create required TRIGGERs during install or upgrade. '''Kodi requires these TRIGGERs to function properly.''' <br /> | |||
Use the broader grant *.* statement that is explained on the previous tabs while creating or upgrading the tables. Only restrict rights afterwards, if you need to. <br> | |||
Alternatively, figure out how to specifically give the account the right to create the require TRIGGERS - this varies between MySQL versions. }} | Alternatively, figure out how to specifically give the account the right to create the require TRIGGERS - this varies between MySQL versions. }} | ||
<headertabs /> | <headertabs /> |
Revision as of 10:04, 19 October 2019
Share libraries w/MySQL, guide: |
MySQL | Setting up MySQL |
You'll need to choose which of your computers, Kodi 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 Kodi device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required.
Please Note: Don't create the MySQL databases on your server. Simply set up the MySQL server itself, as Kodi will create the specific databases by itself.
Also: Some versions of MySQL set their passwords to expire by default, even the root password! If the password expires, Kodi cannot access the database and the TV Series and Movies libraries will disappear.
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )
MySQL can be installed on just about every major OS:
Important: Please use only supported versions of the MySQL or MariaDB server. As of January 2019, this is MySQL in at least version 5.6 or MariaDB in at least version 5.5.
Next step: | Setting up Kodi |