Difference between revisions of "Mythfilldatabase"

From MythTV Official Wiki
Jump to: navigation, search
(1. LinkSys or Fedora Core)
(Run mythfilldatabase with the --file flag)
(48 intermediate revisions by 24 users not shown)
Line 1: Line 1:
 
{{Cleanup}}
 
{{Cleanup}}
 
{{Wrongtitle|mythfilldatabase}}
 
{{Wrongtitle|mythfilldatabase}}
= About =
+
'''mythfilldatabase''' fills the Myth database [[program table]] with upcoming shows.
'''mythfilldatabase''' fills the Myth programs table with upcoming shows.
+
 
 +
= Automatic use of mythfilldatabase =
 +
Normally mythfilldatabase is run automatically by [[mythbackend]] every 24 hours. For most people allowing mythfilldatabase to run automatically will be sufficient, however in areas with no XMLTV grabber or an unusual channel setup it may be run manually.
  
 
= Manual use of mythfilldatabase =
 
= Manual use of mythfilldatabase =
 +
To run an extra time out of sequence (for example, because your subscription had run out, and you just renewed it), use no command line options:
 +
      mythfilldatabase
  
== Command Line Options ==
+
== Command line options ==
--manual
+
<pre>
  Run in manual channel configuration mode
+
$ mythfilldatabase --help
  This will ask you questions about every channel
+
mythfilldatabase version: fixes/0.25 [v0.25-100-gb5b4c48] www.mythtv.org
 
+
Misc. Options:
--update
+
--dd-file                       Bypass grabber, and read SD data from file
  For running non-destructive updates on the database for
+
   --lineupid                      DataDirect lineup of input xml file
  users in xmltv zones that do not provide channel data
+
  --offset                       Day offset of input xml file
 
+
   --xmlfile                       XML file to import manually
--preset
+
--dd-grab-all                  refresh full data using DataDirect
  Use it in case that you want to assign a preset number for
+
--file                          Bypass grabbers and define sourceid and file
  each channel, useful for non US countries where people
+
  --xmlfile                      XML file to import manually
  are used to assigning a sequenced number for each channel, i.e.:
+
--manual                        Run interactive configuration
  1->TVE1(S41), 2->La 2(SE18), 3->TV3(21), 4->Canal 33(60)...
+
--no-mark-repeats              do not mark repeats
 
+
--preset                        Use channel preset values instead of numbers
--no-delete
+
-h OR --help OR --usage        Display this help printout, or give detailed
  Do not delete old programs from the database until 7 days old.
+
                                information of selected option.
 
+
--version                      Display version information.
--file <sourceid> <offset> <xmlfile>
+
--sourceid                      Operate on single source
  Bypass the grabbers and read data directly from a file
+
--update                        Run non-destructive updates
  <sourceid> = number for the video source to use with this file
+
--xawchannels                  Read channels from xawtvrc file
  <offset>   = days from today that xmlfile defines
+
  --xawtvrcfile                  xawtvrc file to import channels from
                (-1 means to replace all data, up to 10 days)
 
  <xmlfile>  = file to read
 
 
 
--dd-file <sourceid> <offset> <lineupid> <xmlfile>
 
  <sourceid> = see --file
 
  <offset>   = see --file
 
  <lineupid> = the lineup id
 
  <xmlfile>  = see --file
 
 
 
--xawchannels <sourceid> <xawtvrcfile>
 
  (--manual flag works in combination with this)
 
  Read channels as defined in xawtvrc file given
 
  <sourceid>    = cardinput
 
  <xawtvrcfile> = file to read
 
 
 
--do_channel_updates
 
  When using DataDirect, ask mythfilldatabase to
 
  overwrite channel names, frequencies, etc. with the
 
  values available from the data source. This will
 
  override custom channel names, which is why it is
 
  off by default.
 
  This may manage to fix a corrupted channel lineup.
 
 
 
--remove-new-channels
 
  When using DataDirect, ask mythfilldatabase to
 
  remove new channels (those not in the database)
 
  from the DataDirect lineup.  These channels are
 
  removed from the lineup as if you had done so
 
  via the DataDirect website's Lineup Wizard, but
 
  may be re-added manually and incorporated into
 
  MythTV by running mythfilldatabase without this
 
  option.  New channels are automatically removed
 
  for DVB and HDTV sources that use DataDirect.
 
 
 
--graboptions <"options">
 
  Pass options to grabber
 
 
 
--sourceid <number>
 
  Only refresh data for sourceid given
 
 
 
--max-days <number>
 
  Force the maximum number of days, counting today,
 
  for the grabber to check for future listings
 
--only-update-channels
 
  Get as little listings data as possible to update channels
 
--refresh-today
 
 
 
--refresh-second
 
 
 
--refresh-all
 
  (Only valid for grabbers: DataDirect, se_swedb, no, ee, de_tvtoday)
 
  Force a refresh today or two days (or every day) from now,
 
  to catch the latest changes.
 
  These may be used to attempt to fix corrupted program guide data.
 
--dont-refresh-tomorrow
 
  Tomorrow will always be refreshed unless this argument is used
 
--dont-refresh-tba
 
  "To be announced" programs will always be refreshed
 
  unless this argument is used
 
 
 
--export-icon-map [<filename>]
 
  Exports your current icon map to <filename> (default: iconmap.xml)
 
--import-icon-map [<filename>]
 
  Imports an icon map from <filename> (default: iconmap.xml)
 
--update-icon-map
 
  Updates icon map icons only
 
--reset-icon-map [all]
 
  Resets your icon map (pass all to reset channel icons as well)
 
  
--mark-repeats
+
Channel List Handling Options:
   Marks any programs with a OriginalAirDate earlier
+
--do-channel-updates            update channels using datadirect
  than their start date as a repeat
+
--do-not-filter-new-channels   don't filter ATSC channels for addition
 +
--only-update-channels          only update channel lineup
 +
--remove-new-channels          disable new channels on datadirect web interface
  
-v or --verbose debug-level
+
Filtering Options:
  Use '-v help' for level info
+
--dont-refresh-tba              don't refresh "To be announced" programs
 +
--max-days                      force number of days to update
 +
--refresh                      Provide a day or range of days to refresh. Can
 +
                                be used repeatedly.
  
--help
+
Channel Icon Handling Options:
  This text
+
--export-icon-map              export icon map to file
 +
--import-icon-map              import icon map to file
 +
--reset-icon-map                resets icon maps
 +
--update-icon-map              updates icon map icons
  
 +
Logging Options:
 +
--loglevel                      Set the logging level.  All log messages at
 +
                                lower levels will be discarded.
 +
                                In descending order: emerg, alert, crit, err,
 +
                                warning, notice, info, debug
 +
                                defaults to info
 +
--logpath                      Writes logging messages to a file in the
 +
                                directory logpath with filenames in the format:
 +
                                applicationName.date.pid.log.
 +
                                This is typically used in combination with
 +
                                --daemon, and if used in combination with
 +
                                --pidfile, this can be used with log rotators,
 +
                                using the HUP call to inform MythTV to reload
 +
                                the file
 +
--nodblog                      Disable database logging.
 +
-q OR --quiet                  Don't log to the console (-q).  Don't log
 +
                                anywhere (-q -q)
 +
--syslog                        Set the syslog logging facility.
 +
                                Set to "none" to disable, defaults to none.
 +
-v OR --verbose                Specify log filtering. Use '-v help' for level
 +
                                info.
  
  --manual and --update can not be used together.
+
</pre>
  
 
== External XMLTV ==
 
== External XMLTV ==
 
If you are in a country where mythfilldatabase will not work the normal way  you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV).
 
If you are in a country where mythfilldatabase will not work the normal way  you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV).
  
=== 1. Obtain xml file of tv guide ===
+
=== Obtain xml file of tv guide ===
  
 
Here in Belgium, I use [http://pytvgrab.sourceforge.net pytvgrab] to get my tv guide and output to an xml file:
 
Here in Belgium, I use [http://pytvgrab.sourceforge.net pytvgrab] to get my tv guide and output to an xml file:
Line 122: Line 87:
 
</nowiki></pre>
 
</nowiki></pre>
  
=== 2. Find out the source id of your card ===
+
=== Find out the source id of your card ===
  
 
This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database:
 
This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database:
Line 137: Line 102:
 
Remember the source id
 
Remember the source id
  
=== 3. Run mythfilldatabase with the --file flag ===
+
=== Run mythfilldatabase with the --file flag ===
 +
 
 +
The --file argument allows to directly import XMLTV files. This is useful if you are using programs like [http://nxtvepg.sourceforge.net/ nxtvepg] to grab your EPG data.
  
The -1 means to replace all data, belgium.xml is the file name for the output of the grabber as above:
+
Note that Schedules Direct members should not use the <code>--file</code> argument with mythfilldatabase.  They should instead use --dd-file with data obtained by running <code>tv_grab_na_dd</code> using the <code>--dd-data</code> argument.
 +
 
 +
'''From 0.21 on:'''
 +
 
 +
From version 0.21 on the arguments of this command changed. The offset argument has been removed and the command changed to:
 
<pre><nowiki>
 
<pre><nowiki>
$ mythfilldatabase --file <sourceid> -1 belgium.xml
+
$ mythfilldatabase --file <sourceid> belgium.xml
 
</nowiki></pre>
 
</nowiki></pre>
The first time you will need to use the --manual flag, but this is better explained on the [[XmlTv]] page.
 
  
== Troubleshooting ==
+
'''From 0.25 on:'''
=== 1. LinkSys or Fedora Core ===
 
I spent the past 3 weeks trying to troubleshoot a problem I was having with mythfilldatabase.  I would run it and it would download between 5K and 3K and then just timeout. 
 
  
I found this solution [http://www.gossamer-threads.com/lists/engine?do=post_view_flat;post=219553;page=1;sb=post_latest_reply;so=ASC;mh=25;list=mythtv http://www.gossamer-threads.com]
+
From version 0.25, the arguments of this command changed:
 +
<pre><nowiki>
 +
$ mythfilldatabase --file --sourceid <sourceid> --xmlfile belgium.xml
 +
</nowiki></pre>
  
which says to do this:
 
  
add this line in /etc/sysctl.conf
+
The first time you will need to use the --manual flag, but this is better explained on the [[XMLTV]] page.
  
net.ipv4.tcp_window_scaling = 0
+
= Troubleshooting =
  
execute sysctl -p /etc/sysctl.conf
+
=== mythfilldatabase causes the system to hang===
or restart your computer
+
This is probably an I/O saturation issue. mythfilldatabase and [[MySQL]] can cause hard disk or ATA bus saturation, causing [[Mythbackend]] to starve.  Read more about [[Troubleshooting:Mythfilldatabase_IO_bottleneck]].
  
Weeks of frustration fixed.  Hope this helps someone.
+
[[Category:MythTV_Software]]

Revision as of 20:46, 2 January 2013

Clean.png Cleanup: This article or section may require cleanup. Discuss the issue on the talk page

Important.png Note: The correct title of this article is mythfilldatabase. It appears incorrectly here due to technical restrictions.

mythfilldatabase fills the Myth database program table with upcoming shows.

Automatic use of mythfilldatabase

Normally mythfilldatabase is run automatically by mythbackend every 24 hours. For most people allowing mythfilldatabase to run automatically will be sufficient, however in areas with no XMLTV grabber or an unusual channel setup it may be run manually.

Manual use of mythfilldatabase

To run an extra time out of sequence (for example, because your subscription had run out, and you just renewed it), use no command line options:

     mythfilldatabase

Command line options

$ mythfilldatabase --help
mythfilldatabase version: fixes/0.25 [v0.25-100-gb5b4c48] www.mythtv.org
Misc. Options:
--dd-file                       Bypass grabber, and read SD data from file
  --lineupid                      DataDirect lineup of input xml file
  --offset                        Day offset of input xml file
  --xmlfile                       XML file to import manually
--dd-grab-all                   refresh full data using DataDirect
--file                          Bypass grabbers and define sourceid and file
  --xmlfile                       XML file to import manually
--manual                        Run interactive configuration
--no-mark-repeats               do not mark repeats
--preset                        Use channel preset values instead of numbers
-h OR --help OR --usage         Display this help printout, or give detailed
                                information of selected option.
--version                       Display version information.
--sourceid                      Operate on single source
--update                        Run non-destructive updates
--xawchannels                   Read channels from xawtvrc file
  --xawtvrcfile                   xawtvrc file to import channels from

Channel List Handling Options:
--do-channel-updates            update channels using datadirect
--do-not-filter-new-channels    don't filter ATSC channels for addition
--only-update-channels          only update channel lineup
--remove-new-channels           disable new channels on datadirect web interface

Filtering Options:
--dont-refresh-tba              don't refresh "To be announced" programs
--max-days                      force number of days to update
--refresh                       Provide a day or range of days to refresh. Can
                                be used repeatedly.

Channel Icon Handling Options:
--export-icon-map               export icon map to file
--import-icon-map               import icon map to file
--reset-icon-map                resets icon maps
--update-icon-map               updates icon map icons

Logging Options:
--loglevel                      Set the logging level.  All log messages at
                                lower levels will be discarded.
                                In descending order: emerg, alert, crit, err,
                                warning, notice, info, debug
                                defaults to info
--logpath                       Writes logging messages to a file in the
                                directory logpath with filenames in the format:
                                applicationName.date.pid.log.
                                This is typically used in combination with
                                --daemon, and if used in combination with
                                --pidfile, this can be used with log rotators,
                                using the HUP call to inform MythTV to reload
                                the file
--nodblog                       Disable database logging.
-q OR --quiet                   Don't log to the console (-q).  Don't log
                                anywhere (-q -q)
--syslog                        Set the syslog logging facility.
                                Set to "none" to disable, defaults to none.
-v OR --verbose                 Specify log filtering. Use '-v help' for level
                                info.

External XMLTV

If you are in a country where mythfilldatabase will not work the normal way you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV).

Obtain xml file of tv guide

Here in Belgium, I use pytvgrab to get my tv guide and output to an xml file:

$ tv_grab_be_tvb --configure  (you only need this the first time)
$ tv_grab_be_tvb -o belgium.xml

Find out the source id of your card

This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database:

$ mysql -u root mythconverg
mysql> select * from cardinput\G
cardinputid
cardid
sourceid=4
etc.

Remember the source id

Run mythfilldatabase with the --file flag

The --file argument allows to directly import XMLTV files. This is useful if you are using programs like nxtvepg to grab your EPG data.

Note that Schedules Direct members should not use the --file argument with mythfilldatabase. They should instead use --dd-file with data obtained by running tv_grab_na_dd using the --dd-data argument.

From 0.21 on:

From version 0.21 on the arguments of this command changed. The offset argument has been removed and the command changed to:

$ mythfilldatabase --file <sourceid> belgium.xml

From 0.25 on:

From version 0.25, the arguments of this command changed:

$ mythfilldatabase --file --sourceid <sourceid> --xmlfile belgium.xml


The first time you will need to use the --manual flag, but this is better explained on the XMLTV page.

Troubleshooting

mythfilldatabase causes the system to hang

This is probably an I/O saturation issue. mythfilldatabase and MySQL can cause hard disk or ATA bus saturation, causing Mythbackend to starve. Read more about Troubleshooting:Mythfilldatabase_IO_bottleneck.