X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=docs%2Fhowto-cygwin.txt;h=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=d92f70685083588e2a7ce6bc312a735f6937b5a6;hp=6f2e4038c3bbce298ecdc3fae8e7a3d6a5dcd2ad;hpb=6c1f39091444e58c33362f0cc086375d9d273e77;p=debian%2Famanda diff --git a/docs/howto-cygwin.txt b/docs/howto-cygwin.txt index 6f2e403..e69de29 100644 --- a/docs/howto-cygwin.txt +++ b/docs/howto-cygwin.txt @@ -1,261 +0,0 @@ - -Chapter 12. Amanda on Cygwin HOWTO -Prev Part III. HOWTOs Next - -------------------------------------------------------------------------------- - -Chapter 12. Amanda on Cygwin HOWTO - - -Doug Kingston - -Original text - -Stefan G. Weichinger - -XML-conversion -AMANDA Core Team - -Table of Contents - - - Install_Cygwin - - Other_Preparation - - Compile_Amanda - - Configure_Cygwin_files - - Configure_Windows_System_Files - - Configure_inetd_to_run_automatically_as_a_service - - Windows_98/ME - - Windows_NT/2000/XP - - Notes_on_Amanda_backup_options - - - Compression - - Exclude_Lists - - Debugging_Files - - -by Doug Kingston, 30 January 2003. Based on Cygwin 1.3.18, and Amanda 2.4.3- -20021027 and some fixes which will be in the official release by the time you -see this. -With thanks to Enrico Bernardini from whom I have borrowed some material from -an earlier attempt at documenting the installation of Amanda on Cygwin in 2001. -Please send annotations and corrections to mailto://amanda-hackers@amanda.org. -I can be reached as dpk (at) randomnotes.org (do the obvious). - - Install Cygwin - -The following Cygwin packages are required for binary installation (may be -incomplete): - -* Category BASE: standard -* Category MISC: gzip -* Category MISC: tar -* Category NET: inetutils - -You need also these packages to build from source (may be incomplete): - -* Category DEVELOP: ALL -* Category INTERPRETERS: m4, gawk ? -* Category LIBS:default selection? (libc, libiconv, others?) - -I have most or the basic utilities and libraries installed so I cannot give you -a more specific list of what is required. If someone has a more definitive -list, I would appreciate and email to mailto://amanda-hackers@amanda.org. -One user reported some problems with access rights when running under Cygwin, -which he solved by setting the CYGWIN environment variable to nontsec. I do not -believe this is necessary if you run the Amanda daemon as System (see below). - - Other Preparation - -When doing backups on a NT, Windows 2000 or Windows XP system, the choice of -user and group will be important if you are to properly interact with the -security mechanisms of these more modern Microsoft product. For Windows 95/98/ -ME this is probably a non-issue. The most privileged account on the Windows -systems is 'System', and I have chosen to use this account for Amanda backups -to ensure that I can access the widest set of files. On Unix we would run as -root, with equivalent access permissions. I have also chose to run under the -'Administrators' group, another standard Windows group. Ensure these exist -before you continue - or identify another account to use. The Cygwin -installation postinstall script should have already populated /etc/passwd and -etc/group with these entries. - -* Make sure that System (or SYSTEM) has a home directory specified in /etc/ - passwd. - -I used _/home/root_. You'll need to put the file .amandahosts here later. The -relevant lines from my file /etc/passwd are: - - SYSTEM:*:18:18:,S-1-5-18:/home/root: - root:*:18:18:,S-1-5-18:/home/root: - - - Compile Amanda - -After installing Cygwin, unpack the Amanda sources, typically in /usr/src/ -Amanda or something similar. In the Amanda directory, you will need to execute: - - automake # this may not be necessary in the official release - autoconf # this may not be necessary in the official release - - ./configure --without-server \ - --without-force-uid \ - --with-user=yourlogin \ - --with-group=Administrators - make - make # yes, I needed to run it a second time - make install - -The use of your own login instead of SYSTEM requires some explanation. If you -were to call runconfigure with SYSTEM instead of your own login id as part of -the -with-user parameter, the installation process will fail due to the way -Cygwin and the NT/W2K/XP security system interact. Once you chown a file to -another user (like SYSTEM) you are no longer able to chgrp or chmod the file. -The installation process will abort at this point. By installing the files -owned by yourself, you will be able to chgrp and chmod them as expected. Note -that you still RUN as SYSTEM from /etc/inetd.conf (see below). - - Configure Cygwin files - -You have to modify some config files: - -* /etc/inetd.conf: cleanup un-needed entries: Comment out any entries you do - not need by placing a '#' at the start of the lines. This is just good - practice, and if any of the entries reference non- existent users (e.g. uucp) - inetd may not start up. - - -* /etc/inetd.conf: add - - amanda dgram udp wait System /usr/local/libexec/amandad amandad - - ATTENTION: Use tabs, don't use spaces. - - -* create _/home/root/.amandahosts_ (or whereever System's home directory is): - - -Then create the following Amanda directories and the file amandates: - - mkdir -p /usr/local/var/amanda/gnutar-lists - - mkdir /tmp/amanda - - touch /etc/amandates - - - Configure Windows System Files - -Update the Windows services list - -* WINDIR\Services: add - - amanda 10080/udp # Amanda backup services - amandaidx 10082/tcp # Amanda backup services - amidxtape 10083/tcp # Amanda backup services - - -where WINDIR is C:\WINNT\system32\drivers\etc or something similar. The last -two lines are needed if you want to use amrecover. -Ensure that the default Windows PATH environment variable include your Cygwin / -bin directory. This is necessary since inetd and hence the amandad that it -spawns will not have the advantage of being started by the standard bash shell -startup script and won't find the needed dynamic libraries (e.g. cygwin1.dll). -My PATH is: - - _%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\cygwin\bin_ - -This is on XP; My Computer, right click Properties, click on Environment -Variables (at the bottom). Yours may vary, but make sure the Cygwin bin -directory is represented somewhere in the PATH. - - Configure inetd to run automatically as a service - -If you want to test your installation, you can call inetd from bash prompt: - - /usr/sbin/inetd -d - - - Windows 98/ME - - -* To start after the user logs in: Create a shortcut to c: - \cygwin\usr\sbin\inetd.exe in WINDIR\start menu\programs\startup - - -* To start before the user logs in: Add the string key - - CygwinInetd=C:\cygwin\usr\sbin\inetd.exe - - under - - HKLM\Software\Microsoft\Windows\CurrentVersion\RunServices - - in the registry. You'll see a dos-like window on the startup: I did not find - a solution to iconize or to make invisible (suggestions are welcome). - - - Windows NT/2000/XP - -From bash prompt, type: - - /usr/sbin/inetd --install-as-service - -Then, to start/stop the inetd service use the Services control panel or the -following Windows command: -net start/stop inetd - - Notes on Amanda backup options - - - Compression - -Currently, client side compression does not work, probably due to problems in -pipe emulation in Cygwin. I have not tried to debug this yet. This may be -addressed in a subsequent release, or it could be fixed in later releases of -Cygwin. Due to this issue, we recommend that if you want compressed dumps from -Windows clients, you configure Amanda for server compression in amanda.conf on -your Amanda server: - - define dumptype srv-comp-tar { - global - comment "partitions dumped via tar with server compression" - program "GNUTAR" - compress server fast - exclude list ".Amanda.exclude" - } - - - Exclude Lists - -A note on exclude lists is also in order. If you specify a relative path, it -will be expected that the file is in or relative to the root of the directory -you are planning to dump. Typically this will not be '/' but '/cygdrive/c' or -something similar if you want to get the Windows files and the Cygwin files. '/ -' is taken to be the root of the Cygwin tree, normally something like C: -\cygwin or possibly C:\Program Files\cygwin. - - Debugging Files - -Amanda will leave debugging files in /tmp/amanda if it exists. I have -recommended to create this directory above. - -Note - -Refer to http://www.amanda.org/docs/howto-cygwin.html for the current version -of this document. -------------------------------------------------------------------------------- - -Prev Up Next -Part III. HOWTOs Home Chapter 13. How to use the Amanda file-driver -