===== Installing VSNS Lemon =====

VSNS Lemon comes with an installation script that guides you through the entire process.  Follow all of the instructions and you should be fine.

Before you install VSNS Lemon, you must make sure that you have:
  * Created a database for VSNS Lemon to use.
  * Created a MySQL user that has access to the database.
  * Uploaded all files for VSNS Lemon.
  * CHMODed ''settings.php'' so that it is writable by PHP.  Usually this requires a setting of ''0755'' or ''0777''.  The script will alert you if ''settings.php'' is not writable.
  * CHMODed ''rss.xml'' and ''images/smilies/'' so that they are writable by PHP.  This isn't required for the installation, but you'll need it later on anyway.

==== Step 1: MySQL Information ====

Enter the information VSNS Lemon will use to access the database.

  * **Hostname** - The hostname of the MySQL server.  This is usually ''localhost''.
  * **Database** - The name of the database where VSNS Lemon will create its tables.
  * **User** - The MySQL user VSNS Lemon will use to access the database.
  * **Password** - The password of the above user.
  * **Table prefix** - The prefix for all tables created by VSNS Lemon.  Default is ''vsns''.  Combines with an underscore to produce the table name, i.e., ''vsns_news''.

After you enter your information and click **Continue**, the installer will attempt to connect to the database using the credentials you supplied.  If it can't connect, it will return you to this page and tell you why it couldn't establish a connection.

==== Step 2: Personal Information ====

VSNS Lemon does not disclose your personal information, except your name, to anyone.

  * **Your name** - This will be the default value for the **author** field when creating a new article.
  * **Your email address** - VSNS Lemon will send email notifications of new comments (if enabled) this address.
  * **Password** - The password you will use to access the Admin CP.
  * **Confirm password** - Enter the password again to make sure you typed it correctly.

If your passwords do not match, the installer will return to this page and you will be forced to re-enter the desired password.

==== Step 3: Blog Information ====

VSNS Lemon uses this information to give your blog an identity, particularly in the RSS feed.

  * **Blog name** - The name of your blog!
  * **Description** - //Optional//. A short sentence describing what purpose your blog serves.  Rants?  Technology news?  Gossip?  Philosophical lectures?  You name it.
  * **Path to blog** - The URI people will use to access your blog.  The installer attempts to detect this automatically; check to make sure it got it right.

==== Step 4: Confirm Details ====

This page presents you with all of the details you've entered (minus the passwords).  Read over them carefully before continuing.  If you desire to make any changes, use the **No, take me back!** link to go back as many steps as necessary and edit the information.

If you're satisfied, select **Yes, let's do this!** to finalize your installation.

==== Ack!  It exploded/it doesn't work/ihateyou ====

Whoa.  Calm down.  **Don't panic.**  [[ben@tachyondecay.net|Email me]] with your problem and I will try to help you out.  Please provide as specific details as possible so that I can figure out what the problem is.