You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@couchdb.apache.org by GitBox <gi...@apache.org> on 2020/03/23 20:26:53 UTC
[GitHub] [couchdb-documentation] chintan-mishra opened a new issue #511:
Extend Clouseau(search-plugin) installation docs
chintan-mishra opened a new issue #511: Extend Clouseau(search-plugin) installation docs
URL: https://github.com/apache/couchdb-documentation/issues/511
<!--- Provide a general summary of the issue in the Title above -->
Clouseau(search-plugin) installation [docs](https://docs.couchdb.org/en/master/install/search.html#installation-of-binary-packages) are missing some steps that would allow basic usage by someone new to this plugin. While installing the plugin, we have to provide Java classpath for the plugin application to find all the dependencies and start all the components. However, best strategies to do so are missing.
## Expected Behavior
<!--- If you're describing a bug, tell us what should happen -->
It was expected that Clouseau(search-plugin) would start. But instead, an error was shown.
<!--- If you're suggesting a change/improvement, tell us how it should work -->
## Current Behavior
<!--- If describing a bug, tell us what happens instead of the expected behavior -->
<!--- If suggesting a change/improvement, explain the difference from current behavior -->
While trying to start the Clouseau application following error is shown `Error: Could not find or load main class com.cloudant.clouseau.Main`
## Possible Solution
<!--- Not obligatory, but suggest a fix/reason for the bug, -->
<!--- or ideas how to implement the addition or change -->
Add more details for the users to debug without pestering the devs and maintainers. Guide me. I will report my findings.
## Steps to Reproduce (for bugs)
<!--- Provide a link to a live example, or an unambiguous set of steps to -->
<!--- reproduce this bug. Include code to reproduce, if relevant -->
<details>
<summary>
Series of commands that were executed on the host and inside the couchdb:3.0.0 container image.
</summary>
### Commands that were executed on the container host.
```bash
$ podman run --name relax -p 5984:5984 -d -e COUCHDB_USER=admin -e COUCHDB_PASSWORD=password couchdb
$ podman exec -it relax bash
```
### Commands that were run inside the container
```bash
# Download AdoptOpenJDK 8
curl -OL https://github.com/AdoptOpenJDK/openjdk8-binaries/releases/download/jdk8u242-b08/OpenJDK8U-jdk_x64_linux_hotspot_8u242b08.tar.gz
# Extract the files
tar -xf OpenJDK8U-jdk_x64_linux_hotspot_8u242b08.tar.gz
# Move the files to suitable location
mv ./jdk8u242-b08 /usr/local/bin/
# Add them to environment
echo -e 'export PATH=/usr/local/bin/jdk8u242-b08/bin:$PATH' >> ~/.bashrc
# Make it available in existing terminal instance
source ~/.bashrc
# Create folders for storing all Clouseau-related files
mkdir /opt/couchdb/extras
mkdir /opt/couchdb/extras/search
# Create the necessary files
# `clouseasu.ini`
cat > /opt/couchdb/extras/clouseau.ini << EOF
[clouseau]
; the name of the Erlang node created by the service, leave this unchanged
name=clouseau@127.0.0.1
; set this to the same distributed Erlang cookie used by the CouchDB nodes
cookie=monster
; the path where you would like to store the search index files
dir=/opt/couchdb/extras/search
; the number of search indexes that can be open simultaneously
max_indexes_open=500
EOF
# `log4j.properties`
cat> /opt/couchdb/extras/log4j.properties << EOF
log4j.rootLogger=debug, CONSOLE
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %c [%p] %m%n
EOF
# Fetch a release of Clouseau from GitHub
curl -OL https://github.com/cloudant-labs/clouseau/releases/download/2.17.0/clouseau-2.17.0-dist.zip
# Move it to the newly created directory
mv clouseau-2.17.0-dist.zip /opt/couchdb/extras
# After generous help from the user 'rnewson' on Slack. Added these steps
apt-get update && \
apt-get install unzip && \
unzip /opt/couchdb/extras/clouseau-2.17.0-dist.zip &&\ # Extract Clouseau
cd /opt/couchdb/extras/ && \
mv clouseau-2.17.0 clouseau
# Start the Clouseau application
java -server \
-Xmx2G \
-Dsun.net.inetaddr.ttl=30 \
-Dsun.net.inetaddr.negative.ttl=30 \
-Dlog4j.configuration=file:/opt/couchdb/extras/log4j.properties \
-XX:OnOutOfMemoryError="kill -9 %p" \
-XX:+UseConcMarkSweepGC \
-XX:+CMSParallelRemarkEnabled \
-cp /opt/couchdb/extras/clouseau:/opt/couchdb/extras/clouseau/lib/* \ # zip file and extracted directory were passed individually to test the issue
com.cloudant.clouseau.Main \
/opt/couchdb/extras/clouseau.ini
```
</details>
## Context
<!--- How has this issue affected you? What are you trying to accomplish? -->
<!--- Providing context helps us come up with a solution that is most useful in the real world -->
The purpose of this task was to start Clouseau(search-plugin) in the same container as the CouchDB. This would further allow building a CouchDB container image with all the benefits provided by Clouseau.
## Your Environment
<!--- Include as many relevant details about the environment you experienced the bug in -->
* Version used: 3.0.0 tagged container image retrieved from docker.io/library/couchdb
* Browser Name and version: NA
* Operating System and version (desktop or mobile): OS - Fedora 31 | Kernel - 5.5.10-200.fc31.x86_64
* Link to your project: https://gitlab.com/rebhu-computing/rosf/sushrut.codes/cdtf
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [couchdb-documentation] wohali commented on issue #511: Extend
Clouseau(search-plugin) installation docs
Posted by GitBox <gi...@apache.org>.
wohali commented on issue #511: Extend Clouseau(search-plugin) installation docs
URL: https://github.com/apache/couchdb-documentation/issues/511#issuecomment-610619076
@kocolosk @rnewson can one of you ehlp with this and/or #516 ? Would be nice to get this in for 3.0.1 / 3.1.0.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [couchdb-documentation] chrystalcastillochavez commented on issue
#511: Extend Clouseau(search-plugin) installation docs
Posted by GitBox <gi...@apache.org>.
chrystalcastillochavez commented on issue #511: Extend Clouseau(search-plugin) installation docs
URL: https://github.com/apache/couchdb-documentation/issues/511#issuecomment-607827194
I don't know about this
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [couchdb-documentation] chintan-mishra commented on issue #511:
Extend Clouseau(search-plugin) installation docs
Posted by GitBox <gi...@apache.org>.
chintan-mishra commented on issue #511: Extend Clouseau(search-plugin) installation docs
URL: https://github.com/apache/couchdb-documentation/issues/511#issuecomment-610613534
@chrystalcastillochavez
What will help figure out a solution for this?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [couchdb-documentation] chintan-mishra commented on issue #511:
Extend Clouseau(search-plugin) installation docs
Posted by GitBox <gi...@apache.org>.
chintan-mishra commented on issue #511: Extend Clouseau(search-plugin) installation docs
URL: https://github.com/apache/couchdb-documentation/issues/511#issuecomment-610615233
https://github.com/apache/couchdb/issues/2630
#516
The referenced issues and this one are related.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services