NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: COPYNLM3.EXE; COPY.NLM Server Utility README FOR: COPYNLM3.EXE NOVELL PRODUCTS and VERSIONS: IntranetWare NetWare 4.11 NetWare 3.12 NetWare 4.1 ABSTRACT: COPY.NLM is a server utility to copy files between servers (without involving any clients). NOTE: The functionality of this utility has been rolled into ToolBox.nlm. Therefore, no more enhancements or fixes will be made to this utility. NOTE: This utility helps system administrators. It is provided free of charge as a courtesy, and therefore, is not a Novell supported product. Problems or questions regarding this product can be reported via e-mail to NTSUTIL@NOVELL.COM. ----------------------------------------------------------------- DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ----------------------------------------------------------------- ISSUE: n/a Self-Extracting File Name: copynlm3.exe Files Included Size Date Time ..\ COPYNLM3.TXT (This file) COPY.NLM 11595 10-31-97 11:29:46 am COPYNLM3.TXT 8242 10-31-97 1:19:48 pm Installation Instructions: COPY.NLM version 1.7a (NetWare v3.12, v4.x, and IntranetWare) Copyright (C) 1997 Novell, Inc. All Rights Reserved ________________________________________ CONTENTS ________________________________________ I. Abstract II. Installation Instructions III. Usage IV. Product Description V. Enhancements/Bug Fixes VI. Known Issues VII. Frequently Asked Questions ________________________________________ I. ABSTRACT ________________________________________ COPY.NLM is a server utility to copy files between servers (without involving any clients). ************************************************************* NOTE: The functionality of this utility has been rolled into ToolBox.nlm. Therefore, no more enhancements or fixes will be made to this utility. ************************************************************* NOTE: This utility helps system administrators. It is provided free of charge as a courtesy, and therefore, is not a Novell supported product. Problems or questions regarding this product can be reported via e-mail to NTSUTIL@NOVELL.COM. ________________________________________ II. INSTALLATION INSTRUCTIONS ________________________________________ Copy COPY.NLM to the SYS:\SYSTEM directory on your server. ________________________________________ III. USAGE ________________________________________ load copy SourceSpec DestPath [Username Password] [Options] ________________________________________ IV. PRODUCT DESCRIPTION ________________________________________ The COPY NLM is used to copy files on the local server, on a remote server, or between the local and remote servers. It is not designed to copy files between two remote servers. Copy SYNTAX: load copy SourceSpec DestPath [Username Password] [Options] SourceSpec = [servername/]vol:path/filespec Specifies the source file(s) to copy. Must include volume. Wildcards may be used. Can specify a DOS drive letter. Examples: silicon/sys:system/*.nlm vol1:*.dat vol1:temp/myfile.txt c:\nwserver\sta*.* DestPath = [servername/]vol:path/[file] Destination directory or file. Can specify a DOS drive letter. If the directory does not already exist, an error will be returned. Wildcards are not allowed in the destination filespec. Examples: silicon/sys:system/ silicon/sys:system vol1:/ silicon/sys:system/testapp.nlm a: c:\nwserver Username = User for authentication to remote server Since copy needs to authenticate to both the source and remote servers, the username and password must be valid for both servers. NDS and bindery authentication cannot be used concurrently Password = Password for user If the user has no password, this parameter should contain empty double quotes. i.e. "" Options = All options should be separated by spaces /b - Force bindery authentication This option will bypass NDS authentication attempts. This is useful when you need to copy between a 3.x and 4.x server and the Username/Password is the same for both servers. /a - This option supresses copying of Dos and NetWare attributes. EXAMPLES: Copy all .EXE files from sys:public to vol1:savepublic on the local server. >load copy sys:public/*.exe vol1:savepublic Copy one file (tmp.log) from a remote server (borg) to the local server and rename the file in the process. >load copy borg/sys:etc/tmp.log sys:etc/borgtmp.log admin yo Copy all .log files from one volume to another on a remote server. In this case, the admin user has no password. >load copy borg/sys:*.log borg/vol1: admin "" Copy one file (tmp.log) to a remote 3.x server, or a remote 4.x server not in the local tree. >load copy sys:tmp.log sr71/sys: joe bananas /b /a ________________________________________ V. ENHANCEMENTS/BUG FIXES ________________________________________ Enhancements to version 1.7 - Added wildcard support in the source filespec. - Allowed the copy to go in any direction between servers. - Added NDS authentication. Enhanced the help screen. - Will load on 3.x and 4.x. - Added ability to copy to the DOS partition. - Will now copy the date/time and attributes of source file. - Added switch to disable copying of DOS and NetWare attributes. Enhancements to version 1.7a - Fixed accidental logout if NDS symbols weren't imported. - Fixed abend if password was not specified. ________________________________________ VI. KNOWN ISSUES ________________________________________ Issue 1: If files already exist in the Destination path, they will be overwritten without warning. Issue 2: SourceSpec and DestPath must use 8.3 DOS names. Only DOS name spaces are used. Issue 3: Copy will not create directories. Issue 4: Will not copy subdirectories (no recursive copying). Issue 5: Will not copy to the DOS partitions on remote servers. Issue 6: Extended attributes and trustees are not copied. Issue 7: Files copied to the DOS partition will not preserve dates and attributes. Issue 8: Copy is NOT reentrant, thus it cannot be run successively from an NCF file. ________________________________________ VII. FREQUENTLY ASKED QUESTIONS ________________________________________ Q: Why is my destination file 0 length? A: Copy returns immediately to the console prompt because it is a background process. When it's done, it displays a done message on the console prompt. Q: When I try to make a backup of a directory, I get messages like "Unable to create the destination file SYS:/SYSTEM2/AFP". A: Copy couldn't create the file because it couldn't create the directory to put the file (Known Issue 4 above). A: How can I call copy multiple times? Q: Since Copy is not reentrant you will need to use a task scheduler such as Cron.nlm to schedule multiple copies. ----------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. -----------------------------------------------------------------