The Official PostNuke Installation & Getting Started Guide: Revision 9939 / Preview
Prev |  | Next

# 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

- Print this document and keep it handy during the installation.

- Create the database that PostNuke will use. See Appendix 1 for assistance with this step.

- Create the database username and password that PostNuke will use. See Appendix 2 for assistance with this step.

- Obtain the latest PostNuke release from http://www.postnuke.com in either ZIP or TAR.GZ format. Download the release to a temporary directory. Under *NIX, TAR.GZ is the preferred format since the files will possess the correct user privileges.

- Using your compression program, VIEW the distribution file to make sure it will expand the files into the correct subdirectory path.

- Extract the PostNuke archive into a temporary directory. Move the /html and /sql directories into your DocumentRoot (as specified by Apache) (for example, /var/www/html), preserving paths (for example, "`tar -xzvf $lt;PostNuke-archive.tar.gz$gt;`", "`mv -R html /var/www/`", "`mv -R sql /var/www/`").

-or-

- Upload the extracted PostNuke files into your web directory, preserving paths.

* 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.

Prev | Home | Next
Assumptions & Conventions |  | Upgrade Installation