Installation & System Requirements

Contents

• 1. Marvin Applets or Marvin Beans?
• 2. System Requirements
  • 2.1. Marvin Applets
  • 2.2. Marvin Beans for Java
  • 2.3. Marvin Beans for .NET
  • 2.4. How to get Java?
  • 2.5. How to get .NET Framework?
• 3. Installation
  • 3.1. Marvin Applets
  • 3.2. Marvin Beans for Java
    • 3.2.1. Windows
    • 3.2.2. MAC OS X
    • 3.2.3. Linux / Solaris
    • 3.2.4. Other platforms
    • 3.2.5. How to uninstall?
    • 3.2.6. Additional package
  • 3.3. Marvin Beans for .NET

1. Marvin Applets or Marvin Beans?

Marvin is separated to two packages depending on how you want to use it

• Marvin Applets for the web developer
• Marvin Beans for the chemist's desktop and for the software developer

Marvin Applets are tools for building chemical web pages, which are compatible with most browsers (Internet Explorer, Firefox, Safari, Opera, etc.). They offer access from/to JavaScript and are customizable by applet parameters.
Note, that the applets are signed that allows the same feature set as the applications.

Marvin Beans are easy-to-install applications for the desktop and tools for integrating Marvin capabilities into any application.

2. System Requirements

2.1. Marvin Applets

• Java distributed by Sun (or Apple's Mac OS X built-in Java)
• Java version 1.5
• Java 2 enabled browser

2.2. Marvin Beans for Java

• Java distributed by Sun (or Apple's Mac OS X built-in Java)
• Java version 1.5

2.3. Marvin Beans for .NET

• .NET framework 2.0

2.4. How to get Java?

You can download Sun's Java from Sun's official site or contact your OS manufacturer.

If you use Mac OS X, probably Java is already installed on your machine. If not, select Java in the Software Update center to install or update.

Which Java do I need? You must have a copy of the Java Runtime Environment (JRE) on your system to run applications and applets. To develop applications and applets, you need the Java Development Kit, which includes the JRE.

If you are not sure whether Java is installed or not on Windows, you can check it the following way:

1. Select Command Prompt from the Accessories sub-menu in the Start menu.
2. Type the following commands in the opened Command Prompt window: java -version
3. You will get the following error message if Java is not available on your machine:

   'java' is not recognized as internal or external command, operable program or batch file

   If Java is installed, the version number of Java will be printed:

   java version "1.5.0_11"
   Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03)
   Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode, sharing)

2.5. How to get .NET framework?

• .NET framework 2.0
• .NET framework 3.5

3. Installation

3.1. Marvin Applets

1. Download the Marvin Applets package according to your platform from the Marvin download page.
   (.tar.gz is recommended for Unix-like platforms, .zip for others).
2. You need a web server on the machine where you would like to install the Marvin Applets package (because applets work properly only through HTTP protocol). If there is no web server on the target machine, we suggest to use Tomcat.
3. Extract marvin-all-VERSION.tar.gz (in Unix or in Mac OS X) or marvin-all-VERSION.zip (in MS Windows) in the parent directory of "marvin", where VERSION is the current version number.
4. Modify the settings of the web server if the directory of Marvin is not accessible from the web server root. Then restart it (if it is necessary) to validate new settings. (Consult with the manual of the web server how to do it.)
5. Open the index.html file in a browser.

Removing any binary (jar or zip) or configuration (properties or xml) file from the applet package can cause unexcepted error or limitation in the usage.

3.2. Marvin Beans for Java

• Download Marvin for End Users to install desktop applications
• Download Marvin for Developers to use the tools for application development

3.2.1. Windows

1. Double-click on marvinbeans-VERSION-windows.exe or marvinbeans-VERSION-windows_with_jre.exe to install.
2. You can add the bin folder of Marvin Beans to the PATH environment variable to be able to run Marvin applications from any directory in the command line. Details about editing environment variables is described in Windows Help.

3.2.2. MAC OS X

1. Double-click marvinbeans-VERSION-macos.dmg to install.
2. You can add the bin folder of the Marvin Beans folder to the PATH to be able to run Marvin applications from any directory in command line.

Notes

• Requires Mac OS X 10.0 or later
• The compressed installer should be recognized by Stuffit Expander and should automatically be expanded after downloading. If it is not expanded, you can expand it manually using StuffIt Expander 6.0 or later.
• If you have any problems launching the installer once it has been expanded, make sure that the compressed installer was expanded using Stuffit Expander. If you continue to have problems, please contact technical support.

3.2.3. Linux / Solaris

1. Open a shell and cd to the directory where you downloaded the installer.
2. Type the following to install: sh marvinbeans-VERSION-linux.sh
3. You can add the bin subdirectory of the Marvin Beans directory to the PATH to be able to run Marvin applications from any directory.

Notes

• If the installer does not start, check whether JAVA_HOME/bin is in PATH (where JAVA_HOME is the directory of Java).
  To check it, type the "which java" command that shows the location of the Java launcher. You should get something like this:

  /usr/java/jdk1.5/bin/java

  If Java is missing from PATH, you will see something like that:

  /usr/bin/which: no java in (/usr/java/jdk1.5/bin:/opt/apache-ant-1.6.1/bin:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin:/home/vertset/bin)

3.2.4. Other Platforms

1. Go to the directory where marvinbeans-VERSION.zip was downloaded then uncompress the zip file.
2. You can start applications via scripts or batch files that you can find in the marvinbeans/bin directory.

Notes

• You need an expander which can handle zip extension.
• Batch files (bin/*.bat) have to be initialized before the first use. Set the MARVINBEANSHOME variable in the files to the full path of the directory where Marvin Beans is located.

3.2.5. How to uninstall?

• Windows: Double click on uninstall.exe in the Marvin Beans's home folder or select Marvin Beans from the Add / Remove programs list on Control Panel.
• OS X: Double click on uninstall in the Marvin Beans' home directory.
• Linux / Solaris: Launch the uninstall script in the Marvin Beans' home directory.

3.2.6. Additional package

Who needs this package?

Install marvinbeans-lib-VERSION-signed.zip only if you need the signed version of the Marvin Beans package.
If you would like to launch Marvin applications via Java Web Start from your server, you will need the signed version for security reasons.
Please note that this archive can only be used as an extension of the already installed Marvin Beans package.

Installation

1. Check the product version of the Marvin Beans package you have already installed. You can find the product version of your installed disribution in the Help > About dialog or in the version.properties file located in the Marvin Beans installation directory.
2. Download the additional package for exactly the same version: marvinbeans-lib-VERSION-signed.zip.
3. Create a backup of the lib sub-directory of your Marvin Beans package.
4. Extract the marvinbeans-lib-VERSION-signed.zip archive file into the Marvin Beans directory. Your extractor tool (e.g. unzip or WinZip) may ask confirmation to update all files by unwrapping. In this case let it overwrite all. This operation will update the jar files (overwrite them with the signed versions) in the lib sub-directory of the installed Marvin Beans package.

3.3. Marvin Beans for .NET

The Marvin Beans package for .NET platform can be downloaded from this link.

Copyright © 1998-2009 ChemAxon Ltd.    All rights reserved.