Difference between revisions of "Setup General"

From MythTV Official Wiki
Jump to: navigation, search
(Combined individual settings for one of the sections into one table)
(Continued the table changes for most of the page. Messes up order of content menu - anyone know a solution?)
Line 44: Line 44:
  
 
===Backend Reference===
 
===Backend Reference===
 
====Host Address Backend Setup====
 
  
  
 
{| border="1" cellspacing="0" cellpadding="5" align="center"
 
{| border="1" cellspacing="0" cellpadding="5" align="center"
 +
| colspan="4" align="center" style="background: #efefef;" | '''Host Address Backend Setup'''
 +
|-
 
! |Setting
 
! |Setting
 
! |Default Value
 
! |Default Value
Line 78: Line 78:
 
|Port which the server will listen to for HTTP requests. Currently, it shows a little status information.
 
|Port which the server will listen to for HTTP requests. Currently, it shows a little status information.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
+
|-
 
+
|colspan="4" align="center" style="background: #efefef;" | '''Host-Specific Backend Setup'''
 
+
|-
====Host-specific Backend Setup====
+
|Directory to hold recordings
Directory to hold recordings:
+
| align="center" |/mnt/store/
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|/mnt/store/
 
|-
 
|On Page Description
 
 
|All recordings get stored in this directory.
 
|All recordings get stored in this directory.
 +
|Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
 
|-
 
|-
|Detailed Description and Comments
+
|Directory to hold the Live-TV buffers
 +
| align="center" |PUT IN THE DEFAULT HERE
 +
|All Live-TV buffers will get stored in this directory. These buffers are used to allow you to pause, fast forward and rewind through live TV.
 
|Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
 
|Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
|}
 
 
 
Directory to hold the Live-TV buffers:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|PUT IN THE DEFAULT HERE
 
|-
 
|On Page Description
 
|All Live-TV buffers will get stored in this directory. These buffers are used to allow you to pause, fast forward and rewind through live TV.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Live TV Buffer (GB)
|Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
+
| align="center" |PUT IN THE DEFAULT HERE
|}
 
 
 
 
 
Live TV Buffer (GB):
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|PUT IN THE DEFAULT HERE
 
|-
 
|On Page Description
 
 
|How large the live TV buffer is allowed to grow.
 
|How large the live TV buffer is allowed to grow.
 +
|This is the meat of the subject
 
|-
 
|-
|Detailed Description and Comments
+
|Minimum free Live TV Buffer
 +
| align="center" |PUT IN THE DEFAULT HERE
 +
|How full the live TV buffer is allowed to grow before forcing an unpause.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Minimum free Live TV Buffer:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|PUT IN THE DEFAULT HERE
 
|-
 
|On Page Description
 
|How full the live TV buffer is allowed to grow before forcing an unpause.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Save original files after transcoding
 +
| align="center" |Not checked
 +
|When set and the transcoder is active, the original nuv files will be renamed to nuv.old once the transcoding is complete.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Save original files after transcoding:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|Not checked
 
|-
 
|On Page Description
 
|When set and the transcoder is active, the original nuv files will be renamed to nuv.old once the transcoding is complete.
 
 
|-
 
|-
|Detailed Description and Comments
+
|colspan="4" align="center" style="background: #efefef;" | '''Global Backend Setup'''
 +
|-
 +
|TV format
 +
| align="center" |NTSC
 +
|The standard to use for viewing TV.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
====Global Backend Setup====
 
TV format:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|NTSC
 
|-
 
|On Page Description
 
|The standard to use for viewing TV.
 
 
|-
 
|-
|Detailed Description and Comments
+
|VBI format
 +
| align="center" |None
 +
|VBI stands for Vertical Blanking Interrupt. VBI is used to carry Teletext and Closed Captioning data.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
VBI format:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|None
 
|-
 
|On Page Description
 
|VBI stands for Vertical Blanking Interrupt. VBI is used to carry Teletext and Closed Captioning data.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Channel frequency table
 +
| align="center" |us-cable
 +
|Select the appropriate frequency table for your system. If you have an antenna, use a “-bcast” frequency.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Channel frequency table:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|us-cable
 
|-
 
|On Page Description
 
|Select the appropriate frequency table for your system. If you have an antenna, use a “-bcast” frequency.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Time offset for XMLTV listings
 +
| align="center" | None
 +
|If your local timezone does not match the timezone returned by XMLTV, use this setting to have mythfilldatabase adjust the program start and end times. None disables this feature, Auto automatically detects your local timezone.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Time offset for XMLTV listings:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|None
 
|-
 
|On Page Description
 
|If your local timezone does not match the timezone returned by XMLTV, use this setting to have mythfilldatabase adjust the program start and end times. None disables this feature, Auto automatically detects your local timezone.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Master Backend Override
 +
| align="center" | Checked
 +
|If enabled, the master backend will stream and delete files if it finds them in the video directory. Useful if you are using a central storage location, like a NFS share, and your slave backend isn’t running.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Master Backend Override:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|Checked
 
|-
 
|On Page Description
 
|If enabled, the master backend will stream and delete files if it finds them in the video directory. Useful if you are using a central storage location, like a NFS share, and your slave backend isn’t running.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Follow Symbolic links when deleting files
 +
| align="center" | Not checked
 +
|This will cause Myth to follow symlinks when recordings and related files are deleted, instead of deleting the symlink and leaving the actual file.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Follow Symbolic links when deleting files:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|Not checked
 
|-
 
|On Page Description
 
|This will cause Myth to follow symlinks when recordings and related files are deleted, instead of deleting the symlink and leaving the actual file.
 
 
|-
 
|-
|Detailed Description and Comments
+
|colspan="4" align="center" style="background: #efefef;" | '''Shutdown/Wakeup Options'''
 +
|-
 +
|Block shutdown before client connected
 +
| align="center" |Checked
 +
|If set, the automatic shutdown routine will be disabled until a client connects.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
====Shutdown/Wakeup Options====
 
Block shutdown before client connected:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|Checked
 
|-
 
|On Page Description
 
|If set, the automatic shutdown routine will be disabled until a client connects.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Idle timeout (secs)
 +
| align="center" |0
 +
|The amount of time the master backend idles before it shuts down all backends. Set to 0 to disable auto shutdown.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Idle timeout (secs):
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|0
 
|-
 
|On Page Description
 
|The amount of time the master backend idles before it shuts down all backends. Set to 0 to disable auto shutdown.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Max. wait for recording (min)
 +
| align="center" |15
 +
|The amount of time the master backend waits for a recording.  If it's idle but a recording starts within this time period, the backends won't shut down.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Max. wait for recording (min):
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|15
 
|-
 
|On Page Description
 
|The amount of time the master backend waits for a recording.  If it's idle but a recording starts within this time period, the backends won't shut down.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Startup before rec. (secs)
 +
| align="center" |120
 +
|The amount of time the master backend will be woken up before a recording starts.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Startup before rec. (secs):
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|120
 
|-
 
|On Page Description
 
|The amount of time the master backend will be woken up before a recording starts.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Wakeup time format
 +
| align="center" |hh:mm yyyy-MM-dd
 +
|Copy the description on the page Here
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Wakeup time format:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|hh:mm yyyy-MM-dd
 
|-
 
|On Page Description
 
|Copy the description on the page Here
 
 
|-
 
|-
|Detailed Description and Comments
+
|Set wakeuptime command
 +
| align="center" |Blank
 +
|The command used to set the time (passed as $time) to wake up the masterbackend.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Set wakeuptime command
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|
 
|-
 
|On Page Description
 
|The command used to set the time (passed as $time) to wake up the masterbackend
 
 
|-
 
|-
|Detailed Description and Comments
+
|Server halt command
 +
| align="center" |sudo /sbin/halt -p
 +
|The command used to halt the backends.
 
|This is the meat of the subject
 
|This is the meat of the subject
|}
 
 
 
Server halt command:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|sudo /sbin/halt -p
 
|-
 
|On Page Description
 
|The command used to halt the backends.
 
 
|-
 
|-
|Detailed Description and Comments
+
|Pre Shutdown check-command
|This is the meat of the subject
+
| align="center" |Blank
|}
 
 
 
 
 
Pre Shutdown check-command:
 
{| border=1 cellspacing=0 cellpadding=5
 
|Default Setting
 
|
 
|-
 
|On Page Description
 
 
|A command executed before the backend would shutdown. The return value determines if the backend can shutdown. 0 - yes, 1 - restart idling, 2 - reset the backend to wait for a frontend.
 
|A command executed before the backend would shutdown. The return value determines if the backend can shutdown. 0 - yes, 1 - restart idling, 2 - reset the backend to wait for a frontend.
|-
 
|Detailed Description and Comments
 
 
|This is the meat of the subject
 
|This is the meat of the subject
 
|}
 
|}

Revision as of 03:16, 12 February 2006

Previous Up Next
Go-prev.png User Manual:Setting Up Go-up.png User Manual:Index User Manual:Detailed configuration Frontend Go-next.png


Backend

MythTV Detailed Backend Configuration v. 0.18.1. (Incomplete)


MythTV Backend

The backend process (mythbackend) is the portion of the system that handles the Video capture cards as well as Scheduling Recordings on those cards, Commercial Flagging, and transcoding. The backend process interacts with the Database primarily.

As with the MythFrontend, there can be multiple backends. One backend process is designated as the master backend. This is usually the first backend installed on a system. This backend is responsible for coordinating the activities of the other backends known as slaves. This is especially true for scheduling as the master backend will determine the best distribution of programs across all available tuners. Each backend can have any number of tuners, including zero. As of 0.16, Commercial Flagging can be distributed across different backends, thereby spreading the load of that process.

There is no requirement for direct user interaction with the backend. The backend can use local HardWare/File Storage or have it mounted from another system. If remotely mounted, network performance should be considered as there will be considerable traffic on the network as recordings are stored and retreived by the backend process.

Communications Protocol

The backend and frontend communicate using their own Myth Protocol. The developer of Win Myth, a windows frontend to MythTV for playing recordings on Windows, has documented his workings on the procotol here. Work on defining the Myth Protocol is also be performed on this Wiki.


Backend Configuration

The MythTV Backend configuration has two main objectives

  • Tell MythTV what TV Capture/Tuner cards to use
  • Populate the Myth Database with information about channels and tuning information

There are additional items that can be configured, but without successfully achieving the above two steps you will not be able to get Live TV.


Running mythtv-setup

Configure the Myth backend like so

> mythtv-setup

The system will now prompt to see if you want to keep the current TV card settings as well as the channel information.

Once configuration is done you can test to see if the mythbackend process is running correctly by starting it in a Terminal window:

> mythbackend

Watch out for any error messages.

Backend Reference

Host Address Backend Setup
Setting Default Value Settings Page's Description Additional Comments
IP address for mythtv 127.0.0.1 Enter the IP address of this machine. Use an externally accessible address (ie, not 127.0.0.1) if you are going to be running a frontend on a different machine than this one. This is the meat of the subject
Port the server runs on 6543 Unless you’ve got a good reason to, don’t change this. This is the meat of the subject
Port the server shows status on 6544 Port which the server will listen to for HTTP requests. Currently, it shows a little status information. This is the meat of the subject
Master Server IP address 127.0.0.1 The IP address of the master backend server. All frontend and non-master backend machines will connect to this server. If you only have one backend, this should be the same IP address as above. This is the meat of the subject
Port the master server runs on 6543 Port which the server will listen to for HTTP requests. Currently, it shows a little status information. This is the meat of the subject
Host-Specific Backend Setup
Directory to hold recordings /mnt/store/ All recordings get stored in this directory. Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
Directory to hold the Live-TV buffers PUT IN THE DEFAULT HERE All Live-TV buffers will get stored in this directory. These buffers are used to allow you to pause, fast forward and rewind through live TV. Be sure this directory exists and that proper permissions are set for the mythtv user. If the directory does not exist or is inaccessible, the backend will not start.
Live TV Buffer (GB) PUT IN THE DEFAULT HERE How large the live TV buffer is allowed to grow. This is the meat of the subject
Minimum free Live TV Buffer PUT IN THE DEFAULT HERE How full the live TV buffer is allowed to grow before forcing an unpause. This is the meat of the subject
Save original files after transcoding Not checked When set and the transcoder is active, the original nuv files will be renamed to nuv.old once the transcoding is complete. This is the meat of the subject
Global Backend Setup
TV format NTSC The standard to use for viewing TV. This is the meat of the subject
VBI format None VBI stands for Vertical Blanking Interrupt. VBI is used to carry Teletext and Closed Captioning data. This is the meat of the subject
Channel frequency table us-cable Select the appropriate frequency table for your system. If you have an antenna, use a “-bcast” frequency. This is the meat of the subject
Time offset for XMLTV listings None If your local timezone does not match the timezone returned by XMLTV, use this setting to have mythfilldatabase adjust the program start and end times. None disables this feature, Auto automatically detects your local timezone. This is the meat of the subject
Master Backend Override Checked If enabled, the master backend will stream and delete files if it finds them in the video directory. Useful if you are using a central storage location, like a NFS share, and your slave backend isn’t running. This is the meat of the subject
Follow Symbolic links when deleting files Not checked This will cause Myth to follow symlinks when recordings and related files are deleted, instead of deleting the symlink and leaving the actual file. This is the meat of the subject
Shutdown/Wakeup Options
Block shutdown before client connected Checked If set, the automatic shutdown routine will be disabled until a client connects. This is the meat of the subject
Idle timeout (secs) 0 The amount of time the master backend idles before it shuts down all backends. Set to 0 to disable auto shutdown. This is the meat of the subject
Max. wait for recording (min) 15 The amount of time the master backend waits for a recording. If it's idle but a recording starts within this time period, the backends won't shut down. This is the meat of the subject
Startup before rec. (secs) 120 The amount of time the master backend will be woken up before a recording starts. This is the meat of the subject
Wakeup time format hh:mm yyyy-MM-dd Copy the description on the page Here This is the meat of the subject
Set wakeuptime command Blank The command used to set the time (passed as $time) to wake up the masterbackend. This is the meat of the subject
Server halt command sudo /sbin/halt -p The command used to halt the backends. This is the meat of the subject
Pre Shutdown check-command Blank A command executed before the backend would shutdown. The return value determines if the backend can shutdown. 0 - yes, 1 - restart idling, 2 - reset the backend to wait for a frontend. This is the meat of the subject


WakeOnLan settings

MasterBackend

Reconnect wait time (secs):

Count of reconnect tries:

Wake Command

Wake command for slaves:


Job Queue (Host-Specific)

Maximum simultaneous jobs on this backend:

Run Jobs only on original recording host

Job Queue Check frequency (in seconds)

CPU Usage

Allow Commercial Detection jobs

Allow User Job #1 jobs

Allow User Job #2 jobs

Allow User Job #3 jobs

Allow User Job #4 jobs


Job Queue (Job Commands)

User Job #1 Description:

User Job #1 Command:

User Job #2 Description:

User Job #2 Command:

User Job #3 Description:

User Job #3 Command:

User Job #4 Description:

User Job #4 Command: