DFSee version 17.0 2022-10-22 (c) 1994-2022: Jan van Wijk =========================[ www.dfsee.com ]========================== _______________________________________________________________________________ C O N T E N T S: _______________________________________________________________________________ Installation = short installation description Backups = how to make the important backup _______________________________________________________________________________ I N S T A L L A T I O N: _______________________________________________________________________________ The standard distribution of DFSee (dfsee_install.zip) contains all the files you will need to use it. There are several versions of the DFSee executable (DOS, Win-NT, OS/2, Linux, macOS) and there are some batch files like DFSDISK. Then there are a bunch of dfs*.txt files that contain detailed information about DFSee and the commands. So, just unzip DFSEExxx.ZIP in a directory of your choice ... IMPORTANT: When you are new to DFSee, I recommend you use the DFSTART script after installation to start with. It will collect some very useful backup files. DFSee is a SWISS-ARMY KNIFE of disk-tools packaged in a single executable file (.EXE). There is really no need for 'installing' anything, as long as the executable can be found. (in the PATH for instance). So make sure the executable is in a tools directory or a directory of its own, and make sure that directory is in the PATH to make it more convenient. The only thing that IS a bit important is that the registration file needs to be in a directory in the PATH as well, and must be renamed to the fixed name: 'dfsee.key'. Automatic install and Desktop objects: For OS/2 and Windows you can also use the dedicated installers to install DFSee, these will install all required files and will also create a desktop folder with some program objects. On Windows it will also add DFSee to the start menu. Once installed, you may be able to use the 'Program Updates' menu item from the Help menu to update to newer versions. This will work when your system has a working Internet connection and a proper version of the 'wget' utility for your operating system. Available executables: - DFSOS2.EXE The OS/2 executable, full function including REXX The distribution contains CMD scripts for various functions Shortcuts for these are added to the Desktop 'DFSee' folder when you use the specific OS/2 installer (.wpi). which is a seperate download (not the generic ZIP) For OS/2, there is also a REXX script (DFSWPOBJ.CMD ) that will create a desktop folder with useful program and documentation objects. - DFSWIN.EXE The Win-XP/Win-7/8/10 executable, full function The distribution contains BAT scripts for various functions, and for Windows-7 upwards, these will also automatically perform a 'Run as Administrator'. Shortcuts for these are added to the Windows start-menu when you use the specific Windows installer (.msi) which is a seperate download (not the generic ZIP) - DFSDOS.EXE The DOS executable, full function no REXX From version 5.11 the DFSDOS version uses the DOS32A Dos-extender (5.00 up to 5.10 used Causeway) It is best to use these versions WITHOUT additional memory managers like EMM386 loaded when possible. To suppress the DOS32 startup messages, set the environment variable: SET 'DOS32A=/QUIET' - dfsee The Linux or macOS executable, must be installed with the 'executable' bit set, and needs ROOT privileges. (login as 'root' or use the 'sudo' command) The Linux version was designed for the Linux CONSOLE using the 'linux' terminal type, but should work acceptably in most xwindow terminals too ('xterm') (and supports the mouse in xterm, not in console!) The macOS (Darwin) version runs in the standard 'Terminal' application, as well as many others, like iTerm. (For some 'Terminal' preference keyboard tweaks, see below) Extract the provided ZIP archive to a suitable install location (like your home dir, to '~/dfsee'), where a '/linux' or '/mac' and a few other subdirectories will be created. When using '/opt' you could extract the 'linux' branch into '/opt/dfsee/bin' to adhere to Linux FHS standards. (you may need SUDO to create these, and to run setup!) The distrubution ZIP contains a 'setup' script that you need to run, with an optional parameter that specifies a directory (in the PATH) to create symlinks in. To execute the setup script, change to the directory where the dfsee exectable was extracted, which will be '~/dfsee/linux/' if you extracted in your home directory, and run the following commands: chmod 755 setup ./setup You can get usage for the setup script with: ./setup -? and to run the DFSee executable directly here: ./dfsee Also, when you let the setup create symlinks too, (default to '/usr/local/bin' but can be specified) you can simply run some of the dfsee scripts directly since the setup scripts created symlinks, examples: dfs dfsedit You can run these from ANY directory, like /tmp or a specific dfsee 'data' directory, so logfiles or other resultfiles will end up there too. For macOS, when the 'dfs' startup symlink has been created, you can also use the 'DFSee.app' that is in the install /mac directory (and drag it to the Dock or Desktop if you wish) However, due to the ever increasing security measures on later macOS versions like High Sierra, need to allow the setup script to create a security exception for DFSee.app. Without that, you may get a security popup that advises you to remove the suspect application, don't do that :-) macOS keyboard tweaking for DSee in the 'Terminal' app ====================================================== Terminal->Preferences->[Settings]->[Keyboard]", Find each key there, and change the buffer scroll action into", one to send it to TXWin: 'Action' select 'send string to shell:'", The codes to be sent are (insert the \033 by using the Esc key):", Ctrl-Home \033[1;5H (goes to begin output window)", Ctrl-End \033[1;5F", (goes to end output window)", Home \033[1~ (goes to begin input field)", End \033[4~ (goes to end input field)", PgUp \033[5~ (pageUp in the output window)", PgDn \033[6~ (pageDn in the output window)", DFSee also maps other keys to some (missing) functions for OSX:", PgUp Ctrl + Left-Arrow", PgDn Ctrl + Right-Arrow", Insert Ctrl + Delete (Or Ctrl + Fn + Backspace)", You can also use apps (like 'Karabiner') on macOS to map keys, like:", Insert Right-Shift (useful on macBook keyboards)", Delete Right-Alt (useful on macBook keyboards)", _______________________________________________________________________________ I M P O R T A N T B A C K U P S: _______________________________________________________________________________ I advise to keep a bootable medium with some DFSee version for emergency purposes. This could be a copy of DFSDOS.EXE on a DOS boot diskette, a bootable CD with either the DOS or Linux version, or a Linux bootable stick like DFSPUPPY. Then an important backup command to be used on your existing system(s) as a preventative measure: psave * filename Some-short-description-of-your-system This will make a backup of all important partition table and boot sectors to a relatively small file that can be used in cases of emergency to restore them (with prestore). Use a meaningful 'filename' for each different system you backup. (of course it works just as well with DFSDOS.EXE or DFSWIN.EXE) For extra information on your systems you could also run the DFSDISK.CMD or DFSDISK.BAT script that comes with DFSee. It will create several DFSDISKI.* files for each physical hard disk in the system. Note: The DFSDISK and PSAVE stuff above is included in DFSTART, so if you use that you are on the safe side! ----------------------------[ www.dfsee.com ]-------------------------------