Installing Chemistream

Mac OSX

For the Mac OSX operating system, the Chemistream installation in performed through a pkg file installer. Once you download the pkg file you can either type

open Chemistream-x.x.x-MacOSX-x86_64.pkg

from a command line terminal or you can move the pkg file to your desktop and open. Once the pkg installer starts you will see the following:

_images/chemistream-pkginstall-osx-1.png

Follow the instructions from the installer. The default selections should be sufficient for a single user installation. You may check the installation destination by clicking on the “Destination Select” –> “Customize Location” and check that “Install for me only” is chosen. You may see the following

_images/chemistream-pkginstall-osx-2.png

This is not an error, simply click on the “Install for me only” selection and you should see

_images/chemistream-pkginstall-osx-3.png

then continue with the installation. The installation procedure may take several minutes during which you will see progress status e.g.

_images/chemistream-pkginstall-osx-4.png

If the installation procedure is successful you should see

_images/chemistream-pkginstall-osx-5.png

The Chemistream Launchpad application should then startup (see description below). The location of the Chemistream Launchpad will be shown in the Finder. Upon closing the launchpad you may either go to the same location in the Finder and click on the app or right-click on the Chemistream logo in your dock (while the launchpad is running) and select “Keep In Dock” as a convenient way to restart the application.

Linux

For a Linux operating system, the Chemistream installation in performed through a shell file installer script. Once you download the installer script you install by going to a terminal and typing

Chemistream-x.x.x-Linux.sh

Follow the installer instructions. Once the shell script is complete change to the installation directory you chose and type

run.sh

The Chemistream Launchpad application should then startup (see description below).

Windows

For the Windows operating system, the Chemistream installation is performed through an exe installer. Once you download the exe file you install by moving it to your Desktop or locating in your File Explorer and opening. Once the installer starts you will see the following:

_images/chemistream-pkginstall-win-1.png

Follow the instructions from the installer. The default selections shold be sufficient for a single user installation. Make note of the installation location

_images/chemistream-pkginstall-win-2.png

so you can locate with the File Explorer later. The installation procedure may take several minutes during which you will see progress status e.g.

_images/chemistream-pkginstall-win-3.png

During the configuration of JupyterLab, which is a major component of the Chemistream application, you will see a separate windows labeled ‘npm’ that will start with the following output

_images/chemistream-pkginstall-win-3a.png

and later

_images/chemistream-pkginstall-win-3b.png

This window should close once the configuration step is complete and the installation window instructions can be followed once again. If the installation procedure is successful you should see

_images/chemistream-pkginstall-win-4.png

The location of the Chemistream Launchpad will be shown in the File Explorer. You might have to scroll down in the Explorer to find the ‘chemistream-launchpad.exe’ file. Upon closing the launchpad you may either go to the same location in the File Explorer and click on the app, or you can also right-click on the Chemistream logo in the installation location in the File Explorer and create a shortcut. This shortcut may be moved to your Desktop for a convenient way to restart the application.

Chemistream Launchpad

Once the installation procedure for any of the supported platforms is complete the ‘Chemistream Launchpad’ application will open.

_images/chemistream-launchpad.png

The first button has basic overview info and the other two buttons will open tabs in your default web browser.