Skip to content

Commit 4c3aa53

Browse files
fix(docs): remove untested rollback procedure
SM does not support rollback procedure because of the reasons mentioned in #3484. Because of that, we shouldn't describe it in our docs. Refs #3484
1 parent 09e978c commit 4c3aa53

File tree

1 file changed

+0
-178
lines changed

1 file changed

+0
-178
lines changed

docs/source/upgrade/index.rst

Lines changed: 0 additions & 178 deletions
Original file line numberDiff line numberDiff line change
@@ -286,181 +286,3 @@ Check that cluster is up:
286286
sctool status -c <cluster>
287287
288288
All running nodes should be up.
289-
290-
Rollback Procedure
291-
==================
292-
293-
.. note:: Rolling back is not recommended because updated versions contains bug fixes and performance optimizations so you will be going back to a lesser version. This should be only used as a last resort.
294-
295-
Rollback procedure contains the same steps as upgrade but with downgrading the components to older version:
296-
297-
- Stop all ScyllaDB Manager tasks (or wait for them to finish)
298-
- Stop the ScyllaDB Manager Server
299-
- Stop the ScyllaDB Manager Agent on all nodes
300-
- Downgrade the ScyllaDB Manager Server and Client
301-
- Downgrade the ScyllaDB Manager Agent on all nodes
302-
- Bring back old configuration (if there was conflict)
303-
- Start the ScyllaDB Manager Agent on all nodes
304-
- Start the ScyllaDB Manager Server
305-
- Validate status of the cluster
306-
307-
Rollback steps
308-
==============
309-
310-
Stop all ScyllaDB Manager tasks (or wait for them to finish)
311-
------------------------------------------------------------
312-
313-
**On the Manager Server** check current status of the manager tasks:
314-
315-
.. code:: sh
316-
317-
sctool tasks -c <cluster>
318-
319-
None of the listed tasks should have status in RUNNING.
320-
321-
Stop the ScyllaDB Manager Server
322-
--------------------------------
323-
324-
**On the Manager Server** instruct Systemd to stop the server process:
325-
326-
.. code:: sh
327-
328-
sudo systemctl stop scylla-manager
329-
330-
Ensure that it is stopped with:
331-
332-
.. code:: sh
333-
334-
sudo systemctl status scylla-manager
335-
336-
It should have a status of *“Active: inactive (dead)”*.
337-
338-
Stop the ScyllaDB Manager Agent on all nodes
339-
--------------------------------------------
340-
341-
**On each ScyllaDB node** in the cluster run:
342-
343-
.. code:: sh
344-
345-
sudo systemctl stop scylla-manager-agent
346-
347-
Ensure that it is stopped with:
348-
349-
.. code:: sh
350-
351-
sudo systemctl status scylla-manager-agent
352-
353-
It should have a status of *“Active: inactive (dead)”*.
354-
355-
Downgrade the ScyllaDB Manager Server and Client
356-
------------------------------------------------
357-
358-
**On the Manager Server** instruct package manager to downgrade server and the client:
359-
360-
CentOS, Red Hat:
361-
362-
.. code:: sh
363-
364-
sudo yum downgrade scylla-manager-server-3.x* scylla-manager-client-3.x* -y
365-
366-
Debian, Ubuntu:
367-
368-
.. code:: sh
369-
370-
sudo apt-get install scylla-manager-server=3.x scylla-manager-client=3.x -y
371-
372-
Downgrade the ScyllaDB Manager Agent on all nodes
373-
-------------------------------------------------
374-
375-
**On each ScyllaDB node** instruct package manager to downgrade the agent:
376-
377-
CentOS, Red Hat:
378-
379-
.. code:: sh
380-
381-
sudo yum downgrade scylla-manager-agent-3.x* -y
382-
383-
Debian, Ubuntu:
384-
385-
.. code:: sh
386-
387-
sudo apt-get install scylla-manager-agent=3.x -y
388-
389-
Revert to the old configuration
390-
-------------------------------
391-
392-
If you followed instructions from the Upgrade Steps section and you had configuration conflict when upgrading, then listing the configuration directory should give you both new and old configuration:
393-
394-
.. code:: sh
395-
396-
/etc/scylla-manager/scylla-manager.yaml # New version that you want to disable
397-
/etc/scylla-manager/scylla-manager.yaml.old # Previous version that you want to rollback
398-
399-
To restore the old configuration:
400-
401-
.. code:: sh
402-
403-
cd /etc/scylla-manager/
404-
mv scylla-manager.yaml scylla-manager.yaml.new
405-
mv scylla-manager.yaml.old scylla-manager.yaml
406-
407-
The procedure is the same for the ScyllaDB Manager Agent (on all nodes):
408-
409-
.. code:: sh
410-
411-
cd /etc/scylla-manager-agent/
412-
mv scylla-manager-agent.yaml scylla-manager-agent.yaml.new
413-
mv scylla-manager-agent.yaml.old scylla-manager-agent.yaml
414-
415-
Start the ScyllaDB Manager Agent on all nodes
416-
---------------------------------------------
417-
418-
On all nodes instruct Systemd to start the agent process:
419-
420-
.. code:: sh
421-
422-
sudo systemctl start scylla-manager-agent
423-
424-
Ensure that it is running with:
425-
426-
.. code:: sh
427-
428-
sudo systemctl status scylla-manager-agent
429-
430-
It should have a status of *“Active: active (running)”*.
431-
432-
Start the ScyllaDB Manager Server
433-
---------------------------------
434-
435-
**On the Manager Server** instruct Systemd to start the server process:
436-
437-
.. code:: sh
438-
439-
sudo systemctl stop scylla-manager
440-
441-
Ensure that it is stopped with:
442-
443-
.. code:: sh
444-
445-
sudo systemctl status scylla-manager
446-
447-
It should have a status of *“Active: active (running)”*.
448-
449-
Validate status of the cluster
450-
------------------------------
451-
452-
**On the Manager Server** check the version of the client and the server:
453-
454-
.. code:: sh
455-
456-
sctool version
457-
Client version: 3.x
458-
Server version: 3.x
459-
460-
Check that cluster is up:
461-
462-
.. code:: sh
463-
464-
sctool status -c <cluster>
465-
466-
All running nodes should be up.

0 commit comments

Comments
 (0)