Command-line interface

The command-line is the Linux default user interface. It is used to maintain the operating system. Therefore also cherryEPG is using this way of performing jobs.

Login as cherryepg user before running any cherryEPG related maintenance tasks!

The command-line tool for maintenance is cherryTool. By various parameters and switches you can define the behavior of the tool. You can always run cherryTool -hto get a short command-line switch overview.

cherryTool - ver. 1.71 Copyright 2021 Bojan Ramsak                  
Usage:
     cherryTool [options] -[gdiprwx zero or multiple channel_id]           
                                                                
Options:
     -v         use verbose output mode

     -h         show this help
     -V         show version and configuration info
     -R         systemcheck and report
     -N         systemcheck and notify to log
     -S         show detailed database statistics
     -I chunk   inspect chunk and generate mosaic.png
     -Z msg     send ERROR record to log for testing

     -L scheme  initialize EPG database and load scheme
     -l scheme  load scheme into existing database (do not remove existing services and events)
                every imported scheme is copied to archive
     -f         show last(newest) scheme in archive
     -F         list scheme in archive
     -e file    export scheme to file
     -H host    set host as target when converting xls to scheme (used to select sheet)
     -c xls     convert xls scheme file to yaml scheme

     -C         list content of carousel
     -u file    add/upload .gz file to carousel
     -p chunk   play TS chunk
     -s chunk   stop playing TS chunk
     -y         clear carousel - EIT only {eit_???.cts}
     -Y         clear carousel - ALL

     -G target  grab&ingest by target: all, daily, hourly, weekly
     -M         make all output EIT chunks
     -B         build all output EIT chunks (forced make)
     -g id      grab service schedule data
     -d id      delete all files for service (not directory itself)
     -i id      ingest (parse) files for channels from ingest directory
     -a id      parse files for channels from ingest directory and just return result DON'T INGEST
     -r id      reset by deleting *.md5.parsed files
     -w id      wipe/remove service definition and data
     -x id      export events for service in XMLTV format to file {service_id.xml}

     -T         reset all tables in database to empty state (drop+init)
     -t         delete section and version table (force at next build)
     -D         delete ingest
     -P         delete all output rules

     -o         delete all .ets from carousel
     -O         cleanup database (events, logs)

     -W         run the web server

Description:
    "cherryTool" is a command-line interface to cherryEpg.pm, which it uses
    to perform all the work of grabbing, ingesting and building Epg.

    cherryEpg will look for a configuration file before reading its command
    line parameters. The default location is "$USER_HOME/config.yml".