ScyllaDB Documentation Logo Documentation
  • Server
    • ScyllaDB Open Source
    • ScyllaDB Enterprise
    • ScyllaDB Alternator
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
Download
Menu

Caution

You're viewing documentation for a previous version of Scylla Manager. Switch to the latest stable version.

Scylla Manager Troubleshooting

Troubleshooting¶

  • Use custom port for Scylla Manager Agent

  • Add a Node to a Managed Cluster

  • Remove a Node from a Managed Cluster

Use custom port for Scylla Manager Agent¶

By default Scylla Manager Agent starts API server on port 10001. The following procedure changes the default port.

Note that this procedure needs to be repeated for each Scylla node.

Procedure

  1. Edit the /etc/scylla-manager-agent/scylla-manager-agent.yaml.

  2. Uncomment and set https_port to match your desired port - all nodes must use the same port.

  3. Save the file.

  4. Restart Scylla Manager Agent service.

    sudo systemctl start scylla-manager-agent
    
  5. Verify the Scylla Manager Agent is running.

    sudo systemctl status scylla-manager-agent -l
    ● scylla-manager-agent.service - Scylla Manager Agent
      Loaded: loaded (/usr/lib/systemd/system/scylla-manager-agent.service; disabled; vendor preset: disabled)
      Active: active (running) since Wed 2019-10-30 10:46:51 UTC; 7s ago
        Main PID: 14670 (scylla-manager-)
        CGroup: /system.slice/scylla-manager-agent.service
               └─14670 /usr/bin/scylla-manager-agent
    

After that Change cluster port in Scylla Manager.

sctool cluster update -c <your cluster> --port <new port>

You can also pass the --port flag to sctool cluster add command when registering a new cluster.

Add a Node to a Managed Cluster¶

Although Scylla Manager is aware of all topology changes made within every cluster it manages, it cannot properly manage a cluster without establishing connections with every node in the cluster using the Scylla Manager Agent which is on each managed node.

Procedure

  1. Add Scylla Manager Agent to the new node. Use the same authentication token as you did for the other nodes in this cluster. Do not generate a new token.

  2. Confirm the node / datacenter was added by checking its sctool status. From the node running Scylla Manager server run the sctool status command, using the name of the managed cluster.

    sctool status -c prod-cluster
    Datacenter: eu-west
    ╭────┬────────────┬───────────┬───────────┬───────────────┬──────────┬──────┬──────────┬────────┬──────────┬──────────────────────────────────────╮
    │    │ Alternator │ CQL       │ REST      │ Address       │ Uptime   │ CPUs │ Memory   │ Scylla │ Agent    │ Host ID                              │
    ├────┼────────────┼───────────┼───────────┼───────────────┼──────────┼──────┼──────────┼────────┼──────────┼──────────────────────────────────────┤
    │ UN │ UP (4ms)   │ UP (3ms)  │ UP (2ms)  │ 34.203.122.52 │ 237h2m1s │ 4    │ 15.43GiB │ 4.1.0  │ 2.2.0    │ 8bfd18f1-ac3b-4694-bcba-30bc272554df │
    │ UN │ UP (15ms)  │ UP (11ms) │ UP (12ms) │ 10.0.138.46   │ 237h2m1s │ 4    │ 15.43GiB │ 4.1.0  │ 2.2.0    │ 238acd01-813c-4c55-bd65-5219bb19bc20 │
    │ UN │ UP (17ms)  │ UP (5ms)  │ UP (7ms)  │ 10.0.196.204  │ 237h2m1s │ 4    │ 15.43GiB │ 4.1.0  │ 2.2.0    │ bde4581a-b25e-49fc-8cd9-1651d7683f80 │
    │ UN │ UP (10ms)  │ UP (4ms)  │ UP (5ms)  │ 10.0.66.115   │ 237h2m1s │ 4    │ 15.43GiB │ 4.1.0  │ 2.2.0    │ 918a52aa-cc42-43a4-a499-f7b1ccb53b18 │
    ╰────┴────────────┴───────────┴───────────┴───────────────┴──────────┴──────┴──────────┴────────┴──────────┴──────────────────────────────────────╯
    

Remove a Node from a Managed Cluster¶

There is no need to perform any action in Scylla Manager after removing a node or datacenter from a Scylla cluster.

PREVIOUS
Scylla Monitoring
NEXT
Older Versions
  • 2.4
    • master
    • 3.0
    • 2.6
    • 2.5
    • 2.4
    • 2.3
    • 2.2
  • Install Scylla Manager
  • Install Scylla Manager Agent
  • Add a Cluster
  • Backup
    • Setup AWS S3
    • Setup S3 compatible storage
    • Setup Google Cloud Storage
    • Setup Azure Blob Storage
    • Examples
  • Restore
    • Download files command
  • Repair
    • Repair faster
    • Repair slower
    • Examples
  • Health Check
  • CLI sctool
    • Global flags and variables
    • Cluster
    • Backup
    • Repair
    • Status
    • Suspend & Resume
    • Task
    • Version
  • Configuration Files
    • Scylla Manager Config
    • Scylla Manager Agent Config
  • Swagger File
  • Scylla Monitoring
  • Troubleshooting
  • Older Versions
  • Slack
  • Create an issue
  • Edit this page

On this page

  • Troubleshooting
    • Use custom port for Scylla Manager Agent
    • Add a Node to a Managed Cluster
    • Remove a Node from a Managed Cluster
Logo
Docs Contact Us About Us
Mail List Icon Slack Icon Forum Icon
© 2023, ScyllaDB. All rights reserved.
Last updated on 15 February 2023.
Powered by Sphinx 4.3.2 & ScyllaDB Theme 1.3.4