Chapter 10. New Installation

If you are new to the world of PostNuke or CMSs, WELCOME! You are about to embark upon a very exciting journey. Grab a big cup of coffee, sit back, and let's get this installed and configured!

Ensure that your system has the required software (and, optionally, the recommended software) installed and working before attempting installation of PostNuke.

Step-by-step: First-time installation of PostNuke

-or-

* If you plan to offer multiple languages, download and install the appropriate 
language packs. English is included in the distribution by default. Language 
packs and installation instructions can be found on SourceForge's PostNuke 
page: http://sourceforge.net/projects/post-nuke under "Files".

* If you have a logo graphic for your site, upload it to the images directory 
(for example, /var/www/html/images). You may name the file anything you want. 
If you do not yet have a logo, you may skip this step and the default PostNuke 
logo will be displayed. Generally, the dimensions of this file should be 220 
pixels wide by 80 pixels tall to fit into most pre-made themes. However, if you 
are satisfied with how a larger graphic looks, you may use a logo graphic that 
ignores these size recommendations. This graphic file is displayed at the top 
of the page within some themes, and at the top of every page that is printed 
from your site. 

The graphic file must be located in the /images/ directory of your web site or 
within the theme's /images/ directory. The graphic file can be in PNG, GIF, or 
JPG format. The canonical location will be determined in a future release.

* Set the following permissions on these files located in your web directory:
- "chmod 666 config.php" (Windows: Remove the read-only file attribute 
with "attrib -r config.php". If using NTFS, be certain that the proper NTFS 
permissions are set.)

- "chmod 666 config-old.php" (Windows: Remove the read-only file 
attribute with "attrib -r config-old.php". If using NTFS, be certain that the 
proper NTFS permissions are set.)

* Point your browser to the installation file (for example, 
http://www.yoursite.com/install.php).

* Follow the prompts to create databases, tables, and configuration options.
- Select your language from the drop-down list. Click "Set Language" to 
continue.

- Read the license. Click "Next" to agree with the license terms and 
continue installation. If you do not agree with the license terms, abort the 
installation.

- CHMOD Check: PostNuke checks to make sure that critical files are 
appropriately writable in the web directory. If no errors are reported, click 
"Continue". If there are errors reported, correct them and click "Re-check" to 
perform the CHMOD check again.

- Database configuration
- Database Host: Enter the name of the host system where the 
database files will be stored. This is the <dbhost> that was defined in 
Appendix A. If your database is on your local machine, this entry will usually 
be "localhost".

- Database Username: Enter the database username that will be 
used to add, edit, and delete records from the database. This is the <dbuser> 
that was defined in Appendix B.

- Database Password: Enter the database password for the user 
defined above. This is the <dbpass> that was defined in Appendix B.

- Database Name: Enter the name of the database to be created. 
This is the <dbname> that was defined in Appendix A. Entry example: "postnuke".

- Table Prefix (for Table Sharing): If you wish to prefix the 
table names, enter the prefix here. For most users that are not sharing tables, 
the recommended entry is "nuke".

- Database Type: Select the database type from this drop-down 
list. Entry example: "MySQL"

- Site is for intranet or other local (non-internet) use: Check 
this box if this site is intended for intranet or other local (non-internet) 
use.

Click "Continue" to move to the next step.

You are presented a review of the database configuration selections that you 
just made. If they are incorrect, click "Change Info" to modify the selections. 
If the settings are correct, click "New Installation" to begin the installation.

- If you were able to create the database as directed in Appendix A, leave 
"Create the database" box UNCHECKED and click "Start".

- If you did not create the database as directed in Appendix A, and have root 
access to the database, check the "Create the database" box and click "Start".

- If you do not have root access, you must create the database manually and the 
installation script will automatically add the tables. See Appendix A for 
assistance with creating the database.

- If you are not sure if you have root access or not, check the "Create the 
database" box and click on "Start" to try it.

If you receive an error such as "Unable to make database", then you do not have 
root access to the database and will need to create the database in another way 
before the installation can continue. See Appendix A for assistance with 
creating the database.

Once the database has been created, installation can continue and the tables 
will be created. Click "Continue" to move to the next step.

You can now set up an Administrator account. If you skip this step, the login 
for the Administrator account will be username: "Admin" and password: 
"Password" (case sensitive). However, it is very strongly advised that you set 
up an Administrator account now.

- Admin Login: Enter the login name of the Administrator here. The name 
that is entered is displayed as a user on the site. Pick an appropriate name. 
Entry examples: "siteadmin" or "joesmith".

- Admin Name: Enter the full name of the Administrator here. Entry 
example: "Joe Smith".

- Admin Password: Enter the password for the Administrator here.

- Admin Password (verify): Enter the password for the Administrator 
again here to verify that the correct password is saved.

- Admin Email: Enter the full email address for the Administrator here. 
Entry example: "admin@yoursite.com".

- Admin URL: Enter the URL for the Administrator here, including 
"http://". Usually, the URL will be the site that the Administrator is 
administrating. Entry example: "http://www.yoursite.com".

IMPORTANT NOTE: Write down the Administrator name & password. You will need 
them later.

Click "Set Login" to save this information. You will be notified that the 
update was successful. Click "Finish" to continue.

Click "Go to your PostNuke site" to enter your PostNuke site for the first 
time. Skip down to "TESTING THE INSTALLATION/UPGRADE", below.