Home | Members Center | Community & Support Forum | Contact us
  Welcome to iBSupported.com  
  Navigation
    Forums
Snake II
Places of interest
Our banners
   
  Tutorials
    ModCP options
Install guide
More
Soon
   
  Other
    Let us know where you are from - sign the guest map.


   
  Stats
    Number of users active on our forum
1 guests, 0 members making a total of 1 users


Board statistics
We have a total of 45832 posts
(made up of 6624 topics with 39208 replies)
Last Post
   
  Online Users
   
   
  Activity list
   

There is no event scheduled in the calendar for the next 15 days
   
 
   
   
  Installation guide  
   
Welcome to the Ikonboard installation guide.
This guide will walk you through the Ikonboard installation procedure and get you started with
your board.

   
     
 
  Getting started  
   
Make sure you have the latest Ikonboard version available already downloaded.
Unzip the download package with your favourite unzip program. Ensure that the filenames are kept intact during the unzip process. If you end up with file names like: IKONB~1.cgi, you'll need to edit your unzip programs preferences to preserve the original filenames.
Take a moment to familiarise yourself with the files. Open the directory called 'iB3_UPLOAD', it should contain the following:

   
     
 
  File Structure  
   
iB_UPLOAD
  |- cgi-bin
    |- BACK_UP
    |- Data
    |- Data.tar
    |- Database
    |- Database.tar
    |- ikonboard.cgi
    |- ikonboard.conf
    |- index.html
    |- installer.cgi
    |- INSTALL_DATA
    |- install_modules
    |- Languages
    |- Languages.tar
    |- non-cgi.tar
    |- Skin
    |- Skin.tar
    |- Sources
    |- Sources.tar
  |- public_html
    |- iB_html
        |- uploads
        |- non-cgi

   
     
 
  Uploading the Ikonboard Files  
   
For this step, you'll need a good FTP client. Try Smart FTP for Windows based operating systems and InterArchy for Macintosh. (Note: we are no way affiliated with these companies, these are the popular choice according to the ikonboard community.)

Uploading: Step 1
Creating the new directories

Using your FTP client, navigate into your cgi-bin. (If you do not have a cgi-bin, create a new directory called 'cgi-bin' on your server. CHMOD this directory to '0755' [ see 'Figure A' ]).

You should be in your cgi-bin directory. If you have other scripts in your cgi-bin, you may wish to create another sub directory called 'ikonboard'. If you create this directory, CHMOD the directory to '0755' [ see 'Figure A' ].
This guide will call this directory your 'ikonboard CGI directory'.
 
Figure A:Permission Settings for '0755'



Figure B:Permission Settings for '0777'

You should now be in your ikonboard CGI directory. Create the following directories:
BACK_UP, Data, Database, INCOMING, INSTALL_DATA, install_modules, Languages, OUTGOING, Skin and Sources
Now CHMOD the directories you have just created to '0777' (See Figure B).

   
     
 
  Uploading the Ikonboard Files cont  
   
Uploading: Step 2
Uploading the ikonboard CGI directory files

Upload the contents of the INSTALL_DATA directory from the un-zipped zip file on your computer into the newly created INSTALL_DATA directory on your server. All of these files should be uploaded in ASCII.

Navigate into the INSTALL_DATA directory on the server. CHMOD all the files [ board_rules.dat, cgi_path.html, cgi_url.html, email_template.dat, index.html, mem_groups.dat, non-cgi_path.html, non_cgi_url.html ] to '0777' (See Figure B).

Upload the contents of the install_modules directory from the un-zipped zip file on your computer into the newly created install_modules directory on your server. All of these files should be uploaded in ASCII.

Navigate into the install_modules directory on the server. CHMOD all the files and directories to '0777' (See Figure B).

Navigate back to your ikonboard CGI directory.

Now upload all the *.tar files [Data.tar, Database.tar, Languages.tar, non-cgi.tar, Skin.tar, Sources.tar ] in BINARY. CHMOD these files to '0777' (See Figure B).

You should still be in your ikonboard CGI directory.
Upload ikonboard.cgi and installer.cgi (or ikonboard.pl and installer.pl if you've changed the suffix). in ASCII. CHMOD these files to '0755' (See Figure A).

NOTE: Your webhost may use a different set of permissions to execute perl scripts. Please double check with your webhost if you are unsure.

Upload ikonboard.conf in ASCII. CHMOD this file to '0777' (See Figure A).

Uploading: Step 3
Creating a directory in the 'public_html' part of your webspace

Navigate into the public_html directory on your server. You should see all the webpages from your webiste in this directory.

Create a directory called iB_html.

CHMOD this new directory to '0777' (see Figure B)

Create a directory called uploads inside the iB_html directory and CHMOD to 0777.
Create a directory called non-cgi inside the iB_html directory and CHMOD to 0777.

CHMOD this new directory to '0777' (see Figure B)

You have now completed all the file uploads needed to install Ikonboard.


   
     
 
  Finishing the Installation  
   
Once the file upload steps have been completed, run the installer. To do this, open up a new browser window and type in the URL to the installer.cgi (ie: www.domain.com/cgi-bin/ib3/installer.cgi).

Once the Ikonboard Installation Wizard has loaded, you can begin to configure the options.
You should be able to leave the top table alone (with the installation options). If you are unsure of your correct paths, check with your web space provider - they will know. Once you are happy that the information is correct, submit the form. This step may take up to 5 minutes

Follow the rest of the directions to set up an administrators account.

Once you have logged into your AdminCP, please remove the installer.cgi program from your server. Leaving it there is a big security risk.
Enjoy!

   
     
 
  Windows/NT Server Tips  
    Running .cgi files as .pl

Although it only takes a few minutes to allow NT servers to run CGI scripts as ".cgi", most NT servers only allow ".pl" extensions to be executed. If this is the case, then rename "ikonboard.cgi" and "installer.cgi" to "ikonboard.pl" and "installer.pl" now.


   
     
 
 
  Terms Used and Tips  
   

Uploading Information

FTP is an acronym for File Transfer Protocol. FTP is a method of tranferring files from your local machines hard drive to the remote (the server) machines hard drive.

ASCII mode is 'plain text'. Examples of ASCII files would be 'HTML', 'Javascript', 'PHP' and 'Perl' scripts.

BINARY mode is used for graphic files such as 'jpeg', 'png' 'gif' and other data types such as 'Archived Files (.tar)' and 'Compressed Files (.gz)'.

CHMOD is a unix command to alter the permissions set on a file. You can set the 'read', 'write' and 'execute' from your FTP client. Note: CHMOD is not needed when using Win/NT servers

public_html is the term this install guide uses for the default directory webpages (such as HTML) are served from. 'htdocs' is another common name for this directory.

cgi-bin is the term this install guide uses for the directory that contains the executable perl scripts. If you don't have a cgi-bin, your server can execute scripts from any directory.

Ikonboards file types

.tar files are "Tape ARchives", based on the tape back-up devices used by early Unix platforms. It's an extremely useful way to transport many files WITHOUT compression whilst retaining the original file names, data and permission settings. One .tar file could contain tens, hundreds or even thousands of files.
These files are always uploaded in binary.

.cgi files are 'Common Gateway Interface' files. A common misconception is that CGI is a language. This is not true. A CGI is a server process, many different languages can be run as a CGI process including Perl and PHP.
These files are always uploaded in ASCII (Text).


   
     
 
Copyright © 2002 iBSupported - Legal Policy