Installation & Licensing Getting Started Product Contents The DBCommander product consists of: X DBCommander Reference & User Guide X One (1) high-density diskette containing the DBCommander software and installation files. If this is a demonstration copy you will not have the DBCommander Manual. The manual is shipped when payment for a full license is received. If any of the product materials are missing or damaged, contact DBSA immediately. Software Contents The software distribution contains the following files: X DBCmdr.pkg - a compressed version of the software ready for installation X README - an on-line version of the installation and licensing information X RELEASE.NOTES - notes describing the specific release of software provided X SOFTWARE.LICENSE - a complete copy of the DBCommander software license. Acceptance Of Software License Installing the DBCommander software signifies acceptance of all terms and conditions of the DBCommander licensing agreement contained in the file SOFTWARE.LICENSE. A copy of the licensing agreement is also printed in the first section of the manual and displayed in the Licensing panel within the DBCommander application for reference. Be certain to read and understand the licensing agreement prior to installing the product. Installing DBCommander Preparing For Installation Prior to beginning the installation process, perform the following steps: X Verify the directory location of your Sybase software If Sybase is not installed, install it and note the location of the software X Insert the DBCommander diskette and select it using the Workspace Browser X Read the software licensing agreement provided in the file SOFTWARE.LICENSE. X Read the README and RELEASE.NOTES files displayed Starting The Installation To begin the DBCommander installation, perform the following steps: X Perform the instructions listed in Preparing For Installation described above X With the DBCommander diskette inserted, select the diskette in the Workspace Browser X Double-click the file DBCmdr.pkg to launch the Installer application The Installer Application The Installer is a standard (NeXT supplied) application for installing software. The Installer prompts for required information and provides feedback on the progress of the installation. The Installer supports the following operations on software packages: X Install - place software in the appropriate locations and prepare it for operation X Delete - remove software from its installed locations and delete it X Compress - leave software on the computer but compress its files to save space X Expand - expand a software package which has been compressed using the installer X List - display the contents of the software package All Installer operations are performed from the installer panel. To continue the installation process, select the Install option. The Installation Directory Installer prompts for a destination directory for the DBCommander product before proceeding. DBCommander expects to be installed in /LocalApps, but may be installed in any location. Enter the desired target directory by selecting it from the panel Installer provides for this purpose. Installer asks for confirmation of the target directory and proceeds with the installation. Installation Processing The installation process takes a few minutes to complete. During processing, Installer displays progress in the Installer panel. A log file documenting the installation process is kept during the installation process. This file can be viewed by selecting the Log option from the pop-up menu on the Installer panel. When the installation has completed, the Installer displays a message signifying that installation is complete. Remove the DBCommander diskette and store it in a safe location. Demonstrating DBCommander DBCommander can be run for 5-minute intervals using Demo mode. This option is provided to allow the software to be used when it is not possible, or desirable, to license the software at the time. To use Demo mode, select the Demo command from the Licensing panel when it is displayed. The database access layer of DBCommander will discontinue operation after 5 minutes. Licensing DBCommander DBCommander must be licensed in order to function without shutting down database access. Once the software has been purchased and you have installed the software package: X Double-click the DBCommander icon in the Workspace Browser to launch the application X A licensing panel will appear. Note the license number and host id information presented on this panel X Call DBSA, (505) 662-5619, to get an authorization key for the host / license combination. If you are licensing a previously obtained demonstration copy you will also be assigned a permanent license id X Enter the authorization key, exactly as presented by DBSA. X Select the License command to save the authorization key and activate the software X Select the Close command to close the licensing panel Performing Initial Configuration DBCommander requires two settings in the General Preferences panel to be updated if the software is installed in a location other than /LocalApps. In order to function properly, the Sybase directory, and Template directory entries should be set as described in Help under Support_Tools->General Preferences. Improv API Support The Improv data transfer functions supplied with DBCommander make use of the Improv API, a package provided by Lotus to allow applications to interact with Improv. No special configuration is required to take advantage of this capability. In Case Of Difficulties If there are any difficulties with the installation process, try using the Installer to Delete the DBCommander package and re-install it. If problems persist, contact DBSA.