ocPortal Tutorial: Basic Installation

Written by Allen Ellis, ocProducts

Before you begin using ocPortal, you will need to install it. Installing ocPortal is easy with our installation utility, which will be explained in detail in this tutorial.

Table of contents

ocPortal Tutorial: Basic Installation

Prerequisites

Before you install ocPortal, you will need to make sure that your host covers our minimum requirements, and a general knowledge of web applications will also help you, but is not required. You also need the following information from your web host, if you don't already.

FTP servername
FTP username
FTP password
mySQL databasename
mySQL username
mySQL password

Similar products require the same information.

If you would like to use a 3rd party system as the forums of your website, we require that you install that before installing ocPortal.

Deciding: Quick or manual install

At some point you'll need to decide which method you'd like to use to install ocPortal. You have two options, the quick installer, or the manual installer.

We highly recommend choosing the quick installer. This is a simple process, where you upload two files to your web server, then launch our installation utility from there.

The second option is the manual installer. This option requires you to manually upload all of ocPortal's files and apply permissions to them - the typical method for most CMS systems. This method takes much longer - as there is a pause for "handshaking" between each file. We maintain this version in case the quick installer fails on your host.

Preparing files

Example of "Download Now" link

To install ocPortal, you must first download it from our web site (http://www.ocportal.com/pg/download). It is generally best to choose the latest version, and, as stated above, we also recommend choosing the "quick method".

Download ocPortal by clicking the "Download Now!" link in the bottom left corner of the version you choose. Save it to a location where you'll be able to find it - perhaps the "My Documents" folder or the Desktop if you're using Windows.

After it downloads, you'll need to extract the files. The exact methods for doing this will vary based on which zip utility you use.

Using FTP

File upload demonstration

Internet Explorer FTP login

The next step is to upload the files to your web server. To do this you'll need an FTP client (such as SmartFTP or CuteFTP, or use the one that comes with Windows). The exact steps to upload the files depend slightly depending on which FTP client you choose.

If you'd like to use the one bundled with windows, open a new Internet Explorer window, and in the address bar, type ftp://username@servername.com, replacing username with your username and servername with the servername given to you by your web host. You should be presented with a login screen (if not, you can access it by choosing File > Login As), where you can enter the username and password given to you by your web host [Example ]. Then you'll need to navigate to your webroot (possibly in a folder called www or httpdocs). If you can't find your webroot, email your webhost for help.

At this point you need to decide whether you want your website to reside in your root folder or not. If you choose to place it in your root folder (which is the recommended option), people will be able to access your site by going to http://www.mywebsite.com (unless you don't own your own domain name). If you choose to place it in a subfolder (for example, "subfolder"), people will access your ocPortal installation by going to http://www.mywebsite.com/subfolder.

When you successfully connect, find your webroot, and navigate into a subfolder if you chose to, you need to upload the files that were inside the zip package you downloaded. If you chose the quick installer, these files are called 'install.php', the other is called 'data.ocp'. If you chose the manual installer, there will be many more.

Regardless whether or not you chose to make a new subfolder, you need to put these files in the same folder. This can usually be done by dragging and dropping the files from your computer to your web host in your FTP client [Example ].

Permissions

If you chose the manual installer, you now need to set the appropriate permissions for your files and folders.

If you have "shell access" (ask your web host if you don't know), then you can automatically set these permissions by logging into your server with a program like putty, and executing the file fixperms.sh.

If you don't have shell access, then you will need to manaully set each folder to the correct permissions.

Tip

Note for Linux users: If you are on a suexec-system (where the PHP script is run as your own user), 744 and 644 permissions should be suitable (with info.php being 600 for additional security).

Here are the directories that need file permissions setting:

Set the following to 777: (full directory permissions)

adminzone/pages/comcode_custom
adminzone/pages/comcode_custom/<for-each-language>
adminzone/pages/html_custom/<for-each-language>
adminzone/pages/html_custom
adminzone/pages/modules_custom
adminzone/pages/minimodules_custom
cms/pages/comcode_custom
cms/pages/comcode_custom/<for-each-language>
cms/pages/html_custom/<for-each-language>
cms/pages/html_custom
cms/pages/modules_custom
cms/pages/minimodules_custom
forum/pages/comcode_custom
forum/pages/comcode_custom/<for-each-language>
forum/pages/html_custom/<for-each-language>
forum/pages/html_custom
forum/pages/modules_custom
forum/pages/minimodules_custom
pages/comcode_custom
pages/comcode_custom/<for-each-language>
pages/html_custom/<for-each-language>
pages/html_custom
pages/modules_custom
pages/minimodules_custom
personalzone/pages/comcode_custom
personalzone/pages/comcode_custom/<for-each-language>
personalzone/pages/html_custom/<for-each-language>
personalzone/pages/html_custom
personalzone/pages/modules_custom
personalzone/pages/minimodules_custom
site/pages/comcode_custom
site/pages/comcode_custom/<for-each-language>
site/pages/html_custom/<for-each-language>
site/pages/html_custom
site/pages/modules_custom
site/pages/minimodules_custom
collaboration/pages/comcode_custom (available to enterprise version users only)
collaboration/pages/comcode_custom/<for-each-language> (available to enterprise version users only)
collaboration/pages/html_custom/<for-each-language> (available to enterprise version users only)
collaboration/pages/html_custom (available to enterprise version users only)
collaboration/pages/modules_custom (available to enterprise version users only)
collaboration/pages/minimodules_custom (available to enterprise version users only)
data_custom/modules/chat
data_custom/modules/admin_stats
data_custom/modules/admin_backup
exports/backups
exports/mods
imports/mods
lang_cached
lang_cached/<for-each-language>
lang_custom
lang_custom/<for-each-language>
sources_custom
text_custom
text_custom/<for-each-language>
themes/<for-each-theme>/theme.ini
themes/<for-each-theme>/css_custom
themes/<for-each-theme>/images_custom
themes/<for-each-theme>/templates_custom
themes/<for-each-theme>/templates_cached/EN
themes/default/templates_cached
uploads/attachments
uploads/attachments_thumbs
uploads/auto_thumbs
uploads/banners
uploads/catalogues
uploads/downloads
uploads/filedump
uploads/galleries
uploads/galleries_thumbs
uploads/grepimages
uploads/iotds
uploads/iotds_thumbs
uploads/ocf_avatars
uploads/ocf_photos
uploads/ocf_photos_thumbs
uploads/watermarks

Set the following to 666: (full read/write permissions)

data_custom/errorlog.php
data_custom/functions.dat
data_custom/spelling/output.log
data_custom/spelling/personal_dicts
data_custom/spelling/write.log
info.php
site/pages/html_custom/EN/download_tree_made.htm
site/pages/html_custom/EN/cedi_tree_made.htm
themes/<for-each-theme>/css/*.css

Remember - if you chose the quick install option, none of this permission setting is required.

Installation

The ocPortal installation screen

After you upload these files, you've completed the hardest part of the installation. The next step is to open your web browser and go to http://www.mywebsite.com/install.php (substitute 'mywebsite.com' as appropriate for your domain and install path). You should be greeted with a welcome screen, asking you which language you would like to use.

On step two, you are shown a license agreement. You must agree to the license agreement before you can install ocPortal. You also have the opportunity to sign up for our newsletter, which will notify you by email of any updates to our software. ocPortal will never sell or rent your email address to a third party. You can read our privacy policy for more information.

On step three, you are presented with a choice to choose which forum system you would like to use for your website. Choose the name of the software on the left, and then choose the appropriate version from the right-hand column.

If you would like your website to be one of many on one network, you can choose the option to install a multi-site-network. Read our multi-site-network tutorial for more information on this feature, and to decide whether or not you would like to use it.

Step 4: primary configuration

On step 4 is where the guts of the configuration happen. Fill out each of the configuration options to the best of your knowledge. If you chose the "No forums or members" option or the "ocPortal's own forum" choice, you will need to fill out less options than shown in our example.

If you are not installing any forum system, the "password" field near the top is the password that will allow you to access your Admin Zone (with the username "admin").

Tip

Pick a password that's easy to remember, yet difficult for others to guess

However, if you are installing a forum system, the password you choose here is still important, as it will be the exclusive password that allows you access to our "environment editor" - a special section of ocPortal where you can change database and host names - useful if there is ever a critical error with your website.

All of the database fields should be filled out with the information given to you by your webhost. If you would like to tweak the cookie settings, you can click the "Cookie Settings" link to open up several more options. Each other option is explained in detail on the configuration page, thus is will not be repeated here. When you finish, click the "Install ocPortal" link at the bottom of the screen.

Step 5: success message

Hopefully, at this point you'll receive this success message. If you receive any errors, return to the previous page and correct them. Click the "Proceed" button to continue through the installation. There will be 4 more similar screens until you finish the installation.

Final screen

After you finish the installation, you are presented with one final screen, congratulating you on your successful installation, and giving you two choices - you can either jump right to your new homepage, or go to the Setup Wizard.

Congratulations on your successful installation!

Concepts

Administrative password: The administrative password is a special password that will help you restore settings if something makes the traditional ocPortal interface unusable.
Multi-site networks (M.S.N.): Multi-site networks allow you to have more than one ocPortal installation (multiple websites), all running on the same network. If you choose this, members who join one website will also have registrations at other sites.