======================================================================== * * * Advanced Digital Delivery - ADD Version 2, Release 1.2 * * * Last update to this file on 05/16/2000. ======================================================================== Welcome to the README.TXT file for Advanced Digital Delivery ( ADD ). This file contains information about requirements, installation and support of ADD. After installation, this ReadMe.txt file is located in : ADD_Installation_Directory\com\ibm\sms\ADD This file is formatted for use with a monospaced font. ======================================================================== CONTENTS 1.0 Requirements 2.0 Install / Uninstall 2.1 Installing Java 2.1.1 Java on Windows 95/NT 2.2 Installing ADD 2.2.1 Before Installing ADD 2.2.1.1 Installing using 'setup.exe' (only for Windows platforms) ** Important NOTE for Windows NT ** 2.2.1.2 Installing using 'setup.class' (for all platforms) 2.2.2 After Installing ADD 2.2.3 Uninstalling ADD 2.2.4 Upgrading ADD 2.2.5 ADD Package Contents 2.3 Migrating ADD from Version 1.1 3.0 Running ADD 4.0 Help / Support 4.1 On-line Help 4.2 Website Help ======================================================================== 1.0 Requirements - A minimum of the Java 1.1.6 Runtime Environment (JRE). The Jave 1.1.6 Development Kit (JDK) is also acceptable. ADD installation will verify that you have the correct level of Java. - An operating system (or installation drive/partition) that supports long filenames. - An HTML browser (Netscape, Internet Explorer, etc.) to view online help/documentation. - TCP/IP correctly installed and configured. - Hughes DirecPC Package Delivery program correctly configured and running. ======================================================================== 2.0 Install / Uninstall 2.1 Installing Java 2.1.1 Java on Windows 95/NT The installation process for Java ( JRE or JDK ) does not update the PATH environment variable that makes it easier to invoke java programs, like ADD. To make it easier to install and run ADD, we recommend following these steps. ** NOTE ** This information was copied from the JDK README file, currently located at the Sun website : http://java.sun.com/products/jdk/1.1/README Please read the entire README file before installing Java. -------------------------------------------------------------------- MICROSOFT WINDOWS PATH -------------------------------------------------------------------- Windows NT only - If you are using Windows NT, it is preferable to make the following environment variable changes in the Control Panel. Start the Control Panel, select System, then edit the environment variables. 1. PATH - Add the absolute path of the "jdk1.1.6\bin" directory to your PATH statement as follows. The PATH statement enables Windows to find the executables (javac, java, javadoc, etc.) from any current directory. To find out the current value of your PATH, at the DOS prompt type: C:\> path To change the PATH, open the AUTOEXEC.BAT file and make the change to the PATH statement. To edit the AUTOEXEC.BAT file in Windows 95: i. Start a text editor by choosing "Start", "Programs", "Accessories", and choosing WordPad or NotePad. ii. Choose Open from the File menu and type "c:\autoexec.bat" for the filename This will open the file for editing. iii. Look for the PATH statement. Notice that the PATH statement is a series of directories separated by semi-colons (;). Windows looks for programs in the PATH directories in order, from left to right. Look for other JDK versions in the PATH. There should only be one path to a classes.zip file. When in doubt, put the java directory at the end of the path statement. For example, in the following PATH statement, we have added the java directory at the end: PATH C:\WINDOWS;C:\WINDOWS\COMMAND;C:\;C:\DOS;C:\JDK1.1.6\BIN To make the path take effect, execute the following: C:\> autoexec.bat You may want to reboot the system to make the updated path available to all Windows processes. ---------------------------------------------------------------------- 2.2 Installing ADD 2.2.1 Before Installing ADD The ADD installation package consists of these files: ReadMe.txt - this file setup.class - java installation program ( for all platforms ) OR setup.exe - executable installation program ( only for Windows platforms ) ADD uses InstallShield to create a simple, easy-to-use installation procedure. Since ADD is intended for use on many operating systems (the main reason for and benefit of using Java), the installation procedure is also built / executed using Java. ** NOTE ** You MUST have Java installed on your machine before you attempt to install ADD. Download one of the two installation programs, depending on the platform you plan on running ADD. Then, from inside the directory (this does not have to be the final installation directory) that contains either of the ADD package installation programs, begin the installation as below depending on the file you downloaded. During installation you will be prompted for a fully qualified directory name to install ADD into. 2.2.1.1 Installing using 'setup.exe' (only for Windows platforms) This is the easiest way to install ADD on Windows platforms. Begin the installation simply by typing setup on the command line and follow the simple instructions. ** NOTE ** For Windows NT with the Java Development Kit ( JDK ) : ==> Icons (shortcuts) will NOT be added to the Start menu or the Startup folder. You can either : 1) Create shortcuts by dragging the icon for the IBMADD.BAT file (in the ADD install directory) to the Start menu and the Startup folder and clicking 'Create Shortcut(s) here.' 2) Install ADD using the 'setup.class' file as described below in section 2.2.1.2 2.2.1.2 Installing using 'setup.class' (for all platforms) You must invoke 'java' with this installation program name. Begin the installation by typing jre -cp . setup OR java setup on the command line and follow the simple instructions. ** NOTE ** Java is case-sensative, so this command must be typed exactly as shown. -------------------------------------------------------------------- 2.2.2 After Installing ADD After invoking the installation procedure as described above and following the simple instructions, installation will be complete, and you may delete the install program - setup.class OR setup.exe. After installation the ADD directory structure looks like this: InstallDir\install.idb ---> Installation file \uninstall.class ---> Program file to uninstall ADD Windows files : InstallDir\IBMADD.bat ---> Executable file \IBMADD.ini ---> Used for shortcuts \launcher.exe ---> Used for shortcuts \Receive.bat ---> Internal executable \Rexec.bat ---> Internal executable \trace.bat ---> Internal executable InstallDir\com\ibm\sms\ADD\... ---> Directories for ADD's programs InstallDir\com\ibm\sms\ADD\doc ---> ADD documentation / \doc\images Users Guide and images \ReadMe.txt ---> This 'Read Me' file \ADDwin.ico ---> An ADD icon for Windows InstallDir\com\ibm\sms\awt\... ---> Directories for utility ftp\... packages used by ADD trace\... ** NOTE ** While we intend this to be the complete and accurate file list, it may be different from your installation. -------------------------------------------------------------------- 2.2.3 Uninstalling ADD When ADD is installed, an uninstallation program - uninstall.class - is also installed. It is just like the install program in that you must invoke Java with this class name. From inside the directory that ADD was installed into, begin the uninstallation by typing: jre -cp . uninstall OR java uninstall This will completely remove the ADD installation. However, it will not remove the original install program - setup.class OR setup.exe, the directory ADD was installed into, any program objects/shortcuts that you may have made to invoke ADD or any temporary files or files you created within the ADD directory structure. -------------------------------------------------------------------- 2.2.4 Upgrading ADD If you downloaded a newer version of ADD and want to install it, it is recommended that you go through the 'Uninstall' procedure described in section 2.2.3. Then use the 'Install' procedure described in section 2.2.1. ---------------------------------------------------------------------- 2.2.5 ADD Package Contents ** NOTE ** This information is not needed for general users. This release of ADD contains the following versions of these packages. Java Package Name Version/Release/Modification ----------------- ---------------------------- com.ibm.sms.awt 1.1.A com.ibm.sms.ftp 1.1.8 com.ibm.sms.trace 1.1.4 com.ibm.sms.ADD 2.1.1 ---------------------------------------------------------------------- 2.3 Migrating ADD from Version 1.1 If you are a user of ADD version 1 for OS/2, you can migrate your settings, including your target definitions, to your new installation of ADD version 2 for Windows, using the following steps: 1) Download ADDPORT.EXE (a self-extracting zip file) and copy it to a diskette from: FIX ftp://service.boulder.ibm.com/ps/products/ibmadd/r2 2) Insert the diskette into a diskette drive on your OS/2 receiving workstation. 3) Enter A: to change your current directory to your diskette drive (assuming your diskette drive is your A drive). 4) Enter ADDPORT to extract the migration program. 5) Enter ADDPORT.CMD to run the migration program. It will ask you to enter the drive letter of your diskette drive and will create a new IBMADD.INI file on the diskette. 6) Remove the diskette from your OS/2 system and insert it into a diskette drive on your Windows receiving workstation. 7) Make sure ADD version 2 for Windows is not running. 8) Copy IBMADD.INI from the diskette to same directory on your Windows receiving workstation in which you installed Java (either the JRE or JDK). Frequently this is the root directory on your C drive. In this directory you should see the top level Java directory (either JDK1.1.x or JRE1.1.x). ** NOTE ** We recommend following these step before starting ADD version 2 for Windows the first time, since these steps will overwrite the IBMADD.INI file that it creates. ======================================================================== 3.0 Running ADD ** NOTE ** ADD is meant to be running all the time on the receiving workstation. If it is ever stopped, it should be restarted as soon as possible. On Windows platforms a shortcut for ADD is created in the Startup folder to ensure that every time the system is booted, ADD begins executing. * Windows NT users MUST carefully read section 2.2.1.1 ** NOTE ** ADD is meant to to be running only ONCE on the machine. Before invoking ADD look at the task bar to ensure ADD is not already running. Having 2 copies of ADD executing on the same machine can have unknown and undesired effects. The installation procedure creates an execution 'script', which is either a command file, a batch file or something appropriate for your operating system. To invoke ADD should be as simple as typing IBMADD from inside the directory where you chose to install ADD. On Windows platforms, the installation procedure created a shortcut which was placed under the Programs tab of the Start menu. Simply click on this to invoke ADD. You may create your own shortcuts or desktop objects to more easily invoke ADD. Just be sure to set the current directory for the object to the directory where you installed ADD. The following icon is included with ADD for you to attach to your ADD program objects: InstallDir\com\ibm\sms\ADD\ADDwin.ico ---> An ADD icon for Windows ======================================================================== 4.0 Help / Support 4.1 On-line Help All of ADD's documentation and help are on-line. The following is the main entry point into the documentation. Just load this file into your favorite browser: ADD_Installation_Directory\com\ibm\sms\ADD\doc\UsersGuide.html While executing ADD, there are HELP buttons on the dialogs which will attempt to open your favorite browser with the appropriate Users Guide page. Before using this you must tell ADD which browser to use by clicking Help->Choose browser... on the menu bar. ---------------------------------------------------------------------- 4.2 Website Help More information and help is available at the (internal IBM) ADD Website: http://w3sdf.boulder.ibm.com/ott