Installation

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.

Marvin Beans for Java

Download the package according to your platform from one of these links.

Follow the instruction below:

Platforms:

Notes

  • After installation, at the first launch of MarvinSketch, a dialog asks the user to select the desired skin for the GUI configuration :

  • The selected configuration can be changed later any time.

Windows

If you have a 64-bit Windows, you can choose both the normal (32-bit) Marvin Beans installer or its 64-bit version.

The following table helps you to choose which installer can you use on your platform.

Installer

32-bit Windows

64-bit Windows

without Java

with Java

without Java

with 32-bit Java

with 64-bit Java

marvinbeans-VERSION-windows.exe

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

marvinbeans-VERSION-windows_with_jre.exe (bundled with 32-bit Java)

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

marvinbeans_VERSION-windows_64bit.exe

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/error.png

images/s/en_GB/6219/97b73ca06fd2a90682d80f34d4c4c163eebdd511.89/_/images/icons/emoticons/check.png

If you have a 64-bit Windows, follow the instructions in the 64-bit Windows section.

  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.

Notes

  • Please make sure to close all running Marvin applications before starting the installer otherwise it may not be able to perform the installation correctly (overwriting certain .jar files is not possible if they are being used by a running application).
    Running applications may include:

    • Marvin desktop applications

    • MS-Office documents where Marvin Objects are being edited

    • Running applications where Marvin is embedded, like Instant JChem

    If the installation stops and an error popup is displayed, check the running processes in Windows Task Manager: if marvinOLEServer.exe is running, please stop it manually. This may occur when an MS-Office document is just using Marvin.

  • You can run the installer in silent/non-interactive mode, which means that in case Marvin is already installed, it will be overwritten with the update without the need of checking the "OK" and "Next" buttons on the installer dialogs. To enable this mode, use the -q option (for example open the command prompt with cmd.exe and type "marvinbeans-5_3_0.exe -q").

64-bit Windows

System requirements: 64-bit Windows system having an installed Java for 64-bit architecture.

  1. After downloading marvinbeans-VERSION-windows_64bit.exe, take a double-click on the downloaded file (accept running if Windows expects verification).

  2. Installer is started: go through the installation wizard. The installer will setup the 64-bit version of JChem_NET_API automatically (that is wrapped into the installer)

Notes

  • JChem_NET_API is required to be able to insert Marvin OLE (embedded object) into MS-Office document or transfer it between Marvin and the MS-Office applications.

  • Earlier versions of MS-Office suites are not available in 64-bit format. If your Office does not support 64-bit platform, you cannot use the OLE functionality of 64-bit version of Marvin. In this case, install 32-bit version of Marvin Beans and JChem_NET_API that can incorporate with 32-bit Office applications.

  • When you edit an embedded Marvin Object in Office, the editor can be different depending on the platform.

    • MS-Office 32-bit requires 32-bit JChem .NET API for Marvin embedding. It uses 32-bit .NET implementation of MarvinSketch unless 32-bit Marvin Beans package is installed. In this case, it prefers the 32-bit Java implementation.

    • MS-Office 64-bit requires 64-bit JChem .NET API for Marvin embedding. The 64-bit .NET implentation of MarvinSketch is used in all cases.

  • See further notes in the 32-bit Windows section.

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.

  • 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 still have problems, please contact our technical support.

  • You can run the installer in silent/non-interactive mode, which means that in case Marvin is already installed, it will be overwritten with the update without the need of confirmation. To enable this mode, use the -q option.

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 (or sh marvinbeans-VERSION-linux_with_jre.sh depend on which package has been downloaded).

  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.

  • 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.6/bin/java

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

    /usr/bin/which: no java in (/usr/java/jdk1.6/bin:/opt/apache-ant-1.6.1/bin:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin:/home/vertset/bin)
  • You can run the installer in silent/non-interactive mode, which means that in case Marvin is already installed, it will be overwritten with the update without the need of confirmation. To enable this mode, use the -q option. If you are in terminal mode (GUI is not accessible), we recommend to use this option.

Application crashes with java virtual machine error on Linux systems when File>Document Style > Settings is opened. Uninstalling ttf-unifont package or updating Java to the latest version can eliminate the problem.

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.

  • 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.

How to uninstall?

Use the uninstaller to remove Marvin Beans from your machine. If you give the -q command line parameter by running the uninstaller, it will run in silent mode (no GUI, non-interactive mode).

  • 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 ChemAxon Marvin Beans Uninstaller in the Marvin Beans' home directory.

  • Linux / Solaris: Launch the uninstall script in the Marvin Beans' home directory.

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 distribution 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.

Marvin Beans for .NET

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