[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ 8 ] [ 9 ] [ next ]

aviManager - Manual
Chapter 2 - Installation

Please open the file UPGRADE instead if you upgrade from a previous version of aviManager!.

Version 0.9pre9 comes with an install script. You can use this if you install aviman on your local machine or if you have ssh access to your server (once again, don't install aviManager on a public server!).

Run the script with

perl install.pl

The script tries to guess your system. If everything looks ok, start installation with

perl install.pl -i

If not, specify the paths and the apache user with the corresponding command line arguments (see output of the script).

For people who can't use the installer, here the detailed installation instructions. Steps marked with [X] are necessary even with the installer (AFTER you run the script).

[X] Make sure that you have installed Apache, Perl and following Perl Modules: LWP Module, CGI:Session, HTML::Template and Config::IniFiles

Most Linux distributions package LWP under the filename libwww-perl (Debian: apt-get install libwww-perl libhtml-template-perl libcgi-session-perl libconfig-inifiles-perl)

Unzip the distribution. Upload all files in cgi-bin in ASCII mode to a directory on your server that can run cgi. For example, I recommend creating a directory called aviman off your cgi-bin.

Make sure these files are transferred in ASCII mode!!

Upload the files in avimanager/pages to a directory outside cgi-bin.

On your server, you should now have two directories with following structure

     	
        cgi-bin/aviman/
        cgi-bin/aviman/Aviman/
        cgi-bin/aviman/Aviman/CGI
        cgi-bin/aviman/data
        cgi-bin/aviman/data/db
        cgi-bin/aviman/data/db/backup
        cgi-bin/aviman/data/db/comment
        cgi-bin/aviman/data/db/plots
        cgi-bin/aviman/data/movielist
        cgi-bin/aviman/data/tmp
        cgi-bin/aviman/data/votes
        cgi-bin/aviman/language
        
        aviman/pages/
        aviman/pages/images
        aviman/pages/images/cover
        aviman/pages/images/headshots
        aviman/pages/media/
        aviman/pages/subtitles
        aviman/pages/themes
        aviman/pages/themes/default
        aviman/pages/themes/default/images
        aviman/pages/themes/default/templates

[X] Double-check that the Path to perl in aviman.pl and all other *.pl files is correct.
```
             #!/usr/bin/perl
```

Set permissions:
- chmod 755 (-rwxr-xr-x) on the *.pl files and aviman.cfg file in cgi-bin/aviman/
- 777 (drwxrwxrwx) on the cgi-bin/aviman/data directory and its subdirectories
- 777 (drwxrwxrwx) on the pages/images directory and its subdirectories

[X] Open aviman.cfg with your favorite editor and answer the configuration questions. The most confusing step here for many new users is the owners feature. If you want to manage your movie collection with your roommate for example, you have to add your username and your roommates username here.

@owners = ("me", "roommate");

Yes, this is a hack and there is not yet an interface for adding or removing owners. Removing owners is probably not yet possible without some textfile hacking, so you should only delete the accounts (that means, they can't login anymore)!

Open Aviman/CGI/aviman_cgi.ini with your favorite editor and set paths and urls

[X] Go to: http://yourserver.com/cgi-bin/aviman/aviman.pl or wherever you set up aviman.pl, Login as user: admin, password: admin, and you should see the search screen.

Now try following features:
1. Add a new super user account [SU] (e.g. "me" and "roommate" in the example above).
1. Logout and login as "me"
1. Add a movie.
1. Search for a movie.
1. Vote for a movie
1. add comments
1. upload file (if you have activated subtitle upload in aviman.cfg)
1. delete user "admin"
If everything goes ok, you should be all done!

[X] Customize look. Edit htm-files in aviman directory and db.css. Of course, all changes in aviman.pl will be lost if you upgrade to a newer version of aviManager. This will change in future versions due enhanced template support.

[X] Optional but highly recommended: Install String::Approx

Debian: apt-get install libstring-approx-perl

[X] If you have problems, please use our help-forum at sourceforge.

[X] If you miss some fields (Quality, md5sums, ...), it is now the best moment to add them, because it is much more difficult with an existing database. Please read comments in aviman.cfg, Preference Questions and read the FAQ in this manual.

[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ 8 ] [ 9 ] [ next ]

aviManager - Manual

0.9.2

Markus Riester mriester@gmx.de

aviManager - Manual Chapter 2 - Installation

aviManager - Manual
Chapter 2 - Installation