docs/INSTALL

   1 INSTALLATION INSTRUCTIONS
   2 =========================
   3 (For a more friendly approach on installing, see /docs/HOWTO)
   4         REQUIREMENTS
   5                 _PHP => 4
   6                 _mySQL
   7                 File uploading
   8                 PERL REGEX FUNCTIONS
   9                 SIMPLEXML
  10
  11
  12 1. Extract all files from the .tar.gz (or other filetype) (or skip this if you downloaded via SVN) to a directory of your choice.
  13
  14 2. Visit the directory in your web browser (Firefox, Epiphany, Internet Explorer, etc etc)
  15
  16 3. You will be redirected to the /install/ directory.
  17
  18 4. Follow the onscreen instructions.
  19         NOTICE: If you are upgrading from v1, DO NOT CHECK THE "upgrade from v1.*" CHECKBOX. YOU WILL HAVE TO DO THIS *AFTER* THE INSTALLATION OF v2.
  20
  21 5. Once you are presented with the last page, it will tell you one of two possibilities.
  22         a. Complete success, and phpns wrote to the config.php file, or
  23         b. We don't have write access to config.php, so you need to paste the information yourself.
  24                 xx. Open config.php on your server/machine, and paste the code you were presented with in the last step. Save and upload.
  25
  26 6. Installation finished, visit the root of the phpns directory.
  27
  28 7. You will be reminded to DELETE THE /INSTALL/ DIRECTORY, because it has no further use. IT IS A SECURITY RISK TO LEAVE THIS FOLDER UNDELETED.
  29         NOTICE: If you wish to upgrade from v1, skip this step and continue to UPGRADING.
  30
  31
  32 UPGRADING INSTRUCTIONS
  33 ==========================
  34
  35 After you are done installing phpns version 2, you can 'transfer' all of your articles from a version 1 installation.
  36         1. Visit /install/, and check the "upgrade from 1.*", press Continue.
  37         2. Either enter the database information, or upload the mysql.php file from the v1 installation.
  38
  39 AFTER YOU ARE DONE UPGRADING, DELETE THE /install/ DIRECTORY.