Looky Installation Routing

	Table Of Content
1  Setup Server / Apache Server 2  Install packages   2.1  Urload   2.2  Install Looky Core 3  Configuration   3.1  Define Pools   3.2  Define Resources   3.3  Setup Security   3.4  Setup Redirection     3.4.1  Setup up error redirection     3.4.2  Setup up standard redirection 4  Start processes

1. Assume that you have an Apache WEB server. If not, you must adopt this document to the configuration of your WEB server.
   
   
2. Assume that WWW:WWW is the user and the group of the user running your WEB server.
   
   
3. Assume that $DOWNLOAD names the directory where you have downloaded the package files.
   
   
4. Create directory /opt/looky and make this directory readable and writeable to your Apache server:

   #> cd /opt
   #> mkdir looky
   #> chown WWW:WWW looky
   #> chmod 755 looky

   
   
   
5. Copy files urload.pl and urload.pbp to this directory /opt/looky

   #> cd /opt
   #> cp $DOWNLOAD/urload.pl looky
   #> cp $DOWNLOAD/urload.pbp looky
   #> chmod 755 looky/urload.pl
   #> chmod 644 looky/urload.pbp
   #> chown -R WWW:WWW looky

   
   
   
6. Edit shebang of file /opt/looky/urload.pl to match your local perl:

   #> cd /opt
   #> type perl 
   perl is /usr/bin/perl
   #> vi looky/urload.pl
   (ESC-i)#!/usr/bin/perl(ESC-wq)

   
   
   
7. Add a script alias entry to your httpd.conf file.

   ScriptAlias /looky/ /opt/looky/

   
   
   
8. Restart your Apache server.
   
   

• step 1: urloading
• step 2: install application

• looky-1.0.7-core.pbp: the looky core: libaries and applications to run looky.
  
  
• looky-1.0.7-doc.pbp: this documentation.
  
  
• looky-1.0.7-rc.pbp: a set of rc scripts (to make looky bootable) and application looky-killer.pl (to shut down looky server)
  
  

1. To run the urload process, use a web browser with URL

   http://<server>/looky/urload.pl

   to urload pkg-by-pkg structure to directory /opt/looky. If you set up your Apache server als described in previous section, the urload start screen is [shown].
   
   On this screen two substeps steps are shown:
   
   First some very basic checks are done:
   • The urload.pbp file is checked, if this file exists and if it is readable or not. The file has to be readable.
   • The installation directory is checked if an pkg-by-pkg instances already exists. Warning: you should not install a pkg-by-pkg instance on an other instance: this is done at your own risk!
   
   
   If this checks are passed successfully the urloader tries to guess the binary path to your perl interpreter and the root directory where looky has to be installed (/opt/looky).
   
   Please check the values quite carefully. This cannot be changed later, so you must enter the correct values (In case you fail here: just delete the complete directory root directory /opt/looky and start again)
   
   
2. On the next [screen], the given values for root-directory and perl interpreter are checked. If this is ok, the package file urload.pbp is opened and content is shown to you.
   
   Just click 'accept' button to proceed.
   
   
3. Now the pkg-by-pkg infrastructure is created. The result of this step is shown on the next [screen].
   
   Once the pkg-by-pkg infrastructure is available, the urload.pl script tries to use the perl packages as urloaded from urload.pbp file. If this fails, a perl error message is shown.
   
   
4. On the next [screen], the package requirements are checked. This phase may lead to a perl error that is shown to you: in this case you have to fetch listed package from cpan.
   
   
5. Finally, on the last [screen], the files urload.pl and urload.php are deleted .
   
   Instead of these a new file admin.pl has been created to manage your looky installation. Just select [continue].
   
   

1. The admin script provides the following main [screen].
   
   To upload the looky core package file, select [upload package]
   
   
2. Select the looky-1.0.7-core.pbp file and upload file by button [upload].
   
   
3. The file is uploaded (this may take a while). If the upload was successfully a positve result is [shown].
   
   Select [import] to jump to the import page.
   
   
4. All uploaded files are [shown] to the user.
   
   Just select [import] of the uploaded looky-1.0.7-core.pbp file to start import of the uploaded package.
   
   
5. The package is extracted and its content is [shown] to the user.
   
   Just select [import] to import the package.
   
   
6. The package is installed and the result of this process is [shown] to the user.
   
   Just select [continue] to proceed
   
   
7. The imported package has added two links to the admin.pl [script].
   
   The installation process is done.
   
   

• define pools
• assign resource to pools
• setup security and finally
• setup redirection urls.

PerlModule Apache::Registry

# ----- map location 'load' to be run by LBC
#
ScriptAliasMatch ^/load/.* /opt/looky/looky-client-cgi.pl

# ----- host this location by mod_perl
#
<Location /load/>
    SetHandler perl-script
    PerlHandler Apache::Registry
    Options +ExecCGI
    PerlSendHeader On
    allow from all
</Location>

http://<server>/load/<pool>/<start>/<url>/<of>?<your>=<application>
                     `----´ `----------------´ `------------------´
                       |       |                              |
 get pool from this segment   make path transient             |
                              from segment 2                  |
                                                    just use query par\
 \t
                                                    as given by url

redirect:http://%{resource}/%{path}%{url/query:?%{url/query}}%{url/fra\
 \gment:#%{url/fragment}}
compute.pool:path/1
transient.path:2

$>cd /opt/looky
$>perl looky-server.pl -q &