Difference between revisions of "Sabnzbd"

From Amahi Wiki
Jump to: navigation, search
 
(46 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:apps]]
+
== Migration Instructions ==
=== [http://www.amahi.org/apps/sabnzbd-plus SABnzbd Plus] Upgrade Path ===
+
The purpose of this guide is to explain how to upgrade from older versions of Amahi [http://www.amahi.org/apps/sabnzbd SABnzbd] application (not SABnzbd Plus) to the new SABnzbd Plus version.  In the past the application was an RPM-based install, but that has now changed to a source-based.  This only has to be done one time.  All new versions hereafter will automatically take care of any changes needed.
The purpose of this guide is to explain how to upgrade from older versions of Amahi SABnzbd application to the new SABnzbd Plus version.  In the past the application was an RPM-based install, but that has now changed to a source-based.  This will make upgrading simpler (all files are now in '''/var/hda/web-apps/sabnzbdplus/html''').  You can do it manually via downloading (Python Source file) and extracting new files into the directory or uninstall/reinstall the Amahi one-click app as it changes (settings file will be automatically backed up and restored as well).  The older versions utilize port 25914, so the new version has been configured to use 25915.  This can be changed of course, but was done by design to allow both versions to run side-by-side for upgrade purposes.
+
 
 +
*This will make upgrading simpler (all files are now in '''/var/hda/web-apps/sabnzbdplus/html''').  You can do it manually via downloading (Python Source file) and extracting new files into the directory or uninstall/reinstall the Amahi one-click app as it changes (settings file will be automatically backed up and restored as well).   
 +
 
 +
*The older versions utilize port '''25914''', so the new version has been configured to use '''25915'''.  This can be changed of course, but was done by design to allow both versions to run side-by-side for upgrade purposes. If you change the port, it must be changed in the '''/etc/httpd/conf.d/####-sabnzbdplus.conf''' file and '''httpd''' restarted.
 +
 
  
<u>Assumptions</u><br>
+
<u>'''Assumptions'''</u><br>
You have SABnzbd (version < 0.6.10) and SABnzbd Plus (version 0.6.10) installed.
+
You have '''SABnzbd''' (version < 0.6.10) and '''SABnzbd Plus''' (version 0.6.10) installed.
  
* <u>Copy current Settings:</u>
+
# <u>Copy current Settings:</u>
** Copy '''/var/spool/sabnzbd/sabnzbd.ini''' file to your home directory.   
+
#* Copy '''/var/spool/sabnzbd/sabnzbd.ini''' file to your home directory.   
** This will allow you to read the setting you might want to incorporate in the new version.
+
#* This will allow you to read the setting you might want to incorporate in the new version.
* <u>Copy Downloads:</u>
+
#*Recommend you use the old sabnzbd.ini file as a reference for making changes to the new one.
** Copy existing downloads from '''/var/spool/sabnzbd/incoming''' (whatever directory you have set) to '''/var/hda/files/newsgroups'''.
+
# <u>Copy Downloads:</u>
** There is now a '''complete''' and '''incomplete''' folders for Downloads.
+
#* Copy existing downloads from '''/var/spool/sabnzbd/incoming''' (whatever directory you have set) to '''/var/hda/files/newsgroups'''.
* <u>Uninstall old version:</u>
+
#* There is now a '''complete''' (incoming) and '''incomplete''' (incoming/temp) folders for Downloads.
** Uninstall via Amahi Dashboard
+
#* Ensure permissions are correctly set (should match '''/var/spool/sabnzbd/incoming''').
** There may be some clean up needed
+
# <u>Uninstall old version:</u>
*** Remove init script and other files ( '''/etc/init.d/sabnzbd''', '''/usr/bin/sabnzbd''', '''/var/spool/sabnzbd''')
+
#* Uninstall via Amahi DashboardThere may be some clean up needed
*** Remove '''amahi-sabnzbd''' RPM (in ase this was not removed on uninstall)
+
#* Remove init script and other files ( '''/etc/init.d/sabnzbd''', '''/usr/bin/sabnzbd''', '''/var/spool/sabnzbd''')
*** You will find a backup of your settings from the uninstall at '''/tmp/sabnzbd.ini.bak'''
+
#* Remove '''amahi-sabnzbd''' RPM (in case this was not removed on uninstall)
 +
#* You will find a backup of your settings from the uninstall at '''/tmp/sabnzbd.ini.bak''' (in case you forgot to copy it).
  
 
If all goes well, you should now have the latest version.   
 
If all goes well, you should now have the latest version.   
  
 +
'''NOTE:''' These instructions might require some updates, so please feel free to do so.
 +
 +
== Upgrading to Latest ==
 +
 +
If you alreading running a version of the [http://www.amahi.org/apps/sabnzbd-plus SABnzbd Plus] one-click application and would like to upgrade to the latest version the procedure is simple. You need to log-in to the HDA dashboard and uninstall, then reinstall the application, your settings should be retained. As part of the uninstall procedure the sabnzbd.ini configuration file is copied to the newsgroup directory (''/var/hda/files/newsgroups''). The installation picks up this file and copies it to the sabnzbdplus install directory (''/var/hda/web-apps/sabnzbdplus/html'').
 +
 +
If you would like to maintain your queue history and bandwidth counters it is advisable to backup your administration directory.
 +
cp /var/hda/web-apps/sabnzbdplus/admin/* /var/hda/files/newsgroups/admin
 +
 +
Remembering to reverse the procedure when you reinstall the new version.
 +
 +
To avoid having to back up your administration folder on each upgrade it is possible to alter the sabnzbd.ini file such that the admin folder is located in the newsgroup directory. This can be performed be either editing the .ini file or via sabnzbdplus web interface on the config/folders page.
  
'''NOTE:''' These instructions might require some updates, so please feel free to do so.
+
If you have any problems reinstalling check that the program directory (''/var/hda/web-apps/sabnzbdplus/'') was completely deleted. This may occur if you have made any changes to the directory to include post processing scripts for other applications for example [https://www.amahi.org/apps/sick-beard Sick Beard].
  
=== Accessing [http://www.amahi.org/apps/sabnzbd-plus SABnzbd Plus] via IP Address ===
+
== Accessing via IP Address ==
 
'''NOTE:'''  Needed for using some SABnzbd remote control apps such as mynzb for the iPad
 
'''NOTE:'''  Needed for using some SABnzbd remote control apps such as mynzb for the iPad
  
* Open SABnzbd using http://sabnzbdplus
+
* Open SABnzbd using <nowiki>http://sabnzbdplus</nowiki>
 
* Navigate to the SABnzbd configuration page
 
* Navigate to the SABnzbd configuration page
 
* Ensure the option for host is set to 0.0.0.0
 
* Ensure the option for host is set to 0.0.0.0
 
* Save changes using the icon at the bottom of the SABnzbd configuration page and then restart SABnzbd.
 
* Save changes using the icon at the bottom of the SABnzbd configuration page and then restart SABnzbd.
* You should now be able to access SABnzbd using x.x.x.x:25915 (where "x" is the hda IP address and "25915" is the default port of SABnzbd when installed via the hda.
+
<br />
 +
You should now be able to access SABnzbd using x.x.x.x:25915 (where "x" is the HDA IP address and "25915" is the default port of SABnzbd when installed via the HDA).
 +
 
 +
== Troubleshooting (Amahi 7) ==
 +
If you have problems with [https://www.amahi.org/apps/sabnzbd-plus SABnzbd Plus], the configuration settings may be corrupt.  To work around this issue, do the following:
 +
* Uninstall the app
 +
* Remove the backup of sabnzbd.ini file:
 +
rm -rf /var/hda/files/newsgroups/sabnzbd.ini
 +
* Reinstall the app.
 +
<br />
 +
If all goes well, the app should be working again.
 +
<br />
 +
 
 +
-------------------------------------------------
 +
<br />
 +
SABnzbd receives NZB from sickbeard / Couchpotato but does not download
 +
* Check your newsgroup server details in SABnzbd '''Config>Servers>'''
 +
* If your newsgroup server is not shown you will need to click '''add server'''. 
 +
* Once you have entered your details and tested connection your queued download should continue to download.  
 +
* Another common cause would be file permissions on your download folders '''incomplete''' and '''complete'''.
 +
<br />
 +
[[Category:apps]]

Latest revision as of 13:49, 11 November 2015

Migration Instructions

The purpose of this guide is to explain how to upgrade from older versions of Amahi SABnzbd application (not SABnzbd Plus) to the new SABnzbd Plus version. In the past the application was an RPM-based install, but that has now changed to a source-based. This only has to be done one time. All new versions hereafter will automatically take care of any changes needed.

  • This will make upgrading simpler (all files are now in /var/hda/web-apps/sabnzbdplus/html). You can do it manually via downloading (Python Source file) and extracting new files into the directory or uninstall/reinstall the Amahi one-click app as it changes (settings file will be automatically backed up and restored as well).
  • The older versions utilize port 25914, so the new version has been configured to use 25915. This can be changed of course, but was done by design to allow both versions to run side-by-side for upgrade purposes. If you change the port, it must be changed in the /etc/httpd/conf.d/####-sabnzbdplus.conf file and httpd restarted.


Assumptions
You have SABnzbd (version < 0.6.10) and SABnzbd Plus (version 0.6.10) installed.

  1. Copy current Settings:
    • Copy /var/spool/sabnzbd/sabnzbd.ini file to your home directory.
    • This will allow you to read the setting you might want to incorporate in the new version.
    • Recommend you use the old sabnzbd.ini file as a reference for making changes to the new one.
  2. Copy Downloads:
    • Copy existing downloads from /var/spool/sabnzbd/incoming (whatever directory you have set) to /var/hda/files/newsgroups.
    • There is now a complete (incoming) and incomplete (incoming/temp) folders for Downloads.
    • Ensure permissions are correctly set (should match /var/spool/sabnzbd/incoming).
  3. Uninstall old version:
    • Uninstall via Amahi Dashboard. There may be some clean up needed
    • Remove init script and other files ( /etc/init.d/sabnzbd, /usr/bin/sabnzbd, /var/spool/sabnzbd)
    • Remove amahi-sabnzbd RPM (in case this was not removed on uninstall)
    • You will find a backup of your settings from the uninstall at /tmp/sabnzbd.ini.bak (in case you forgot to copy it).

If all goes well, you should now have the latest version.

NOTE: These instructions might require some updates, so please feel free to do so.

Upgrading to Latest

If you alreading running a version of the SABnzbd Plus one-click application and would like to upgrade to the latest version the procedure is simple. You need to log-in to the HDA dashboard and uninstall, then reinstall the application, your settings should be retained. As part of the uninstall procedure the sabnzbd.ini configuration file is copied to the newsgroup directory (/var/hda/files/newsgroups). The installation picks up this file and copies it to the sabnzbdplus install directory (/var/hda/web-apps/sabnzbdplus/html).

If you would like to maintain your queue history and bandwidth counters it is advisable to backup your administration directory.

cp /var/hda/web-apps/sabnzbdplus/admin/* /var/hda/files/newsgroups/admin

Remembering to reverse the procedure when you reinstall the new version.

To avoid having to back up your administration folder on each upgrade it is possible to alter the sabnzbd.ini file such that the admin folder is located in the newsgroup directory. This can be performed be either editing the .ini file or via sabnzbdplus web interface on the config/folders page.

If you have any problems reinstalling check that the program directory (/var/hda/web-apps/sabnzbdplus/) was completely deleted. This may occur if you have made any changes to the directory to include post processing scripts for other applications for example Sick Beard.

Accessing via IP Address

NOTE: Needed for using some SABnzbd remote control apps such as mynzb for the iPad

  • Open SABnzbd using http://sabnzbdplus
  • Navigate to the SABnzbd configuration page
  • Ensure the option for host is set to 0.0.0.0
  • Save changes using the icon at the bottom of the SABnzbd configuration page and then restart SABnzbd.


You should now be able to access SABnzbd using x.x.x.x:25915 (where "x" is the HDA IP address and "25915" is the default port of SABnzbd when installed via the HDA).

Troubleshooting (Amahi 7)

If you have problems with SABnzbd Plus, the configuration settings may be corrupt. To work around this issue, do the following:

  • Uninstall the app
  • Remove the backup of sabnzbd.ini file:
rm -rf /var/hda/files/newsgroups/sabnzbd.ini
  • Reinstall the app.


If all goes well, the app should be working again.



SABnzbd receives NZB from sickbeard / Couchpotato but does not download

  • Check your newsgroup server details in SABnzbd Config>Servers>
  • If your newsgroup server is not shown you will need to click add server.
  • Once you have entered your details and tested connection your queued download should continue to download.
  • Another common cause would be file permissions on your download folders incomplete and complete.