1 Introduction

This documents contains instructions to download, install, configure and use a stand-alone instance of the Regulatory Sequence Analysis Tools (RSAT) in the form of a Virtual Machine (VM) running under VirtualBox.

2 Requirements

The RSAT Virtual Machine (RSAT-VM) requires

  1. The VirtualBox platform should be installed on the host computer. This software runs under Linux, Solarix, Mac OSX and Windows operating systems.

  2. A sufficient amount of memory (RAM) to allocate two Gb to the RSAT-VM.

  3. The VM initially occupies ~5Gb of hard disk space. By default, its hard drive is configured to grow dynamically when needed (for example when installing genomes), wih a maximal size of 18Gb.

3 Technical specifications


4 Downloading RSAT-VM

Virtualbox RSAT Virtual Machines can be downloaded from the RSAT distribution site.

  • Open a connection to any RSAT server (http://rsat.eu/).
  • In the left-side menu, click on the Download link.
  • Enter your coordinates and click GO. You will be redirected towards the download server.
  • In the download Web site, the link virtual_machines.
  • Download the version of your choice (current version: rsat-vm-2018-05.ova).

5 Network configuration

The RSAT-VM is provided in a ready-to-use mode. However, you may need to adapt the configuration of your VirtualBox environment in order to obtain a correct behaviour of the VM.

5.1 VirtualBox host-only adapter

The host-only adapter enables your computer (the “host”) to establish connections to the “guest” virtual machine. This is necessary if you want to use the VM as a Web server, or use command lines on a terminal (via ssh connection from the host machine).

  1. Open the VirtualBox program.

  2. Open VirtualBox Preferences.
    Click on the Network option.
    Click on the tab Host-only Networks. Check if a host-only adapter is already installed. If not, create a new one by clicking the + icon on the right side (snapshot).

  3. Double-click on the host-only adapter to change its parameters.

  4. In the Adaptor tab, set the parameters as follows (snapshot).

    1. IPv4 Address: 192.168.56.1
    1. IPv4 Network Mask: 255.255.255.0
    1. IPv6 Address: (leave this field blank)
    1. IPv5 Nework Mask length: 0

  5. In the tab DHCP Server, set the parameters as follows (snapshot). 1. Check the option Enable Server 1. Server Address: 192.168.56.100 1. Server mask: 255.255.255.0 1. Lower Address Bound: 192.168.56.101 1. Upper Address Bound: 192.168.56.154

5.2 Network settings for the guest machine

VirtualBox supports various ways to connect the guest (virtual machine) to the network. The two first adapters are required for proper functioning of the RSAT VM. The third one is optional and should be enabled with caution.

  1. Host-only network will enable the host machine (your computer) to access the virtual machine by HTTP (Web browser) or SSH (secure shell).

  2. NAT will enable the communication from the virtual machine to the external world.

  3. Optionally, a Bridged network might be configured in order to make your virtual machine visible from external computers.

5.2.1 Host-only network

This solution offers a good tradeoff between security and confort: your virtual machine (the guest) will be accessible only from your computer (the host).

  1. In the panel showing the available virtual machines, right-click on the RSAT-VM (RSAT-VM-2018-05), open the Settings … dialog box.

  2. In the tab Network, select Adapter 1, check Enable Network Adapter, select Attached to: Host-only Adapter (snapshot).

  3. In the pop-up menu besides the option Name, select vboxnet0.

5.2.2 NAT

Note: the host-only adapter will enable you to establish a connection (Web browsing, ssh connection) from the hosting operating system (the usual environment of your computer) to the guest system (the virtual machine). however, this adapter does not allow to connect the external world from the guest.

In parallel to the host-only adapter, we thus recommend to enable the second adapter and select NAT.

5.2.3 Bridged network

Alternatively , for the sake of flexibility, you might consider to use a bridged network. The bridged adapter is the most convenient, because it establishes a bidirectional connection between your VM (the guest) and the network. Your guest RSAT Web server can thus be used from any other computer in your network. This configuration can typically be usd to make an RSAT server available for all people from the same lab or institute.

Attention! The bridged network makes your virtual machine visible for all the other computers of the local network the host machine (your PC). Check with your system administrator that this fits the local security requirements.

  1. In the panel showing the available virtual machines, right-click on the RSAT-VM (RSAT-VM-2018-05), open the Settings … dialog box.
  2. In the tab Network, select Adapter 1, check Enable Network Adapter, select Attached to: Bridge adapter.
  3. In the pop-up menu besides the option Name, select an adapter depending on your local network configuration, e.g. Wi-fi (Airport) (snapshot).

6 Running RSAT-VM

6.1 Starting the RSAT virtual machine

  1. In the left panel of VirtualBox, select the virual machine (RSAT-VM-2018-05), and click on the Start icon.

At this stage, your RSAT VM should now be ready to be used from the Web interface. Assuming that you activated the host-only network as described abve, and that you only started one virtual machine), VirtualBox hould have assigned the first IP address of the range defined in the settings above: 192.168.56.101.

6.2 Using RSAT-VM as Web server

  1. Open a connection to http://192.168.56.101/rsat/ in your web browser.

If the link does not work, it probably means that your network was not activated as described above. You will then need to obtain the IP address of your VM. Unfortunately, VirtualBox does not provide a direct way to know which IP address has been assigned to a VM. The only way we found to get this information is to run the VM with the graphical interface, open a terminal, and run the command /sbin/ifconfig.

6.3 RSAT-VM log-in

You can log with the following parameters:

  1. Username: vmuser
  2. Password: tochng

We intently chose an overly simple temporary password to ensure compatibility with AZERTY as well as QUERTY keyboards, but we recommend to use a safer password.

  1. At your first login, you will be prompted to change your password before anything else.

  2. The user vmuser is sudoer. After login, you can thus become the master of your Virtual Machine, create new users, install packages, etc.

6.4 Chosing the adequate keyboard for your computer

A small difficulty when distributing a VM is the large variety of keybords expected to be found on the users’ computers. By default, we selected the standard British QWERTY keyboard.

On Ubuntu 16.04 server version, keybord configuration can be modified with following command.

For the desktop version, click on the Settings icon , then on the , and check the keyboard..

6.5 Connecting RSAT-VM in ssh

In principle your RSAT VM should be accessible at the following address.