OpenNMP Scheduler: Difference between revisions

From QNAPedia
Jump to navigation Jump to search
m (1 revision imported)
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
''by AdNovea - Nov 2009''<br>
''by AdNovea - Nov 2009''<br> '''[[OpenNMP|OpenNMP Homepage]]''' <br> <br>  
'''[[OpenNMP|OpenNMP Homepage]]'''
__TOC__
<br>
<br>
<span style="font-size: 200%;">Scheduler (''TV/Radio programs recording and Tasks execution'')</span>
<blockquote style="text-align: justify;">From '''version v0.04.xx,''' OpenNMP includes the JQuery RIA (<i>Rich Internet Application</i>) libraries.
Starting with version v0.04.01, we have included a Scheduler to help in recurrent or delayed tasks scheduling. The main menu includes direct accesses to the Scheduler pages for Internet Radio and TV program recording.
<br>
<b>NOTE</b>: Shall you customize the scheduler, refer to the ['''scheduler'''] section of the configuration file "'''/share/OpenNMP/.onmp/config.ini'''".
<br>
<br>
<span style="color: darkred"><b>IMPORTANT</b>: Migration from v0.03.xx to v0.04.xx requires a fresh installation (<i>using a Telnet console, from the unzipped archive folder issue the command: ./installer.sh --force-reinstall</i>)</span>
<br>
<br>
[[Image:OpenNMP_Scheduler_1.jpg|thumb|400px|center|Direct access to Scheduler from menu (<i>PVR & Internet Radios</i>)]]
<br>
== FOREWORD ==
<blockquote>
Despite there is no limitation to the number of simultaneous recordings, one shall take into account:
* The '''DSL line bandwidth''' - to be share between your recording (audio/video) but also the TV-set and the PCs. Bottleneck due to DSL bandwidth will result in impairments of the multimedia contents recorded and displayed.
* The '''Home network bandwidth''' - to be share between your recording (audio/video) and the home PCs.
* The '''storage disk capacity''' to record lengthy multimedia contents (1x audio ~ 1 MB/min, 1x video SD ~ 10 MB/min)
* The '''NMP-1000 CPU power''' is limited (~300MHz) and is shared with Audio/Video processing to display the signal.
Bottlenecks will result in Quality impairments on both recorded and displayed multimedia contents.<br>
<br>
Be GENTLE (and PATIENT) with the NMP, with OpenNMP we are pushing the CPU to its limits. Having concurrent scheduled recordings starting at the same time ('''e.g. one video and an Internet Radio''') or two video recordings at the same time may crash the NMP. OpenNMP is also planned to run on the future more powerful units too.
</blockquote>
<br>


== Schedule a TV program recording ==
= OpenNMP Installation  =
<blockquote>
<blockquote>There are four ways to install (''or to upgrade'') OpenNMP on your device:<br> <br>  
<span style="color: darkred"><b>IMPORTANT</b>: You must install the latest version of My-PVR NPKG.<br>ONLY TV stream in '''RTSP''' format are currently supported.</span><br>
*<span style="color: darkgreen">'''Using MANUAL INSTALLATION with the <u>Distribution packages</u>''' (OpenNMP-xxxx.zip)</span><br>Extract the 3 files (''README, Installer.sh and onmp.tgz'') on your internal drive or a 2nd USB thumbdrive. Then execute the ''installer.sh'' script.<br><span style="color: darkred">'''This procedure shall be used for the <u>very first installation of OpenNMP </u>.'''</span>
<br>
*<span style="color: darkgreen">'''Using full AUTOMATIC INSTALLATION from the OpenNMP <u>Remote repository</u>''' (''available with version 0.3.20 and above'')</span><br>Goto the '''Manage NPKG''' page of the OpenNMP Administration interface. Check (''and only check'') the '''OpenNMP Engine''' to install under '''[SPECIAL] OpenNMP Engine Upgrade''' section, select '''ONLY UPGRADE OpenNMP Engine''' from the drop list and press '''APPLY'''.<br>You will be asked to reboot your device to complete the installation/upgrade.
[[Image:OpenNMP Upgrade.jpg|thumb|center|400px|OpenNMP Upgrade.jpg]] <br>
*<span style="color: darkgreen">'''Using ASSISTED INSTALLATION with the upload feature of MANAGE NPKG page '''</span><br>Download the (''OpenNMP-xxxx.onmp'') archive from the forum and copy the file on your PC local disk. Upload the file using the '''Install a new NPKG Plug-in or Upgrade OpenNMP''' section on the '''MANAGE NPKG''' page of the OpenNMP Administration interface and press '''INSTALL'''.
[[Image:OpenNMP Upgrade 2.jpg|thumb|center|400px|OpenNMP Upgrade 2.jpg]] <br>  
*<span style="color: darkgreen">'''Manual installation of a Build package''' (''OpenNMP-xxxx.onmp'')</span><br>Copy the file at the root directory of your USB device and proceed with the manual installation using the command below:<pre>./autorun --upgrade OpenNMP-xxxx.onmp</pre>
</blockquote>
<br>  


To access the TV program scheduler, click the My-PVR icon in the main Menu or navigate to the My-PVR NPKG configuration page.
= OpenNMP Configuration  =
<br>
<blockquote>OpenNMP configuration is defined into to the '''&lt;your_usb&gt;/.onmp/config.ini''' file.<br> The parameters are self-explained. Most of these parameters are managed through the Administration interface pages.<br>Nevertheless, some parameters shall be set directly in the configuration file:  
<br>
*'''Turn off the sound''' (''onmp.beeper'')
[[Image:OpenNMP_Scheduler_2.jpg|thumb|400px|center|Schedule a TV program recording]]
*'''Force IPV4''' if not using IPV6 for quicker downloads (''force_ipv4'')
<br>
*Change '''uploaded file size limit''' (''php.upload_max_filesize'' &amp; ''php.post_max_size'')
'''NOTE''': Video files are stored in the ''/share/Video/My-PVR'' folder unless specified otherwise in '''video_folder''' under the [''scheduler''] section of the ''/share/OpenNMP/.onmp/config.ini'' configuration file. If there is no internal disk drive, the video files will be saved in the ''/share/Qweb/My-PVR'' folder.
</blockquote>
<br>
<br>  


=== Internet Service Provider Channel list ===
= Under the Hood  =
<blockquote>
<blockquote>For a quick understanding of the OpenNMP architecture, we provide here below three snapshots. They are subject to evolution along with the OpenNMP versions.  
* 1- Most of the ISP (''Internet Service Provider'') allows today the streaming of TV channel to PCs in their Triple-Play offers. They provide a TV channel playlist (''M3U format'') which can be used by software such as VLC.<br><br>The '''URL''' of these lists shall be available at your ISP. Here is below the URL for some French ISPs (''not checked''):
{| width="100%"
<blockquote><pre>
|-
FREE: http://mafreebox.freebox.fr/freeboxtv/playlist.m3u
| [[Image:ONMP Hood1.jpg|thumb|center|200px|ONMP Hood1.jpg]]
NEUF TELECOM: http://televisionsurpc.neuf.fr/televisionsurpc.m3u
| [[Image:ONMP Hood2.jpg|thumb|center|200px|ONMP Hood2.jpg]]
ALICE: http://www.c-alice.com/phpBB2/files/AliceTV.m3u
| [[Image:ONMP Hood3.jpg|thumb|center|200px|ONMP Hood3.jpg]]
SFR: http://televisionsurpc.sfr.fr/televisionsurpc.m3u
|}
...
</blockquote>  
</pre></blockquote>
<br> <br>  
<br>
* 2- Enter the ISP playlist URL and press '''REFRESH'''<br>The list is uploaded.<br>If the list cannot be uploaded, you create the M3U content into the "/share/OpenNMP/.npkg/my_pvr/inc/playlist.m3u"<br>''Here is below a M3U sample for the French ISP FREE.''
<blockquote>
<pre>
#EXTM3U
#EXTINF:0,2 - France 2
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=201
#EXTINF:0,3 - France 3 national
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=202
#EXTINF:0,14 - France 4
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=376
#EXTINF:0,5 - France 5
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=203
#EXTINF:0,8 - Direct8
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=372
#EXTINF:0,11 - NT1
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=374
#EXTINF:0,12 - NRJ 12
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=375
#EXTINF:0,13 - La Chaine Parlementaire
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=226
#EXTINF:0,15 - BFMTV
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=400
#EXTINF:0,23 - TV5
rtsp://mafreebox.freebox.fr/fbxtv_pub/stream?namespace=1&service=206
...</pre></blockquote>
<br>
* 3- The playlist.m3u is then read out and creates the drop list.<br>Any selection from the drop list will automatically fill-in the TITLE and URL fields of the Scheduler.<br>
<span style="color: darkred">'''NOTE''': Channel names may use illegal characters which cause issues while renaming the recorded files. Rename those channels in the ''playlist.m3u'' to avoid problems.<br>Also check that the M3U file has been saved with UTF-8 encoded format otherwise accented characters are incorrectly displayed.</span>
</blockquote>


=== Recording Scheduler ===
<blockquote>
* 4- Check the Format (''Only the RTSP format is currently supported'') and the URL<br>'''NOTE''': You can select the default video format in ''default_video_format'' under the ''[scheduler]'' section of the ''/share/OpenNMP/.onmp/config.ini'' configuration file.
<br>
* 5- To start immediately the recording, press the Record button. The video file is stored under the video folder set in the ''/share/OpenNMP/.onmp/config.ini'' file. New recording erases the previous one.<br>
<br>
* 6- For weekly recording, ticks the days of the weeks. At the end of the recording, a new event is automatically setup for the next recording. Event that are not weekly repeated are removed from the list at the end of recording.<br>
<br>
* 7- Set the begin and end of the event. For a weekly event, use the first day of the event.<br>
<br>
* 8- Use these buttons to Enable or Disable the Scheduler. A LED displays the current Scheduler's status.<br>
<br>
* 9- Select from the drop list, the schedule event to REMOVE or to PAUSE (''paused events remain in the list but are not processed by the Scheduler'')<br>
</blockquote>
=== Electronic Program Guide (EPG) ===
<blockquote>
There are mainly two ways to get an EPG.
* Read the '''EPG from the source''' (''but this is ISP's dependent and requires lot of formating to display the HTML pages'')
* Read the '''EPG from a Internet Guide''' using a grabber such as XML-TV (''but the grabber strongly rely on an accurate HTML formatting of the event's pages '')
Therefore, retrieving an EPG is not straightforward and may easily fail. It will be faster to read an HTML Guide and get the event information.<br>
<br>
Here are useful websites that provide TV Guides for free (''feel free to add one for your country'')
* '''France''' : http://www.telepoche.fr/listing.html
* ...
</blockquote>
</blockquote>
== Schedule an Internet Radio recording ==
<blockquote>
To access the Internet radio scheduler, click the Internet Radio icon in the main Menu or navigate to the Media Services NPKG configuration page.<br>
Based on '''StreamRipper''', the recording is very ''SMART'' and the Internet radio stream is automatically split into tracks where MP3 files are named according to the Shoutcast's titles (''Author/track''). The raw stream is also recorded as well as the CUE file.<br>
<br>
<span style="color: darkred">'''NOTE''': RAW and CUE files doubles the size required for the recording. You have to delete the non longer needed files to save disk place.</span>To rip a single file and disable the individual track files recording, set the '''audio_tracks''' parameters to FALSE in the [''scheduler''] section of the ''/share/OpenNMP/.npkg/media_services/media_services.ini'' configuration file.<br>
<br>
[[Image:OpenNMP_Scheduler_3.jpg|thumb|400px|center|Schedule a Internet Radio recording]]
<br>
'''NOTE''': Audio files are stored in the ''/share/Music/RRecording'' folder unless specified otherwise in '''audio_folder''' under the [''scheduler''] section of the ''/share/OpenNMP/.onmp/config.ini'' configuration file. If there is no internal disk drive, the video files will be saved in the ''/share/Qweb/RRecording'' folder.<br>
<blockquote>
* 1- Click the URL field of the Internet Radio to copy the URL into the Scheduler.<br>
<br>
* 2- Check the Format (''AUDIO handles MP3 or Vorbis formats'') and the URL, add a short description (''e.g. Radio name'')<br>
<br>
* 3- To start immediately the recording, press the Record button. The audio file is stored under the audio folder set in the ''config.ini'' file. New recording erases the previous one.<br>
<br>
* 4- For weekly recording, ticks the days of the week. At the end of the recording, a new event is automatically rescheduled. Recording events without repetitions are removed from the list at the end of recording.<br>
<br>
* 5- Set the begin and end of the event. For a weekly event, use the first occurrence of the event.<br>
<br>
* 6- Use these buttons to Enable or Disable the Scheduler. A LED displays the current Scheduler's status.<br>
<br>
* 7- Select from the drop list, the schedule event to REMOVE or to PAUSE (''paused events remain in the list but are no longer processed by the Scheduler'')<br>
<br>
</blockquote>
</blockquote>
== Multi-purpose Scheduler ==
To access the Scheduler, navigate to the MANAGE NPKG page and select the SCHEDULER tab.<br>
ALL scheduled events (''Audio, Video and Tasks'') can be edited from this page.<br>
<br>
<br>
[[Image:OpenNMP_Scheduler_4.jpg|thumb|400px|center|Multi-purpose Scheduler]]
<blockquote>
=== Tasks scheduler ===
<blockquote>
* 1- The status of Scheduler (''blinking green or gray light'') an the status of the events are displayed on this page.<br> - '''Disabled''' : This event will not be processed by the Scheduler<br> - '''Recording''' : The event is currently recording<br> - '''Enabled''' : The event is waiting for the scheduled date<br>
<br>
* 2- The scheduled events can be:<br>- '''Edited''': Edited event are automatically re-enabled if they were previously paused.<br>- '''Paused''' : paused events are not removed from the list even if they are obsolete. They are no longer processed by the scheduler. If re-enabled without being edited for a new schedule, they will be removed from the list.<br>- '''Deleted''' : remove an event from the list<br>
<br>
* 3- Information about the record duration, repetition and format are displayed on this page.
<br>
* 4- To refresh the list of events, press this button. This will update the status of the events.
<br>
* 5- This is the Scheduler quick-edit area. You are able to Pause or Remove one item from the drop list. The drop list contains all events or may be filtered when the Scheduler is display in an application (''E.g. Internet Radio'')<br>
<br>
* 6- When the NMP is recording a content, an "animation" is displayed. Refer to the list of events to identify which event is currently recorded or check the ''Instant recording'' (''Record button is grayed''). If none is activated, this means that a Zombie recorded is still running. To stop Zombie processes Disable and Re-Enable the Scheduler (8).<br>
<br>
* 7- This is the NMP date & Time.<br>
<br>
* 8- Enable or Disable the Scheduler. This applies to all scheduled events - audio, video or tasks.<br>
<br>
* 9- Create a new event. Select the type (''Format'') of the new task: AUDIO, RTSP (''Video requires My-PVR NPKG'') or CMD (''Bash'').<br>
<br>
* 10- With the correct information set, you may start immediately a recording by pressing the record button. Only one type (''format'') of recording can be use at a time. You must stop yourself the recording by pressing the Stop button.
</blockquote>
=== Immediate Script execution ===
<blockquote>
* 4- If you select the CMD format, enter in the ''URL/Command'' field the command line for a script and press the ''Record'' button, it will execute the script.
<blockquote>
<pre>E.g. /share/OpenNMP/test.sh</pre>
</blockquote>
<span style="color: darkred">'''IMPORTANT''': to avoid any ill-intentioned user to harm your NMP using this feature, change the default admin password with a stronger one.</span>
</blockquote>
<br>
</blockquote>
= Troubleshooting =
<blockquote>
* '''My-PVR folder / Recordings are erased'''!<br>You have scheduled a nightly Remote Replication and your scheduled records and folder are erased. Change the default folder location or modify your Remote replication parameters.
</blockquote>
<br>
<br>
[[Category:Multimedia_Applications]] [[Category:NMP-1000]]
[[Category:Multimedia_Applications]] [[Category:NMP-1000]]

Latest revision as of 09:48, 30 June 2015

by AdNovea - Nov 2009
OpenNMP Homepage

OpenNMP Installation

There are four ways to install (or to upgrade) OpenNMP on your device:

  • Using MANUAL INSTALLATION with the Distribution packages (OpenNMP-xxxx.zip)
    Extract the 3 files (README, Installer.sh and onmp.tgz) on your internal drive or a 2nd USB thumbdrive. Then execute the installer.sh script.
    This procedure shall be used for the very first installation of OpenNMP .


  • Using full AUTOMATIC INSTALLATION from the OpenNMP Remote repository (available with version 0.3.20 and above)
    Goto the Manage NPKG page of the OpenNMP Administration interface. Check (and only check) the OpenNMP Engine to install under [SPECIAL] OpenNMP Engine Upgrade section, select ONLY UPGRADE OpenNMP Engine from the drop list and press APPLY.
    You will be asked to reboot your device to complete the installation/upgrade.
OpenNMP Upgrade.jpg


  • Using ASSISTED INSTALLATION with the upload feature of MANAGE NPKG page
    Download the (OpenNMP-xxxx.onmp) archive from the forum and copy the file on your PC local disk. Upload the file using the Install a new NPKG Plug-in or Upgrade OpenNMP section on the MANAGE NPKG page of the OpenNMP Administration interface and press INSTALL.
OpenNMP Upgrade 2.jpg


  • Manual installation of a Build package (OpenNMP-xxxx.onmp)
    Copy the file at the root directory of your USB device and proceed with the manual installation using the command below:
    ./autorun --upgrade OpenNMP-xxxx.onmp


OpenNMP Configuration

OpenNMP configuration is defined into to the <your_usb>/.onmp/config.ini file.
The parameters are self-explained. Most of these parameters are managed through the Administration interface pages.
Nevertheless, some parameters shall be set directly in the configuration file:

  • Turn off the sound (onmp.beeper)
  • Force IPV4 if not using IPV6 for quicker downloads (force_ipv4)
  • Change uploaded file size limit (php.upload_max_filesize & php.post_max_size)


Under the Hood

For a quick understanding of the OpenNMP architecture, we provide here below three snapshots. They are subject to evolution along with the OpenNMP versions.

ONMP Hood1.jpg
ONMP Hood2.jpg
ONMP Hood3.jpg