FAQ
42go ISP-Manager
42go SPAM-Filter
Forums
Email
Telephone
Installation

42go ISP-Manager FAQ / Knowledgebase

What is the best way to install a 42goISP-Update?

 

Normally a 42goISP-Update does not cause any problems. Since the 42go ISP-Manager is installed on a multitude of different systems and because we have heard of sporadic problems with updates which we could not reproduce in spite of testing intensively, we publish some tips/hints here that should prevent a failed update to paralyse your system.

 

Please note: Placeholders are indicated by square brackets [ ].

 

1) First make a backup of your existing (working) 42goISP installation:

Open a root shell (under Windows you can use PuTTY ( http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html ) for this task).

 

cd /root/

tar -pczf root_42go_old.tar.gz 42go/

cd /home/

tar -pczf home_adm42go_old.tar.gz adm42go/

 

If your MySQL database is protected by a password:

 

mysqldump -h [name of your server, e.g. localhost] -u [database user, e.g. root] -p[database password] -c --add-drop-table --add-locks --all --quick --lock-tables [name of the 42goISP database] > existing_db.sql (no space character between -p and password!)

 

Otherwise:

 

mysqldump -h [name of your server, e.g. localhost] -u [database user, e.g. root] -c --add-drop-table --add-locks --all --quick --lock-tables [name of the 42goISP database] > existing_db.sql

 

Save /etc/passwd, /etc/shadow and /etc/group.

 

Save /etc/init.d/42go_server and (if existing) /etc/init.d/42go_tcpserver.

You should transfer the files named above(existing_db.sql, /etc/passwd, /etc/shadow, /etc/group, /etc/init.d/42go_server, /etc/init.d/42go_tcpserver) to your workstation (e.g. with WinSCP: http://winscp.sourceforge.net/eng/ ).

 

2) Install the 42goISP-Update (see here). Do not close your root shell immediately after the update (also do not close your WinSCP window)!

Open a second root shell and check if the root login still works! If it does not you can restore the root user in the root shell you have left open (e.g. by editing /etc/passwd and /etc/shadow or by playing back your backups of these two files via the open WinSCP window). Please take care that these files keep the same privileges as before!

 

3) Open the 42goISP system in a browser and make a change (e.g. change a user's settings). After approx. 30 sec. you can check if the root login still works on the shell. If it does, you can undo the user settings change in the 42goISP system and close all shells/WinSCP windows. Your 42goISP update has been installed successfully!

 

4) If you realise with hindsight that the root login does not work on the shell you have the following possibilities to rescue your system (it is in no way necessary to format the system's hard disk and install a new system!):

 

4.1) If webmin ( http://www.webmin.com/ ) is installed as tar.gz (not rpm!), you can still login to webmin and fix the root user.

 

4.2) Boot your system from a Rescue-CD (e.g. http://sourceforge.net/projects/rescuecd/ ).

 

Login: root Password: rescue

 

Adjust your keyboard:

 

kbdmap

 

Mount the /-partition of your hard disk (mostly /dev/hda1):

 

mount -t [your filesystem, e.g. ext2|ext3|reiserfs|etc.] /dev/hda1 /mnt

chroot /mnt

 

Now you can find the passwd and shadow file under /etc and edit them in an editor (e.g. vi) or with programs like usermod. Repair your root user and reboot the system (do not forget ot remove the Rescue-CD from your CD-ROM):

 

shutdown -r now

 

4.3) If your server has a rescue mode (like the 1&1-Root-Server):

Boot your server into the rescue mode.

Mount the /-partition of your hard disk (mostly /dev/hda1):

 

mount -t [your filesystem, e.g. ext2|ext3|reiserfs|etc.] /dev/hda1 /mnt

chroot /mnt

 

Now you can find the passwd and shadow file under /etc and edit them in an editor (e.g. vi) or with programs like usermod. Repair your root user and reboot the system.

 

shutdown -r now

 

5) If you want to restore your old 42goISP system, please do the following steps:

 

/etc/init.d/42go_server stop

cd /root/

mv 42go/ 42go_new/

tar xvfz root_42go_old.tar.gz

cd /home/

mv adm42go/ adm42go_new/

tar xvfz home_adm42go_old.tar.gz

 

If your MySQL database is protected by a password:

 

mysql -h [name of your server, e.g. localhost] -u [database user, e.g. root] -p[database password] [name of the 42goISP database] < existing_db.sql (no space character between -p and password!)

 

Otherwise:

 

mysql -h [name of your server, e.g. localhost] -u [database user, e.g. root] [name of the 42goISP database] < existing_db.sql

 

Restore /etc/init.d/42go_server (and /etc/init.d/42go_tcpserver, where applicable) (e.g. by using WinSCP).

 

chmod 744 /etc/init.d/42go_server

chmod 744 /etc/init.d/42go_tcpserver (if existing)

/etc/init.d/42go_server start

 

<< Back

 
(c) projektfarm GmbH 2012 - imprint