home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 30 fixes_v / 30-fixes_v.zip / lr11de.zip / MANUAL.TXT < prev    next >
Text File  |  1994-12-12  |  37KB  |  861 lines

  1. What is LinkRight??
  2. Sales Information
  3. Differences Between Version 1.0 and 1.1
  4. Differences Between Version 1.1 and 1.1E
  5. Installation
  6.   LinkRight LPT Driver
  7.   Compression Driver
  8. Cables
  9. Quick Start
  10.   Navigating Directories
  11.   Copying Files and Directories
  12. Hot Keys
  13. Directory Syncronization
  14. DOS Version
  15. OS/2 Command Line Version
  16. Verify Failures
  17. Batch Mode
  18. Connections
  19. Log Options
  20. System Options
  21.   Copy Subdirectories
  22.   Copy Newer Files Only
  23.   Force Copy
  24.   Copy Archive Only
  25.   Autostart
  26.   Verify Options
  27.   Max Packet Size
  28.   Retry Warning Delay
  29. Pushbuttons
  30.   Delete Pushbutton
  31.   Mkdir Pushbutton
  32.   Refresh Pushbutton
  33. Cloning an OS/2 Partition with LinkRight Cloner
  34.   Initial Preparation
  35.   Bootable OS/2 Floppies
  36.   LPT Drivers
  37.   Modifying the OS/2 Bootable Diskettes
  38.   Preparing the Target System
  39.   Running LRCLONER.EXE
  40.   Restarting a Cloning Operation
  41.   The Final Step
  42.   Potential Problems
  43. Hints and Tips
  44. Bugs and Missing Features
  45. Future Stuff
  46. Technical Support
  47.  
  48.  
  49. What is LinkRight??
  50.  
  51. LinkRight is a serial and parallel port file transfer utility for OS/2.
  52. It features DCF/2 compression for faster transfers and CRC checking for
  53. accurate transfers.  It includes a PM version and a DOS version.
  54. Version 1.1 has LinkRight Cloner which can be used for cloning an
  55. entire OS/2 partition (including the OS/2 operating system) from one
  56. system to another (in accordance with your licensing agreement with
  57. IBM; no bootlegging please).  LinkRight handles EAs and HPFS easily.
  58. LinkRight is multithreaded, so while you are transferring files in
  59. the background, you can continue to queue more files for transfer,
  60. change directories on either machine, delete files, etc.
  61.  
  62. LinkRight is not shareware.  It is a commercial shrink wrapped
  63. product and version 1.1E is available at CompUSA, Egghead, Indelible
  64. Blue and other retailers.  Street price is around $69 without cables
  65. and $89 with cables.  Like Microsoft, we have no Manufacturers 
  66. Suggested Retail Price (MSRP).
  67.  
  68. Sales Information
  69. LinkRight is available from Indelible Blue (919) 834-7005 or (800) 776-8284, The Corner 
  70. Store 1-800-I BUY OS2. Egghead, and CompUSA.  
  71.  
  72. For quantity discounts, you should contact:
  73. Rightware Inc.
  74. Susan Tremble, Vice President of Marketing.
  75. Voice (maybe voice mail) (301)762-1151
  76. Fax (301)762-1185
  77.  
  78. Differences Between Version 1.0 and 1.1
  79.  
  80. There are too many differences to mention.  We suggest that users
  81. of LinkRight 1.0 read this manual all the way through.  Although it
  82. will cover things you already know, it is the best way to get the
  83. new information.  
  84.  
  85. ***********Important*********
  86. LinkRight 1.0 is incompatible with LinkRight 1.1.  You should use
  87. LinkRight 1.1 on both the Local and Remote machines OR you should
  88. use LinkRight 1.0 on both the Local and Remote machines.
  89. *****************************
  90.  
  91. Differences Between Version 1.1 and 1.1E
  92.  
  93. You have version 1.1E.  You can check the version number by starting
  94. LinkRight and looking at the bottom of the screen that asks you 
  95. whether you want Local or Remote mode.  When you start LRCLONER or
  96. LRDOS, the version number is shown.  Also, when LRPAR.SYS is loaded,
  97. the version is displayed.
  98.  
  99. OS/2 Warp Version 3.0 uses polled printing as a default which breaks
  100. LinkRight 1.1.  LinkRight 1.1E has been modified to use polled also
  101. as the default option, so it works well with OS/2 Warp.  Since 
  102. LinkRight 1.1E now can use polled, it will work well with OS/2 version
  103. 2.0.  Replacement of PRINT01.SYS or PRINT02.SYS is no longer required.
  104.  
  105. LinkRight 1.1E will overwrite Read Only files.  It is up to the user
  106. to use caution to make sure important files are not overwritten.
  107.  
  108. LinkRight 1.1E implements Idle Time only transfers.  This is the
  109. preferred mode, your system usage and requirements may differ.
  110.  
  111. LinkRight 1.1E allows 8 bit transfers and 4 bit transfers through
  112. the parallel port.
  113.  
  114. LinkRight 1.1E no longer allows a user to mark files or directories
  115. on both sides and copy them.  The new method to accomplish this is
  116. to mark one side first, do a copy, mark the other side, and copy
  117. again.
  118.  
  119. Retry Warnings can be disabled by setting this option to the 
  120. maximum value of 9.
  121.  
  122. Autostart is disabled and is no longer supported.
  123.  
  124. Assorted bugs have been fixed with this new version.
  125.  
  126. Parallel port speed is much faster with LinkRight 1.1E.
  127.  
  128. ***********Important*********
  129. LinkRight 1.1 is incompatible with LinkRight 1.1E.  You should use
  130. LinkRight 1.1E on both the Local and Remote machines OR you should
  131. use LinkRight 1.1 on both the Local and Remote machines.  The matching
  132. version of LRPAR.SYS should also be used.
  133. *****************************
  134.  
  135. Installation
  136.  
  137. To install LinkRight, insert the LinkRight floppy into drive a: (or
  138. b:) and type a: (or b:).  Then from the a:\> prompt (or b:\> prompt)
  139. type install.
  140.  
  141. If you choose Update CONFIG.SYS, drivers are installed automatically,
  142. and your CONFIG.SYS is updated.  Backups are made of all files.  Your
  143. backup CONFIG.SYS will be named CONFIG.BAK.  
  144.  
  145. If you selected Update CONFIG.SYS, you should read the next 3 sections
  146. but you do not have to do anything.  All drivers, etc. will be installed
  147. for you (if necessary).
  148.  
  149. LinkRight LPT Driver
  150.  
  151. The following line in your CONFIG.SYS file installs the LinkRight Parallel
  152. Port Device Driver:
  153.  
  154. DEVICE=C:\OS2\LRPAR.SYS
  155.  
  156. The complete list of options for LRPAR.SYS are
  157.  
  158. DEVICE=LRPAR.SYS /Q:7 /P /A:3BC /M
  159.  
  160. where:
  161.  /Q:7 uses IRQ7 or /Q:5 uses IRQ5.  These are the only IRQs supported.
  162.  Interupt driven mode can only be used if PRINT01.SYS or PRINT02.SYS
  163.  also uses the same interupt.  If no /Q option is selected, polled is
  164.  assumed.
  165.  
  166.  /P is for polled.  This is a useless option, since it is the default.
  167.  
  168.  /A:3BC or /A:378 or /A:278 select the address of the LPT port for
  169.  LinkRight to use.  If this parameter is used, only one address can
  170.  be specified.  Then, when you select Connect from the LinkRight 
  171.  menu, no matter which LPT port you select, either LPT1, LPT2 or
  172.  LPT3, LinkRight will use the address specified.  If this parameter
  173.  is not included, LinkRight reads the BIOS info at bootup time to
  174.  get the LPT addresses.
  175.  
  176.  /M is to specify MicroChannel machines.  For some MicroChannel systems
  177.  when booted from bootable floppies, LinkRight would not see that it
  178.  was MicroChannel and would assume an ISA bus.  This caused the
  179.  driver to fail.  So if you boot your MicroChannel system from floppies
  180.  and the LinkRight driver displays a message at bootup time saying
  181.  an ISA bus was found, use this parameter to fix the problem.
  182.  
  183.  The preferred and suggested mode of use is no parameters on the 
  184.  LRPAR.SYS line in CONFIG.SYS.  You can add parameters if there are
  185.  any problems.
  186.  
  187. OS/2 versions 2.0 and 2.1 can only use polled.  Version 2.11 and 3.0
  188. can use polled or interupt driven.  Even for version 2.11 and 3.0 we
  189. recommend that you use polled, which is the default.
  190.  
  191. After you have installed the par port drivers, shutdown and reboot
  192. to get the new drivers running.  You are now ready to run LinkRight
  193. beta 1.1.
  194.  
  195. DCF/2 Compression
  196. LinkRight uses the DCF/2 compression driver.  We found that it provided
  197. the best, fastest compression possible.  It is SIGNIFICANTLY better than
  198. the compression algorithm used with LinkRight 1.0.
  199.  
  200. This will not compress your entire disk.  Compression will only be
  201. used to compress packets that are sent thru the parallel port or
  202. serial port.  For complete disk compression, contact the DCF/2 
  203. people.
  204.  
  205. The following line in your CONFIG.SYS file installs DCF/2 compression.
  206.  
  207. DEVICE=C:\OS2\DCF2CDE.SYS
  208.  
  209. Cables
  210.  
  211. LinkRight requires LapLink type cables.  Do not try to use a normal
  212. printer cable because it won't work.  Some serial null modem cables
  213. work with LinkRight, some don't.  LinkRight requires serial null
  214. modem cables with 7 pins wired thru, while some cables only have
  215. 3 wires.
  216.  
  217.  Serial Pinouts
  218.  
  219.  9 pin    25 pin       25 pin        9 pin
  220.   
  221.   5         7            7             5   Ground to Ground
  222.   3         2            3             2   Transmit - Recieve
  223.   7         4            5             8   RTS - CTS
  224.   6         6            20            4   DSR - DTR
  225.   2         3            2             3   Receive - Transmit
  226.   8         5            4             7   CTS - RTS
  227.   4         20           6             6   DTR - DSR
  228.   
  229.   
  230.  Parallel Pinouts  - Shielded low capacitance cable recommended
  231.   
  232.  25 pin       25 pin
  233.   
  234.     1            1
  235.     2           15
  236.     3           13
  237.     4           12
  238.     5           10
  239.     6           11
  240.     15           2
  241.     13           3
  242.     12           4
  243.     10           5
  244.     11           6
  245.     14          14
  246.     16          16
  247.     17          17
  248.     25          25
  249.  
  250. Quick Start
  251.  
  252. When you first start LinkRight, you are given a choice of whether you
  253. want to make the machine the Local machine or the Remote machine.
  254. You should make one machine the Local, and the other Remote.  You will 
  255. control all file transfers from the Local machine.  
  256.  
  257. After making a machine the Remote machine, you should select which port
  258. to connect on the Remote machine.  That should be the last selection you
  259. make on the Remote machine.
  260.  
  261. For the Local machine, you must also select a port to connect.  If you 
  262. have a box on BOTH machines that says "Establishing a connection Please
  263. Wait", there is a problem with the connection.  Make sure you selected 
  264. the proper ports, cables are connected, etc.
  265.  
  266. A common error is to select a port to connect from on the Local machine
  267. without selecting a corresponding port on the Remote machine.  You must
  268. select a connect port from BOTH the Local and Remote machine. If you 
  269. cannot establish a connection using LPT ports, you should make sure you
  270. have the proper drivers installed.
  271.  
  272. Navigating Directories
  273.  
  274. The left side of your screen displays drives, directories, and files in
  275. the current working directory of the Local machine.  The right side of
  276. your screen displays the same information for the Remote machine.
  277. The current working directory and drive for the Local and Remote machine 
  278. is shown on the line above the list of drives, directories, and files.
  279.  
  280. To change directories on either the Remote computer or the Local computer,
  281. double click on the directory you want to change to.  The directory ".."
  282. is the parent directory.  You can change the current working drive by
  283. double clicking on one of the drives.
  284.  
  285. Copying Files and Directories
  286.  
  287. Use the Copy button to send files and directories from the Local computer to the Remote
  288. computer or to send files and directories from the Remote computer to the Local computer.
  289.  
  290. First, mark files and directories by single clicking the primary (left) mouse
  291. button.  Then, hit the Copy button.  If you have marked files from both 
  292. the Remote side and the Local side, transfer order is Local to Remote first,
  293. then Remote to Local.
  294.  
  295. Marking and copying a drive is not supported.  To copy a complete drive, individually
  296. mark all files and directories in the root directory of the drive to be copied.  Do
  297. not mark the files EA DATA. SF or WP ROOT. SF, since they will not be copied.
  298.  
  299. The screen is not automatically refreshed after copying.  Hit the Refresh Pushbutton
  300. to update the screen.
  301.  
  302. Hot Keys
  303.  
  304. F10 Moves focus to the Menu
  305. TAB Moves focus to the Local or Remote list of files 
  306. Return Selects an entry
  307. Space marks an entry
  308. Arrow Keys move the cursor within a group
  309.  
  310. Directory Syncronization
  311. To perform Directory Syncronization, select Newer Files Only from 
  312. the Options Screen. Change directories on both the Local and Remote
  313. computer to the parent directory of the two directories you want to
  314. synchronize.  Mark the directory on one side and hit the Copy pushbutton.
  315. Mark the directory on the other side of the screen and hit the Copy
  316. pushbutton.
  317.  
  318. Note: the directories must have the same name.
  319.  
  320. DOS Version
  321. The DOS version can only be used as the Remote computer.  The DOS version
  322. uses command line parameters to select which port to use.  At the DOS 
  323. prompt, type LRDOS.EXE with no parameters for a list of valid parameters.
  324.  
  325. To install the DOS version, copy the file LRDOS.EXE to a subdirectory on
  326. your DOS machine.
  327.  
  328. OS/2 Command Line Version
  329. LinkRight Cloner can be used from an OS/2 command line and can be used in 
  330. the Remote or Local mode.
  331. LRCLONER uses command line parameters to select the mode,
  332. which port to use, and the batch file to use.  At the OS/2 command line 
  333. prompt, type LRCLONER with no parameters for a list of valid parameters.
  334.  
  335. Verify Failures
  336.  
  337. Some files may not verify properly.  This may or may not be a critical
  338. error.  If a file cannot be read, it cannot be copied.  Executable files
  339. or .DLL files that are currently in use are the usual culprits here.
  340.  
  341. Batch Mode
  342.  
  343. When you select Batch Mode On, you can mark files and hit the Copy 
  344. pushbutton.  No files are sent or received.  Instead, file information is saved 
  345. into a list of files.  Later, you can send/receive the files by selecting
  346. Run Batch File.
  347.  
  348. After selecting Batch Mode On and selecting files to send/receive, you should
  349. select Batch Mode Off to save the Batch file and return to Normal mode.
  350.  
  351. If file transfers fail for some reason, a special batch file is created called
  352. the Retry file.  The file specification is <BASEDIR\RETRY.LRB> where BASEDIR is
  353. where you installed LinkRight.  You can View the Retry file by selecting View\Retry.
  354. If you select Run Retry File, LinkRight will send/receive the files listed.
  355.  
  356. After creating a Batch file, you can run it by selecting Run Batch File.
  357.  
  358. The batch file is straight ASCII text.  It can be edited with a text editor.  
  359. Caution should be used when creating a batch file using a text editor. Spaces
  360. are significant.
  361.  
  362. Conections
  363.  
  364. You can select which port to use for your connection from the Connect 
  365. menu.
  366.  
  367. If you have a message box on BOTH machines that says "Establishing a 
  368. Connection Please Wait", there is a problem with the connection.  Make 
  369. sure you selected the proper ports, cables are connected, etc.  
  370.  
  371. A common error is to select a port to connect from on the Local machine
  372. without selecting a corresponding port on the Remote machine.  You must
  373. select a connect port from BOTH the Local and Remote machine.
  374.  
  375. If you cannot establish a connection using LPT ports, you should make sure
  376. that the drivers LRPAR.SYS and PRINT0X.SYS are installed properly.
  377.  
  378. Upon completion of a successful LPT connection, LinkRight will negotiate the
  379. top speed that it can use between these two specific machines.  
  380. LinkRight 1.1 takes about
  381. 1 or 2 seconds to negotiate with the other machine the proper speed.
  382. Please don't do anything while this is going on.  Don't even
  383. move the mouse.  LinkRight wants all CPU time and all bus time
  384. so that it can calculate the maximum speed that these two 
  385. machines can use.
  386.  
  387. Log Options
  388.  
  389. You can select options of append, overwrite, and disabled for the Logs.
  390. These options control handling of the Event Log, Error Log, and Retry file.
  391.  
  392. Two kinds of logging takes place.  Event logging and Error logging.
  393. A Retry batch file is also created if there is a file transfer error.
  394.  
  395. The Event log contains useful information for keeping track of what
  396. files have been transferred.  You can view the Event log by selecting
  397. View\Event Log.  The path and name of this file is <BASEDIR\EVENT.LOG>
  398. where BASEDIR is where you installed LinkRight.
  399.  
  400. The Error log contains useful information for keeping track of any
  401. LinkRight errors.  You can view the Error log by selecting
  402. View\Error Log.  The path and name of this file is <BASEDIR\ERROR.LOG>
  403. where BASEDIR is where you installed LinkRight.
  404.  
  405. System Options
  406.  
  407. Copy Subdirectories
  408.  
  409. If this box is marked, subdirectories are copied.  If this box is not marked, only 
  410. individually marked files are copied.
  411.  
  412. Copy Newer Files Only
  413. If this box is marked, only newer files are copied.  The date and time checked
  414. is the "Last Written" date and time.
  415.  
  416. Force Copy
  417. If this box is marked, all files are copied regardless of flags or dates.
  418.  
  419. Copy Archive Only
  420. If this box is marked, all files with the Archive bit set are copied.  Other files
  421. are ignored.  The Archive bit is reset for any files copied using this option.
  422.  
  423. Autostart
  424.  
  425. Autostart is disabled and is no longer supported.
  426.  
  427. Verify Options
  428. There are a few Verify Options you can use.  These options are
  429. an afterthought and are not well integrated.  For internal testing
  430. before release, We had debug code to do a verify after every file
  431. transfer.  It helped me find errors.  When we mentioned this to one
  432. of the beta testers, he suggested we leave it in the released version.
  433.  
  434. Verify performs a CRC check and Checksum test on a file by file
  435. basis.  If you select "Transfer and Verify", it will transfer the
  436. file, do the check, and display the results.  If you select 
  437. "No Copy, Verify Only", it overrides the Force Copy options and does
  438. not transfer files, just does the Verify test.  "No Verify" is
  439. self explanatory.
  440.  
  441. Max Packet Size
  442. Max Packet Size affects thruput and system responsiveness.  If you 
  443. have a serial mouse and are doing LPT port file transfers, you will
  444. find that your mouse is useless unless you set a low number for 
  445. packet size.  PS/2 style mice that use high interupts should allow
  446. you to use the maximum packet size.  Aren't you glad you got a PS/2
  447. or ThinkPad??
  448.  
  449. If you are using LPT ports, you should use caution in setting a high
  450. packet size.  If both machines are 486s, you should be able to use
  451. 1024 as a packet size.  If one of the machines is a 386, you are
  452. better off selecting 512 as a packet size.  If one machine is a 286,
  453. you should use 256 as a packet size.
  454.  
  455. Turbomode implements a sliding window for packets and should result
  456. in higher thruput.
  457.  
  458. Retry Warning Delay is the time that the Local system will wait for
  459. a reply from the Remote machine before displaying a Warning msg.  If
  460. you are getting lots of warnings, set this value higher.  If you set
  461. this to the maximum value, you will never get a Retry Warning.
  462.  
  463. If you get a Retry Warning, select Retry, and nothing happens with
  464. LinkRight not continuing to transfer files, try opening an OS/2 window
  465. and doing a dir command.  Do this on both the Remote and Local machines.
  466. This should cause the machines to regain sync.
  467.  
  468. Pushbuttons
  469.  
  470. Delete Pushbutton
  471. Use the Delete button to delete files and directories.  Directories must be empty
  472. before they can be deleted.
  473.  
  474. Mkdir Pushbutto
  475. Use the Mkdir button to create directories on either the Remote computer or
  476. the Local computer  
  477.  
  478. Refresh Pushbutton
  479. The Refresh button will redisplay the file list for both the Local and
  480. Remote computer.
  481.  
  482. Cloning an OS/2 Partition with LinkRight Cloner
  483.  
  484. LRCLONER.EXE can be used to copy an entire OS/2 partition, including 
  485. the operating system, to another machine.
  486.  
  487. Initial Preparation
  488.  
  489. To prepare to clone an entire OS/2 system, the first thing you should
  490. do is get LinkRight 1.1 working between two systems that already
  491. have OS/2 installed.  Or even one OS/2 machine and one DOS machine.
  492. It is much easier to get LR.EXE working than LRCLONER.EXE.  Consider 
  493. it good practice.  Doing this first will make sure that the drivers 
  494. work on your machine.  After you have successfully 
  495. transferred a few files and small directories using LinkRight in PM
  496. mode, you can attempt to clone a system.
  497.  
  498. *******Important Note*********
  499. Make sure that all files and directories go where you want them to go
  500. before doing a complete clone.  I've had users transfer hundreds of
  501. Megs only to find that they transferred the files to a subdirectory
  502. rather than the root directory.  They had to start over and we don't
  503. want to see this happen to you.  It's another good reason to practice
  504. for a while first with the PM version of LinkRight.
  505. ******************************
  506.  
  507. A good command to know about is dir /n.  This will show the files
  508. in a directory and the extended attributes associated with each file.
  509. Since cloning OS/2 doesn't work if EAs don't get transferred, you 
  510. should make sure that EAs get transferred properly.
  511.  
  512. Bootable OS/2 Floppies
  513.  
  514. You will need to build OS/2 bootable floppies.  You will have to make
  515. minor modifications to the first two OS/2 disks, plus you may need
  516. the first two original OS/2 disks, depending on your system.  You have 
  517. two possible ways to create these disks.  If OS/2 is on CDROM, use the
  518. utility on the CDROM to create the Installation Diskette and Diskette
  519. 1.  If you have OS/2 on diskettes, use DISKCOPY to duplicate the 
  520. diskettes.  DISKCOPY help can be found by typing "help diskcopy" at
  521. an OS/2 command prompt.
  522.  
  523. ******  IMPORTANT  ******
  524. DO NOT USE THE ORIGINAL DISKS.  THEY MUST BE MODIFIED.
  525.  
  526. IF YOU HAVE OS/2 ON CDROM, DO NOT USE DISKCOPY.  USE THE DISKIMAGE
  527. UTILITY ON THE CDROM.
  528. *************************
  529.  
  530. The Installation Diskette (Diskette 0) can be used as is.  Diskette
  531. 1 needs to be modified.
  532.  
  533. Modifying The OS/2 Bootable Diskettes
  534.  
  535. Included with the LinkRight 1.1 package is a sample CONFIG.SYS file.
  536. You should copy this file to Diskette 1 to replace the CONFIG.SYS
  537. file that is there.  
  538.  
  539. There are other differences in the standard OS/2 Bootable Diskettes
  540. CONFIG.SYS file and the sample that comes with LinkRight 1.1.  If
  541. you examine it, you will see that the swapper is enabled, plus a 
  542. few other minor differences.  These differences are important for
  543. the successfull operation of LinkRight Cloner.
  544.  
  545. **************Important***************
  546. You must modify the sample CONFIG.SYS to use either PRINT01.SYS or
  547. PRINT02.SYS.
  548. **************************************
  549.  
  550. Select which PRINT0X.SYS that was distributed with the LinkRight 
  551. diskette that you want to use on your target machine.  Micro Channel
  552. machines should use PRINT02.SYS while ISA/EISA machines should use
  553. PRINT01.SYS.
  554.  
  555. Copy the file LRPAR.SYS Diskette 1.  This is the
  556. LinkRight parallel port device driver.  Also copy DCF2CDE.SYS to
  557. Diskette 1.
  558.  
  559. You may have to delete some files to make room.
  560. We would suggest deleting FDISK.COM and FORMAT.COM from the modified
  561. bootable floppies to make room.  If you are not using HPFS, you
  562. can delete the HPFS specific files also.
  563.  
  564. Preparing the Target System
  565.  
  566. The target system must have a hard drive that is partitioned and
  567. formatted.  If you have a virgin drive on the target system and 
  568. wish to use HPFS, use the ORIGINAL OS/2 diskettes to boot, partition,
  569. and format the drive.  If you have a virgin drive on the target
  570. system and wish to use FAT, you can probably boot from a DOS 
  571. bootable diskette (faster than the ORIGINAL OS/2 diskettes) and
  572. partition and format the disk.
  573.  
  574. The Target machine needs a directory for the swapper file.  
  575. THIS DIRECTORY SHOULD BE CALLED TEMPSWAP.  From an OS/2 command 
  576. prompt type "md c:\tempswap".
  577.  
  578. The target machine needs a directory to contain temporary files.  THIS
  579. DIRECTORY **MUST** BE NAMED "TEMP".  The reason why LinkRight is
  580. so strict about this is that LinkRight Cloner will mess up if it
  581. tries to transfer files that it shouldn't.  Therefore all files 
  582. in the TEMP directory will be skipped.
  583.  
  584. The target machine must have a few files placed in the TEMP directory.
  585. CMD.EXE and LRCLONER.EXE must be in this directory.  You
  586. can find CMD.EXE in your C:\OS2 directory on a machine
  587. that has OS/2 installed.
  588.  
  589. YOU MUST FINISH PREPPING THE TARGET MACHINE BEFORE BOOTING FROM THE
  590. MODIFIED OS/2 BOOTABLE FLOPPIES.  The Bootable Floppies, with
  591. the CONFIG.SYS that comes with LinkRight will not boot
  592. unless CMD.EXE is in the TEMP directory and the TEMPSWAP directory
  593. exists.
  594.  
  595. Running LRCLONER.EXE
  596.  
  597. Now comes the easy part.  After you have booted the target machine from
  598. the modified bootable floppies, change the current working drive
  599. from A: to C:.  Change directory to TEMP.  Do a DIR command.  You
  600. should see CMD.EXE and LRCLONER.EXE.  IT IS IMPORTANT
  601. THAT YOU BE LOCATED IN THE TEMP DIRECTORY WHEN YOU START LRCLONER.EXE.
  602. After starting LinkRight and establishing a connection, be sure to
  603. change directories on the Remote system to the Root.
  604.  
  605. For the Target system, type:
  606.  
  607. LRCLONER T LPT1
  608.  
  609. Alternatively, if you want to use serial ports, make sure you have COM.SYS
  610. and VCOM.SYS on the bootable floppies and are installed in the config.sys
  611. file.  Then you can type LRCLONER T COM2 HI, or whatever to clone using
  612. serial ports.
  613.  
  614. Run the full PM version of LinkRight 1.1E from the Source system.  
  615. This machine should already be tested to run LinkRight 1.1E, so
  616. the drivers, etc. are already installed and working.  Make it the Local 
  617. machine.  Select Connect/LPT1 and establish a connection between the
  618. systems.  Now select the files and directories that you want transferred.
  619. Do not transfer EA DATA. SF or WP ROOT. SF.  You can transfer everything
  620. else. Allow about 20 seconds for them to negotiate speed.  Then they should
  621. start making directories and a little later start sending and recieving 
  622. files.
  623.  
  624. ********Hot Tip***********
  625. Have your Source machine use a different partition for the swapper.  If
  626. OS/2 is on C:, have your swap file located on D:.  When you clone your
  627. Source machine, your swap file (which could be 2 to 12 Meg) won't get
  628. copied.  This file is not needed on the Target (remember setting your
  629. swap file to C:\TEMPSWAP ??), so you're just wasting time transferring
  630. this file.
  631. **************************
  632.  
  633. Alternatively, rather than running the full PM version of LinkRight on 
  634. the Source system, you can run LRCLONER.EXE from this machine also.  I've
  635. been told that to clone OS/2 2.0 you must use this method along with serial
  636. ports while using OS/2 bootable diskettes, but we have not tested it 
  637. extensively.  Supposedly, OS/2 2.0 locks certain files when booted with PM
  638. so these files won't get transferred.  OS/2 2.1 does not lock these files.
  639.  
  640. Restarting a CLONING Operation
  641.  
  642. If you have a problem and have to abort a cloning operation and want to
  643. restart from where you left off, it's easy to do.  First note the file
  644. that LRCLONER stopped on and retransfer that file.  Then set the Newer
  645. Files Only option, mark everything and hit the copy pushbutton.  It will
  646. grind a while, try to remake a bunch of directories that already exist,
  647. and then start transferring from where you left off.  Check the Status
  648. Report to see how things are going.
  649.  
  650. The Final Step
  651.  
  652. If the Source machine is idle and it looks like all of the files have been
  653. done, the transfer has completed successfully.  Select Connect/Disconnect
  654. from the Source machine.  This should cause the Target machine to exit
  655. LRCLONER.
  656.  
  657. Find an executable file called SYSINSTX.COM.  It is on your ORIGINAL OS/2
  658. Installation Diskette.  Run SYSINSTX C: to get the OS/2 boot record
  659. installed on the Target system.  Then comes the important step: reboot 
  660. the target machine and run a few programs and make sure everything is fine.
  661.  
  662. Potential Problems
  663.  
  664. Make sure you read this manual and carefully follow the instructions listed
  665. here.  If your modified bootable floppies don't boot, read the instructions
  666. and try again.  If you cannot establish a connection, it is probably a 
  667. problem with the CONFIG.SYS and LPT address or interupt.
  668.  
  669. The bootable floppies should be removed after booting.  LinkRight Cloner
  670. should run completely off the hard drive and should not need any files 
  671. that are on the floppies.
  672.  
  673. If the machines are not identical, you could have problems.  You've already
  674. noticed that ISA/EISA machines install PRINT01.SYS while Micro Channel 
  675. machines use PRINT02.SYS.  There are HUNDREDS more incompatibilities
  676. between Micro Channel and ISA, so don't even try cloning one to the other.
  677.  
  678. And there are lots of other potential incompatibilities.  SCSI vs. IDE,
  679. different video cards, CDROMs, sound cards, etc.  My recommendations 
  680. are to have the Source machine running VGA.  After the system is cloned, 
  681. you can add upgraded video drivers.  Optional features like sound cards 
  682. and CDROMs should also be added after cloning.
  683.  
  684. Hints and Tips
  685.  
  686. Be sure to read the file README.TXT for late breaking bugs, tips,
  687. workarounds, etc.
  688.  
  689. DOS and Windows file transfer utilities are single task oriented.
  690. You start a transfer, then stare at a status report until it is 
  691. done.  You can do the same thing with LinkRight by starting a transfer,
  692. then selecting File / Status.  Or you can do multitasking with LinkRight.
  693. Start a transfer, and while the transfer is going on in the background,
  694. change directories, delete files, queue more files for transfer, etc.
  695.  
  696. For higher thruput and easier use, you should make the faster of the
  697. two computers the Local computer, if possible.
  698.  
  699. Transfers from Local to Remote are faster due to better code
  700. optimization for this transfer direction.  So if you have a choice
  701. for which machine to make Local and which to make Remote, make the
  702. computer that will be sending most the Local system.  This 
  703. optimization is not a huge difference, maybe 10%, but it is 
  704. something to keep in mind.  This consideration overrides the faster
  705. computer consideration mentioned above.
  706.  
  707. The appearance of LinkRight can be easily customized.  Open OS/2 System / System
  708. Setup / Color Pallette and drag a color to a portion of the LinkRight screen.
  709. The new color will be preserved between sessions of LinkRight.  You can use
  710. the Scheme Pallete and Font Pallete to do similar customization.
  711.  
  712. If you are having problems getting reliable transfer completed, turn 
  713. Turbomode off and select a packet size of 128.  If won't help if you
  714. are having problems establishing connections, but it could help make
  715. transfers more reliable.
  716.  
  717. Serial port speed is tricky.  If both machines have 16550 UARTs,
  718. there is a very good chance that you can use HI speed comm (57.2 KBPS)
  719. for your connections.  If you have a 16550 UART on one machine and
  720. the other has a 16450 UART with a fast CPU (33 Mhz 486 or higher),
  721. you can probably use HI speed comm.  Otherwise, you should probably
  722. use MED speed comm (19.2 KBPS).  To test for a 16550, go to an
  723. OS/2 prompt, type MODE COM1 (or whichever COM you want LinkRight to
  724. use).  If you see the line "Buffer = ON", you have a 16550 UART.
  725. If the line says "Buffer = N/A" you have a 16450 or even worse
  726. an 8250.
  727.  
  728. Strangely enough, a straight DOS machine is more likely to accept
  729. a higher speed for COMM.  A 12 Mhz 286 class machine should work
  730. fine at Med speed.
  731.  
  732. If you have an original IBM PC, LPT port connections are probably
  733. out of the question.  Your best chance of establishling a connection
  734. on this machine (4.77 Mhz 8088) is thru serial ports at Low or Snail
  735. speed.
  736.  
  737. When you establish a connection, LinkRight 1.1E takes about
  738. 1 to 2 seconds to negotiate with the other machine the proper speed.
  739. Please don't do anything while this is going on.  Don't even
  740. move the mouse.  LinkRight wants all CPU time and all bus time
  741. so that it can calculate the maximum speed that these two 
  742. machines can use.
  743.  
  744. LinkRight stores all configuration info in the file LINKRGHT.CFG.
  745. To start LinkRight with the default options, delete this file.
  746.  
  747. LinkRight for the Remote computer uses the Options from the 
  748. Local machine.  It gets these options once, at connection time,
  749. so be sure to set the options BEFORE establishing a connection.
  750.  
  751. LRCLONER, when used in the source mode, uses the Options from
  752. LINKRGHT.CFG.  You can run the PM version of LinkRight, set the
  753. Options the way you want, then run LRCLONER in source mode.
  754.  
  755. For unattended transfers, set packet size low (256 or 128),
  756. Retry Warning level to the max (9), and Transfer and Verify On.
  757. If you set up a transfer like this and let it run overnight, it
  758. will have the best chance of completing successfully.  Verify
  759. On will make it easier to find which files transferred OK and
  760. which didn't.  Use the Error Log and Event Log to check after
  761. the transfer.
  762.  
  763. ************Important*****************
  764. If you are doing a transfer and want to cancel it, you must exit LinkRight
  765. (We know, this is an oversight and will be fixed).  DO NOT DOUBLE CLICK
  766. on the upper left LinkRight icon to close LinkRight on the Local machine
  767. while a file transfer is in progress.  This could LOCK UP YOUR OS/2 
  768. SYSTEM.  Instead, hit cntl-esc to bring up the task list, select LinkRight
  769. from this list, and select close.  This will kill LinkRight gracefully.
  770. **************************************
  771.  
  772. Bugs and Missing Features
  773.  
  774. There is a bug in marking a directory to transfer if the directory has a 
  775. space in the name.  It is not a problem if the directory is a subdirectory
  776. of another directory that was marked.  The work around is to manually 
  777. create a directory and manually mark the files in the directory that you
  778. want to transfer.
  779.  
  780. Overwriting the Retry file is disabled.  You should manually Clear the Retry
  781. file.
  782.  
  783. Transferring a file from HPFS to FAT causes the filename to be truncated to
  784. 8.3.  Transferring the file back to HPFS you should get the long file name
  785. back, but doesn't.
  786.  
  787. If you attempt to establish a connection, but decide you want to
  788. cancel this connection attempt, wait at least 5 seconds before
  789. selecting "Cancel".  LinkRight has been known to lockup your OS/2
  790. machine if you try to cancel the connection attempt too quickly.
  791.  
  792. LRCLONER in source mode when connecting to a DOS machine cannot use
  793. compression.  Make sure this option is turned off before starting
  794. LRCLONER.  LRCLONER connections to an OS/2 machine can use 
  795. compression as long as DCF2CDE.SYS is installed on both machines.
  796. The PM version of LinkRight (LR.EXE) will automatically not use
  797. compression when connecting to a DOS machine.
  798.  
  799. You should select Connect / Disconnect from the Local machine to 
  800. disconnect before exiting LinkRight.  Not doing this could cause
  801. the Remote machine to lock up.
  802.  
  803. If you find any other bugs, please let us know so we can fix them.
  804.  
  805. Future Enhancements
  806.  
  807. Do not make any important business decisions based on these vague
  808. promises.
  809.  
  810. Planned features for future versions include:
  811. Bug fixes for any bugs found in version 1.1.
  812. Missing features in version 1.1.
  813. Display EA size along with the usual information about each file.
  814. Local File Manager.
  815. Mini-peer network, ala DOS Interlnk / Intersrv.
  816. Masking of files for display or transfer.
  817. DOS compression.
  818. Network Support.  LapLink support Novell nets, LinkRight will obviously
  819. support LanServer nets first and maybe others later.
  820.  
  821. There is no date set any of these future features.  We'll let you know
  822. when they're done.
  823.  
  824. You can assist us by telling us which features you would like to see and
  825. which features you do not care about.  If you have a feature that is not
  826. listed that you would like to have, please let us know.
  827. Customer feedback is very important to us.
  828.  
  829. Technical Support
  830. For technical support, please contact
  831. Jeff Tremble, Chief Developer of LinkRight.
  832. Compuserve: 71033,3517, OS2AVEN/Other Vendors, or OS2USER/App quest
  833. Internet: 71033.3517@compuserve.com
  834. Direct BBS: Jeff Tremble, Local Area OS/2 Shareware, (703) 385 4325 
  835. Rightware does not have it's own BBS.  We use Pete Norloff's OS/2 
  836. Shareware BBS.
  837.  
  838. Voice answering machine (301)762-1151
  839. Fax (301)762-1185
  840.  
  841. Bug fixes are top priority for me.  It is easy and simple for me
  842. to create a patch and distribute it via CIS and BBSs.  Any bug fixes
  843. will likely be distributed like this. Hobbes site will be used to
  844. post patches for Internet users.  Patches have been coming at a rate
  845. of about 1 per month, so all users are encouraged to look for an
  846. improved version of LinkRight occasionally.
  847.  
  848. If you find bugs that have an easy workaround, we'll make them low priority.
  849. If you find bugs that we can duplicate on my machines (big IF there, 
  850. since we do NOT have every type of computer ever made) and there is no
  851. easy workaround, we'll fix them as quickly as possible and post a patch.
  852.  
  853. Phone technical support will be minimal.  We prefer a Compuserve msg
  854. or FAX with a written description of the problem, pleas include the
  855. following information: Type of machines; speed of machines; Version
  856. of OS/2; Version of LinkRight; circumstances of the error; actual
  857. error and any error messages displayed.  We'll try to get
  858. you up and running as soon as possible.
  859.  
  860.  
  861.