Post-Nuke on E-Smith How-To. Installation and Removal

Post-Nuke on E-Smith How-To Part 1 : Installation (Part 2 : Removal at end of document)

How to install Post-Nuke "Mutant" release - on an E-Smith / Mitel Server

Version

1.0.2 – December 17, 2001

Changelog:

Combined Installation and Removal How-To’s. Title change to reflect versioning of PostNuke. Added copyright information

Author:
J-L Boers

Contributors:
Dan Brown
Tim Litwiller
Steve MacGregor
Blake Heinemann
Mahmood Al-Yousif

Situation:
You want Post-Nuke, a PHP content management solution, for your website hosted on an E-Smith Server.

Assumptions:
You are running E-Smith Server version 4.1.2 or Mitel SME 5.0
You downloaded the Post-Nuke file to your E-Smith server from Post-Nuke.com
Get the file mutant_dot_sixty_three.tar.gz here.

Solution:
Step 1: (For installation in the primary i-bay)
Decide if you want to use PHP-Nuke on your primary i-bay directory or on another i-bay.
If primary i-bay is your choice, go to step 2.

Step 1a: (For installation in another i-bay)
Create a new i-bay in e-smith-manager. Set the new i-bay with full permissions from the entire internet - no password, then proceed to Step 2a

Step 2: (For installation in the primary i-bay)
If you want it on your primary i-bay, you must upgrade the e-smith-base rpm to version 4.4.0-26. This is not needed on Mitel SME 5.0 .
This will allow you to execute PHP content in the primary i-bay.
To download the file to your E-Smith server and install it,perform the following:

# rpm -Uvh ftp://ftp.e-smith.com/pub/e-smith/current/updates/RPMS/noarch/e-smith-base-4.4.0-26.noarch.rpm
NOTE: the above command is all on one line.

# /sbin/e-smith/signal-event post-upgrade

# /sbin/e-smith/signal-event reboot

Step 2a: (For installation in another i-bay)
Setup a new virtual domain using the e-smith-manager to use that i-bay

Step 3:
Login to your e-smith console as root. You can do this on the server itself by pressing ALT-F2 to switch to a console screen or you can do it remotely via a SSH/Telnet session from a remote machine.

Step 4:
Create the new database in mysql."mutant" is the name of the database we will create just for Post-Nuke.

# mysqladmin CREATE mutant
(NOTE: You can call the database anything you like. Just remember the change you made)

You can verify at this point that you created the new database by typing in the command:

# mysqlshow

You should see "mutant" as one of the databases listed.

Step 5:
Make a user other than root to handle the "mutant" database. You can do it with the user "root" however it is smarter to have another user for this function. In this example we will make a new user called "nuke". You should log into mysql as user "root". The root password can be found in the file /root/.my.conf . Jot down this password as you may need it to log in to mysql.

# mysql -u root

You will now be at a mysql prompt.
Example: mysql> _

Add the new user by entering the grant statement at the mysql prompt as follows:

mysql> grant all on mutant.* to nuke@localhost identified by 'password_for_nuke';
(NOTE: You can call the user anything you like. In this case nuke@localhost. Just remember the change you made)

Type quit to exit mysql

Verify the new user account by logging back into mysql as follows:

# mysql --user=nuke --password=password_for_nuke

If it took, and you got to a mysql> prompt, you successfully made the new user. Exit mysql by typing quit .

Step 6:
Copy the Post-Nuke file you downloaded to the /home/e-smith/files/primary/html directory.
or.. /home/e-smith/files/ibays/ibay_you_created/html (if installing to an i-bay)
Please note that the mutant tar file is double tarred. So you need to un-tar it twice.
Also note that you will need to move all files and directories up two levels.

# cd /home/e-smith/files/primary/html
or
#cd /home/e-smith/files/ibays/ibay_you_created/html

# cp /path/to/mutant_dot_sixtytwo.tar.gz . (that's filename.tar.gz - space - period )

# tar -xzvf mutant_dot_sixtythree.tar.gz

# tar -xvf mutant_dot_sixtythree.tar

#cd /home/e-smith/files/primary/html/mutant/html
or
# cd /home/e-smith/files/ibays/ibay_you_created/html/mutant/html

# mv * ../..

# cd ../..

Step 7:
You should now be in the top-level ../html directory. Change the ownership and permissions on config.php

# chown www config.php

# chmod 600 config.php

Step 8:

# pico config.php

Edit the config.php file and change the following fields:

dbuname <-- in our example this is user nuke
dbpassword <-- the password you made for user nuke
dbname <-- in our example, the database name is mutant

After you are done editing the fields, press Ctrl-X to exit pico. You will be prompted to save the file.

Step 9:
Move on to the installation via a web browser.
Point a browser to:

http://yoursite.com/install.php

You should now have the installation web page show up in your browser. Follow the prompts and enter the relevant info as required. When you get to the section where you press the "Make DB" button, make sure you do not check the checkbox to make the database. You already did this earlier.

Step 10:
You should now have a running site. Point your browser to

http://yoursite.com/admin.php

Here you can start to configure your site

Step 11:
For security purposes, you should delete the install.php file or alternatively chmod 0 it so you can get it later if needed.

# rm install.php
OR
# chmod 0 install.php

You're Done!

Part 2 : How-To describing how to remove Post-Nuke , "Mutant" release, from your E-Smith Server and Gateway version 4.1.2 or Mitel SME 5.0 .

Author:
J-L Boers

Problem:
You need to remove Post-Nuke - "Mutant" release -from your website hosted on an E-Smith Server version 4.1.2 or Mitel SME 5.0 .

Assumptions:
You are running E-Smith Server version 4.1.2 or Mitel SME 5.0
You can get to a console on your E-Smith / Mitel box.

Solution:
Step 1:
Login to the console as root. You can do this on the server itself by pressing ALT-F2 to switch to a console screen or you can do it remotely via a SSH/Telnet session from a remote machine.

Step 2:
Change to the directory where your Post-Nuke site is.

# cd /home/e-smith/files/primary/html
or
# cd /home/e-smith/files/ibays/post-nuke_ibay/html

# rm -Rf *

Step 3:
Now we delete the database that was used for your Post-Nuke Site.

# mysqlshow

You should see "mutant" as one of the databases listed.

#mysqladmin drop mutant

Answer "y" to the "Are-you-sure" question.

# mysqlshow

You should no longer see "mutant" listed.

You're Done!

Many thanks to all the folks who helped me write and check this How-To. Useful sites were the mysql FAQ's at www.mysql.com and the e-smith discussion phorums at www.e-smith.com

This document is copyrighted (c) 2001 by Jean-Louis Boers. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is available at http://www.gnu.org/copyleft/fdl.html.