Skip to content

Commit 29371eb

Browse files
authored
Merge pull request ceph#59508 from rkhudov/src-test-rgw-bucket_notification-update-documentation
src/test/rgw/bucket_notification/README.rst: update RabbitMQ documentation for RGW notification tests
2 parents df06b90 + 508bba9 commit 29371eb

File tree

2 files changed

+10
-6
lines changed

2 files changed

+10
-6
lines changed

examples/rgw/boto3/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ This directory contains examples on how to use AWS CLI/boto3 to exercise the Rad
33
This is an extension to the [AWS SDK](https://github.com/boto/botocore/blob/develop/botocore/data/s3/2006-03-01/service-2.json).
44

55
# Users
6-
For the standard client to support these extensions, the: ``service-2.sdk-extras.json`` file should be placed under: ``~/.aws/models/s3/2006-03-01/`` directory.
6+
For the standard client to support these extensions, the ``service-2.sdk-extras.json`` file should be added. You can place it under the default folder ``~/.aws/models/s3/2006-03-01/`` or create a custom one ``/path/to/custom/folder/models/s3/2006-03-01/`` and add it to ``AWS_DATA_PATH`` environment variable.
77
For more information see [here](https://github.com/boto/botocore/blob/develop/botocore/loaders.py#L33).
88
## Python
99
The [boto3 client](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) could be used with the extensions, code samples exists in this directory.

src/test/rgw/bucket_notification/README.rst

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ we would need the following configuration file::
2525
access_key = 1234567890
2626
secret_key = pencil
2727

28+
Add boto3 extension to the standard client: https://github.com/ceph/ceph/tree/main/examples/rgw/boto3#introduction.
2829

2930
===========
3031
Kafka Tests
@@ -125,29 +126,33 @@ To run the Kafka security test, you also need to provide the test with the locat
125126
RabbitMQ Tests
126127
==============
127128

128-
You need to install RabbitMQ in the following way::
129+
You need to install RabbitMQ, check supported platforms: https://www.rabbitmq.com/docs/platforms. For example, for Fedora::
129130

130131
sudo dnf install rabbitmq-server
131132

132133
Then you need to run the following command::
133134

134135
sudo chkconfig rabbitmq-server on
135136

137+
Update rabbitmq-server configuration to allow access to the guest user from anywhere on the network. Uncomment or add line to rabbirmq configuration, usually `/etc/rabbitmq/rabbirmq.comf`::
138+
139+
loopback_user.guest = false
140+
136141
Finally, to start the RabbitMQ server you need to run the following command::
137142

138-
sudo /sbin/service rabbitmq-server start
143+
sudo systemctl start rabbitmq-server
139144

140145
To confirm that the RabbitMQ server is running you can run the following command to check the status of the server::
141146

142-
sudo /sbin/service rabbitmq-server status
147+
sudo systemctl status rabbitmq-server
143148

144149
After running `vstart.sh` and RabbitMQ server you're ready to run the AMQP tests::
145150

146151
BNTESTS_CONF=bntests.conf python -m nose -s /path/to/ceph/src/test/rgw/bucket_notification/test_bn.py -v -a 'amqp_test'
147152

148153
After running the tests you need to stop the vstart cluster (``/path/to/ceph/src/stop.sh``) and the RabbitMQ server by running the following command::
149154

150-
sudo /sbin/service rabbitmq-server stop
155+
sudo systemctl stop rabbitmq-server
151156

152157
To run the RabbitMQ SSL security tests use the following::
153158

@@ -156,4 +161,3 @@ To run the RabbitMQ SSL security tests use the following::
156161
During these tests, the test script will restart the RabbitMQ server with the correct security configuration (``sudo`` privileges will be needed).
157162
For that reason it is not recommended to run the `amqp_ssl_test` tests, that assumes a manually configured rabbirmq server, in the same run as `amqp_test` tests,
158163
that assume the rabbitmq daemon running on the host as a service.
159-

0 commit comments

Comments
 (0)