Minimum requirements

Datastream Pro requires a pre-installed copy of the Java Runtime Environment (JRE). version 1.4.0 or later in order to run. You can download a copy of the Java runtime environment from java.com. The JRE must be on your system path, so that the "java" command can be run from anywhere. You can test to see if this is the case by executing the command

			 java -version
			 

			  java version "1.4.2"
			  Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
			  Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
			 

Install on Linux and other *ix systems

Datastream Pro can be downloaded as a tar.gz file from the downloads section.

NOTE: it has come to our attention that the linux version is only able to run on JVM version 1.5. This will be fixed in the next release of Datastream Pro.

• Download this file to your system, extract it to the installation location.
• Ensure that the Java Runtime Environment is available on the users path. (Must be 1.4 or later)
• If nesseccary perform a "chmod" operation on dspro.sh to make it executable.
• Run the dspro.sh file to use Datastream Pro.
• You will find some icons in the "icons" directory if you want to make a desktop or menu link to Datastream Pro.

Install on Microsoft Windows

Installation of Datastream Pro on Microsoft Windows is very easy. Once you have downloaded the installation file (.exe) double click it to begin the installation process.

Follow the onscreen instructions and when the installation wizard finishes, Datastream Pro will be installed.

Troubleshooting

Behaviour: I get the following error when starting Datastream Pro from the command line:

Experienced a problem while starting the application.
java.lang.reflect.InvocationTargetException
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:324)
        at com.explosion.boot.Bootstrap.main(Bootstrap.java:83)
Caused by: java.lang.NoClassDefFoundError: org/w3c/dom/ranges/DocumentRange
        at java.lang.ClassLoader.defineClass0(Native Method)
        at java.lang.ClassLoader.defineClass(ClassLoader.java:539)
        at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:123)
        at java.net.URLClassLoader.defineClass(URLClassLoader.java:251)
        at java.net.URLClassLoader.access$100(URLClassLoader.java:55)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:194)

• It is likely that you are using a version of the Java Virtual machine that is incompatible with this release of Datastream Pro. Try upgrading your Java Virtual Machine to Version 1.5 (Sometimes referred to as Java 5), you can get this at http://www.java.com

Behaviour: Connection settings are not remembered between version 0.9.6 and version 0.9.7
Help:

• Unfortunately radical changes between versions 0.9.6 and 0.9.7 meant incompatibility between the format of the connection settings. Please accept our apologies for any inconvenience this may cause.

Message: "A version of Datastream Pro is already installed in the location C:\Program Files\Datastream Pro. Please uninstall the existing version before restarting the installation."
Help:

• If you haven't uninstalled the previous version of Datastream Pro which you had on your system, please do using the Datastream Pro uninstaller before installing the new version.
• If you have uninstalled your old version of Datastream Pro using the installer but you are still getting this message then delete all files in the directory "C:\Program Files\Datastream Pro" as well as the directory itself before installing the new version.
  The leftover files could be there for one of two reasons:
  
  • The uninstaller wasn't able to delete all the files in the installation directory.
  • The version of Datastream Pro you had installed was earlier than 0.9.0.2. Prior to this version the installer was not deleting all of the files in the installation directory. This bug was fixed in version 0.9.0.2.