Installation ============ Host platforms -------------- We deliver our products via email or on 3.5" floppy disks (1.44 MB IBM Format) On request we can send out 720 kB floppy disks. These formats can be read by PC, Macintosh, Amiga, Atari, Acorn, and others. If you received the software via email or downloaded it from an electronic network you will received it in compressed format (PKZIPF). You will need the latest version of PKUNZIP to decompress the software. On Macintosh do not use the standard UNZIP utility. Instead, use the ZIPIT utility. In ZIPIT uncheck the box that says: "By default, smart-strip line feeds from text files." After unzipping you will find a number of documentation files (this file is one of them). There is no need to transfer them to the palmtop. The actual program files are contained in the file PRODUCT.ZIP. Unzip PRODUCT.ZIP only if you agree with the contents of LICENSE.TXT. Installation using PsiWin on a PC --------------------------------- 1. On the PC create a new directory called \3setup. (If such a directory already exists remove all contents.) Unzip PRODUCT.ZIP into the \3setup directory. On the palmtop stop all running applications. 2. Connect the palmtop to the PC, start "Remote Link" on the palmtop, and invoke the PSION Manager on the PC. 3. Using the PSION Manager's COPY function copy the directory \3setup to the internal drive or a RAM SSD. If such a directory already exists on the palmtop, remove it first. Do not use Drag&Drop copy in PSION Manager and don't select the CONVERT option. 4. Stop "Remote Link" on the palmtop. 5. Now install the Setup utility. To do so, invoke the system "Install" function. In the file selector box press TAB and navigate to the /3setup directory. Select 3setup.opa. 6. The 3setup icon appears on the system screen. Under the icon is a list of available languages. Select a language and press ENTER. 7. The installation begins. If the product was installed before, 3setup will start a dialog asking you if you want to (Continue) = Overwrite existing version. (Other drive) = Install new version on different drive. (Options only) = Adds modules to the existing version. 8. 3setup asks you about the drives to use: System drive: Where the programs go to. We recommend Flash SSD or internal disk. Data drive: For example files and modifiable data. We recommend internal disk or RAM SSD. Permanent drive: Where the Morpheus help server will be installed. We recommend the internal disk. 9. 3setup will ask you about optional modules. You can decide to install them now, or you can leave it for later. 10. 3setup will give instructions on how to proceed. During the installation process it will MOVE files from the \3setup directory into the target directories. It will also create a file INSTALL.LOG in the \3setup directory for diagnostic purposes. 11. After 3setup has finished, delete the whole \3setup directory on the palmtop. You may remove 3setup from the system screen or leave it there if you plan to install another application. Installation using MCLINK or RCOM --------------------------------- This installation method requires far less disk space during installation. It does not need a special installation directory on the palmtop because it installs directly from the PC. 1. On the PC create a new directory called \3setup. (If such a directory already exists remove all contents.) Unzip PRODUCT.ZIP into the \3setup directory. On the palmtop stop all running applications. 2. Connect the palmtop to the PC, start "Remote Link" on the palmtop and start RCOM or MCLINK on the PC. 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and press TAB. When the file selection screen appears, press TAB again. In the first line of the dialog box specify the name of the installation directory (where the new software is stored), e.g. REM::C:\3setup\ (assuming the the \3setup directory is on your C-drive) A file selection list appears. 4. Select the file 3setup.opa (first file). Press ENTER. 3setup now takes control. The screen goes blank for a few seconds. Don't panic. A file selector box appears. 5. The file selector box shows "Script file" with several languages. Select a language. 6. The file transfer starts. If the product was installed before, 3setup will start a dialog asking you if you want to (Continue) = Overwrite existing version. (Other drive) = Install new version on different drive. (Options only) = Add modules to existing version. 7. 3setup asks you about the drives to use: System drive: Where the programs go to. We recommend a Flash SSD or the internal drive. Data drive: For example files and modifiable data. We recommend internal disk or RAM SSD. Permanent drive: Where the Morpheus help server will be installed. We recommend internal disk. 8. 3setup will ask you about optional modules. You can decide to install them now, or you can leave it for later. 9. 3setup will give instructions on how to proceed after the successful transfer. During the installation process it will COPY files from the PC-\3setup directory into the target directories. It will also create a file INSTALL.LOG in the PC-\3setup directory for diagnostic purposes. Installation from other platforms (MacIntosh, Acorn, Amiga, Atari, etc.) ------------------------------------------------------------------------ Proceed as in "Installation using PsiWin", but use appropriate methods to transfer the contents of the host directory \3setup to the \3setup palmtop directory. Stand alone installation ------------------------ This method is used if you downloaded the zipped files directly to your palmtop or if you use a Cyclone drive. 1. Stop all running applications. Create a directory \3setup on the internal disk or a RAM SSD and unzip the file PRODUCT.ZIP into that directory. You will need a unzip utility for your S3a. 2. Proceed from step 5 in "Installation using PsiWin". Guided manual installation -------------------------- This method can be used on all platforms and can be used if disk space on the palmtop is a problem. 1. On your host computer create a new directory called \3setup. (If such a directory already exists remove all contents.) Unzip PRODUCT.ZIP into the \3setup directory. On the palmtop stop all running applications. 2. Connect your Series3 computer to your host computer. Start the host communications software and start "Remote Link" on the palmtop. 3. Copy 3setup.opa into M:\APP\ . Copy all IPF files (*.IPF) into the same directory M:\APP\ . Install 3setup.opa to the system screen using the system "Install" function. 4. Position the highlight under 3setup and press ENTER. A file selector box appears. 5. The file selector box shows "Script file" with a list of languages. Select a language. 6. The installation begins. If the product was installed before, 3setup will start a dialog asking you if you want to (Continue) = Overwrite existing version (Other drive) = Install new version on different drive (Options only) = Add modules to existing version. 7. 3setup asks you about the drives to use: System drive: Where the programs go to. We recommend a Flash SSD or internal disk. Data drive: For example files and modifiable data. We recommend internal disk or RAM SSD. Permanent drive: Where the Morpheus help server will be installed. We recommend internal disk. 8. 3setup will ask you about optional modules. You can decide to install them now, or you can leave it for later. 9. 3setup will ask you to copy files from the /3setup directory on the host computer to a target destination on the PSION. Initiate the file transfer from your host computer. When the file has been transmitted, acknowledge this by pressing ENTER on the PSION. 3Setup will continue with the next file to be copied. 10. After all files have been copied, 3setup will give instructions on how to proceed after the successful transfer. 11. Delete 3setup.opa, the *.ipf files, and INSTALL.LOG from the \APP directory. Installation on the S3a emulator -------------------------------- The S3a emulator is PSION freeware that was developed originally by PSION for inhouse testing. The emulator is available on several PSION related BBS, CIX, and CompuServe. There is also an emulator for Siena, but no emulator for S3c. The emulator runs on PC only. It is able to run as an S3a with the original screensize of 480x160 or up to a screen size of 640x480. The sound capabilities are limited (only a beep and a ring), and there are a few incompatibilities that can make programs behave different. All of our programs have been tested on the emulator and run well - however, some minor hitches may be experienced. If you experience problems and think it is our software, check if the same problems appear on the palmtop. To install a application on the emulator: 1. On the PC create a new directory called C:\3setup. (If such a directory already exists remove all contents.) Unzip PRODUCT.ZIP into the C:\3setup directory. 2. Shut down WINDOWS and start the emulator. 3. Proceed from step 5 in "Installation using PsiWin". After successful installation delete the installation directory C:\3setup. Note: Each time you restart the emulator you have to reinstall all installed applications again to the screen. There is a freeware utility called INSTALL14 which can automate this task. Note: Depending on the emulator setup, you may get a DOS prompt: "Insert floppy into drive ... " Do not insert a floppy, but press the ESC key to continue. Installing several applications ------------------------------- To save disk space some of the program modules are shared by several of our applications. These modules are stored in \APP\COMMON\ . At preset these are the modules: ABOUT.OPA About box and registration RSSET.OPA Printer drivers DIALSET.OPA Tone dialling \plugs\GIF.OPO GIF import/export filter \plugs\PCX.OPO PCX import/export filter \plugs\BMP.OPO PCX import/export filter An application loading these modules will search for these modules on the disk where the application is stored. If not found, it will search for the modules on the internal disk. If you install several applications on the same disk manually, make sure to install the latest version of these moduls. Automated installation with 3setup takes care of this. If 3setup finds a module on the application disk or internal disk it will replace it with a newer version. If the module was not found the new copy will be stored on the application disk. When things go wrong -------------------- - If the installation was interrupted (disk full, battery flat, user abort, etc.) you have to start from scratch again (unzip into installation directory). - If the installation does not run smoothly, do not try to install manually. The chance is that if 3setup or the installation control (IPF) file was corrupted other modules may be corrupted, too. - Please read the instructions again and repeat installation. - You could also try to use a lower transmission speed between host and PSION. - If the problem should persist, check for data corruption. Order another floppy disk, or download again. - If the problem still persists, please seek our advice. To enable us to diagnose the problem, send us file INSTALL.LOG (email or printout). This file is found in the same directory as 3setup.opa. Morpheus -------- If you want help you need Morpheus. Please do not send us questions "What is Morpheus". Instead read this: One of the tricky things when writing OPL-applications is the handling of the HELP-key. Normally an OPL-application is not able to react to the HELP-key when a menu or a dialog box is open. This is unfortunate because this is probably the moment when you need help the most. That is the reason for Morpheus. Morpheus is a independent application which runs in the background and intercepts the HELP-key. Morpheus checks which application is in the foreground and will then display the appropriate help. Morpheus' other function is to handle alarms (for the products ProPoc and HyperPoc). It can do this better than the Agenda. As long as there are alarms scheduled it will run in the background and reschedule new alarms if necessary. Morpheus is launched automatically by any application that uses Morpheus' services. Morpheus will stay active as long as a client application is active or any Morpheus-alarms are scheduled. (The actual shutdown may be delayed for 1 minute). Normally you don't have to shutdown Morpheus manually. Morpheus can serve multiple clients. Even if you run two or more of our products in parallel only one copy of Morpheus is running. Morpheus is installed on the "permanent drive" - usually the internal disk. The permanent drive should not be removed from the palmtop and cannot be reformatted unless Morpheus is stopped. If you must, here is the way: Install Morpheu2 to the system screen (see PSION user manual) Then KILL Morpheus. If Morpheus was running it will respond with a beep and will die. Remove Morpheus from the system screen (see PSION user manual). Deinstallation -------------- To deinstall an application from the palmtop: 1. First backup your system. 2. Remove the applications data folder. To locate the data folder, position the cursor under the application icon and press TAB. 3. Remove the any application specific files and folders from your system (application disk AND internal disk): such as \APP\ProPoc.opa (Example for deinstalling ProPoc) \APP\PROPOC\ M:\propoc.* (For example propoc.ini and propoc.$$$) 4. Remove the applications help file \APP\HELP\ProPoc.hlp (Example for PROPOC) 5. If there are no other of our applications (F11, FlowPoc, HyperPoc, MusiPoc PicPoc, PocDoc, PocView, ProPoc, RepPoc...) are installed on the same disk remove the following files and directories from THAT disk. \APP\COMMON\ABOUT.OPA \APP\COMMON\RSSET.OPA \APP\COMMON\DIALSET.OPA \APP\COMMON\PLUGS\GIF.OPO \APP\COMMON\PLUGS\PCX.OPO \APP\COMMON\PLUGS\BMP.OPO 6. If there are no other of our applications installed on the palmtop (all disks) remove the above files from the internal disk, too. Also remove M:\ALRM.$$$ from the internal disk and \APP\MORPHEU2.OPA \APP\MORPHEU2\ from the permanent disk (usually the internal disk). End of document ---------------