MELANIETM version 9.0
The 2-D Gel Image Analysis Software Package
Platforms: Windows® 7 / 8 / 10
Important
Please take the time to familiarize yourself with the program by reading the documentation. You will find that the investment in time will help you to quickly become a proficient user of Melanie.
Contents
1	Software versions
1.1	Melanie Classic
1.2	Melanie DIGE
1.3	Melanie Coverage
2	Minimum Installation Requirements
3	Software installation
3.1	Software updates
4	Software protection - Licensing
4.1	Find the Physical Address
4.2	Install the license server
4.3	Place a license file
4.4	Start the license server
4.5	Start using the license
5	Documentation
6	Tutorials
6.1	Non-DIGE Tutorial
6.2	DIGE Tutorial
6.3	Coverage Tutorial
7	Uninstall Instructions

1	Software versions
Depending on the license you purchased, this installation of Melanie will give access to one of the following software versions. 
1.1	Melanie Classic
This version offers all the functionality you need to analyze experiments consisting of conventional 2-DE gels.
1.2	Melanie DIGE
This version includes all the features of the Classic version, plus specific functionality for the analysis of DIGE gels. This lets you fully exploit the advantages offered by multiplexing, in particular the high statistical confidence and reliability resulting from the use of an internal standard.
1.3	Melanie Coverage
This version includes all the features you need to analyze HCP antibody coverage experiments. Both conventional 2D PAGE/Western Blot experiments and 2D-DIGE or 2D-DIBE experiments can be analyzed.
2	Minimum Installation Requirements
To install and run this software, the following minimum specifications are required:
•	Microsoft Windows 7, 8 or 10 operating systems. 64 bit versions are recommended for maximum performance. Please request a 32 bit installer if you need to install on a 32 bit Windows operating system.
•	Administrative privileges to install Melanie, the license server, and the license.
•	Minimum 2 GB of RAM. Increased memory enhances the performance when many and/or large images are analyzed.
•	Minimum 24-bit color resolution and 1024 x 768 screen resolution.
•	Browser to view the software documentation and access databases on the web. 
3	Software installation
You can install Melanie from a CD-ROM or by downloading the installation package over the Internet. When you insert the CD-ROM into the appropriate drive on your computer, the Setup Wizard starts automatically and guides you through a series of screens. Alternatively, you can double click on the icon of the installer file (for example SetupMelaniev900.exe) to launch the install program.
The Melanie installer creates a default directory on your hard disk called Program Files\GeneBio\Melanie 9, where the program files are placed. If you want to save the default directory in a different folder, then browse and open the folder before continuing the installation.
3.1	Software updates
When installing a Melanie 9.X software update, the installation process will automatically uninstall the previous release 9.X and install the new release. All your data, links to data, preferences and license files remain unchanged. Once the software update is complete, you can immediately continue working on your projects.
4	Software protection - Licensing
Upon installation, Melanie is fully functional when analyzing the tutorial images (see Section 6), but it does not allow alignment and detection on other gels. To analyze your own images, you must purchase and install an electronic license, or request a trial license. The availability of the license file is verified each time the software is launched.
There are two types of Licenses:
•	Node-locked (Machine) license: To be used on a single computer. It is practical when only a few computers are used for working with Melanie. A node-locked license file must be placed on the computer running Melanie.
•	Floating license: To be used by all computers networked to a license server. It is useful when many users, but not all at the same time, need access to the software. The number of computers that can simultaneously work with Melanie depends on the license, and is administered via the license server. A floating license file must be placed on the computer running the license server. This server can either be installed on a computer running Melanie or on any other network computer (recommended: install on a network computer that is continually running).
Read on to learn how to obtain and place a license file.
4.1	Find the Physical Address
In order for GeneBio to create a license file, the Host ID – more particularly the Physical Address of your computer – is needed. This address identifies the computer and is used by the licensing system.
If purchasing a node-locked license, send the Physical Address of the computer where Melanie is to be installed. If purchasing a floating license, send the Physical Address of the computer where the license server is to be installed.
To find the Physical Address:
1.	On the computer where the license file is to be placed, choose All Programs > Accessories > Command Prompt in the Windows Start menu.
2.	In the Command Prompt window, enter ipconfig /all. There must be a space between ipconfig and /all.
3.	The response should contain several parameters for the network. Look for the line Ethernet adapter Local Area Connection. Then look for the Physical Address. This is the recommended Host ID for the license. Note that you can use one of the other available Physical Addresses. However, avoid virtual adapters or devices that are deactivated in low power mode.
4.	Note down the Physical Address among the displayed information and send it to melanie@genebio.com so that your license can be created. The Physical Address must be correctly recorded for the license file to work.
4.2	Install the license server
This section only pertains to floating licenses. If you have a node-locked license, then skip to the next section.
To install the GeneBio license server:
NOTE: Administrative privileges are required to install and run the license server, and place the license file. If any question about Windows Firewall appears during the procedure, answer Yes in order for the license server to work properly. If you encounter any issues to start the license service using LMTOOLS (see below), make sure to add Lmgrd.exe to the firewall exceptions of your antivirus, and to enable the TCP/IP ports 27000 to 27009 on the server computer, as these are used by the licensing components.
1.	Download and run the installation file http://www.2d-gel-analysis.com/licenseserver/Setup_GeneBioLicenseServer.msi on the computer where the license server is installed.
2.	If Windows User Account Control asks if you want to allow the program to make changes to your computer, answer Yes.
3.	In the installation window, click Next.
4.	Accept the default installation path and start the installation. By changing the default installation path, the file paths in LMTOOLS will need to be updated accordingly.
5.	LMTOOLS automatically opens once the installation is successfully completed.
6.	Click the Config Services tab and ensure that the following options are set:
•	Service Name: GeneBio
•	Path to the lmgrd.exe file: C:\Program Files (x86)\GeneBio\License Server\lmgrd.exe
•	Path to the license file: C:\Program Files (x86)\GeneBio\License Server\Licenses\
•	Path to the debug log file: C:\ProgramData\GeneBio\ lmgrd.log
•	Start Server at Power Up: ticked
•	Use Services: ticked
7.	Click Save Service, even if no changes were made.
8.	Leave LMTOOLS open and proceed to the next section.
4.3	Place a license file
You will receive the license file (with a .lic extension) from GeneBio once you have sent the Physical Address of your computer.
•	For a node-locked license, the file must be placed in the Melanie installation folder (C:\Program Files\GeneBio\Melanie 9 by default).
•	For a floating license, the file must be placed in the Licenses subfolder of the License server installation folder (C:\Program Files (x86)\GeneBio\License server\Licenses by default).
4.4	Start the license server
This section only pertains to floating licenses. If you have a node-locked license, then skip to the next section.
To start the GeneBio license server:
1.	Select the Start/Stop/Reread tab in LMTOOLS.
2.	Click Start Server.
3.	Close LMTOOLS.
4.5	Start using the license
Node Locked license
Simply start Melanie on the computer where the software and license file are installed. If the software starts in Demo mode:
1.	Click the Import license button.
2.	Check Specify the License File and click Next.
3.	Browse to select the node-locked license file (normally in the Melanie installation directory) and click Open.
4.	Terminate the process by clicking Next, then Finish.
Floating license
1.	Start Melanie on each computer where the software is installed. Click the Import license button in the window that appears.
2.	Check Specify the License Server System and click Next.
3.	Enter the name of the computer where the eLicense server is installed. Enter “localhost” if the eLicense server is running on the same computer as Melanie. Click Next, then Finish.
5	Documentation
Complete and regularly updated documentation (including User Guide, various other guides, FAQs and blog articles) is available online on the website http://www.2d-gel-analysis.com/documentation/, and accessible directly from within the software. A copy of the User Guide (in HTML format) is also installed with the software, and will be automatically accessed when there is no connection to the Internet.
6	Tutorials
Melanie comes installed with a number of tutorial images that you can use to evaluate the software. These images can be found in the folder Tutorials in the software installation directory.
6.1	Non-DIGE Tutorial
The 12 sample gels used in this tutorial come from an experiment that aims to study protein expression changes between four conditions. Cells were grown on two different substrates (substrate A and substrate B) and underwent one of two treatments (treatment 1 and treatment 2). Three biological replicates have been run for each condition.
Condition	Treatment	Substrate
A_T1	Treatment 1	Substrate A
A_T2	Treatment 2	Substrate A
B_T1	Treatment 1	Substrate B
B_T2	Treatment 2	Substrate B
6.2	DIGE Tutorial
The sample gels used in this tutorial come from an experiment that aims to study protein expression changes between control and treated groups of bacterial cultures.
In this study, eight sample lysates were prepared; four were derived from treated bacterial cultures and four were derived from un-treated (control) bacterial cultures. Aliquots from each sample were taken and pooled to prepare a standard sample (pooled internal standard). The samples were run on four gels. The control and treated samples were alternatively labeled with Cy3 or Cy5 (dye swap) to avoid dye-bias. The standard was labeled with Cy2 and run on each gel in the experiment. A preparative gel, including reference markers, was run on the pooled sample and post-stained with a Fluor total stain to pick spots and identify them by mass spectrometry (MS).
Gel	Cy2	Cy3	Cy5
Gel 01	Pooled internal standard	Control A	Treated A
Gel 02	Pooled internal standard	Treated B	Control B
Gel 03	Pooled internal standard	Control C	Treated C
Gel 04	Pooled internal standard	Treated D	Control D
6.3	Coverage Tutorial
The sample images used in this tutorial come from a 2D Differential In Blot Electrophoresis (2D-DIBE) experiment aimed at assessing coverage, i.e. the percentage of immunodetection that an antibody reagent offers for a population of HCPs. 
An E. Coli HCP sample was pre-labeled with Cy5TM and separated on a 2D gel. Protein was transferred from the gel to a membrane. The blot was then incubated with an anti-E. Coli HCP polyclonal antibody and a Cy3TM pre-labeled secondary antibody, and imaged for Cy5 and Cy3 to detect HCP antigen and anti-HCP antibody signals, respectively. The experiment was carried out in duplicate (Blot1 and Blot2).
Blot	Cy3	Cy5
Blot1	anti HCP antibody	HCP antigen
Blot2	anti HCP antibody	HCP antigen
7	Uninstall Instructions
To uninstall the Melanie package:
•	In Windows, choose Start > Control Panel.
•	Select Programs and Features icon in the Control Panel. 
•	Select Melanie in the list.
•	Click Uninstall.