Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Message-ID: <861978735.1243954867520.JavaMail.jira@brutus>
Date: Tue, 2 Jun 2009 08:01:07 -0700 (PDT)
From: "Paul Joseph Davis (JIRA)" <jira@apache.org>
To: dev@couchdb.apache.org
Subject: [jira] Created: (COUCHDB-373) ./utils/run complains about
 non-existant directories
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

./utils/run complains about non-existant directories
----------------------------------------------------

                 Key: COUCHDB-373
                 URL: https://issues.apache.org/jira/browse/COUCHDB-373
             Project: CouchDB
          Issue Type: Bug
    Affects Versions: 0.10
         Environment: trunk
            Reporter: Paul Joseph Davis
            Assignee: Noah Slater
            Priority: Minor


Executing ./utils/run complains about missing directories

Steps to reproduce:
1. Find a computer that you can install linux on.
2. Fetch a copy of an operating system that you can use. I recommed the GNU/Linux Ubuntu distribution. You can download a copy of it at [1]. If you're new to the GNU/Linux operating system, I recommend downloading the "Desktop" distribution. At the time of this writing, Ubuntu 9.04 is the most recent release an is the recommended version when following these steps to reproduce the issue.
3. Once your download has completed you should have a local file that has an extension of ".iso". (An extension is the last three characters of the filename.) "ISO" files is an archive copy that is commonly used to distributed software that is designed to run from optical media. See [2] for a more thorough explanation of the format.
4. Transfer the ISO file to an optical media that your target system is capable of reading. (Alternatively you could create a bootable thumb drive [3], but that is outside the scope of this document.) When transferring the "ISO" file you must be sure to use software that understands the format. See [4] for further help.
5. Place the installation media into your computer and reboot.
6. When the BIOS screen [5] appears, press the appropriate key combination to view your preferred boot device [6]. You'll need to ensure that the drive containing your installation media is the primary boot device. Exact instructions will vary based on manufacturer and model of motherboard. Consult Google [7] for more information.
7. Installing GNU/Linux will depend on the distribution that you chose. If you followed these steps to reproduce, the Ubuntu installation procedure provides helpful Graphical User Interface [8] to assist with the installation procedure. More detail instructions for installation can be found at [9].
8. Assuming that your installation was successful it is always helpful to get acquainted with the new system. See [10] for a helpful community of Ubuntu users. To proceed with the rest of these steps you'll need to become familiar with the Command Line Interface [11]. In the Ubuntu GNU/Linux operating system, this application is called "Terminal" [12]. At the minimum you will need to be familiar with how to execute commands and perform actions as the "Superuser" or "Root user" [13]. See [14] for instructions on using the "sudo" (Super User Do) command line application.
9. Install dependencies that CouchDB requires for configuration and compiling. The fastest method for installing dependencies is to issue the following command in the Terminal application:

    $ sudo build-dep couchdb

A note on commands: The above syntax is a method for describing commands in the Terminal application. The '$' character represents the "prompt" [11]. Commands are entered as a string of characters and executed by pressing the "Return" key on your keyboard. Sometimes the "Return" key is referred to by other names, (for instance, on keyboards for languages other than English), suffice it to say that it is generally the largest key on the right hand side of your keyboard (disregarding the (possibly non-existant) numeric keypad, and (possibly non-existant) directional keys.).

Assuming that command completes successfully, we should be ready to start configuring and installing CouchDB. If something goes awry, you should be aware that the CouchDB community is willing to help [15].
10. Fetch the Subversion [16] utility. Subversion is a "Revision Control System" [17], a tool commonly used by programmers to track changes they make to a program. On the Ubuntu GNU/Linux you can fetch this tool with the following command:

    $ sudo apt-get install subversion
    
If that command fails, I will refer the user once again to the CouchDB community found at [15].

11. Fetch a copy of the CouchDB source code.

    $ svn co http://svn.apache.org/repos/asf/couchdb/trunk couchdb

12. Change into the CouchDB directory

    $ cd couchdb

13. Bootstrap the software. Bootstrapping [18] refers to the process of preparing a source code distribution (such as the one you have just retrieved) for the configuration process. A more thorough description of the process can be found at [19].

    $ ./bootstrap
    
14. Configure the software. Note, although we will not be installing the software in this guide, the configuration step is where the paths for installation are decided. If you are building CouchDB for system wide use, you may wish to peruse the Filesystem Hierarchy Standard (FHS) [20] to get an idea of where you may want to install different portions of the final build product. Also consult with the CouchDB README that has helpful pointers.

    $ ./configure
    
15. Now that the software is configured, we are ready to compile it into a running program.

    $ make
    
16. The following steps involve creating and running CouchDB in a development environment as this is the configuration affected by this bug. If you desired to install the compiled program on your system the appropriate command would be:

    # THIS IS NOT REQUIRED
    $ sudo make install
    
I have placed an obvious note to...

Damn. My upgrade yesterday broke stuff. I have things to attend to.

[1] http://www.ubuntu.com/getubuntu/download
[2] http://en.wikipedia.org/wiki/ISO_image
[3] http://www.google.com/search?q=bootable+thumb+drive
[4] http://www.google.com/search?q=Burning+an+ISO
[5] http://en.wikipedia.org/wiki/BIOS
[6] http://en.wikipedia.org/wiki/Booting#Boot_devices_.28IBM_PC.29
[7] http://www.google.com
[8] http://en.wikipedia.org/wiki/Graphical_user_interface
[9] https://help.ubuntu.com/9.04/installation-guide/i386/index.html
[10] http://www.ubuntu.com/community
[11] http://en.wikipedia.org/wiki/Command_line_interface
[12] https://help.ubuntu.com/community/UsingTheTerminal
[13] http://en.wikipedia.org/wiki/Root_user
[14] https://help.ubuntu.com/community/RootSudo
[15] http://couchdb.apache.org/community/index.html
[16] http://subversion.tigris.org/
[17] http://en.wikipedia.org/wiki/Revision_control
[18] http://en.wikipedia.org/wiki/Bootstrapping_(computing)#Software_bootstrapping
[19] http://sources.redhat.com/autobook/autobook/autobook_43.html#SEC43


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.