83 docs tagged with "Administrator guide"

Add a new hard disk to a CubeCOS storage pool, either individually or all at once, and verify the cluster provisions OSDs onto it.

Assign users to a project in CubeCOS to manage access, permissions, and resource usage.

Change the Ceph data replication factor for a CubeCOS storage pool to adjust the balance between fault tolerance and available capacity.

The SSD caching tier can be tailored to different workloads by adjusting the cache ratio and behavior.

Check the status of Ceph OSDs in a CubeCOS storage cluster, including power-on time, usage, and disk health details.

Monitor, update, and troubleshoot your CubeCOS cluster, and perform backup and recovery tasks.

Start up a CubeCOS single-node or multi-node cluster, including bootstrapping behaviour and monitoring guidance.

Disable and remove a failed compute node from a hyper-converged infrastructure (HCI) cluster, then prepare and rejoin a replacement node.

Configure initial settings for a CubeCOS deployment.

Configure and manage CubeCOS tunings to customize system usage and functionality.

Configure Email (SMTP) notifications in CubeCOS.

Configure external SAN and NAS storage integration in CubeCOS to host VM disks and images, optimize internal SDS usage, and support hybrid storage architectures.

Set up Logstash to collect and forward system logs to a remote syslog server using UDP transport.

Set and manage resource quotas for CubeCOS projects using the admin panel. Control resource usage and optimize multi-tenant cloud environments.

Configure Slack notifications in CubeCOS.

Remove a failed control node from a CubeCOS cluster, prepare a replacement node, and rejoin it to restore cluster services.

Create a CubeCOS snapshot to back up configurations or capture the current state of the platform for recovery, troubleshooting, or audit purposes.

Group compute hosts with shared characteristics to enable targeted scheduling, resource segmentation, and metadata-based policies.

Create projects on CubeCOS to serve as logical resource groupings.

Create a volume mirror for disaster recovery or replication requirements.

Add an additional external network provider by enabling a NIC as an extra provider interface.

Configure an external network using flat networking, where nodes share a bridged Ethernet interface.

Configure an external network using VLAN to isolate project traffic on shared physical hosts.

Create and manage user groups in CubeCOS using the local identity service. User groups simplify permission management by allowing role assignments at the group level.

Create users in CubeCOS using the local identity service. Applicable to environments without external identity providers or when local control over user accounts is required.

Create a bonded network interface during CubeCOS installation to provide link redundancy or aggregated bandwidth.

Create users in CubeCOS through Single Sign-On (SSO) using Keycloak as the identity provider. This approach enables centralized authentication and seamless access across integrated systems.

Create a VLAN-tagged network interface during CubeCOS installation.

Create a VLAN-tagged interface on top of a bonded network interface during CubeCOS installation.

CubeCOS delivers flexible deployments with a modular, node-based architecture—allowing you to assign compute, storage, and control roles based on your infrastructure needs.

CubeCOS supports flexible deployment options ranging from single-node setups to multi-node high-availability clusters, making it suitable for testing, development, and production environments.

Learn the responsibilities and functions of each CubeCOS node role within the cluster architecture.

CubeCOS is a self-hosted private cloud platform that delivers full public cloud capabilities, enterprise-grade data center orchestration, and a flexible foundation for VDI, edge computing, AI, and beyond.

Enable cluster-level storage caching to improve access performance in hybrid storage deployments.

Review the prerequisites for external SAN and NAS storage integration in CubeCOS. Meeting them lets you host VM disks and images, optimize internal SDS usage, and support hybrid storage architectures.

Swap the active firmware partition or back up the active firmware to the inactive partition using the CubeCOS CLI.

Recover a load balancer that has stopped working using the CLI fix command.

Review the minimum and recommended hardware requirements to deploy CubeCOS.

Install CubeCOS on a compute (HCI) node, which contributes CPU and memory to the cluster and can add local SSD/HDD drives to the storage pool.

Install CubeCOS on a dedicated control node, which manages cluster services and requires at least one compute node and an optional storage node.

Install CubeCOS on a single node that combines the control, compute, network, and storage roles for testing, evaluation, or small-scale deployments.

Install CubeCOS on a moderator node, which pairs with an edge-core node to provide control and optional storage for quorum.

Install CubeCOS on a dedicated storage (SDS) node, which contributes SSD and HDD drives to the cluster's software-defined storage pool.

Install CubeCOS on an edge-core node, an all-in-one role that combines control, compute, network, and storage for edge computing deployments.

Install CubeCOS for both small-scale and large-scale cluster deployments, from single-node setups to enterprise-grade infrastructure.

Install the QEMU guest agent to enable IP reporting, guided shutdown, and file-system freezes for backups.

Upgrade CubeCOS firmware and install fixpacks with one-click updates. Includes step-by-step instructions, rolling upgrades, troubleshooting, and error code reference.

Integrate external SAN and NAS storage in CubeCOS to host VM disks and images, optimize internal SDS usage, and support hybrid storage architectures.

This guide explains the technical differences between firmware and fixpack updates to help ensure high availability and business continuity during cluster upgrades.

Request and install a CubeCOS license to activate support entitlement.

Perform log analysis in CubeCOS to diagnose issues, monitor system behavior, and gain visibility into infrastructure events using integrated OpenSearch dashboards.

Manage external storage models and vendor drivers in CubeCOS, and troubleshoot connectivity and configuration issues.

Use Trigger Management to automate responses to system events — send email or Slack notifications and run custom scripts based on filtered conditions.

Manually flush SSD cache to remediate IOPS load when data tiering operations are stuck.

Identify and troubleshoot CubeCOS service errors using the web UI or CLI tools.

Monitor instance resource usage.

Monitor resource usage on physical hosts within the CubeCOS cluster.

Monitor storage capacity, throughput, and usage.

Switch between project-level and administrator views in the management console, including how to access and exit the administrator view.

Review the minimum and recommended network requirements to deploy CubeCOS.

Configure and manage remote power operations for server nodes using IPMI within the BigStack CubeCOS interface.

Complete CubeCOS upgrade guide covering firmware upgrades, fixpack updates, prerequisites, and rolling upgrade workflows. One-click automation for production environments.

Use the CLI to manually upgrade CubeCOS firmware and fix packs. This includes prerequisite checks, step-by-step commands and verification procedures.

Verify your network environment before deploying CubeCOS with built-in pre-installation check tools and the network preset CLI to ensure connectivity and reduce deployment issues.

A reference for how CubeCOS clusters scale compute, storage, and control resources across AIO, HCI, and web scale deployments.

Disable and remove a compute node from a hyper-converged infrastructure (HCI) cluster, then verify the removal from the CLI and the management UI.

Remove a storage node from a CubeCOS cluster and verify that Ceph recovers its data replication afterward.

Recover a CubeCOS storage pool from a HEALTH_WARN state by removing the OSD associated with a failed disk.

Permanently remove a failed hard disk from your storage pool using the prepare_disk command without physical removal. Safely wipe partition tables and decommission hardware via software.

Identify a failed physical disk in a CubeCOS storage pool and safely remove it from the cluster using safe or force mode.

Retire a compute node with outdated specs and convert it into a storage node, either by migrating workloads only or by fully rebuilding the node.

Use the CLI to reset instances (virtual machines) that become unresponsive due to unexpected errors.

Monitor resource usage across your CubeCOS cluster, including compute hosts, virtual instances, and storage components.

Recover a failed CubeCOS control node by removing its disks, rebuilding it from a saved snapshot, and rejoining it to the cluster.

Restore CubeCOS from a snapshot to recover a failed node.

Safely shut down a CubeCOS cluster with a step-by-step power-off procedure, including pre-shutdown checks to prevent data loss and service disruption.

Remove a failed storage node from a CubeCOS cluster, prepare a replacement node, and rejoin it to restore Ceph storage.

CubeCOS centralizes logs from system components and forwards them to an external syslog server for monitoring and analysis.

Diagnose and resolve common CubeCOS instance problems, including launch failures, stuck states, console access, and resize or migration errors.

Diagnose and resolve common CubeCOS networking problems, including connectivity, floating IPs, routers, DNS, and load balancers.

Diagnose and resolve common CubeCOS storage problems, including Ceph cluster health, OSD failures, volume attachment, and object or file storage errors.

Start here to triage a CubeCOS issue before moving to instance, network, or storage specific troubleshooting steps.

This guide covers how to utilize external storage in CubeCOS, including attaching volumes, verifying connections, and troubleshooting multipath storage across FC, iSCSI, and NFS.