1 Download In-Portal

Download In-Portal files and/or modules from:
http://www.in-portal.com/download.html

2 Extract and Upload Files to the Web Server

Upload In-Portal files into a directory within your web server's document root (typically “www” or “web”) or your public HTML directory where you want In-Portal to reside:

Simple Method (with an FTP client)

If you downloaded the file(s) to your computer and unpacked them locally on your computer, use an FTP program to upload all files to your server. Make sure all PHP, HTML, CSS, XML and JS files are uploaded in an ASCII mode, and image files (GIF, JPG, PNG) are uploaded in a BINARY mode.

If you don’t have an FTP client, download and install FileZilla and then connect to your web server.

After uploading files, go to the next step.

Advanced Method (command line)

If you prefer unpacking directly on the server, following the following steps:

1) Copy the tar.gz (or zip) file(s) into a working directory e.g.

$ cp in-portal_X_X_X.tar.gz to /tmp/in-portal/

If you want to install additional modules like In-Link, In-Bulletin or In-Newz, you can do so by downloading and copying them following the same rules.

For example:
$ cp in-link_X_X_X.tar.gz to /tmp
$ cp in-newz_X_X_X.tar.gz to /tmp
…

2) Change to the working directory, e.g.

$ cd /tmp

3) Extract the files, e.g.

$ tar -zxvf in-portal_X_X_X.tar.gz

If you have other module(s), repeat the commands:

$ tar -zxvf in-link_X_X_X.tar.gz
…

This will automatically create /tmp/in-portal folder and will extract all
In-Portal (and modules) files and subfolders into that folder. As the result, you should see something like this in that folder:

- admin/
- core/
- system/
- themes/
- tools/
- index.php
- other LICENSE and README files

You should also see module-specific folders (i.e. in-link, in-news, in-bulletin) if they were downloaded and extracted.

4) Move the contents of that directory into a directory within your web server's document root or your public HTML directory where you want In-Portal to reside e.g.

$ mv /tmp/in-portal/* /var/www/html

3 Create a Database for In-Portal

In-Portal uses MySQL database that needs to be setup in order for In-Portal to work. If you already have a database setup, please proceed to the next step.

If you don’t have a database setup, let’s create one using one of the two methods:

Simple Method through your Hosting Account’s Control Panel

Most web hosting accounts come with a control panel that lets you create and manage databases. Use your Hosting Control Panel or phpMyAdmin to create a database for In-Portal

1) Create a new database for your In-Portal site. Let's call it “Inportal”.

2) Create a new database user for this newly added 'inportal' database, for example “db_user”.

3) Go to next step

Advanced Method (command line)

In the following examples, "db_user" is an sample MySQL user which has the CREATE and GRANT privileges. You will need to use a user that has these access privileges for the database you want to use.

1) Create a new database for your In-Portal site e.g.

$ mysqladmin -u db_user -p create inportal

MySQL will prompt for the 'db_user' database password.

2) Next you must login and set the access database rights e.g.

$ mysql -u db_user -p

Again, you will be asked for the 'db_user' database password.

3) Grant permissions

At the MySQL prompt, enter following command:

GRANT ALL PRIVILEGES ON inportal.*
TO db_user@localhost IDENTIFIED BY 'password';

where:
'inportal' is the name of your database
'db_user@localhost' is the userid of your webserver’s MySQL account
'password' is the password required to log in as the MySQL user

If successful, MySQL will reply with

Query OK, 0 rows affected

4) Activate new permissions by entering the command

flush privileges;

5) Exit the MySQL prompt by typing

quit;

4 Run the In-Portal’s Installation

Now you ready to proceed with the installation of In-Portal through your web browser. In your web browser go to the URL where you uploaded In-portal followed by “/core/install.php”. For example:

http://www.yourwebsite.com/core/install.php

The Installation Script will guide you through the rest of the installation.

Once the installation has been completed you should have a <root-of-in-portal>/system/config.php file created in the /system folder of your In-Portal installation.

No Config File?
In some rare cases your server might be configured in way that the In-Portal installation may not be able to create the /config.php file. In this case you'll have to do it manually:

1) Copy /tools/config.php-dist file into the root folder of your In-Portal installation.

2) Rename it from config.php-dist to config.php. Make sure you do NOT have the config.php file already and if you do, rename the original one to something like config.bak.php. You can delete the old one later, once the installation has completed successfully.

3) Change permissions on config.php to 777.

4) Open the config.php in a text editor; carefully add your database information in the designated area and save it.

5) Proceed with the installation again.

You Are Done!

You can now start using and administrating In-Portal through your web browser:

Front: http://www.yourwebsite.com
Admin: http://www.yourwebsite.com/admin

You can log into the Admin Console using the username 'root' along with the password that you specified during the installation process.

Administrating In-Portal

In-Portal defaults to a basic configuration once installed. Log into the Administrative Console and use the Configuration section to configure your website’s settings and preferences. If you run into any problems, feel free to ask questions on the Community Forums as well as refer to the User’s Guide for more information.

Thank you for installing In-Portal and Welcome to the In-Portal Community!