Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Can't connect to server (No route to host)
== About ZNC in Amahi ==
* Currently '''BETA''' in for Amahi7.
* The application makes use of your HDA first admin user. To log in to the web interface, enter that user name and the password is ''admin''. You can change the password once logged in to anything you desire.
* ZNC appears in the '''Servers''' tab so you can stop, start, and restart as needed.
* There is a [http://wiki.znc.in/FAQ FAQ] on the ZNC web site which may help with common questions.
== SSL Initial Configuration ==To enable SSL support, some manual configuration must be done. * As '''root''' user, install one dependency:{{Code|Lang=Bash|Code=yum -y install mod_ssl}}<!--* Add the following line There are a few steps you need to the end of '''''/etc/httpd/conf/httpdcomplete before ZNC is ready.conf''''' if it does not already exist: NameVirtualHost *:443-->* Change the line in '''''/etc/httpd/conf.d/####-znc.conf''''' to read (replace #### with Log into the number web interface using credentials as noted in your file name):{{Code|RedirectPermanent / <nowiki>https://znc:26244</nowiki>}}* Restart the web server:{{Code|Lang=Bash|Code=service httpd restart}}* Modify Special Instructions on the line in '''''/home/username/Applications Installed tab.znc/config/znc.conf''''' to read:{{Code|Code=Listener4 = +26244}}* Restart Expand the ZNC:{{Code|service znc restart}}* Access the web console via '''<nowiki>https://znc:26244</nowiki>'''* All connections with IRC clients app and you will be SSLsee them displayed. When you add new servers# Once logged in, ensure you precede select User Settings from the port number with a '''+'''. The default server menu on install is already set for SSL communicationthe left. '''NOTE:''' See [http://en# To be continued.znc.in/wiki/Configuration ZNC Configuration] for more guidance on customization.
== IRC Client Setup ==
=== mIRC ===
*When using the mIRC client you will need to connect to ZNC using the following command: <!--<nowiki>/server -m <yourHdaIp> -p 26244 -g gZNC -w <username>:<password> -d ZNC</nowiki>--> /server -m <!yourHdaIp> -p 26244 -g gZNC -w <username>:<password> -d ZNC
<table cellspacing="0" border="1">
</tr>
<tr>
<td><ipaddress_of_hdayourHdaIp></td>
<td>The ip address of the HDA where you installed ZNC</td>
</tr>
</tr>
</table><br />
* When using mIRC in Windows, go to the options page. Select '''Server''' and choose '''Add'''. The following window will open:<br>[[file:mirc-settings-znc.jpg]]<br /> <table cellspacing="0" border="1"><tr><th>Option</th><th>Value</th></tr><tr><td>'''Description'''</td><td>ZNC</td></tr><tr><td>'''IRC Server'''</td><td>HDA IP</td></tr><tr><td>'''Port'''</td><td>26244</td></tr><tr><td>'''Group'''</td><td>ZNC</td></tr><tr><td>'''Password'''</td><td>ZNC <username>:<password></td></tr></table><br />
=== Chatzilla (FireFox Add-on) ===
After installation of Chatzilla Add-on you can write enter the following in your browsers address bar: {{Link|Link=irc://<YouHdaIp>:26244/<channel>/?pass=<ZncUser>:<ZncUserPass>}}<br />
or
or SSL
== Client Commands ==
'''NOTE:''' Go [http://en.znc.in/wiki/Modules here] for guidance on how to use ZNC modules.
== SSL Configuration ==
To enable SSL support, some manual configuration must be done (Required '''znc.pem''' certificate is pre-installed; it can be regenerated by following [[ZNC#Generating_a_SSL_Certificate|Generate a SSL Certificate]]).
* As '''root''' user, install one dependency:
yum -y install mod_ssl
<!--* Add the following line to the end of '''''/etc/httpd/conf/httpd.conf''''' if it does not already exist:
NameVirtualHost *:443-->
* Change the line in '''''/etc/httpd/conf.d/####-znc.conf''''' to read (replace #### with the number in your file name):
RedirectPermanent / <nowiki>https://znc:26244</nowiki>
* Restart the web server:
systemctl restart httpd.service
* Modify the line in '''''/home/username/.znc/config/znc.conf''''' to read:
Listener4 = +26244
* Restart ZNC:
systemctl restart znc.service
* Access the web console via '''<nowiki>https://znc:26244</nowiki>'''
* All connections with IRC clients will be SSL. When you add new servers, ensure you precede the port number with a '''+''' (the pre-installed server is already set for SSL communication).
'''NOTE:''' See [http://en.znc.in/wiki/Configuration ZNC Configuration] for more guidance on customization.
== Generating a SSL Certificate ==
You can use the following openssl commands to generate a certificate:
openssl req -nodes -newkey rsa:2048 -keyout znc.key -x509 -days 365 -out znc.crt
cat znc.crt znc.key > znc.pem
Copy this file to your '''/home/username/.znc''' directory (replace ''username'' with your first admin user name) and restart ZNC:
systemctl restart znc.service
'''NOTE:''' See [http://wiki.znc.in/Cert ZNC Cert] for more guidance on certificates.
== Backup Personal Settings ==
You can have your setting automatically backed up or do it manually. This script will email them to you as a compressed file.
* Install a few dependencies:
yum install p7zip mailx
* Create <b>znc-backup.sh</b> and place it in /var/hda/web-apps/znc/html directory (ensure you change the USER as noted below):
<pre>
vi /var/hda/web-apps/znc/html/znc-backup.sh
</pre>
<pre>
#!/bin/bash
### You can change this if you want
USER=`/var/hda/platform/html/script/first-admin`
MAILADRESSE1=root
YOUREHOST=localhost
### Facultatif change :
DIR=/home/$USER/.znc
TAR_PATH=`whereis tar | cut -d ' ' -f 2`
p7zip_PATH=`whereis 7za | cut -d ' ' -f 2`
SendEmail_PATH=`whereis mailx | cut -d ' ' -f 2`
DATEI1=$(date +%Y-%m-%d)_znc_backup.tar
DATEI2=$(date +%Y-%m-%d)_znc_backup.tar.7z
DATUM=$(date +%Y-%m-%d)
sevenzp="a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on -mhe=on"
### no Change after here
if [ ! -d "$DIR" ]; then echo "You MUST change DIR variable. TAR. Visit: http://wiki.znc.in/index.php?title=ZNC_Backup"; exit 0; fi
if [ ! -x "$TAR_PATH" ]; then echo "You MUST change TAR_PATH variable. Or install TAR. Visit: http://wiki.znc.in/index.php?title=ZNC_Backup"; exit 0; fi
if [ ! -x "$p7zip_PATH" ]; then echo "You MUST change p7zip_PATH variable. Or install p7zip. Visit: http://wiki.znc.in/index.php?title=ZNC_Backup"; exit 0; fi
if [ ! -x "$SendEmail_PATH" ]; then echo "You MUST change SendEmail_PATH variable. Or install SendEmail. Visit: http://wiki.znc.in/index.php?title=ZNC_Backup"; exit 0; fi
$TAR_PATH -cvf $DATEI1 $DIR
$p7zip_PATH $sevenzp $DATEI2 $DATEI1
echo ZNC Backup from $DATUM | $SendEmail_PATH -r $USER@$YOUREHOST -s ZNC-Backup-$DATUM -a $DATEI2 $MAILADRESSE1
rm -f $DATEI1 $DATEI2
</pre>
* Make script executable
chmod 755 /var/hda/web-apps/znc/html/znc-backup.sh
* To run manually, execute the script from the /var/hda/web-apps/znc/html directory
./znc-backup.sh
* Install a cron job as your First Admin User, not root and insert the following text:
<pre>crontab -e</pre>
<pre>40 0 * * 5 /var/hda/web-apps/znc/html/znc-backup.sh >/dev/null 2>&1</pre>
<blockquote><b>NOTE:</b> This will run on Fri at 00:40 AM, but you can change to meet your needs.</blockquote>
== Troubleshooting ==
=== ZNC canCan't connect to server (No route to host) ===
If ZNC can't connect to a IRC server with the message:
Attempting to connect to [chat.freenode.net +7000] ...
You could try using the IP address of the server you are trying to connect to. For '''''chat.freenode.net''''' this IP is:
'''''140.211.166.3'''''
* Go to your [http://znc:26244 ZNC webadmin page]
* Login using your username and password
* Click on "Your Settings"
* Edit the server name in the '''''Servers:''''' text box.
ZNC will pickup this new server name the next time trying to connect (wait a minute or so).
=== Install Fails ===
If you have installed ZNC multiple times without success, perform the following as '''root''' user:
yum -y erase znc*
* Once the RPMs have been removed, perform install.
* Check ''/var/log/amahi-app-installer.log'' for details.
<br>
[[Category: Apps]]
