|
| Menu |
|---|
|
Home About Services Portfolio Pricing Contact Listings OfficeTrio IntraVersion |
| News |
|
21 Aug 2008 17 May 2008 16 Feb 2008 31 Oct 2007 31 Oct 2007 |
IntraVersion: Installation
[ Home | Installation | Manual PT1 | Manual PT2 | FAQ | Demo | News | Notes | Services ]
Installing a Web-Server On A PC
To install IV on your PC - You'll need Wamp Server (or similar)... Install IV into the 'www' directory once wamp is installed. Then access if from your browser at http://localhost/IntraVersion
Installation IV On Your Web-Server
You must have PHP and MySQL V4.01+ installed on your web-server.
- Create a database and user for IV.
- Copy the files into the directory you want to run IV from.
- Access the directory from a web-browser and follow the install instructions.
The install process creates 2 files - installed.php which is just a flag. db.php contains the db login details...
If the installation fails (e.g. you mis-type the database name), you should delete inc/db.php and inc/installed.php (if it exists), and start again.
Unix Users & Permissions
IV needs write-access to a number of it's sub-directories so it can create the directories and files it needs to.
The 'right' way to do this is to ensure that the IV files and directories are writable by the group the webserver belongs to (i.e. Apache). So if Apache belongs to the group 'Apache', you'd need to chgrp the whole directory structure to Apache (i.e. chgrp -R Apache .).
I guess the install could find out what the current group is and chgrp automatically? If anyone has the time to confirm / test this, please let me know.
Single-User Usage
If only one user is going to use IV, you should set STRICT_CHECKIN to FALSE. This makes using IV much easier because you don't have to check files out in order to have permission to update them. You can also switch STRICT_ACCESS OFF.
Settings
These are the settings defined in the inc/settings.php file:
| LINE_END | All files processed by IV have their line-endings converted to this. Should be \n on Unix, \r\n on Windows... |
|---|---|
| DT_FORMAT | Date format used in showing file dates. (Long version - used in file list etc). |
| DT_SHORT | Short date format used in showing file dates. |
| MAX_SIZE | The maximum size of file to track in bytes. Files larger than this will be ignored. |
Options
| TRIM_WHITESPACE | Delete any spaces or other whitespace characters from the end of lines. Applies to text files only... |
|---|---|
| STRICT_CHECKIN | If set to TRUE, files can only be updated by a user if they have first been checked out. If set to FALSE, any user can update a checked-in file. See below... |
| TRACK_UNKNOWN_TYPES | Default is FALSE. If TRUE, IV will track files with extensions that are not listed in ft_array.php. |
| SYSTEM_CMD | Default is FALSE. If TRUE, IV will allow users to run system commands after builds/gets. |
| ALWAYS_PROCESS_MACROS | Default is FALSE. If TRUE, IV will process macros on all file gets. (If FALSE macros are only processed on project gets). |
| BRANCHES | Default is TRUE. Allow file branches? For Document Management this should usually be OFF (FALSE). |
| PROJECT_VERSIONS | Enable project versioning? For Software Configuration Management this should be ON (TRUE). For Document Management this should usually be OFF (FALSE) |
| ALLOW_UPLOAD | Enable Upload Functionality? For secure intranets - this can be ON (TRUE). For internet this should usually be OFF (FALSE) |
Directories
| BUILD_DIR | Directory to output files to on build. Default is 'build'. |
|---|---|
| ZIP_DIR | Directory to output temp files to when getting to a ZIP file. Default is 'zip'. |
Tree View Options
| INDENT_PIXELS | Directory Tree Indent size (pixels). |
|---|---|
| MAX_DISPLAY_LEN | Length at which filenames get shortened in the tree. |
Professional Version Options
| PROJECT_OPTIONS | Enable project options. For Software Configuration Management this should be ON (TRUE). For Document Management this should usually be OFF (FALSE). |
|---|---|
| STRICT_ACCESS | Check all file operations against user-level permissions? |
| GZIP_BINARIES | Default is FALSE. If TRUE, IV will GZIP the contents of binary files before addind them to the database. Depending on the type of file - this can save a lot of database disk-space. Note - files that are already compressed (e.g. .png) will take up more space when gzipped, not less! |
| GZIP_LEVEL | Default is 9. GZIP compression level - where 0 is none, and 9 is maximum. |
| STORE_DIFFS | Default is TRUE. If TRUE, IV will store only the differences between files, not the whole file contents. This can save a lot of database disk-space. |
| BASELINE EVERY | Store a full copy of file data every n versions. This improves performance when files have been through a lot of versions. |
| PUBLISHER_DIR | Directory where publisher exists. |
Macro Options
| MD_L & MD_R | Macro Delimiters. MD_L is a unique combination of characters that won't occur elewhere in your text files. Indicates to IV that a macro is there to be processed. |
|---|---|
| MO_* | Macro Outputs. This is the text that is displayed when macros are processed. |
| TIMESTAMP_FORMAT | PHP strftime format specifier for the IVTIME macro. |