This chapter should help you to install Cinderella on your computer.
You need two things to run Cinderella: the program code and a Java Virtual Machine (JVM). We included a installation software on the CD which includes JVMs for the most popular platforms. If your platform is not included, you can still be able to run Cinderella, provided that you get a Java-1.1 compatible JVM first. Please refer to the Javasoft website at http://www.javasoft.com for information on third-party Java ports and proceed to the "Java install" section in this chapter.
For you convenience we included some Java-1.1-compatible Internet browsers on the CD. This includes versions of Netscape Communicator for Unix and Windows, Microsoft Internet Explorer for MacOS and Microsoft Windows 95/98/2000/NT, as well as a preview version of iCab for MacOS. We do not offer support for these browsers.
Insert the CD into the CD drive and open it. You will find a file called "install" in the root directory of the CD. Start this program and follow the instructions.
After you installed Cinderella you will be able to double-click files with the ".cdy" extension in order to view or edit them.
If you want to uninstall Cinderella you can do so by choosing the "Uninstall Cinderella" shortcut.
Mount the CD (e.g. using "volcheck", or ask your system administrator) and change to the Solaris directory, where you find a file called "install.bin". Run it with "./install.bin" or "sh install.bin".
Follow the on-screen installation instructions. You can choose the installation directory and link locations during the install process. Be sure to choose locations where you have write access.
If you already have a Java-1.1 compatible JVM you can choose to use it instead of the packaged one, which will reduce the disk space needed by Cinderella.
After you installed Cinderella you can run it by executing the "Cinderella" link or the file "Cinderella" in the installation directory.
For uninstalling the software you can use the link "Uninstall Cinderella" or the executable found in the UninstallerData subdirectory of the installation directory.
First of all you have make sure that a Java-1.1 JVM is available and properly installed on your system. Consult the Javasoft webpages for information on third-party Java ports.
Mount the CD and change to the Unix subdirectory on the CD (you should ask your System Administrator if you do not know how to mount a CD). Run the "install.bin" script you find there.
If the installation software finds more than one JVM it will ask you to choose one. After that, the installation procedure begins and works like the Solaris version. Please read the preceding section for more details.
In order to avoid unnecessary downloads we put versions of the Java Runtime Environment for the Linux operating system on the CD. Please understand that neither Springer-Verlag nor the authors can support this software, which is provided "as-is" and without any warranties.
Please consult the README file in the Linux subdirectory on the CD for more information, or consult the Java-Linux site at http://java.blackdown.org.
After you have installed a JVM you can proceed as written in the previous section, "Installing on Unix-like platforms".
Insert the CD into your CD drive and open the CD icon that appears on your desktop. You will find three folders, called Cinderella, MRJ Install, and Internet Browsers. If you are unsure about your version of Macintosh Runtime for Java (MRJ), please change to the MRJ Install folder and follow the instructions given there.
If you have MRJ 2.2 or higher installed, you can run Cinderella directly from the CD by double-clicking the Cinderella-icon in the Cinderella folder. If you prefer, you can copy the entire Cinderella folder to your harddisk and run it from there. No other installation procedure is needed.
It should be possible to install Cinderella on any platform that is capable of running Java-1.1. You will understand that we could not test the software on all these platforms, and your mileage might vary. We tried not to rely on any platform specific features which coulb be unavailable somewhere.
Insert the CD into your CD drive and find the directory called "Java". The file "install.zip" which is contained in this directory contains the complete installation software. Use your platform specific way to add install.zip to the Java classpath and run the class called "install". After that you can proceed as in the Unix install.
A possible way do the above would be to enter
jre -cp install.zip install
in a command shell. Please consult your JVM documentation
for details.
If you are unsure about your platform or if you do not feel like using a command shell you can use a web browser for installation. Open the page "install.htm" in the "Webinstall" with a browser directory on the CD and follow the instructions.
If the installation fails for some reason, please check the following facts:
If none of the above causes your trouble, please visit our website for a list of problems and solutions or mail to install@cinderella.de for help.