Some of the installation steps for itPage require downloading and compiling source code for several image-manipulation utilities. itPage makes use of the abilities of these utilities to add broad image support.

These utilities may or may not be necessary, depending upon your requirements. If you do not have experience with downloading and compiling source code you would be well advised to get help with these steps, as it is out of the scope of this procedure and rather involved.

If you decide later to add these capabilities, it is a simple matter to change the itPage siteconfig and the System Settings to take advantage of the new utilities.

System Requirements

itPage has been tested and running on Mac OS X Server 10.4 and 10.5 installations. It has not been tested on other Lasso-supported platforms, but there is no reason it could not be installed, providing at least ImageMagick and PassThru are installed.

Requirements to run itPage are:

Lasso Professional 8.5
ImageMagick 6.4 or greater
PassThru
MySQL 5.x

Download and Install the itPage Codebase

Download the itPage codebase from Google Code, which is under Subversion version control.

itPage Repository

<http://code.google.com/p/itpage/source/checkout>

Copy the custom tags from the LassoStartup folder to the startup folder of the Lasso site that will run itPage. itPage uses some publicly-available tags from Lasso contributors, so you might want to check the tags to make sure that they do not conflict with or duplicate tags that are already installed. Restart the Lasso site to make the tags active.

Set up proper file ownership and file permissions

itPage writes files to various directories, so you might need to add the OS user 'lasso' to the group for the directories. The directories include:

/log/
/images/
/files/
and all their children.

Refer to Step 8 of Steve Piercy's file permissions guide for details: <http://www.stevepiercy.com/lasso_stuff/file_perms.lasso>

Set up the MySQL Database

Create a MySQL database named "itPage_CMS_Demo" or whatever you would like to call it. Make sure you set the default character set to UTF-8 and the default collation to utf8_unicode_ci.
Set up a unique MySQL user and password to access the itPage_CMS database.

Set up Lasso Security

Lasso Security must be set up to access the itPage database.

Set up Lasso Security. Enable the databases and set the user "AnyUser" to have all privileges.
Under Setup->Security->Files, allow all permissions for the paths "/", "///", and "///var/tmp".

Install Supporting Utilities

ImageMagick

itPage uses ImageMagick to process image uploads, and is REQUIRED. Why not use Lasso's Image tags? A separate install of ImageMagick can be updated and accessed directly for advanced features and direct manipulation, which is how itPage works.

ImageMagick can be installed on Windows, *nix or Mac OS X either from binary (double-click) installers, built using macports <http://www.macports.org/> (Mac OS X only), or compiled from source. See the ImageMagick download page for details.

ImageMagick Downloads

<http://www.imagemagick.org/script/binary-releases.php>

ffmpeg (optional)

itPage uses ffmpeg to process video uploads. If you will never handle video content, this step is unnecessary.

You can either use MacPorts (or other utility on Linux, like yum or apt-get) to build ffmpeg, or you can download ffmpeg from the ffmpeg Subversion repository and compile the code on your server.

ffmpeg via MacPorts

Download and install MacPorts.

<http://www.macports.org/>

Try this command to install ffmpeg:

sudo port install ffmpeg +lame +extvorbis +theora +faac +faad
+xvid +x264 +a52 +gpl

The path to ffmpeg will be:

/opt/local/bin/ffmpeg

ffmpeg Repository

<http://ffmpeg.org/download.html>

Alternatively try following the instructions in this LassoTech article by Pier Kuipers.

Displaying Video with Lasso and FFmpeg

<http://www.lassotech.com/Video_with_Lasso>

This discussion on LassoTalk culminated with this set of instructions.

<http://old.nabble.com/Re%3A--OT--Video-Player-Embedding-and-Recommended-Formats--SOLVED--p26975171.html>

swfTools (optional)

itPage uses swfTools for native .swf integration. If you never will handle native .swf files, this step is unnecessary.

The only one of the swfTools currently used is "swfdump".

Download swfTools from the downloads page and compile the code on your server.
Open the Lasso file siteconfig.lasso and change this values:

$svPathToswftools = swfTools install location (e.g. "/opt/local/bin/swfdump")

swfTools Downloads

<http://www.swftools.org/download.html>

Set up Apache Virtual Host

Sample Virtual Host (Apache 2.2, Mac OS 10.5 Server): <http://www.itpage.ws/wiki/files/itPage_VirtualHost.conf>

Clean URLs

itPage uses rewrite rules to allow the "clean URLs" feature to function. Add these directives to the virtual host running itPage:

DirectoryIndex "index.lasso" "login.lasso" "index.html"

# itPage Clean URL handling
<LocationMatch "(^|/)([^.]*|([^.]+\.)+[^.]{5,}|.*\.)$">
	SetHandler lasso8-handler
</LocationMatch>

Disallow serving of .inc files

This directive is needed so .inc files cannot be directly viewed in a browser.

<IfModule mod_rewrite.c>
     RewriteEngine On
     RewriteCond %{REQUEST_METHOD} ^TRACE
     RewriteRule .* - [F]
     # Disallow direct serving of .inc files         
     RewriteCond %{REQUEST_URI}  ^.*\.inc$  [NC]
     RewriteRule (.*)  - [L,NS,F]
</IfModule>

Disallow .svn Folders (optional)

This directive may be put inside of a VirtualHost container in the Apache configuration file. It protects against direct downloading of Subversion files, which contain directory, file, and other sensitive information.

# Disallow .svn directory and contents
<Directory ~ \.svn>
     Order allow,deny
     Deny from all
</Directory>

Alternatively, and for greater security, don't update a production server directly from your Subversion repository, therefore preventing any .svn or other project-related files from entering the production environment. Use svn export to some place outside of the webroot, then use rsync to push changes into production.

Make Symlink

ln -s detail.lasso index.lasso

Edit itPage's Siteconfig file

Open the Lasso file /siteconfig.lasso and change these values:

$svSiteDatabase = 'itPage_CMS' (or whatever database name used)
$svSiteUsername = the MySQL username previously set up
$svSiteDatabase = the MySQL user's password previously set up
$svSalt = Make this any string at least 8 digits long

Save and close the file.

Run the Installer

Run the installer at http://www.yourdomain.com/install/install.lasso and fill in the required information. The installer will set up the itPage demo data.

Log Into Admin

Now log into the itPage CMS Admin at this page:

http://www.yourdomain.com/admin/

If this page does not work or the Apache rewrite rules are not working, use this link:

http://www.yourdomain.com/admin/login.lasso

You should be able to log in with the default username and password are:

User ID: Super
Password: Demo

SECURITY NOTE: Change the User ID and Password! Do NOT leave it at the default values.

Sign up for WebThumbs

itPage uses the WebThumbs service to create template previews. You can sign up for a free account at the WebThumbs site. The free account lets you create up to 100 previews per month. After signup and logging in, you will be able to copy the API Key and User ID. These need to be added to the siteconfig in $svEasyThumbUserID and $svEasyThumbAPIKey.

http://webthumb.bluga.net/home