ePortal's home page

· English · Русский ·

Main menu

Installation

Install Apache, mod_perl, HTML::Mason
Install and test all of them. It's the most important part of installation!

make ePortal

    perl Build.PL [home=/opt/ePortal]
    perl Build
    perl Build install

Here home is home of ePortal where bin, comp_root, samples, images directories will be created and files copied.

 $HOME -- bin
    |-----comp_root
    |-----images
    |-----samples

Create datastore
Before you run any of ePortal's utility set some environment variables:
Unix/Linux:
```
    export EPORTAL_DBI_HOST=localhost
    export EPORTAL_DBI_DATABASE=eportal
    export EPORTAL_DBI_USERNAME=<username>
    export EPORTAL_DBI_PASSWORD=<...>
    export EPORTAL_ADMIN_MODE=1
```
WindowsNT: Use Control Panel/System to set system wide variables
The variable EPORTAL_ADMIN_MODE is used for the first start. Any user connected to ePortal WEB server becomes administrator. You need it to register the very first user to be administrator.
crontab
Install crontab. See samples/crontab as example.
logrotate
Install logrotate script. See samples/logrotate.d/ePortal as expample.
httpd.conf
Modify your httpd.conf file. See samples/httpd-eportal.conf as example. The file httpd.conf is very documented and icludes only ePortal's specific parameters.
Browse it
At the first hit on new site you will be redirected to database creation page. Whenever you install new version of ePortal it will automatically test and upgrade database tables and indexes.
Point your browser to http://your_server_name/admin/index.htm and setup menu, users and other things.
Speed UP
You may need to set anvironment variable for speed up (see Params::Validate)
```
 export PERL_NO_VALIDATION=1
```

APPLICATION INSTALLATION

Any application of ePortal is installed in the same manner as ePortal itself.

 tar zfxv ePortal-APPNAME.tar.gz
 cd ePortal-APPNAME
 perl Build.PL
 perl Build
 perl Build install

Login to ePortal as administrator and see the home page. A notification about new application will be on the administrator's section of the home page.

WIN32 INSTALLATION

Win32 environment is not so comfortable as Unix one. Do installation by your hands. I will point you to some Win32 specific tasks.

Unzip and untar distribution archive to c:\ePortal. WinZIP works for it.
Download and install
```
 Apache binaries for Windows
 ActiveState Perl
 MySQL database
 mod_perl
```
You have to download and install a lot of Perl modules. Look at Build.PL near the lines
```
    requires       => {
        'CGI'                   => 0,
        ... etc
```
Use PPM of ActiveState's Perl to install every module in the list. Some of modules are out of date at ActiveState's repository. Look at http://theoryx5.uwinnipeg.ca/ppmpackages/ for some of them.

Set some environment variables. Use Control Panel / System icon to do it.

    EPORTAL_DBI_HOST=localhost
    EPORTAL_DBI_DATABASE=eportal
    EPORTAL_DBI_USERNAME=<username>
    EPORTAL_DBI_PASSWORD=<...>
    EPORTAL_ADMIN_MODE=1

Configure your Apache server. Look at samples/httpd-eportal.conf as example.
Start MySQL, Apache and look at http://localhost/index.htm
Configure it.
Run Perl script bin/ePortal-cron.pl every 5 minutes.