You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/deploy/spectrum_archive/deployment_guide.md
+54-5Lines changed: 54 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ This deployment guide goes over the steps that needs to be taken to get NooBaa r
5
5
NooBaa has the following prerequisites and expects them to be in place before proceeding with its installation and deployment.
6
6
1. Host is a Red Hat OS like Centos/RHEL.
7
7
2. Spectrum Scale along with Spectrum Archive must be in installed on the host machine.
8
-
3. libboost RPM packages must be already installed. In particular, `boost-system` and `boost-thread` packages are required. Without them in place, NooBaa installation will fail.
8
+
3. libboost RPM packages must be already installed. In particular, `boost-system` and `boost-thread` packages are required. Without them in place, NooBaa installation will fail. Can be checked by running `rpm -q boost-system boost-thread`.
9
9
10
10
## NooBaa Installation
11
11
NooBaa is packaged as a RPM which needs to be installed in order to be able to use NooBaa.
@@ -20,6 +20,8 @@ NooBaa is packaged as a RPM which needs to be installed in order to be able to u
20
20
NooBaa needs some configurations to be in place before we start up the NooBaa process and it is important to ensure that this is done before starting up the service.
21
21
22
22
### Configure NooBaa User
23
+
Before proceeding, please ensure there are no stale items in `/etc/noobaa.conf.d` from a previous (not in use) NooBaa setup. If there is this directory with stale data then remove it by runnign `rm -r /etc/noobaa.conf.d`.
24
+
23
25
In order to be able to access NooBaa, the user should create a account. This can be done in the following way.
@@ -93,13 +95,58 @@ $ systemctl status noobaa_nsfs # You should see status "Active" in green color
93
95
Now that NooBaa has been installed and is active, we can test out the deployment.
94
96
These AWS commands will read `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` from the environment, ensure that these are available in the environment and should be the same that we used in [configure NooBaa user](#configure-noobaa-user).
95
97
98
+
### Basic Testing
96
99
```console
97
100
$ aws s3 --endpoint https://localhost:443 --no-verify-ssl mb s3://first.bucket # Create a bucket named first.bucket
98
101
make_bucket: first.bucket
99
102
$ aws s3 --endpoint https://localhost:443 --no-verify-ssl ls # List all of the buckets
100
103
2023-10-05 21:18:45 first.bucket
101
104
```
102
105
106
+
### Test `GLACIER` Storage Class
107
+
```console
108
+
$ # Upload "somefile" to "first.bucket" bucket that we created in the previous step. Here "--storage-class GLACIER"
109
+
$ # tells the S3 server to store the file onto tape instead of disk.
warning: Skipping file s3://first.bucket/somefile. Object is of storage class GLACIER. Unable to perform download operations on GLACIER objects. You must restore the object to be able to perform the operation. See aws s3 download help for additional parameter options to ignore or force these transfers.
115
+
$ # Let's issue a restore request. This will return immediately but will take about 15 mins for the restore to finish.
download: s3://first.bucket/somefile to ./somefile.cp
148
+
```
149
+
103
150
## Log and Logrotate
104
151
Noobaa logs are configured using rsyslog and logrotate. RPM will configure rsyslog and logrotate if both are already running.
105
152
@@ -108,9 +155,9 @@ Rsyslog status check
108
155
systemctl status rsyslog
109
156
```
110
157
111
-
Noobaa logs are pushed to `var/log/noobaa.log` and the log is rotated and compressed daily.
158
+
Noobaa logs are pushed to `/var/log/noobaa.log` and the log is rotated and compressed daily.
112
159
113
-
Verify the rsyslog and logrotate rpm configuration is complete by checking the files `etc/rsyslog.d/noobaa_syslog.conf` and `etc/rsyslog.d/noobaa_rsyslog.conf` for rsyslog and `etc/logrotate.d/noobaa/logrotate_noobaa.conf` for logrotate.These files contain the noobaa specific configuration for rsyslog and logrotate.
160
+
Verify the rsyslog and logrotate rpm configuration is complete by checking the files `/etc/rsyslog.d/noobaa_syslog.conf` and `/etc/rsyslog.d/noobaa_rsyslog.conf` for rsyslog and `/etc/logrotate.d/noobaa/logrotate_noobaa.conf` for logrotate.These files contain the noobaa specific configuration for rsyslog and logrotate.
- What happens if I forget the credentials used to generate NooBaa User?
123
170
- You can find all of the NooBaa accounts details here: `/etc/noobaa.conf.d/accounts`.
124
171
- How do I add new users?
125
-
- You can repeat the command that we ran in the section [configure NooBaa User](#configure-noobaa-user). You need to make sure that the access key **must not be reused**.
172
+
- You can repeat the command that we ran in the section [configure NooBaa User](#configure-noobaa-user). You need to make sure that the access key **must not be reused**.
173
+
- My migrations/restores aren't working!
174
+
- You can find the migration/restore related logs in your crontab logs.
0 commit comments