G E O P U B L I S H I N S T A L L A T I O N H E L P Please take a moment to read these installation instructions. They will give you important information about the different installation options, as well as tips and tricks if you encounter difficulties. You must have DOS equivalent to version 3.0 or greater, or OS/2 version 2.0 or greater to install this product. ******************************************** I N S T A L L A T I O N C H O I C E S: ******************************************** 1.) NEW INSTALL: If you choose New Install, the GeoPublish files will be installed into a new directory called GEOPUBL on your hard drive. If you choose to install GeoPublish into an alternate directory where any version of Geoworks GeoPublish already exists, all of the system files common to both products will be overwritten with the newer versions. Installing GeoPublish in this manner may make the original GeoPublish product unusable. 2.) INSTALLATION TOOLS: If you choose Installation Tools, you will be able to install any of the individual files which make up GeoPublish. This choice should be used if any of the files are damaged during use after the original installation process. 3.) FINISHED: If you choose Finished, you will exit the installation program. ****************************************************** I N S T A L L A T I O N T I P S & T R I C K S: ****************************************************** 1.) It's always a good idea to back up any important files on your system. This would be an excellent time to remove any files that you no longer use. Also, you should run a diagnostic program such as CHKDSK or SCANDISK to make sure your hard drive is in good working order. To run CHKDSK on your C: drive, type CHKDSK at a C:\ prompt. For more information on CHKDSK, consult your DOS manual. 2.) The installation will not proceed normally if you do not have enough free disk space on your hard drive. You will need at least 10 Megabytes of free disk space to install GeoPublish. If the installation fails, check to see how much space you have left on your hard drive by typing DIR at a C:\ prompt. At the end of the list of files you will see the number of bytes free on the hard drive. If you have 0 bytes free, you ran out of space. You should delete as many files as you can and try the install procedure again. 3.) You may get the error "Not enough memory to install" or the install procedure may fail before it can copy any files to your hard drive if you have less than 500K (512,000 bytes) of free conventional memory. The first thing to try is our secondary install program INSTALLB. INSTALLB.EXE requires much less conventional memory than INSTALL.EXE but it will also take longer. 4.) The install program will check your CONFIG.SYS for the proper FILES and BUFFERS size. These should both be set to 30. (Unless you are using DR DOS or Novell DOS, in which case your FILES setting should equal 120.) If the install modifies your CONFIG.SYS you will need to reboot your computer for the changes to take effect. 5.) The install program will check your AUTOEXEC.BAT to determine if the GEOPUBL directory needs to be placed in the path. If the install modifies your AUTOEXEC.BAT you will need to reboot your computer for the changes to take effect. 6.) If you are having trouble with a particular floppy disk, you should use CHKDSK to check the integrity of the disk. Put the disk in the appropriate drive and type CHKDSK at the a: or b: prompt. If you get a message such as "Errors found" you will need replacement disks. 7.) With some computers, you may need to put disks in ALL available drives in order to proceed. Additionally, it has been reported that when installing to a Bernoulli drive, the drive must be "locked" (the door shut and a cartridge placed in the drive) BEFORE allowing the installer to check available drives. If you have a Bernoulli drive, it should be "locked" even if you are not attempting to install to it. 8.) If you do not complete the installation, a residual directory may exist. The DIRECTORY name will be ISFYQVO.TWJ and may contain a FILE called SWAPFILE.HDR. To delete the FILE, type the following at the DOS prompt: del isfyqvo.twj\*.* (hit the enter key) You will then see the following: All files in directory will be deleted! Are you sure (Y/N)? (hit a "y" and the enter key) To delete the DIRECTORY, type the following at the DOS prompt: rd isfyqvo.twj (hit the enter key) 9.) You can install GeoPublish under OS/2 in a regular DOS full screen box, not one that boots a specific version of DOS. Therefore, the DOS_STARTUP_DRIVE setting on the session page should be blank. Increase the number of DOS_FILES available to that DOS box to at least 80. Make sure that the HW_TIMER setting is on. All other values can be left at the default. If you are installing from an OS/2 DOS session you may receive an error message indicating that you don't have enough room on your hard drive. NOTE: The install program will allow you continue if you are sure that there is enough space. You may also get a "SYS Error 0005. Access Denied" error while installing under OS/2, because OS/2 thinks there is an extended attribute set for all of the files on the installation disks. To change this extended attribute: 1. Use the DISKCOPY command to copy each GeoPublish installation disk to a diskette that is not write protected. 2. Run CHKDSK /f on each diskette. OS/2 will correct what it thinks is an extended attribute error on every single file. ********************************************* R U N N I N G G E O P U B L I S H ********************************************* The following information may help you if you complete the installation of GeoPublish but are having trouble getting up and running. 1.) If you chose to use the default directory during installation, you will find GeoPublish in a directory called GEOPUBL. The command to start the program is PUB. Therefore, to start GeoPublish from a C:\ prompt type CD\GEOPUBL PUB If you would like GeoPublish to start automatically when you turn on the computer, type C: CD\GEOPUBL BT2GEOS (If you have installed GeoPublish in a directory other than C:\GEOPUBL, substitute the appropriate drive and directory in these commands.) The commands above run a batch file that will modify your AUTOEXEC.BAT to run GeoPublish when you turn on your computer. We cannot guarantee that this will work on all systems, in which case you will have to modify the AUTOEXEC.BAT yourself. The AUTOEXEC.BAT can be found in the root directory of the C: drive. You can edit these files with any text editor such as MS-DOS' Edit, DR-DOS' Editor or the Text File Editor in GeoPublish. 2.) When you install the software, a file called GEOHELP.EXE is installed along with the other Geoworks files. GeoHelp is a program designed to help you diagnose and fix problems you may encounter. To start the GeoHelp program 1. Install as much of GeoPublish as you can. 2. At the DOS prompt type: C: CD \GEOPUBL GEOHELP (If you have installed GeoPublish in a directory other than C:\GEOPUBL, substitute the appropriate drive and directory in these commands.) 3.) Some hardware and software products need special treatment to work with GeoPublish. One way to see if a software conflict is behind your problem is to boot clean. Try the following procedure (which is also automated in GeoHelp). It's an easy way to create a special startup disk that you can use to make sure no other software programs load into memory. The beauty of this method is that it makes no changes to your hard disk. Note: This procedure will not work if you are using a disk compression program. 1. Put a blank disk in drive A: and format it as a DOS system disk by typing FORMAT A: /S at the DOS prompt. 2. After the format is complete, restart your machine with this newly formatted disk in drive A. Your computer ignores the commands in your normal CONFIG.SYS and AUTOEXEC.BAT files altogether. 3. Run GEOS by typing C: CD\GEOPUBL PUB If GeoPublish now runs correctly, something in the CONFIG.SYS or AUTOEXEC.BAT file on your hard disk was probably causing the problem. You need to do some trial-and-error testing adding and removing lines to and from these files to isolate the problem. 4.) If you have extended or expanded memory (any RAM beyond 640K) and you're having problems running your software, try starting GEOS by typing PUB /nomem At the DOS prompt in the directory where you installed GeoPublish. Note: You must type nomem in lowercase letters. The nomem parameter instructs GeoPublish to ignore any extended or expanded memory in your system. If using nomem solves your problem, it was probably caused by a Terminate-and-Stay-Resident program (TSR) that uses your expanded or extended memory. The major culprits include RAM disks, disk caches, and advanced memory managers. If you would like to just leave things the way they are, you can make the "nomem" setting permanent. Realize that if you do this, GeoPublish won't use the expanded or extended memory in your computer and will therefore, run slower. To make the nomem setting permanent 1. Open the Preferences desk tool. 2. Choose Computer. 3. Select None for Extra Memory Type and click OK. Setting the nomem parameter will not affect your other programs or their use of higher memory. 5.) To test for possible hardware conflicts, try starting GEOS by typing PUB /log At the DOS prompt in the directory where you installed GeoPublish. Note: You must type log in lowercase letters. The log parameter instructs GEOS to initialize all the system hardware before starting. If your computer freezes, reboot and check the file geos.log by typing: TYPE C:\GEOPUBL\PRIVDATA\GEOS.LOG This file will contain a list indicating which of the many hardware devices on your system were successfully initialized. The last entry will give you a better indication of where the problem lies. For example, if the last thing you see on the list is Initializing Mouse Driver GEOS could be having trouble with your mouse. Write down the last module to be initialized before you call for technical support. If the last thing you see on the list is Initializing Non-Switching Task Driver Then GEOS probably initialized all the hardware successfully. While this does not rule out the possibility of a hardware conflict it is a good indication that the problem lies elsewhere. 6.) GeoPublish is compatible with MS DOS 6.0 and 6.2. However, you will need the line DEVICE=C:\DOS\SETVER.EXE in your CONFIG.SYS file. MS DOS usually places this line in your CONFIG.SYS file when you install, but you should make sure it is still there. 7.) GeoPublish is compatible with DR DOS 6.0. However, you will need the line FILES=120 in your CONFIG.SYS file. If you are using Superstor disk compression and you get the error, "Insert disk in drive C:" you have the very first release of DR DOS 6.0 and Superstor and you should contact Novell to receive an update. The update you will need is the 4/92 version or DR DOS 6.0. There is a later 3/93 update but it does not include the Superstor driver. A potential work around to the problem is to put the line drive d = 65535 in the GEOS.INI file in the [system] section. This is not a guaranteed solution, and if it fails, you should contact Novell for an update at 1-800-NETWARE. 8.) GeoPublish is compatible with Novell DOS 7. However, you will need the line FILES=120 in your CONFIG.SYS file. If you are using NWCACHE, you may find it necessary to disable the "write delay" feature in order to run GeoPublish properly. Consult your DOS manual for more information about NWCACHE. 9.) GeoPublish is compatible with Novell Netware, however, you must have Ensemble installed on a local hard drive. GeoPublish cannot be run from the network server and we do not sell network site licenses. Ensemble should be able to read from network drives and print to a network printer. If you are connected to a Novell network, you must create a SHELL.CFG file in your C: drive's root directory. To create the file, type ECHO FILE HANDLES = 100 > SHELL.CFG at the C:\ prompt and press enter. 10.) There is a known conflict with QEMM's "Stealth Mode" and Ensemble when Ensemble is using Expanded memory. One solution is to disable the stealth mode option. The QEMM line in the CONFIG.SYS will look like DEVICE=C:\QEMM\QEMM386.SYS RAM X=C800-CBFF ST:M R:2 Simply remove the ST:M from the line and the problem should go away. If you want to use stealth mode for your other programs and tell GEOS to ignore stealth, follow this procedure: From the C:\GEOPUBL prompt, type PUB /nomem (that's a forward slash, and the nomem must be in lower case) to enter Ensemble. The /nomem tells Ensemble to ignore the high memory area, which is where QEMM is causing conflicts. Go into Preferences and click on the Computer button. Under Extra Memory Type, turn OFF Expanded (LIM EMS). You can turn on Extended and XMS/HIMEM.SYS, if they aren't already selected. Click on the OK button. When Ensemble tells you it needs to be restarted, click on OK, then Yes. The next time you want to enter Ensemble, you can just type PUB at the C:\GEOPUBL prompt. 11.) If you get a "SHARE.EXE Table Overflow Error" when trying to run GeoPublish, try adding INSTALL=C:\DOS\SHARE.EXE /f:4096 to your CONFIG.SYS file. If the error message persists, increase the number 4096 in increments of 2048 until the problem goes away. It should not be necessary to use a number higher than 10240. 12.) If you get the error "GEOS.INI file has been corrupted" when you try to run GeoPublish, you will need to restore the file. The GEOS.INI file is located in the C:\GEOPUBL directory and contains information about your preferences settings. Should the file ever become damaged, you can copy the original GEOS.INI file from installation disk #1 by typing COPY A:GEOS.INI C:\GEOPUBL (If you have installed GeoPublish in a directory other than C:\GEOPUBL, or your installation disk is in a different drive, substitute the appropriate drive and directory in these commands.) You will then have to reconfigure your preferences settings such as your mouse and printer driver selections. You may wish to make a backup of your GEOS.INI file to avoid having to reconfigure your preferences in case of this particular problem. 13.) If you have difficulty reading any of your drives or if any phantom drives show up that do not belong, you should try editing the GEOS.INI file to tell GEOS the exact drive specifications. For example in the [system] section of the GEOS.INI file you could add the line drive b = 0 This tells GEOS to ignore drive b. Using the format drive = you can use any of the following drive specifications 0 => Ignore the drive 360 => 360K Low Density 5.25" floppy disk 720 => 720K Low Density 3.5" floppy disk 1200 => 1.2M High Density 5.25" floppy disk 1440 => 1.44M High Density 3.5" floppy disk 2880 => 2.88M 3.5" floppy disk 65535 => Hard drive If trouble reading, copying or formatting floppies persists, try putting waitpost = false in the [system] section of the GEOS.INI file. 14.) If you completed the install and you cannot see anything on your screen when you try to start GeoPublish, the install program may have chosen the wrong video driver. The first step in solving this problem is to know what type of video adapter you have. If you do not know, you should contact your hardware vendor to find out. Then follow these steps 1. Run install from the first disk again by typing a:install 2. Choose the Installation Tools Option 3. Install one of the following files based on your display adapter loadervg.exe VGA loadereg.exe EGA loadercg.exe CGA loadermc.exe MCGA loaderhg.exe Hercules 4. Rename the file you install to loader.exe by typing CD\GEOPUBL REN LOADERHG.EXE LOADER.EXE In this example we installed loaderhg.exe into the GEOPUBL directory. If you have a different display device or you installed GeoPublish in a different directory, substitute the appropriate display device and directory in the commands above. 5. Edit the GEOS.INI file to add the appropriate video driver entries immediately below the line [screen 0] device = VGA: 640x480 16-Color driver = Standard VGA Driver device = EGA: 640x350 16-Color driver = EGA Driver device = CGA Compatible: 640x200 Mono driver = CGA Driver device = IBM MCGA: 640x480 Mono driver = MCGA Driver device = Hercules HGC Compatible: 720x348 Mono driver = Hercules Monochrome Driver A few systems have to be switched to graphics mode from the keyboard before they will run GeoPublish. If you start GeoPublish and get a blank screen, try typing either of these commands at the DOS prompt before you start GeoPublish: MODE CO80 (that's c o 8 zero - changes to 80-column mode on some systems) or MODE MONO (changes to monochrome mode on some systems) *************************************** R E M O V I N G E N S E M B L E *************************************** WARNING: Make sure that you have backup copies of any files that are important to you. Improper use of the uninstall program will result in data loss. We have included a program called UNINSTAL.BAT that will completely remove GeoPublish from your hard drive. This program will remove any documents you have created along with the system files, therefore we recommend that you use extra caution. To completely remove GeoPublish, type: CD\GEOPUBL UNINSTAL at a C:\ prompt. (If you have installed GeoPublish in a directory other than C:\GEOPUBL, substitute the appropriate drive and directory in these commands.) %%%%%%%%%%%%%%%%%%%%%% E N D R E A D M E %%%%%%%%%%%%%%%%%%%%%%%%%%