You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by jc...@apache.org on 2008/10/22 02:21:47 UTC

svn commit: r706817 - /incubator/couchdb/trunk/README

Author: jchris
Date: Tue Oct 21 17:21:46 2008
New Revision: 706817

URL: http://svn.apache.org/viewvc?rev=706817&view=rev
Log:
osx launchctl readme notes

Modified:
    incubator/couchdb/trunk/README

Modified: incubator/couchdb/trunk/README
URL: http://svn.apache.org/viewvc/incubator/couchdb/trunk/README?rev=706817&r1=706816&r2=706817&view=diff
==============================================================================
--- incubator/couchdb/trunk/README (original)
+++ incubator/couchdb/trunk/README Tue Oct 21 17:21:46 2008
@@ -232,10 +232,10 @@
 appropriate. If you are running the init script as a non-superuser you need to
 remove the line with the `COUCHDB_USER` setting.
 
-If you wish the ApacheCouchDB daemon to run as a system service you need to copy
-the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
+If you wish the Apache CouchDB daemon to run as a system service you need to
+copy the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
 `/etc/[init.d|rc.d]` directory and update your system configuration as
-appropriate.  Consult your system documentation for more information.
+appropriate. Consult your system documentation for more information.
 
 If you are running a Debian GNU/Linux system (or a derivative such as Ubuntu
 GNU/Linux) you can configure your system using the following command:
@@ -249,11 +249,15 @@
 
 To load the launchd configuration you must run the following command:
 
-    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb
+    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
+
+Then you can start Apache CouchDB by running :
+
+    sudo launchctl start org.apache.couchdb
 
 You can stop the Apache CouchDB daemon by running the following command:
 
-    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb
+    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
 
 If you wish to change the launchd configuration, such as which user to run
 Apache CouchDB as, you must edit the



Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by "C. Florian Ebeling" <fl...@gmail.com>.
On Thu, Oct 30, 2008 at 9:52 AM, Jan Lehnardt <ja...@apache.org> wrote:
> On Oct 30, 2008, at 9:21 , C. Florian Ebeling wrote:
>> On Thu, Oct 23, 2008 at 9:16 AM, C. Florian Ebeling
>> <fl...@gmail.com> wrote:
>>> On Wed, Oct 22, 2008 at 8:36 PM, Chris Anderson <jc...@apache.org>
>>> wrote:
>>>> On Wed, Oct 22, 2008 at 1:09 AM, C. Florian Ebeling
>>>> I know woefully little about MacPorts - maybe someone who's
>>>> deep into the port system could review not only the README but also
>>>> the plists file etc.
>>>
>>> I would not claim to be an expert on macports, but I'm a maintainer of a
>>> few
>>> ports there. I will have a look at the README and see if I find things to
>>> suggest.
>>
>> I have edited the README to make it a bit more concise on OS X
>> usage. Please have a look at the attached patch.
>
> Sorry, your attachment didn't make it through. Can you put it on JIRA or
> something?

Sure, here it is:
https://issues.apache.org/jira/browse/COUCHDB-148

Florian



-- 
Florian Ebeling
Twitter: febeling
florian.ebeling@gmail.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by Jan Lehnardt <ja...@apache.org>.
On Oct 30, 2008, at 9:21 , C. Florian Ebeling wrote:

> On Thu, Oct 23, 2008 at 9:16 AM, C. Florian Ebeling
> <fl...@gmail.com> wrote:
>> On Wed, Oct 22, 2008 at 8:36 PM, Chris Anderson <jc...@apache.org>  
>> wrote:
>>> On Wed, Oct 22, 2008 at 1:09 AM, C. Florian Ebeling
>>> I know woefully little about MacPorts - maybe someone who's
>>> deep into the port system could review not only the README but also
>>> the plists file etc.
>>
>> I would not claim to be an expert on macports, but I'm a maintainer  
>> of a few
>> ports there. I will have a look at the README and see if I find  
>> things to
>> suggest.
>
> I have edited the README to make it a bit more concise on OS X
> usage. Please have a look at the attached patch.

Sorry, your attachment didn't make it through. Can you put it on JIRA or
something?

Cheers
Jan
--

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by "C. Florian Ebeling" <fl...@gmail.com>.
On Thu, Oct 23, 2008 at 9:16 AM, C. Florian Ebeling
<fl...@gmail.com> wrote:
> On Wed, Oct 22, 2008 at 8:36 PM, Chris Anderson <jc...@apache.org> wrote:
>> On Wed, Oct 22, 2008 at 1:09 AM, C. Florian Ebeling
>> I know woefully little about MacPorts - maybe someone who's
>> deep into the port system could review not only the README but also
>> the plists file etc.
>
> I would not claim to be an expert on macports, but I'm a maintainer of a few
> ports there. I will have a look at the README and see if I find things to
> suggest.

I have edited the README to make it a bit more concise on OS X
usage. Please have a look at the attached patch.

Cheers,
Florian


-- 
Florian Ebeling
Twitter: febeling
florian.ebeling@gmail.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by "C. Florian Ebeling" <fl...@gmail.com>.
On Wed, Oct 22, 2008 at 8:36 PM, Chris Anderson <jc...@apache.org> wrote:
> On Wed, Oct 22, 2008 at 1:09 AM, C. Florian Ebeling
> <fl...@gmail.com> wrote:
>> One confusing thing with the macports install is that there
>> is a huge user message in the terminal output which advertises
>> a plist generated by mp. That does not work, unfortunately.
>> The one that couchdb brings itself is fine.
>>
>
> Thanks I did not realize there was a MacPort for couchdb. I've just
> been following the README to install from source. Maybe the start
> command is not necessary - however it's been useful to me to force a
> restart.

ok, sorry, I guess I misread that. As long as you don't expect that the
service actually stays down when you invoke stop all is fine, because it
does get restarted. I found that confusing actually with launchd.

> I know woefully little about MacPorts - maybe someone who's
> deep into the port system could review not only the README but also
> the plists file etc.

I would not claim to be an expert on macports, but I'm a maintainer of a few
ports there. I will have a look at the README and see if I find things to
suggest.

Cheers,
Florian

-- 
Florian Ebeling
Twitter: febeling
florian.ebeling@gmail.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by Chris Anderson <jc...@apache.org>.
On Wed, Oct 22, 2008 at 1:09 AM, C. Florian Ebeling
<fl...@gmail.com> wrote:
> One confusing thing with the macports install is that there
> is a huge user message in the terminal output which advertises
> a plist generated by mp. That does not work, unfortunately.
> The one that couchdb brings itself is fine.
>

Thanks I did not realize there was a MacPort for couchdb. I've just
been following the README to install from source. Maybe the start
command is not necessary - however it's been useful to me to force a
restart. I know woefully little about MacPorts - maybe someone who's
deep into the port system could review not only the README but also
the plists file etc.

Chris

-- 
Chris Anderson
http://jchris.mfdz.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by "C. Florian Ebeling" <fl...@gmail.com>.
On Wed, Oct 22, 2008 at 3:52 AM, Chris Anderson <jc...@apache.org> wrote:
> On Tue, Oct 21, 2008 at 6:45 PM, Noah Slater <ns...@apache.org> wrote:
>> Have things changed?
>>
>> When I checked in this documentation you:
>>
>>  * did not have to use the .plist extension, I'm sure it wouldn't even work
>>
>>  * loading the plist file would automatically start CouchDB
>>
>> Any reason for the changes?
>>
>
> It's been my experience that this has been broken for a while.
>
> The new version seems to work for me...

I think this change might be a reflection of my wiki edit of the
InstallMacOsX page yesterday, so I thought I comment.

The plist does not sport the OnDemand key, so by default
launchd will try to keep it running. The "start" part should not
be necessary. It does not harm either.

One confusing thing with the macports install is that there
is a huge user message in the terminal output which advertises
a plist generated by mp. That does not work, unfortunately.
The one that couchdb brings itself is fine.

I have filed a bug at mp for that: http://trac.macports.org/ticket/16947

Another inconvenience with the port is that if you forget
to install it with +server variant first, then uninstall, then reinstall,
then you end up with broken file permissions.

Other than that the port works fine for me and the test do all
pass.

Florian

-- 
Florian Ebeling
Twitter: febeling
florian.ebeling@gmail.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by Chris Anderson <jc...@apache.org>.
On Tue, Oct 21, 2008 at 6:45 PM, Noah Slater <ns...@apache.org> wrote:
> Hey,
>
> Have things changed?
>
> When I checked in this documentation you:
>
>  * did not have to use the .plist extension, I'm sure it wouldn't even work
>
>  * loading the plist file would automatically start CouchDB
>
> Any reason for the changes?
>

It's been my experience that this has been broken for a while.

The new version seems to work for me...
> On Wed, Oct 22, 2008 at 12:21:47AM -0000, jchris@apache.org wrote:
>> Author: jchris
>> Date: Tue Oct 21 17:21:46 2008
>> New Revision: 706817
>>
>> URL: http://svn.apache.org/viewvc?rev=706817&view=rev
>> Log:
>> osx launchctl readme notes
>>
>> Modified:
>>     incubator/couchdb/trunk/README
>>
>> Modified: incubator/couchdb/trunk/README
>> URL: http://svn.apache.org/viewvc/incubator/couchdb/trunk/README?rev=706817&r1=706816&r2=706817&view=diff
>> ==============================================================================
>> --- incubator/couchdb/trunk/README (original)
>> +++ incubator/couchdb/trunk/README Tue Oct 21 17:21:46 2008
>> @@ -232,10 +232,10 @@
>>  appropriate. If you are running the init script as a non-superuser you need to
>>  remove the line with the `COUCHDB_USER` setting.
>>
>> -If you wish the ApacheCouchDB daemon to run as a system service you need to copy
>> -the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
>> +If you wish the Apache CouchDB daemon to run as a system service you need to
>> +copy the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
>>  `/etc/[init.d|rc.d]` directory and update your system configuration as
>> -appropriate.  Consult your system documentation for more information.
>> +appropriate. Consult your system documentation for more information.
>>
>>  If you are running a Debian GNU/Linux system (or a derivative such as Ubuntu
>>  GNU/Linux) you can configure your system using the following command:
>> @@ -249,11 +249,15 @@
>>
>>  To load the launchd configuration you must run the following command:
>>
>> -    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb
>> +    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
>> +
>> +Then you can start Apache CouchDB by running :
>> +
>> +    sudo launchctl start org.apache.couchdb
>>
>>  You can stop the Apache CouchDB daemon by running the following command:
>>
>> -    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb
>> +    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
>>
>>  If you wish to change the launchd configuration, such as which user to run
>>  Apache CouchDB as, you must edit the
>>
>>
>
> --
> Noah Slater, http://bytesexual.org/nslater
>



-- 
Chris Anderson
http://jchris.mfdz.com

Re: svn commit: r706817 - /incubator/couchdb/trunk/README

Posted by Noah Slater <ns...@apache.org>.
Hey,

Have things changed?

When I checked in this documentation you:

 * did not have to use the .plist extension, I'm sure it wouldn't even work

 * loading the plist file would automatically start CouchDB

Any reason for the changes?

On Wed, Oct 22, 2008 at 12:21:47AM -0000, jchris@apache.org wrote:
> Author: jchris
> Date: Tue Oct 21 17:21:46 2008
> New Revision: 706817
>
> URL: http://svn.apache.org/viewvc?rev=706817&view=rev
> Log:
> osx launchctl readme notes
>
> Modified:
>     incubator/couchdb/trunk/README
>
> Modified: incubator/couchdb/trunk/README
> URL: http://svn.apache.org/viewvc/incubator/couchdb/trunk/README?rev=706817&r1=706816&r2=706817&view=diff
> ==============================================================================
> --- incubator/couchdb/trunk/README (original)
> +++ incubator/couchdb/trunk/README Tue Oct 21 17:21:46 2008
> @@ -232,10 +232,10 @@
>  appropriate. If you are running the init script as a non-superuser you need to
>  remove the line with the `COUCHDB_USER` setting.
>
> -If you wish the ApacheCouchDB daemon to run as a system service you need to copy
> -the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
> +If you wish the Apache CouchDB daemon to run as a system service you need to
> +copy the `/usr/local/etc/[init.d|rc.d]/couchdb` script into your system wide
>  `/etc/[init.d|rc.d]` directory and update your system configuration as
> -appropriate.  Consult your system documentation for more information.
> +appropriate. Consult your system documentation for more information.
>
>  If you are running a Debian GNU/Linux system (or a derivative such as Ubuntu
>  GNU/Linux) you can configure your system using the following command:
> @@ -249,11 +249,15 @@
>
>  To load the launchd configuration you must run the following command:
>
> -    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb
> +    sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
> +
> +Then you can start Apache CouchDB by running :
> +
> +    sudo launchctl start org.apache.couchdb
>
>  You can stop the Apache CouchDB daemon by running the following command:
>
> -    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb
> +    sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
>
>  If you wish to change the launchd configuration, such as which user to run
>  Apache CouchDB as, you must edit the
>
>

-- 
Noah Slater, http://bytesexual.org/nslater