Ticket #1758: mythtv-setup-programs-move-2.diff

File mythtv-setup-programs-move-2.diff, 12.4 KB (added by Dibblah, 14 years ago)

Modifies the remaining references of 'setup' in the documentation to mythtv-setup

  • docs/mythtv-HOWTO.sgml

     
    11481148<p><bf>NOTE</bf>: This section will be considered abandoned as of v0.20.
    11491149<p>Red Hat Linux 9 use a default locale with UTF-8 encoding.
    11501150Date::Manip, a perl module used by XMLTV, is not UTF-8 safe. As a result,
    1151 whenever you run setup or mythfilldatabase you will get a lot of UTF-8
    1152 warnings. There is an <url url="http://membled.com/work/patches/DateManip/"
     1151whenever you run mythtv-setup or mythfilldatabase you will get a lot of
     1152UTF-8 warnings. There is an
     1153<url url="http://membled.com/work/patches/DateManip/"
    11531154name="http://membled.com/work/patches/DateManip/"> updated version of
    11541155Date::Manip at the XMLTV site fixing this and other XMLTV related
    11551156bugs.
     
    13451346Fill in the survey, then proceed to the lineup choices and configure your
    13461347account for your particular location and the channels that you have.  This
    13471348configuration will be imported into MythTV when you first run the
    1348 <bf>setup</bf> program.
     1349<bf>mythtv-setup</bf> program.
    13491350
    13501351See the section called <ref id="MigratingtoDD" name="Migrating from XMLTV
    13511352to DataDirect"> for instructions on moving to DataDirect if you are
     
    15031504<list>
    15041505<item>You do NOT need the MySQL server installed on your remote frontend
    15051506<item>You do NOT need XMLTV installed on your remote frontend
    1506 <item>You do NOT need to run the MythTV setup program on
     1507<item>You do NOT need to run the mythtv-setup program on
    15071508your frontend machine
    15081509</list>
    15091510
     
    15151516Once MythTV is compiled and installed:
    15161517<list>
    15171518<item>
    1518 Run the MythTV setup program on your Master backend. Under the "General"
     1519Run the mythtv-setup program on your Master backend. Under the "General"
    15191520menu, change the IP address of the current machine (by default, "127.0.0.1")
    15201521to the real external IP address - 127.0.0.1 is the loopback address and no
    15211522external machine can access it. Change the Master Server IP setting to the
     
    21822183<bf>irw</bf> and configure the channel changing script.
    21832184 
    21842185The path to the channel changing script will need to be entered on the
    2185 mythbackend setup screen for Input Connections.
     2186mythtv-setup screen for Input Connections.
    21862187
    21872188This csh script will be called each time MythTV needs to change the channel.
    21882189Below is a copy of the script followed by the corresponding perl script.
     
    22412242partition for MythTV.
    22422243
    22432244If you create a <tt>/var/video</tt> subdirectory, change
    2244 <tt>/mnt/store/</tt> to <tt>/var/video/</tt> in the setup screens.
     2245<tt>/mnt/store/</tt> to <tt>/var/video/</tt> in the mythtv-setup screens.
    22452246<tscreen><verb>
    22462247$ su
    22472248# mkdir /var/video
     
    22572258have only one backend, then it will be its own master.
    22582259
    22592260The Master backend will always choose the first available tuner in the same
    2260 order as you add cards through "setup". In other words, the second card you
    2261 add will only be used when there are two overlapping recordings, the third
    2262 when there are three, and so on. Therefore, you will want to have the
    2263 greatest amount of disk space on the Master backend because its tuner will
    2264 always be the first choice. You will then want to add your <ref
     2261order as you add cards through "mythtv-setup". In other words, the second
     2262card you add will only be used when there are two overlapping recordings,
     2263the third when there are three, and so on. Therefore, you will want to have
     2264the greatest amount of disk space on the Master backend because its tuner
     2265will always be the first choice. You will then want to add your <ref
    22652266id="nonmaster_backend" name="other backends"> in the order of your
    22662267preference for recording.
    22672268
     
    23282329
    23292330<sect2>General
    23302331<p>The first screen of the General configuration deals with IP addresses of the
    2331 system that you're running setup on and any master backend you may have.  If
    2332 you've only got one machine, then the default values are fine and you can
     2332system that you're running mythtv-setup on and any master backend you may have.
     2333If you've only got one machine, then the default values are fine and you can
    23332334move to the next page by pressing the space bar.  If you need to move around
    23342335the screen, use the arrow keys to move focus between settings, not the
    23352336mouse.
     
    23932394<bf>NOTE</bf>: You need <bf>wget</bf> version 1.9.1 or higher to use
    23942395DataDirect.
    23952396
    2396 The setup program will contact the Zap2It servers and get your account
     2397The mythtv-setup program will contact the Zap2It servers and get your account
    23972398information.  Once you're done, you may click the Finish button and skip the
    23982399next few paragraphs in this document since they only apply to users that are
    23992400using the external XMLTV script to get their guide data.
     
    24692470<p>The channel editor is used to globally alter channel information,
    24702471including items like hue, contrast, fine tuning and others.  Users in North
    24712472America shouldn't run the channel editor until after completing initial
    2472 setup and running <bf>mythfilldatabase</bf> at least once to populate the
    2473 database.
     2473mythtv-setup and running <bf>mythfilldatabase</bf> at least once to populate
     2474the database.
    24742475
    24752476<sect1>Post-configuration
    24762477<p>Run the <tt>mythfilldatabase</tt> program as directed.  The master
     
    25442545backends as discussed in the section titled <ref id="modify_perm_mysql"
    25452546name="Modifying access to the MySQL database for multiple systems"> and that
    25462547you have the correct IP address for the database server in the "Database
    2547 Configuration" screen of the setup application on this slave backend.
     2548Configuration" screen of the mythtv-setup application on this slave backend.
    25482549
    25492550<figure loc="here">
    25502551<eps file="stop.eps" height="1cm">
     
    29442945but it generates larger files than MPEG-4 for a given recording.
    29452946
    29462947For DVB and HDTV cards, no further configuration is required after
    2947 setting up the card using the 'setup' program.
     2948setting up the card using the 'mythtv-setup' program.
    29482949For all other cards, configuration is done through MythFrontend.
    29492950Selecting 'Recording Profiles' from the 'TV Settings' screen will list
    29502951the profiles currently available for the cards in your system.
     
    35783579<sect2>Wakeup the MySQL server using WOL
    35793580<p>If your MySQL server and your Master backend are not on the same machine,
    35803581you can have the Master backend wake your MySQL server using WOL. You will
    3581 find the settings for this in the second page of the setup program,
     3582find the settings for this in the second page of the mythtv-setup program,
    35823583or at the end of <tt>mysql.txt</tt>.  The meanings are the same as
    35833584discussed in "The WakeOnLan settings" above.
    35843585
     
    37473748can be useful if you believe that you prefer any of the shows on certain
    37483749channels. This would give all shows on a channel an advantage by default.
    37493750
    3750 Input priority -- in the MythTV "setup" program, the "Input Connections"
     3751Input priority -- in the "mythtv-setup" program, the "Input Connections"
    37513752section allows you to add additional priority in the "Input priority".
    37523753This is simply another priority factor but has an interesting effect. If a
    37533754card input has a higher value than the other cards, the scheduler will see
     
    53535354intents and purposes your computer will have crashed.
    53545355
    53555356<sect1>Installing
    5356 <sect2>When trying to run setup, you get an error like this: "./setup: error while loading shared libraries:"
     5357<sect2>When trying to run mythtv-setup, you get an error like this:
     5358"mythtv-setup: error while loading shared libraries:"
    53575359<p>You didn't add <tt>/usr/local/lib</tt> to <tt>/etc/ld.so.conf</tt>.  See the
    53585360section on modifying <ref id="modifying_ld.so.conf" name="/etc/ld.so.conf">.
    53595361
     
    59765978<img src="stop.png">
    59775979<caption><bf>NOTE</bf>:  Performing this step will remove the entire database.
    59785980You will lose all of your settings and will need to re-run the mc.sql script
    5979 to setup the database structure before running the setup program.
     5981to setup the database structure before running the mythtv-setup program.
    59805982</caption>
    59815983</figure>
    59825984<tscreen><verb>
     
    63096311database.
    63106312
    63116313One example of an advanced configuration is the round-robin scheme.  Rather
    6312 than defining all of the cards on the master, you could first go into setup
    6313 on the master to define globals such as the general configuration and the
    6314 channel lineup but not the host-specific configuration item like the capture
    6315 card.  In this example, we will use a 4 tuner configuration, where two
     6314than defining all of the cards on the master, you could first go into
     6315mythtv-setup on the master to define globals such as the general configuration
     6316and the channel lineup but not the host-specific configuration item like the
     6317capture card.  In this example, we will use a 4 tuner configuration, where two
    63166318slaves have one card each and the master has two.
    63176319<enum>
    63186320<item>Add the first capture card on one of the slaves.  Complete the
    63196321configuration, connecting the input source to the card.  This will get
    6320 cardid #1 in the database.  Exit setup.
     6322cardid #1 in the database.  Exit mythtv-setup.
    63216323<item>Configure the first capture card on the master backend.  This will get
    6322 cardid #2 in the database.  Exit setup.
     6324cardid #2 in the database.  Exit mythtv-setup.
    63236325<item>Configure the first capture card on the second slave.  This will be
    6324 cardid #3 in the database.  Exit setup.
     6326cardid #3 in the database.  Exit mythtv-setup.
    63256327<item>Configure the second capture card on the master backend.  This will
    6326 get cardid #4 in the database.  Exit setup.
     6328get cardid #4 in the database.  Exit mythtv-setup.
    63276329</enum>
    63286330
    63296331Using this scheme, the master backend will not use both capture cards until
     
    70197021$
    70207022</verb></tscreen>
    70217023
    7022 Run the MythTV setup program.  When the setup program prompts "Would you
     7024Run the mythtv-setup program.  When the setup program prompts "Would you
    70237025like to clear all program/channel settings before starting configuration
    70247026[no]" type "yes".
    70257027
     
    70347036You <em>must</em> associate your DataDirect information with the inputs on
    70357037your capture device.  If you created "Cable-DD", then don't forget to bind
    70367038<tt>/dev/video0</tt> to Cable-DD in the <ref id="VideoSources" name="Video
    7037 Sources"> portion of setup.
     7039Sources"> portion of mythtv-setup.
    70387040</caption>
    70397041</figure>
    70407042
    7041 Once you're done running setup, run <bf>mythfilldatabase</bf> to populate
    7042 the database with new data.
     7043Once you're done running mythtv-setup, run <bf>mythfilldatabase</bf> to
     7044populate the database with new data.
    70437045
    70447046To restore the channel icons, you will need to perform one of two steps.
    70457047Both are dependant on the channel_copy table you created above.
     
    71767178
    71777179On the slower machine:
    71787180
    7179 Start the backend setup program.  Advance through the pages until you get to
     7181Start the mythtv-setup program.  Advance through the pages until you get to
    71807182the Job Queue page.  Turn off the setting that says "Allow Commercial
    71817183Detection jobs", thereby preventing any commercial flagging jobs from
    71827184running on this machine.
     
    71887190
    71897191On the faster machine:
    71907192
    7191 Start the backend setup program.  Advance through the pages until you get to
     7193Start the mythtv-setup program.  Advance through the pages until you get to
    71927194the Job Queue page.  Ensure that "Allow Commercial Detection jobs" is turned
    71937195ON for this machine.
    71947196
     
    76287630cables, etc.
    76297631
    76307632Once you have confirmed that your card is able to lock onto a HDTV signal it
    7631 is time to configure MythTV. Start the setup program, and in the Capture
    7632 Cards section change the card type to "Digital Video Broadcast".
     7633is time to configure MythTV. Start the mythtv-setup program, and in the
     7634Capture Cards section change the card type to "Digital Video Broadcast".
    76337635
    76347636For HDTV you do not need to use the Advanced configuration.
    76357637<sect1>Diskless Ubuntu
  • programs/programs.pro

     
    1111}
    1212
    1313using_backend {
    14     SUBDIRS += mythbackend mythfilldatabase
     14    SUBDIRS += mythbackend mythfilldatabase mythtv-setup
    1515}
    1616
    1717using_frontend:using_backend {
  • mythtv.pro

     
    1414# Directories
    1515SUBDIRS += libs filters programs themes i18n
    1616
    17 using_backend {
    18     SUBDIRS += setup
    19 }
    20 
    2117# clean up config on distclean, this must be the last sub-directory
    2218SUBDIRS += config