You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by David Leangen <ap...@leangen.net> on 2020/05/14 05:55:08 UTC
curl to the Admin API
Hi!
I am attempting to complete the “Try James in 5 minutes” page for newcomers. I wanted to show how to connect to the Admin API using curl according to the instructions on this page [1], but am having trouble doing so myself.
[1] http://james.apache.org/server/manage-webadmin.html
I am presenting the instructions on this page [2] using the default configurations of the image linagora/james-jpa-sample:3.4.0.
[2] https://james.leangen.net/sws/net.leangen.james.sws/main/3.5/user/try.html
First:
* What port does the Admin API use? The docs [3] say “8080”
* Do I need to authenticate? The docs [3] seem to indicate “no”
[3] http://james.apache.org/server/config-webadmin.html
Trying something like “curl -XGET http://127.0.0.1:8080/users”, I am getting this reply:
—> curl: (52) Empty reply from server
Note that I have tried exposing ports 4000, 8000, 9999, and 8080 when running the docker container and tried to curl each of them, and got exactly the same response from the server.
If I could get a little help making a successful curl to the Admin API, that would be really great.
Thanks!
=David
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
Re: curl to the Admin API
Posted by David Leangen <ap...@leangen.net>.
Awesome, thanks!
I now have the API working now, so I will be able to finish off the “Try James in 5 minutes” section of the docs.
Cheers,
=David
> On May 15, 2020, at 15:11, Tellier Benoit <bt...@apache.org> wrote:
>
> Hi David,
>
> We are missing this information in our current README.md.
>
> You can simply use a docker volume on your `docker run` command.
>
> The path inside the container is `/root/conf`.
>
> So `docker run ... -v
> $PWD/webadmin.properties:/root/conf/webadmin.properties ...` should do
> the trick.
>
> Regards,
>
> Benoit
>
> On 14/05/2020 14:11, David Leangen wrote:
>>
>> Hi Matthieu,
>>
>> Thank you for the quick reply and for the explanation.
>>
>> Another quick question then…
>>
>> This is for the “Try James in 5 minutes” section. I was thinking of giving a quick expose to the admin api.
>>
>> When running the image linagora/james-jpa-sample:3.4.0 from docker, what is the easiest way to customize the configuration as you describe without having to build a new image?
>>
>>
>> Cheers,
>> =David
>>
>>
>>> On May 14, 2020, at 16:01, Matthieu Baechler <ma...@apache.org> wrote:
>>>
>>> Hi David,
>>>
>>> On Thu, 2020-05-14 at 14:55 +0900, David Leangen wrote:
>>>> Hi!
>>>>
>>>> I am attempting to complete the “Try James in 5 minutes” page for
>>>> newcomers. I wanted to show how to connect to the Admin API using
>>>> curl according to the instructions on this page [1], but am having
>>>> trouble doing so myself.
>>>>
>>>> [1] http://james.apache.org/server/manage-webadmin.html
>>>>
>>>> I am presenting the instructions on this page [2] using the default
>>>> configurations of the image linagora/james-jpa-sample:3.4.0.
>>>>
>>>> [2]
>>>> https://james.leangen.net/sws/net.leangen.james.sws/main/3.5/user/try.html
>>>>
>>>> First:
>>>>
>>>> * What port does the Admin API use? The docs [3] say “8080”
>>>> * Do I need to authenticate? The docs [3] seem to indicate “no”
>>>>
>>>> [3] http://james.apache.org/server/config-webadmin.html
>>>>
>>>> Trying something like “curl -XGET http://127.0.0.1:8080/users”, I am
>>>> getting this reply:
>>>>
>>>> —> curl: (52) Empty reply from server
>>>>
>>>> Note that I have tried exposing ports 4000, 8000, 9999, and 8080 when
>>>> running the docker container and tried to curl each of them, and got
>>>> exactly the same response from the server.
>>>>
>>>> If I could get a little help making a successful curl to the Admin
>>>> API, that would be really great.
>>>>
>>>
>>> Default port is 8080 but it's disable by default unless you have a
>>> webadmin.properties file with `enabled=true` in it.
>>>
>>> You can also choose the port in this file with `port=8000`.
>>>
>>> Cheers,
>>>
>>> --
>>> Matthieu Baechler
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-dev-help@james.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-dev-help@james.apache.org
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
> For additional commands, e-mail: server-dev-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
Re: curl to the Admin API
Posted by Tellier Benoit <bt...@apache.org>.
Hi David,
We are missing this information in our current README.md.
You can simply use a docker volume on your `docker run` command.
The path inside the container is `/root/conf`.
So `docker run ... -v
$PWD/webadmin.properties:/root/conf/webadmin.properties ...` should do
the trick.
Regards,
Benoit
On 14/05/2020 14:11, David Leangen wrote:
>
> Hi Matthieu,
>
> Thank you for the quick reply and for the explanation.
>
> Another quick question then…
>
> This is for the “Try James in 5 minutes” section. I was thinking of giving a quick expose to the admin api.
>
> When running the image linagora/james-jpa-sample:3.4.0 from docker, what is the easiest way to customize the configuration as you describe without having to build a new image?
>
>
> Cheers,
> =David
>
>
>> On May 14, 2020, at 16:01, Matthieu Baechler <ma...@apache.org> wrote:
>>
>> Hi David,
>>
>> On Thu, 2020-05-14 at 14:55 +0900, David Leangen wrote:
>>> Hi!
>>>
>>> I am attempting to complete the “Try James in 5 minutes” page for
>>> newcomers. I wanted to show how to connect to the Admin API using
>>> curl according to the instructions on this page [1], but am having
>>> trouble doing so myself.
>>>
>>> [1] http://james.apache.org/server/manage-webadmin.html
>>>
>>> I am presenting the instructions on this page [2] using the default
>>> configurations of the image linagora/james-jpa-sample:3.4.0.
>>>
>>> [2]
>>> https://james.leangen.net/sws/net.leangen.james.sws/main/3.5/user/try.html
>>>
>>> First:
>>>
>>> * What port does the Admin API use? The docs [3] say “8080”
>>> * Do I need to authenticate? The docs [3] seem to indicate “no”
>>>
>>> [3] http://james.apache.org/server/config-webadmin.html
>>>
>>> Trying something like “curl -XGET http://127.0.0.1:8080/users”, I am
>>> getting this reply:
>>>
>>> —> curl: (52) Empty reply from server
>>>
>>> Note that I have tried exposing ports 4000, 8000, 9999, and 8080 when
>>> running the docker container and tried to curl each of them, and got
>>> exactly the same response from the server.
>>>
>>> If I could get a little help making a successful curl to the Admin
>>> API, that would be really great.
>>>
>>
>> Default port is 8080 but it's disable by default unless you have a
>> webadmin.properties file with `enabled=true` in it.
>>
>> You can also choose the port in this file with `port=8000`.
>>
>> Cheers,
>>
>> --
>> Matthieu Baechler
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-dev-help@james.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
> For additional commands, e-mail: server-dev-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
Re: curl to the Admin API
Posted by David Leangen <ap...@leangen.net>.
Hi Matthieu,
Thank you for the quick reply and for the explanation.
Another quick question then…
This is for the “Try James in 5 minutes” section. I was thinking of giving a quick expose to the admin api.
When running the image linagora/james-jpa-sample:3.4.0 from docker, what is the easiest way to customize the configuration as you describe without having to build a new image?
Cheers,
=David
> On May 14, 2020, at 16:01, Matthieu Baechler <ma...@apache.org> wrote:
>
> Hi David,
>
> On Thu, 2020-05-14 at 14:55 +0900, David Leangen wrote:
>> Hi!
>>
>> I am attempting to complete the “Try James in 5 minutes” page for
>> newcomers. I wanted to show how to connect to the Admin API using
>> curl according to the instructions on this page [1], but am having
>> trouble doing so myself.
>>
>> [1] http://james.apache.org/server/manage-webadmin.html
>>
>> I am presenting the instructions on this page [2] using the default
>> configurations of the image linagora/james-jpa-sample:3.4.0.
>>
>> [2]
>> https://james.leangen.net/sws/net.leangen.james.sws/main/3.5/user/try.html
>>
>> First:
>>
>> * What port does the Admin API use? The docs [3] say “8080”
>> * Do I need to authenticate? The docs [3] seem to indicate “no”
>>
>> [3] http://james.apache.org/server/config-webadmin.html
>>
>> Trying something like “curl -XGET http://127.0.0.1:8080/users”, I am
>> getting this reply:
>>
>> —> curl: (52) Empty reply from server
>>
>> Note that I have tried exposing ports 4000, 8000, 9999, and 8080 when
>> running the docker container and tried to curl each of them, and got
>> exactly the same response from the server.
>>
>> If I could get a little help making a successful curl to the Admin
>> API, that would be really great.
>>
>
> Default port is 8080 but it's disable by default unless you have a
> webadmin.properties file with `enabled=true` in it.
>
> You can also choose the port in this file with `port=8000`.
>
> Cheers,
>
> --
> Matthieu Baechler
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
> For additional commands, e-mail: server-dev-help@james.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org
Re: curl to the Admin API
Posted by Matthieu Baechler <ma...@apache.org>.
Hi David,
On Thu, 2020-05-14 at 14:55 +0900, David Leangen wrote:
> Hi!
>
> I am attempting to complete the “Try James in 5 minutes” page for
> newcomers. I wanted to show how to connect to the Admin API using
> curl according to the instructions on this page [1], but am having
> trouble doing so myself.
>
> [1] http://james.apache.org/server/manage-webadmin.html
>
> I am presenting the instructions on this page [2] using the default
> configurations of the image linagora/james-jpa-sample:3.4.0.
>
> [2]
> https://james.leangen.net/sws/net.leangen.james.sws/main/3.5/user/try.html
>
> First:
>
> * What port does the Admin API use? The docs [3] say “8080”
> * Do I need to authenticate? The docs [3] seem to indicate “no”
>
> [3] http://james.apache.org/server/config-webadmin.html
>
> Trying something like “curl -XGET http://127.0.0.1:8080/users”, I am
> getting this reply:
>
> —> curl: (52) Empty reply from server
>
> Note that I have tried exposing ports 4000, 8000, 9999, and 8080 when
> running the docker container and tried to curl each of them, and got
> exactly the same response from the server.
>
> If I could get a little help making a successful curl to the Admin
> API, that would be really great.
>
Default port is 8080 but it's disable by default unless you have a
webadmin.properties file with `enabled=true` in it.
You can also choose the port in this file with `port=8000`.
Cheers,
--
Matthieu Baechler
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org