||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(3)>>|| <<Include(MythTV/Header)>> = mythv-setup = {{{mythtv-setup}}} is the binary used for the initial configuration of a MythTV backend. It is QT based and needs to be launched on an X server (not necessarily on the machine that the backend is running on). == X-Forwarding mythtv-setup == If the backend machine that is being setup doesn't have an X server, {{{mythtv-setup}}} can be launched remotely through a ssh connection that has X forwarded over it. It can be run on windows machine running Cygwin/X, a linux/unix machine running xorg-x11, or a MacOS machine running Apple/X11. The connection is generally forwarded by running the following command on a client machine: {{{ ssh USER@MACHINE -X }}} * ''MACHINE'' is the ip address or hostname of the machine that you are ssh'ing into * ''USER'' is the username normally used for configuring things on this machine. Once connected to the remote machine, apps can be launched as though they are being run locally. == This guide == Note: This guide isn't all inclusive, but should help most people get through the initial mythtv-setup process. If you are looking for more details about a particular section, you will want to see the following areas: [[http://www.mythtv.org/docs/mythtv-HOWTO-9.html#ss9.1|The official mythtv documentation ]] [[http://www.mythtv.org/wiki/index.php/Main_Page|The official mythtv wiki ]] [[http://www.gossamer-threads.com/lists/mythtv/users/|The official mythtv mailing list archive ]] == Starting mythtv-setup == {{{mythtv-setup}}} must either be launched as a user that is in the {{{mythtv}}} group. <<Include(MythTV/Install/mythtv-group)>> <<Include(MythTV/Install/logout)>> Once your are in the mythtv group and have logged out/in, you will be able to launch {{{mythtv-setup}}}. {{{ mythtv-setup }}} <<Include(MythTV/Install/mythtv-setup)>> == Troubleshooting == If it shows up blue and throws errors relating to databases, check these things: * Are you in the mythtv group? * You can check who is in the mythtv group by running {{{ grep mythtv: /etc/group }}} * If you aren't in the mythtv group, add yourself to the group {{{ sudo usermod -a -G mythtv USERNAME }}} Where USERNAME is the name of the user being added. * After adding yourself to the group, remove ~/.mythtv and then '''log out/in'''. {{{ rm ~/.mythtv -rf }}} * If you are already in the group, try to remove ~/.mythtv and then try again. {{{ rm ~/.mythtv -rf }}} * If you still have troubles connecting to the database, you can use these commands to reset the password: {{{ mysql -u root mysql }}} {{{ mysqlcheck -r -u mythtv -pmythtv mythconverg }}} {{{ UPDATE user SET Password=PASSWORD('mythtv') WHERE user='mythtv'; }}} {{{ FLUSH PRIVILEGES; }}} {{{ quit }}} Another common problem is that the mysql database cannot be found. The most probable cause is that you entered the wrong mysql root password when you installing {{{mythtv-database}}}. Mythtv-database needs the mysql root password in order to create the table needed for mythtv. The solution is to reinstall {{{mythtv-database}}} from scratch making sure before that you know the right mysql root password. One way of doing this is to actually reset the password to whatever you want by using {{{ sudo mysqladmin password NEWPASSWORD }}} When you install mythtv-database, it wiĺl prompt you for the mysql root password which is at this point NEWPASSWORD above if you reset the mysql root password. To reinstall mythtv-database {{{ sudo apt-get remove --purge mythtv-database sudo apt-get install mythtv-database }}}