<commit_before><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<chapter id="installation">
  <title>Installation</title>

  <section>
    <title>Installation using Complete Binary Distribution</title>

    <para>The latest Complete Binary Distribution contains:</para>

    <itemizedlist>
      <listitem>
        <para>The TorqueBox server, ready-to-run</para>
      </listitem>

      <listitem>
        <para>A complete JRuby installation</para>
      </listitem>
    </itemizedlist>

    <section>
      <title>Ensure you have Java 6</title>

      <para>TorqueBox requires Java JDK 6.</para>

      <para>To determine which version, if any, is installed on your system,
      at a command-line, attempt to run the <command>java</command> command
      with the <option>-version</option> argument.</para>

      <para><screen><prompt>$</prompt> <command>java -version</command>
java version "1.6.0_07"
Java(TM) SE Runtime Environment (build 1.6.0_07-b06-153)
Java HotSpot(TM) 64-Bit Server VM (build 1.6.0_07-b06-57, mixed mode)</screen></para>

      <para>If the version is at least 1.6, you version of Java is
      sufficient.</para>

      <para>If you have no Java installed, or a version less than 1.6, you'll
      need to install a Java Development Kit. For many systems, it is easy to
      install the open-source OpenJDK.</para>

      <para>For installation on Ubuntu, Fedora, OpenSuse, or Debian, please
      refer to the <ulink url="http://openjdk.java.net/install/">installation
      instructions provided</ulink> by the OpenJDK project. If you find a
      <command>java</command> on your system, ensure that it is not actually
      <command>gcj</command>. The <command>gcj</command> is insufficient for
      running the TorqueBox server.</para>

      <para>For Apple OSX systems, Apple provides a JDK version 6.</para>
    </section>

    <section>
      <title>Get the latest version of TorqueBox binary package</title>

      <para>You can obtain the latest version of TorqueBox from the TorqueBox
      repository. As of this writing, the latest version is
      ${project.version}.</para>

      <para><ulink
      url="http://repository.torquebox.org/maven2/releases/org/torquebox/torquebox-bin/${project.version}/torquebox-bin-${project.version}.zip">http://repository.torquebox.org/maven2/releases/org/torquebox/torquebox-bin/${project.version}/torquebox-bin-${project.version}.zip</ulink></para>
    </section>

    <section>
      <title>Unzip it somewhere handy</title>

      <para>We'll install TorqueBox under your user's $HOME directory.</para>

      <para><screen><prompt>$</prompt> <command>unzip torquebox-bin-${project.version}.zip</command>
<prompt>$</prompt> <command>cd torquebox-${project.version}</command>
</screen></para>

      <para>Before using the TorqueBox server, you must set up your
      environment. To make it easier to upgrade without having to reconfigure
      your environment, it is useful to create a symlink to the versioned
      directory produced when you unpackaged the distribution.</para>

      <para><screen><prompt>$</prompt> <command>ln -s torquebox-bin-${project.version} torquebox-current</command></screen></para>

      <para>Next, <envar>$TORQUEBOX_HOME</envar>, <envar>$JBOSS_HOME</envar>
      and <envar>$JRUBY_HOME</envar> need to be set, and adjusting your
      <envar>$PATH</envar> will make working with the package easier. You can
      either run the following commands each time on the command-line, or add
      them to your <filename>.bash_profile</filename>.</para>

      <para>First, the various
      <envar>$<replaceable>X</replaceable>_HOME</envar> variables are set so
      that each subsystem can find its supporting files.</para>

      <para><screen>export TORQUEBOX_HOME=$HOME/torquebox-current
export JBOSS_HOME=$TORQUEBOX_HOME/jboss
export JRUBY_HOME=$TORQUEBOX_HOME/jruby</screen></para>

      <para>Next, we make sure that JRuby's binaries are first in our
      executable <envar>$PATH</envar>, before any previously-installed Ruby
      packages.</para>

      <para><screen>export PATH=$JRUBY_HOME/bin:$PATH</screen>By doing this,
      commands such as <command>rake</command>, <command>gem</command>, and
      <command>rails</command> will load from the TorqueBox-provided JRuby
      installation.</para>
    </section>
  </section>
</chapter><commit_msg>Added tips on using a non-bundled JRuby.<commit_after><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<chapter id="installation">
  <title>Installation</title>

  <section>
    <title>Installation using Complete Binary Distribution</title>

    <para>The latest Complete Binary Distribution contains:</para>

    <itemizedlist>
      <listitem>
        <para>The TorqueBox server, ready-to-run</para>
      </listitem>

      <listitem>
        <para>A complete JRuby installation</para>
      </listitem>
    </itemizedlist>

    <section>
      <title>Ensure you have Java 6</title>

      <para>TorqueBox requires Java JDK 6.</para>

      <para>To determine which version, if any, is installed on your system,
      at a command-line, attempt to run the <command>java</command> command
      with the <option>-version</option> argument.</para>

      <para><screen><prompt>$</prompt> <command>java -version</command>
java version "1.6.0_07"
Java(TM) SE Runtime Environment (build 1.6.0_07-b06-153)
Java HotSpot(TM) 64-Bit Server VM (build 1.6.0_07-b06-57, mixed mode)</screen></para>

      <para>If the version is at least 1.6, you version of Java is
      sufficient.</para>

      <para>If you have no Java installed, or a version less than 1.6, you'll
      need to install a Java Development Kit. For many systems, it is easy to
      install the open-source OpenJDK.</para>

      <para>For installation on Ubuntu, Fedora, OpenSuse, or Debian, please
      refer to the <ulink url="http://openjdk.java.net/install/">installation
      instructions provided</ulink> by the OpenJDK project. If you find a
      <command>java</command> on your system, ensure that it is not actually
      <command>gcj</command>. The <command>gcj</command> is insufficient for
      running the TorqueBox server.</para>

      <para>For Apple OSX systems, Apple provides a JDK version 6.</para>
    </section>

    <section>
      <title>Get the latest version of TorqueBox binary package</title>

      <para>You can obtain the latest version of TorqueBox from the TorqueBox
      repository. As of this writing, the latest version is
      ${project.version}.</para>

      <para><ulink
      url="http://repository.torquebox.org/maven2/releases/org/torquebox/torquebox-bin/${project.version}/torquebox-bin-${project.version}.zip">http://repository.torquebox.org/maven2/releases/org/torquebox/torquebox-bin/${project.version}/torquebox-bin-${project.version}.zip</ulink></para>
    </section>

    <section>
      <title>Unzip it somewhere handy</title>

      <para>We'll install TorqueBox under your user's $HOME directory.</para>

      <para><screen><prompt>$</prompt> <command>unzip torquebox-bin-${project.version}.zip</command>
<prompt>$</prompt> <command>cd torquebox-${project.version}</command>
</screen></para>

      <para>Before using the TorqueBox server, you must set up your
      environment. To make it easier to upgrade without having to reconfigure
      your environment, it is useful to create a symlink to the versioned
      directory produced when you unpackaged the distribution.</para>

      <para><screen><prompt>$</prompt> <command>ln -s torquebox-bin-${project.version} torquebox-current</command></screen></para>

      <para>Next, <envar>$TORQUEBOX_HOME</envar>, <envar>$JBOSS_HOME</envar>
      and <envar>$JRUBY_HOME</envar> need to be set, and adjusting your
      <envar>$PATH</envar> will make working with the package easier. You can
      either run the following commands each time on the command-line, or add
      them to your <filename>.bash_profile</filename>.</para>

      <para>First, the various
      <envar>$<replaceable>X</replaceable>_HOME</envar> variables are set so
      that each subsystem can find its supporting files.</para>

      <para><screen>export TORQUEBOX_HOME=$HOME/torquebox-current
export JBOSS_HOME=$TORQUEBOX_HOME/jboss
export JRUBY_HOME=$TORQUEBOX_HOME/jruby</screen></para>

      <para>Next, we make sure that JRuby's binaries are first in our
      executable <envar>$PATH</envar>, before any previously-installed Ruby
      packages.</para>

      <para><screen>export PATH=$JRUBY_HOME/bin:$PATH</screen>By doing this,
      commands such as <command>rake</command>, <command>gem</command>, and
      <command>rails</command> will load from the TorqueBox-provided JRuby
      installation.</para>

      <para>You can also run TorqueBox using your own install of JRuby. You 
      will need to ensure that the latest TorqueBox gems are installed under
      your JRuby:<screen>cd $HOME/torquebox-current/gems
gem install *.gem</screen>You will also need to set $JRUBY_HOME to point to 
      your JRuby installation.</para>

      <para><command>Note:</command> if you are going to run a non-bundled 
      JRuby with a beta build of TorqueBox, it is recommended that you either 
      use a separate <ulink url="http://rvm.beginrescueend.com">rvm</ulink> 
      <ulink url="http://rvm.beginrescueend.com/gemsets/">gemset</ulink>
      for each beta build, or be sure to reinstall the TorqueBox 
      gems for the latest beta. Rubygems does not support the 
      Beta<replaceable>X</replaceable> naming scheme, so sees all of the 
      different betas of a version as equivalent.</para>

    </section>
  </section>
</chapter>
{'fraction_non_alphanumeric': 0.12183048792807354, 'fraction_numerical': 0.008485705626830993, 'mean_word_length': 3.5517241379310347, 'pattern_counts': {'":': 0, '<': 281, '<?xml version=': 2, '>': 281, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2130192', 'n_tokens_mistral': 3164, 'n_tokens_neox': 2905, 'n_words': 896}