The virtual machine is the easiest way to test Scrimer. You get a computer preinstalled with Scrimer,many of its dependencies and a test data set. The test data set is a complete scrimer run with all theintermediate files generated from a subset of reads from our nightingale data set, using zebra finchas a reference genome.
The machine is set up tu use 2 GB of RAM and one CPU. Those settings can be adjusted in the main VirtualBoxinterface. We decieded to use 32 bit machine, because it is the most compatible setting. The downside isthat you cannot use more than 4 GB of RAM. We can provide 64 bit image on request.
Because of licensing issues, the image does not contain Newbler. Trinity is not included as well,because of high memory requirements of the assembly. We recommend to perform the assembly ona dedicated machine and then transfer the data back to the scrimer project directory.
WinSCP is an excellent free GUI client for sFTP (Secure FTP) protocol on Windows, however the same is not available on Apple Mac OS X platform. Also, there are not many free frontend clients for OpenSSH's sftp/scp protocls on Apple Mac OS X, from the very limited options 'Fugu SSH' takes the crown for being the best. If you don't have a remote server to try this with, you can try it out between Mac OS X machines or with localhost if you enable ssh and Remote Login on the Mac beforehand. The basic syntax to use scp (secure copy) for securely downloading remote files is as follows, replacing user, server, path, and target as appropriate.
Virtual machine installation¶
Installation steps (it should take less than 10 minutes):
- Install VirtualBox (https://www.virtualbox.org/wiki/Downloads). It works on Windows, Linux and Mac.
- Download the virtual machine image from http://goo.gl/Xf2cVU. You'll get a single file with
.ova
extensionon your hard drive. - You can either double click the
.ova
file, or run VirtualBox, and chooseFile>ImportAppliance
.Follow the instructions after the import is started.
After a successful instalation you should see something like this (only the machine list will contain jsut one machine).Check whether you can start the virtual machine: click Start
in the main VirtualBox window:
Winscp For Mac Free Download
After a while you should see something like this:
You don't need to type anything into that window, just checking that it looks like the screenshot is enough.
Machine configuration details:
- Administrative user: root, password: debian
- Normal user: user, password: user
- ssh on port 2222
Windows¶
Install PuTTY and WinSCP. PuTTY will be used to control the virtual computer. WinSCP will be used to transferfiles between your computer and the virtual computer.
- PuTTY (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html - look for putty.exe)
- WinSCP (http://winscp.net/eng/download.php - look for Installation package).
Mac OS X and Linux¶
Ssh is used to control the virtual computer. It should be installed in your computer.
Files can be transferred with scp
, rsync
or lftp
(recommended)from the command line. Scp and rsync could be already installed in your system,if you want to use lftp, you'll probably have to install it yourself.
Mac users that prefer grapical clients can use something like CyberDuck. Seehttp://apple.stackexchange.com/questions/25661/whats-a-good-graphical-sftp-utility-for-os-x .
Connecting to the virtual machine¶
Connect to control the machine¶
To control the machine, you need to connect to the ssh service.
Download Mac Os X Tiger
In Windows this is done with PuTTY.
- start PuTTY
- fill Host Name:
localhost
- fill Port:
2222
- click Open or press
In the black wnidow that appears, type your credentials:
- login as:
user
- user@localhost's password:
user
In Mac OS X or Linux, this is done with ssh tool: Mac windows office compatible.
Connect to copy files¶
In Windows, WinSCP is used to copy files to Linux machines. You use the same informationas for PuTTY to log in.
Download Winscp For Windows
In Mac OS X or Linux, the most simple command to copy a file intoa home directory of user
on a running virtual machine is: