From 7d97de4642b7b96e1ef4bc670ac7b47b78e068bd Mon Sep 17 00:00:00 2001 From: Roland Gruber Date: Sat, 7 Nov 2009 18:01:46 +0000 Subject: [PATCH] moved docs to new manual --- lam/docs/README.Kolab.txt | 48 ------ lam/docs/README.fpdf.htm | 286 ---------------------------------- lam/docs/README.hosts.txt | 28 ---- lam/docs/README.lamdaemon.txt | 122 --------------- lam/docs/README.openldap.txt | 18 --- lam/docs/README.schema.txt | 86 ---------- lam/docs/README.security.txt | 76 --------- lam/docs/README.upgrade.txt | 84 ---------- 8 files changed, 748 deletions(-) delete mode 100644 lam/docs/README.Kolab.txt delete mode 100755 lam/docs/README.fpdf.htm delete mode 100644 lam/docs/README.hosts.txt delete mode 100644 lam/docs/README.lamdaemon.txt delete mode 100644 lam/docs/README.openldap.txt delete mode 100644 lam/docs/README.schema.txt delete mode 100644 lam/docs/README.security.txt delete mode 100644 lam/docs/README.upgrade.txt diff --git a/lam/docs/README.Kolab.txt b/lam/docs/README.Kolab.txt deleted file mode 100644 index d5630009..00000000 --- a/lam/docs/README.Kolab.txt +++ /dev/null @@ -1,48 +0,0 @@ - -Some notes on managing Kolab accounts with LAM: - - -1. Creating accounts - - The mailbox server cannot be changed after the account has been saved. Please - make sure that the value is correct. - The email address ("Personal" page) must match your Kolab domain, otherwise the - account will not work. - - -2. Deleting accounts - - If you want to cleanly delete accounts use the "Mark for deletion" button on the - Kolab subpage of an account. This will also remove the user's mailbox. - If you delete the account from the account list (which is standard for LAM accounts) - then no cleanup actions are made. - - -3. Managing accounts with both LAM and Kolab Admin GUI - - The Kolab GUI has some restrictions that LAM does not have. - Please pay attention to the following restrictions: - - - Common name in LAM - The common name must have the format " ". - You can leave the field empty in LAM and it will automatically - fill in the correct value. - - - Changing first/last name in Kolab GUI - Do not change the first/last name of your users in the Kolab GUI! - The GUI will change the common name which leads to an LDAP object class - violation. This is caused by a bug in the Kolab GUI. - - -4. Adding a Kolab part to existing accounts - - If you upgrade existing non-Kolab accounts please make sure that the account - has a Unix password. - - -5. Installing LAM on the Kolab server - - You can install LAM in the directory "/kolab/var/kolab/www" which is - the root directory for Apache. - The PHP installation already includes all required packages. - diff --git a/lam/docs/README.fpdf.htm b/lam/docs/README.fpdf.htm deleted file mode 100755 index f556c9cd..00000000 --- a/lam/docs/README.fpdf.htm +++ /dev/null @@ -1,286 +0,0 @@ - - - -FAQ - - - -

FAQ

-1. What's exactly the license of FPDF? Are there any usage restrictions?
-2. When I try to create a PDF, a lot of weird characters show on the screen. Why?
-3. I try to generate a PDF and IE displays a blank page. What happens?
-4. I send parameters using the POST method and the values don't appear in the PDF.
-5. When I use a PHP session, IE doesn't display my PDF any more but asks me to download it.
-6. When I'm on SSL, IE can't open the PDF.
-7. When I execute a script I get the message "FPDF error: Don't alter the locale before including class file".
-8. I try to put a PNG and Acrobat says "There was an error processing a page. A drawing error occurred".
-9. I encounter the following error when I try to generate a PDF: Warning: Cannot add header information - headers already sent by (output started at script.php:X)
-10. I try to display a variable in the Header method but nothing prints.
-11. I defined the Header and Footer methods in my PDF class but nothing appears.
-12. I can't make line breaks work. I put \n in the string printed by MultiCell but it doesn't work.
-13. I try to put the euro symbol but it doesn't work.
-14. I draw a frame with very precise dimensions, but when printed I notice some differences.
-15. I'd like to use the whole surface of the page, but when printed I always have some margins. How can I get rid of them?
-16. What's the limit of the file sizes I can generate with FPDF?
-17. Can I modify a PDF with FPDF?
-18. I'd like to make a search engine in PHP and index PDF files. Can I do it with FPDF?
-19. Can I convert an HTML page to PDF with FPDF?
-20. Can I concatenate PDF files with FPDF?
-

-

1. What's exactly the license of FPDF? Are there any usage restrictions?

-FPDF is Freeware (it is stated at the beginning of the source file). There is no usage -restriction. You may embed it freely in your application (commercial or not), with or -without modification. You may redistribute it, too. -

2. When I try to create a PDF, a lot of weird characters show on the screen. Why?

-These "weird" characters are in fact the actual content of your PDF. This behaviour is a bug of -IE. When it first receives an HTML page, then a PDF from the same URL, it displays it directly -without launching Acrobat. This happens frequently during the development stage: on the least -script error, an HTML page is sent, and after correction, the PDF arrives. -
-To solve the problem, simply quit and restart IE. You can also go to another URL and come -back. -
-To avoid this kind of inconvenience during the development, you can generate the PDF directly -to a file and open it through the explorer. -

3. I try to generate a PDF and IE displays a blank page. What happens?

-First of all, check that you send nothing to the browser after the PDF (not even a space or a -carriage return). You can put an exit statement just after the call to the Output() method to -be sure. -
-If it still doesn't work, it means you're a victim of the "blank page syndrome". IE used in -conjunction with the Acrobat plug-in suffers from numerous bugs, in all versions. You should -test your application with as many IE versions as possible (at least if you're on the Internet). -The problem occurs mostly with the POST method, so it is strongly advised to avoid it (all the -more that it causes other problems, see the next question). The GET works better but may fail -when the URL becomes too long: don't use a query string with more than 45 characters. However, a -tip exists to exceed this limit: end the URL with .pdf, which tricks IE. If you use a form, you -can add a hidden field at the last position: -
-
-
- -<INPUT TYPE="HIDDEN" NAME="ext" VALUE=".pdf"> - -

-The usage of PHP sessions also often causes trouble (avoid using HTTP headers preventing caching). -See question 5 for a workaround. -
-
-To avoid all these problems in a reliable manner, two main techniques exist: -
-
-- Disable the plug-in and use Acrobat as a helper application. To do this, launch Acrobat; in -the File menu, Preferences, General, uncheck the option "Web Browser Integration" (for Acrobat -5: Edit, Preferences, Options, "Display PDF in Browser"). Then, the next time you load a PDF in -IE, it displays the dialog box "Open it" or "Save it to disk". Uncheck the option "Always ask -before opening this type of file" and choose Open. From now on, PDF files will open -automatically in an external Acrobat window. -
-The drawback of the method is that you need to alter the client configuration, which you can do -in an intranet environment but not for the Internet. -
-
-- Use a redirection technique. It consists in generating the PDF in a temporary file on the -server and redirect the client on it (by using JavaScript, not the Location HTTP header which -also causes trouble). For instance, at the end of the script, you can put the following: -
-
-
- -//Determine a temporary file name in the current directory
-$file=basename(tempnam(getcwd(),'tmp'));
-//Save PDF to file
-$pdf->Output($file);
-//JavaScript redirection
-echo "<HTML><SCRIPT>document.location='getpdf.php?f=$file';</SCRIPT></HTML>"; - -

-Then create the getpdf.php file with this: -
-
-
- -<?php
-$f=$HTTP_GET_VARS['f'];
-//Check file (don't skip it!)
-if(substr($f,0,3)!='tmp' or strpos($f,'/') or strpos($f,'\\'))
-    die('Incorrect file name');
-if(!file_exists($f))
-    die('File does not exist');
-//Handle special IE request if needed
-if($HTTP_SERVER_VARS['HTTP_USER_AGENT']=='contype')
-{
-    Header('Content-Type: application/pdf');
-    exit;
-}
-//Output PDF
-Header('Content-Type: application/pdf');
-Header('Content-Length: '.filesize($f));
-readfile($f);
-//Remove file
-unlink($f);
-exit;
-?> - -

-This method works in most cases but IE6 can still experience trouble. The "ultimate" method -consists in redirecting directly to the temporary file. The file name must therefore end with .pdf: -
-
-
- -//Determine a temporary file name in the current directory
-$file=basename(tempnam(getcwd(),'tmp'));
-rename($file,$file.'.pdf');
-$file.='.pdf';
-//Save PDF to file
-$pdf->Output($file);
-//JavaScript redirection
-echo "<HTML><SCRIPT>document.location='$file';</SCRIPT></HTML>"; - -

-This method turns the dynamic PDF into a static one and avoids all troubles. But you have to do -some cleaning in order to delete the temporary files. For instance: -
-
-
- -function CleanFiles($dir)
-{
-    //Delete temporary files
-    $t=time();
-    $h=opendir($dir);
-    while($file=readdir($h))
-    {
-        if(substr($file,0,3)=='tmp' and substr($file,-4)=='.pdf')
-        {
-            $path=$dir.'/'.$file;
-            if($t-filemtime($path)>3600)
-                @unlink($path);
-        }
-    }
-    closedir($h);
-} - -

-This function deletes all files of the form tmp*.pdf older than an hour in the specified -directory. You may call it where you want, for instance in the script which generates the PDF. -
-
-Remark: it is necessary to open the PDF in a new window, as you can't go backwards due to the -redirection. -

4. I send parameters using the POST method and the values don't appear in the PDF.

-It's a problem affecting some versions of IE (especially the first 5.5). See the previous -question for the ways to work around it. -

5. When I use a PHP session, IE doesn't display my PDF any more but asks me to download it.

-It's a problem affecting some versions of IE. To work around it, add the following line before -session_start(): -
-
-
- -session_cache_limiter('private'); - -

-or do a redirection as explained in question 3. -

6. When I'm on SSL, IE can't open the PDF.

-The problem may be fixed by adding this line:
-
-
- -Header('Pragma: public'); - -

- -

7. When I execute a script I get the message "FPDF error: Don't alter the locale before including class file".

-When the decimal separator is configured as a comma before including a file, there is a -bug in some PHP versions and decimal -numbers get truncated. Therefore you shouldn't make a call to setlocale() before including the class. -On Unix, you shouldn't set the LC_ALL environment variable neither, for it is equivalent to a -setlocale() call. -

8. I try to put a PNG and Acrobat says "There was an error processing a page. A drawing error occurred".

-Acrobat 5 has a bug and is unable to display transparent monochrome images (i.e. with 1 bit per -pixel). Remove transparency or save your image in 16 colors (4 bits per pixel) or more. -

9. I encounter the following error when I try to generate a PDF: Warning: Cannot add header information - headers already sent by (output started at script.php:X)

-You must send nothing to the browser except the PDF itself: no HTML, no space, no carriage return, -neither before nor after. The script outputs something at line X. -

10. I try to display a variable in the Header method but nothing prints.

-You have to use the global keyword, for instance: -
-
-
- -function Header()
-{
-    global $title;
-
-    $this->SetFont('Arial','B',15);
-    $this->Cell(0,10,$title,1,1,'C');
-} - -

- -

11. I defined the Header and Footer methods in my PDF class but nothing appears.

-You have to create an object from the PDF class, not FPDF:
-
-
- -$pdf=new PDF(); - -

- -

12. I can't make line breaks work. I put \n in the string printed by MultiCell but it doesn't work.

-You have to enclose your string with double quotes, not single ones. -

13. I try to put the euro symbol but it doesn't work.

-The standard fonts have the euro character at position 128. You can define a constant like this -for convenience: -
-
-
- -define('EURO',chr(128)); - -

-Note: Acrobat 4 or higher is required to display euro. -

14. I draw a frame with very precise dimensions, but when printed I notice some differences.

-To respect dimensions, you have to uncheck the option "Fit to page" in the print dialog box. -

15. I'd like to use the whole surface of the page, but when printed I always have some margins. How can I get rid of them?

-All printers have physical margins (different depending on the model), it is therefore impossible -to remove them and print on the totality of the paper. -

16. What's the limit of the file sizes I can generate with FPDF?

-There is no particular limit. There are some constraints however: -
-
-- The maximum memory size allocated to PHP scripts defaults to 8MB. For very big documents, -especially with images, this limit may be reached (the file being built into memory). The -parameter is configured in the php.ini file. -
-
-- The maximum execution time allocated defaults to 30 seconds. This limit can of course be easily -reached. It is configured in php.ini and may be altered dynamically with set_time_limit(). -
-
-- Browsers generally have a 5 minute time-out. If you send the PDF directly to the browser and -reach the limit, it will be lost. It is therefore advised for very big documents to -generate them in a file, and to send some data to the browser from time to time (for instance -page 1, page 2... with flush() to force the output). When the document is finished, you can send -a redirection on it with JavaScript or create a link. -
-Remark: even when the browser goes in time-out, the script may continue to run on the server. -

17. Can I modify a PDF with FPDF?

-No. -

18. I'd like to make a search engine in PHP and index PDF files. Can I do it with FPDF?

-No. But a GPL C utility does exist, pdftotext, which is able to extract the textual content from -a PDF. It is provided with the Xpdf package:
-
-http://www.foolabs.com/xpdf/ -

19. Can I convert an HTML page to PDF with FPDF?

-No. But a GPL C utility does exist, htmldoc, which allows to do it and gives good results:
-
-http://www.easysw.com/htmldoc/ -

20. Can I concatenate PDF files with FPDF?

-No. But a free C utility exists to perform this task:
-
-http://thierry.schmit.free.fr/dev/mbtPdfAsm/enMbtPdfAsm2.html - - diff --git a/lam/docs/README.hosts.txt b/lam/docs/README.hosts.txt deleted file mode 100644 index 8303992e..00000000 --- a/lam/docs/README.hosts.txt +++ /dev/null @@ -1,28 +0,0 @@ -The attribute "host" is only in objectclass account. -Unfortunatly "account" conflicts with -"inetorgperson". so there's no perfect way to use -both. - -In order to get attribute host working you have to -modify schema/inetorgperson and include host: - - -# inetOrgPerson -# The inetOrgPerson represents people who are associated with an -# organization in some way. It is a structural class and is derived -# from the organizationalPerson which is defined in X.521 [X521]. -objectclass ( 2.16.840.1.113730.3.2.2 - NAME 'inetOrgPerson' - DESC 'RFC2798: Internet Organizational Person' - SUP organizationalPerson - STRUCTURAL - MAY ( - audio $ businessCategory $ carLicense $ departmentNumber $ - displayName $ employeeNumber $ employeeType $ givenName $ - homePhone $ homePostalAddress $ initials $ jpegPhoto $ - labeledURI $ mail $ manager $ mobile $ o $ pager $ - photo $ roomNumber $ secretary $ uid $ userCertificate $ - x500uniqueIdentifier $ preferredLanguage $ - userSMIMECertificate $ userPKCS12 $ host ) - ) - diff --git a/lam/docs/README.lamdaemon.txt b/lam/docs/README.lamdaemon.txt deleted file mode 100644 index 09a43af4..00000000 --- a/lam/docs/README.lamdaemon.txt +++ /dev/null @@ -1,122 +0,0 @@ - - This document describes the installation of lamdaemon which is responsible - for managing quotas and creating home directories. - - - Setting up lamdaemon: - ===================== - - - Lamdaemon.pl is used to modify quota and home directories on a remote or local host via ssh. - If you want wo use it you have to set up some things to get it to work: - - -1. Setup values in LDAP Account Manager -======================================= - - * Set the remote or local host in the configuration - (e.g. 127.0.0.1) - - * Path to lamdaemon.pl, e.g. /srv/www/htdocs/lam/lib/lamdaemon.pl - If you installed a Debian or RPM package then the script may be located at - /usr/share/ldap-account-manager/lib or /var/www/html/lam/lib. - - * Your LAM admin user must be a valid Unix account. It needs to have the object class - "posixAccount" and an attribute "uid". This account must be accepted by the - SSH daemon of your home directory server. - Do not create a second local account but change your system to accept LDAP users. - You can use LAM to add the Unix account part to your admin user. - - -2. Setup sudo -============= - - The perl script has to run as root. Therefore we need - a wrapper, sudo. - Edit /etc/sudoers on host where homedirs or quotas should be used - and add the following line: - - $admin All= NOPASSWD: $path - - $admin is the admin user from LAM (must be a valid Unix account) - and $path is the path to lamdaemon.pl - - e.g.: myAdmin ALL= NOPASSWD: /srv/www/htdocs/lam/lib/lamdaemon.pl - - You might need to run the sudo command once manually to init sudo. - - -3. Setup Perl -============== - - We need an extra Perl module - Quota - To install it, run: - - perl -MCPAN -e shell - install Quota - - If your Perl executable is not located in /usr/bin/perl you will have to edit - the path in the first line of lamdaemon.pl. - If you have problems compiling the Perl modules try installing a newer release - of your GCC compiler and the "make" application. - - Several Linux distributions already include a quota package for Perl. - - -4. Install libssh2 -================== - - 4.1 Install libssh2 - You can get libssh2 here: http://www.libssh2.org - Unpack the package and install it by executing the commands - "./configure", "make" and "make install" in the extracted directory. - - 4.2 Install SSH2 for PHP - The easiest way is to run "pecl install ssh2-beta". If you have no pecl command then install - the PHP Pear package (e.g. php-pear or php5-pear) for your distribution. - - If you want to compile it yourself, get the sources here: http://pecl.php.net/package/ssh2 - - After installing the PHP module please add this line to your php.ini: - extension=ssh2.so - - -5. Set up SSH -============= - - Your SSH daemon must offer the password authentication method. - To activate it just use this configuration option in /etc/ssh/sshd_config: - - PasswordAuthentication yes - - -Now everything should work fine. - - -6. Troubleshooting -====================== - - - There is a test page for lamdaemon: - Login to LAM and open Tools -> Tests -> Lamdaemon test - - - If you get garbage characters at the test page then PHP and your php5-ssh2 library may not - fit together. Try recompiling the library and libssh2. - - This combination was tested successfully: libssh2 0.13 with php5-ssh2 0.10 - php5-ssh2 0.11 should have no problems with recent libssh2 releases. - - - Check /var/log/auth.log or the equivalent on your system - This file contains messages about all logins. If the ssh login - failed then you will find a description about the reason here. - - - Set sshd in debug mode - In /etc/ssh/sshd_conf add these lines: - - SyslogFacility AUTH - LogLevel DEBUG3 - - Now check /var/log/syslog for messages from sshd. - - - Update Openssh - A Suse Linux user reported that upgrading Openssh solved the problem. - diff --git a/lam/docs/README.openldap.txt b/lam/docs/README.openldap.txt deleted file mode 100644 index 1acde347..00000000 --- a/lam/docs/README.openldap.txt +++ /dev/null @@ -1,18 +0,0 @@ -Some basic hints to configure the OpenLDAP server: - -SIZELIMIT: OpenLDAP allows by default 500 return values per search, if you have more users/groups/hosts - change this in slapd.conf: e.g. "sizelimit 10000" or "sizelimit -1" for unlimited return values. - -INDICES: Indices will improve the performance when searching for entries in the LDAP directory. - The following indices are recommended: - - index objectClass eq - index default sub - index uidNumber eq - index gidNumber eq - index memberUid eq - index cn,sn,uid,displayName pres,sub,eq - # Samba 3.x - index sambaSID eq - index sambaPrimaryGroupSID eq - index sambaDomainName eq diff --git a/lam/docs/README.schema.txt b/lam/docs/README.schema.txt deleted file mode 100644 index 4f124725..00000000 --- a/lam/docs/README.schema.txt +++ /dev/null @@ -1,86 +0,0 @@ - - Here is a list of needed LDAP schema files for the different LAM modules. - For OpenLDAP we also provide a source where you can get the files. - - - 1. Unix accounts (modules posixAccount/shadowAccount/posixGroup) - - Schema: nis.schema, rfc2307bis.schema - Source: Part of OpenLDAP installation - - The rfc2307bis.schema is only supported by LAM Pro. Use the nis.schema - if you do not want to upgrade to LAM Pro. - - - 2. Address book entries (module inetOrgPerson) - - Schema: inetorgperson.schema - Source: Part of OpenLDAP installation - - - 3. Samba 3 accounts (modules sambaSamAccount) - - Schema: samba.schema - Source: Part of Samba tarball (examples/LDAP/samba.schema) - - - 4. Quota (module quota) - - Schema: none - - - 5. Kolab 2 users (module kolabUser) - - Schema: kolab2.schema, rfc2739.schema - Source: Part of Kolab 2 installation - - - 6. Mail routing (module inetLocalMailRecipient) - - Schema: misc.schema - Source: Part of OpenLDAP installation - - - 7. Mail aliases (module nisMailAlias) - - Schema: misc.schema - Source: Part of OpenLDAP installation - - - 8. MAC addresses (module ieee802device) - - Schema: nis.schema - Source: Part of OpenLDAP installation - - - 9. Simple Accounts (module account) - - Schema: cosine.schema - Source: Part of OpenLDAP installation - - - 10. SSH public keys (module ldapPublicKey) - - Schema: openssh-lpk.schema - Source: Included in patch from http://code.google.com/p/openssh-lpk/ - - - 11. Group of (unique) names (modules groupOfNames/groupOfUniqueNames) - - These modules are only available in LAM Pro. - Schema: core.schema - Source: Part of OpenLDAP installation - - - 12. phpGroupWare (modules phpGroupwareUser, phpGroupwareGroup) - - Schema: phpgroupware.schema - Source: http://www.phpgroupware.org/ - - - 13. DHCP (modules dhcp_settings, ddns, fixed_ip, range) - - Schema: dhcp.schema - Source: docs/schema/dhcp.schema - The LDAP suffix should be set to your dhcpServer entry. - diff --git a/lam/docs/README.security.txt b/lam/docs/README.security.txt deleted file mode 100644 index 05f1deeb..00000000 --- a/lam/docs/README.security.txt +++ /dev/null @@ -1,76 +0,0 @@ - -1. Use of SSL - - The data which is transfered between you and LAM is very sensitive. - Please always use SSL encrypted connections between LAM and your browser to - protect yourself against network sniffers. - - -2. LDAP with SSL and TLS - - SSL will be used if you use ldaps://servername in your configuration profile. - TLS can be activated with the "Activate TLS" option. - - You will need to setup ldap.conf to trust your server certificate. Some installations - use /etc/ldap.conf and some use /etc/ldap/ldap.conf. It is a good idea to symlink - /etc/ldap.conf to /etc/ldap/ldap.conf. - Specify the server CA certificate with the following option: - - TLS_CACERT /etc/ldap/ca/myCA/cacert.pem - - This needs to be the public part of the signing certificate authority. See "man ldap.conf" - for additional options. - - -3. Chrooted servers - - If your server is chrooted and you have no access to /dev/random or /dev/urandom - this can be a security risk. LAM stores your LDAP password encrypted in the session. - LAM uses rand() to generate the key if /dev/random and /dev/urandom are not accessible. - Therefore the key can be easily guessed. - An attaker needs read access to the session file (e.g. by another Apache instance) to - exploit this. - - -4. Protection of your LDAP password and directory contents - - You have to install the MCrypt extension for PHP to enable encryption. - - Your LDAP password is stored encrypted in the session file. The key and IV to decrypt - it are stored in two cookies. We use MCrypt/AES to encrypt the password. - All data that was read from LDAP and needs to be stored in the session file is also - encrypted. - - -5. Apache configuration - - LAM includes several .htaccess files to protect your configuration files and temporary - data. Apache is often configured to not use .htaccess files by default. - Therefore, please check your Apache configuration and change the override setting to: - - AllowOverride All - - If you are experienced in configuring Apache then you can also copy the security settings - from the .htaccess files to your main Apache configuration. - - If possible, you should not rely on .htaccess files but also move the config and sess - directory to a place outside of your WWW root. You can put a symbolic link in the LAM - directory so that LAM finds the configuration/session files. - - - Security sensitive directories: - - config: Contains your LAM configuration and account profiles - - LAM configuration clear text passwords - - default values for new accounts - - directory must be accessibly by Apache but needs not to be accessible by the browser - - sess: PHP session files - - LAM admin password in clear text or MCrypt encrypted - - cached LDAP entries in clear text or MCrypt encrypted - - directory must be accessibly by Apache but needs not to be accessible by the browser - - tmp: temporary files - - PDF documents which may also include passwords - - images of your users - - directory contents must be accessible by browser but directory itself must not be browseable diff --git a/lam/docs/README.upgrade.txt b/lam/docs/README.upgrade.txt deleted file mode 100644 index f64eb930..00000000 --- a/lam/docs/README.upgrade.txt +++ /dev/null @@ -1,84 +0,0 @@ -Upgrade instructions: -===================== - -1. Migrating configuration files -================================ - -LAM stores all configuration files in the "config" folder. Please backup the -following files and copy them after the new version is installed. - -* config/*.conf -* config/config.cfg -* config/pdf/*.xml -* config/profiles/*.xml - -LAM Pro only: - -* config/selfService/*.* -* config/passwordMailTemplate.txt - -Please check also the version specific instructions. They might include -additional actions. - - - -2. Version specific upgrade instructions -======================================== - - -2.2.0 -> 2.3.0 -============== - -LAM Pro: There is now a separate account type for group of (unique) names. - Please edit your server profiles to activate the new account type. - - - -1.1.0 -> 2.2.0 -============== - -No changes. - - - -1.0.4 -> 1.1.0: -=============== - -If you use the lamdaemon.pl script to manage quotas and home directories please -read docs/README.lamdaemon.txt. - - - -0.5.x -> 1.0.0: -=============== - -The architecture of LAM changed again. - -Please enter the LAM configuration editor and edit your existing profiles. -You can now select which account lists should be displayed by selecting -the active account types ("Edit account types"). The settings for the LDAP -suffixes and the list attributes also moved on this page. - -After saving all configuration profiles you can login to LAM. The Samba domain -editor under "Tools" no longer exists. This is now an account type just like -users or groups. The NIS mail aliases have their own account list, too. - - - -0.4.x -> 0.5.0: -=============== - -There were some major changes since 0.4.x. - -First enter the LAM configuration editor and check if all settings are correct. Since -LAM now supports a plugin architecture for all accounts you can select the needed -modules. Click on "Edit modules" and select which account types you want to manage. -Depending on which modules you selected there might be more configuration options. - -Now save your settings and login to LAM. You will have to recreate all your account -profiles because the format changed. The profile editor can be found on the tools -page ("Tools" in the upper left corner). - -The tools page also includes the new flexible file upload and the PDF editor. -You can specify yourself which attributes should show up in the PDF files. There -are also different PDF profiles possible.