This recipe will describe the options available for installing RubyMine on the three major platforms—Windows, Mac, and Linux. It will briefly cover the steps for installation of the most recent version.
In order to proceed, you must have already installed a version of the Ruby programming language. The installers for these can be found at http://www.ruby-lang.org/en/downloads/.
It is recommended that you download the latest version of Ruby if you are a beginner, which is v2.0. Follow the instructions on the site mentioned previously, depending on your particular operating system.
RubyMine is an application that is written in Java and requires the Java Runtime Environment to work. We will need to download and install the appropriate version of Java as well. If we don't install Java first, then RubyMine will download and install the appropriate version for you the first time it starts. Java installation programs can be found at http://java.com/en/download/manual.jsp.
We will now install the actual RubyMine software depending on your operating system.
RubyMine can be found at http://jetbrains.com/ruby.
Let's have a look at the steps involved in installing RubyMine on a Mac OS X system:
Point your browser to the previous address and download the free trial of the software. This will be in the form of a standard Mac OS X disk image (DMG), as shown in the following screenshot:
Open the Disk Image (DMG) and drag the RubyMine file from the DMG to your
Applicationsfolder. As shown in the following screenshot, you can now open RubyMine from yourApplicationfolder by double-clicking on the RubyMine application:
Figure 1.2
The first window that you will see is the standard Mac OS X security warning about opening an application from the Internet, depending on your security settings. Select the Open button to continue.
We will then be presented with the opening Welcome window in RubyMine. We have successfully installed RubyMine and can proceed to the next lesson.
Now, let us look at the steps involved in installing RubyMine on Windows OS:
Download the RubyMine installer from http://jetbrains.com/ruby.
Click on the RubyMine executable and the first window that you will see is the standard Windows security warning about opening an application, depending on your security settings.
Select the Run button to continue. You will get the following RubyMine setup wizard window:
Follow the standard installation steps and select the defaults for the options presented.
When the installation finishes, you will be given an option to run RubyMine. Do this and you will see a screen that will ask you to import your settings from a prior version and then a screen asking for your license.
If you have a license, enter the two pieces of information into the fields provided and then hit OK.
Otherwise, just select the option Evaluate for free for 30 days and you will have your 30-day trial of the software. You can always enter your license later—after you have been assimilated.
Continue on and agree to the license agreement, and you will then be shown a screen similar to Figure 1.2, the screen showing the message Welcome to RubyMine.
Last but not least, let us look at the installation of RubyMine on a Unix environment.
Most of the X-Windows types of environments in the Unix/Linux world work the same, but we are now going to see the Ubuntu installation:
Point your browser to the same URL http://jetbrains.com/ruby and select the Download Free Trial link. This will begin the download of a
.tar.gzfile and depending on your environment, your browser might ask you to open it with the Archive Manager option, as shown in the following screenshot:
Select OK and the archive manager will show us a folder of the uncompressed files.
Click on the Extract button on the top toolbar of the archive manager and select your home folder to save the folder into.
Once extracted, we can then navigate to the new RubyMine folder and we will see a file called
Install-Linux.tar.txt.Follow the instructions contained in this file to complete the installation.
The main item to pay attention to is the second option in the file:
2. Open a console (ctrl-alt t) and cd into "{installation home}/bin" and type:
./rubymine.sh
to start the application.
Doing this will begin the application installation process.
A screen showing the options to agree to the license and the option checked for the 30-day trial will be presented with a screen like this:
Select the defaults for now and hit OK to continue.
If you run into any errors, some of the solutions are found below. If you have any other problems, you will have to consult the RubyMine website help system.
If you get an error while running the rubymine.sh file in Linux (Ubuntu) like the following:
ERROR: Cannot start RubyMine
No JDK found. Please validate either RUBYMINE_JDK, JDK_HOME or JAVA_HOME environment variable points to valid JDK installation.
In this case, you must install a Java Development Environment first and then re-run the rubymine.sh file as before.
To install Java on Ubuntu, you must enter several commands. There is a good tutorial on installing the Oracle JDK found at http://askubuntu.com/questions/55848/how-do-i-install-oracle-java-jdk-7.
Please note that the OpenJDK is not recommended for use with the RubyMine software.
Once this is complete, you can continue with the RubyMine installation as before.