Inside your iB zip file, you should see the following folders :

DOCS          iB2-iB3_Upgrading          iB3_UPLOAD          TOOLS          upgrading

          If you have never installed ikonboard before, or are not sure what your sendmail path, or directory paths are, then you will want to go into the tools folder first, then into the HELP folder to find the () perl_test.cgi script. If you have installed ikonboard before, and know all your paths, please skip to Step 2. Sign into your site with your FTP client and look for a cgi-bin. Here are a few examples of what you might see. Please find the one closest to your directory structure and follow it based upon color references. Dark Green will represent your html folder and Blue will represent your cgi folder.

              If you do not see a cgi-bin, or a folder named cgi or something similar, then you will need to make one, as long as you know your host supports cgi. Create the folder and () CHMOD it to 755.  ** Please Note : Windows servers do not accept CHMOD values. The steps discussing CHMOD may be skipped if your site is hosted on a Windows server. **

              Upload the perl_test.cgi script into the cgi-bin in ASCII mode and CHMOD it also to 755. Now pull the test script up in your browser window. Your URL would look something like this : http://yourdomain.com/cgi-bin/perl_test.cgi.

           Once you have pulled it up in your browser window, you should see these items listed on the page if the script has been allowed to work. Remember yours will be different depending on how your host is set up :

Ikonboard Perl Checker
--------------------------------------------------------------------------------
The following results were returned

Is Perl Version 5 or above installed? Yes
Version of Perl running on this server: 5.006001
Is the CGI.pm module installed?: Yes
Version of CGI running on this server: 2.752
Is the DB_File installed on this server to allow DBM's to be used? Yes
Is the DBI package installed, allowing the use of MySQL? Yes
Full path to this script: /home/user/public_html/cgi-bin
Sendmail Path: /usr/lib/sendmail

That's it, you can run ikonboard if the Perl version is greater than 5!

              If No is listed for question 5, then you will not be able to run ikonboard on your server. You will need to contact your host, if possible, and ask them to install that module.

              If question 6 is No, then you will still be able to use the DBM version of ikonboard.

              The "Full path to this script:" shows you your cgi-path, which you will want to make note of, as you will need that when running the installer. The "Sendmail Path:" is also something you will need to make note of to run the installer.

              If you see a bunch of code on the page when you go to access the script, the the site or directory is not configured for Perl usage, and you will be unable to run ikonboard on your server.

              If you get an Internal Server Error, please check first to see if you CHMOD the file correctly. It should be RWXR_XR_X or 755. If it is CHMOD correctly and you still get an Internal Server Error, then check to make sure your cgi-bin has also been CHMOD correctly to 755. If the error occurs still after checking those two things, then you will need to contact your host, as something has not been configured correctly or they may not support cgi scripts.

          If everything checks out OK to this point, then you are ready to proceed to Step 2. Please note : You may wish to keep this open in a separate browser window during the install process, as you may need to reference the send mail and directory path during the run of the installer script.

These are two examples of the CHMOD values you will use during the installation of Ikonboard. Depending on the FTP client you have chosen, the placement of "Owner", "Group", & "Everyone" may be different and "Everyone" may be replaced by "World". The effect is no different, regardless of what it's called, so long as you understand what value you are giving your files and to whom.

Example of "755"

Example of "777"

          Now it's time for the good stuff. Please read the instructions below and follow them very carefully. 97% of all installation problems are avoidable by paying attention to the instructions.

          Navigate into your iB3_UPLOAD folder. This is what will be in that folder :

cgi-bin       BACK_UP            index.html       Data            index.html       Database            index.html       INCOMING            index.html       INSTALL_DATA            board_rules.dat            email_template.dat            mem_groups.dat            ssi_templates.dat            cgi_path.html            cgi_url.html            global_template.html            index.html            news.html            non-cgi_path.html            non-cgi_url.html            register.html            tiker.html            help.txt            mysql_schema.txt            oracle_schema.txt            postgres_schema.txt (continued in next column)	install_modules            Archive                 Compress                      Zlib.pm                 index.html                 Tar.pm            admin.pl            database.pl            populate.pl            start.pl            tar.pl            functions.pm       Languages            index.html       OUTGOING            index.html       Skin            index.html       Sources            index.html       ikonboard.cgi       installer.cgi       ikonboard.conf       index.html       Data.tar       Database.tar       Languages.tar (continued in next column)	non-cgi.tar       Skin.tar       Sources.tar iB_html       non-cgi       uploads            Icon            index.html	Upload Types : The following files must be uploaded in () ASCII mode : *.html *.dat *.txt *.pm *.pl *.cgi *.conf The following file types must be uploaded in () binary mode : *.tar NOTE : If your FTP client allows for auto-detect, this is usually the safe way to go, though you may wish to check for your own benefit to make sure that it does upload the files listed above in ASCII format, or you may have problems with your board.
		Legend Directory (folder) html document undefined file type tar file text type document text file

For Windows :

              You will probably need to rename your *.cgi files to have the extension *.pl. The majority of windows servers only run pl files.

              CHMOD settings have no effect. Select all the files (including directories) in your ftp client and upload them into your cgi-bin folder on your server. (To see how to select multiple files, look here.)

              Select the iB_html folder and upload it into the place where your webpages go. This is likely to be either public_html, www, or httpdocs folder.

               Point your browser window to the location of the installer.pl or installer.cgi file and walk through the installation. Further assistance for this process can be found in the Installer Guide.

For UNIX/Linux :

             If you are using multiple cgi scripts on your server, you may wish to make a folder inside your cgi-bin just for ikonboard. The names "forums", "boards", "ib3" are a few examples of what you might name that folder. If you make one, CHMOD it to 755.

             Select all the files in the cgi-bin folder of your hard drive and upload them into the cgi-bin of your server. All your files, including those inside other folders will be uploaded into the correct place. (Most FTP programs do support uploading of a number of files together, if yours does not, make certain that you upload ALL files exactly as show in the directory tree above. To select multiple files, you can a) select the top file, hold down your shift key and select the bottom file or b) select the top file, hold down control and select each additional file individually or c) use a combination of the two.)

             Select all the folders on your server that you just uploaded (the ones in the cgi-bin), the 6 () tar files and the ikonboard.conf files and CHMOD them to 777. (Most FTP programs support this. If you cannot select multiple files, then do them individually.)

             Select the two cgi files (ikonboard.cgi & installer.cgi) and CHMOD them to 755.

             Navigate into the INSTALL_DATA folder. Select all files inside and CHMOD them to 777.

             Navigate into the install_modules directory. Highlight everything inside it and CHMOD to 777.

             Navigate into the area where your html files are stored. This will be something like public_html, www, or httpdocs.

             Select the iB_html folder on your hard drive and upload it into the html area of your web server.

             Highlight the iB_html folder and CHMOD it to 777.

             Navigate inside your iB_html folder. Select the two directories inside it (non-cgi & uploads) and CHMOD those to 777.

          You have now completed uploading and setting permissions on all the necessary files. Now you are ready to run the installer. For a walk-through guide, please go to the Installer Guide.