W E K A
4.4
4.4
  • WEKA v4.4 documentation
    • Documentation revision history
  • WEKA System Overview
    • Introduction
      • WEKA system functionality features
      • Converged WEKA system deployment
      • Optimize redundancy in WEKA deployments
    • SSD capacity management
    • Filesystems, object stores, and filesystem groups
    • WEKA networking
    • Data lifecycle management
    • WEKA client and mount modes
    • WEKA containers architecture overview
    • Glossary
  • Planning and Installation
    • Prerequisites and compatibility
    • WEKA cluster installation on bare metal servers
      • Plan the WEKA system hardware requirements
      • Obtain the WEKA installation packages
      • Install the WEKA cluster using the WMS with WSA
      • Install the WEKA cluster using the WSA
      • Manually install OS and WEKA on servers
      • Manually prepare the system for WEKA configuration
        • Broadcom adapter setup for WEKA system
        • Enable the SR-IOV
      • Configure the WEKA cluster using the WEKA Configurator
      • Manually configure the WEKA cluster using the resources generator
        • VLAN tagging in the WEKA system
      • Perform post-configuration procedures
      • Add clients to an on-premises WEKA cluster
    • WEKA Cloud Deployment Manager Web (CDM Web) User Guide
    • WEKA Cloud Deployment Manager Local (CDM Local) User Guide
    • WEKA installation on AWS
      • WEKA installation on AWS using Terraform
        • Terraform-AWS-WEKA module description
        • Deployment on AWS using Terraform
        • Required services and supported regions
        • Supported EC2 instance types using Terraform
        • WEKA cluster auto-scaling in AWS
        • Detailed deployment tutorial: WEKA on AWS using Terraform
      • WEKA installation on AWS using the Cloud Formation
        • Self-service portal
        • CloudFormation template generator
        • Deployment types
        • AWS Outposts deployment
        • Supported EC2 instance types using Cloud Formation
        • Add clients to a WEKA cluster on AWS
        • Auto scaling group
        • Troubleshooting
    • WEKA installation on Azure
      • Azure-WEKA deployment Terraform package description
      • Deployment on Azure using Terraform
      • Required services and supported regions
      • Supported virtual machine types
      • Auto-scale virtual machines in Azure
      • Add clients to a WEKA cluster on Azure
      • Troubleshooting
      • Detailed deployment tutorial: WEKA on Azure using Terraform
    • WEKA installation on GCP
      • WEKA project description
      • GCP-WEKA deployment Terraform package description
      • Deployment on GCP using Terraform
      • Required services and supported regions
      • Supported machine types and storage
      • Auto-scale instances in GCP
      • Add clients to a WEKA cluster on GCP
      • Troubleshooting
      • Detailed deployment tutorial: WEKA on GCP using Terraform
      • Google Kubernetes Engine and WEKA over POSIX deployment
    • WEKA installation on OCI
  • Getting Started with WEKA
    • Manage the system using the WEKA GUI
    • Manage the system using the WEKA CLI
      • WEKA CLI hierarchy
      • CLI reference guide
    • Run first IOs with WEKA filesystem
    • Getting started with WEKA REST API
    • WEKA REST API and equivalent CLI commands
  • Performance
    • WEKA performance tests
      • Test environment details
  • WEKA Filesystems & Object Stores
    • Manage object stores
      • Manage object stores using the GUI
      • Manage object stores using the CLI
    • Manage filesystem groups
      • Manage filesystem groups using the GUI
      • Manage filesystem groups using the CLI
    • Manage filesystems
      • Manage filesystems using the GUI
      • Manage filesystems using the CLI
    • Attach or detach object store buckets
      • Attach or detach object store bucket using the GUI
      • Attach or detach object store buckets using the CLI
    • Advanced data lifecycle management
      • Advanced time-based policies for data storage location
      • Data management in tiered filesystems
      • Transition between tiered and SSD-only filesystems
      • Manual fetch and release of data
    • Mount filesystems
      • Mount filesystems from Single Client to Multiple Clusters (SCMC)
      • Manage authentication across multiple clusters with connection profiles
    • Snapshots
      • Manage snapshots using the GUI
      • Manage snapshots using the CLI
    • Snap-To-Object
      • Manage Snap-To-Object using the GUI
      • Manage Snap-To-Object using the CLI
    • Snapshot policies
      • Manage snapshot policies using the GUI
      • Manage snapshot policies using the CLI
    • Quota management
      • Manage quotas using the GUI
      • Manage quotas using the CLI
  • Additional Protocols
    • Additional protocol containers
    • Manage the NFS protocol
      • Supported NFS client mount parameters
      • Manage NFS networking using the GUI
      • Manage NFS networking using the CLI
    • Manage the S3 protocol
      • S3 cluster management
        • Manage the S3 service using the GUI
        • Manage the S3 service using the CLI
      • S3 buckets management
        • Manage S3 buckets using the GUI
        • Manage S3 buckets using the CLI
      • S3 users and authentication
        • Manage S3 users and authentication using the CLI
        • Manage S3 service accounts using the CLI
      • S3 lifecycle rules management
        • Manage S3 lifecycle rules using the GUI
        • Manage S3 lifecycle rules using the CLI
      • Audit S3 APIs
        • Configure audit webhook using the GUI
        • Configure audit webhook using the CLI
        • Example: How to use Splunk to audit S3
        • Example: How to use S3 audit events for tracking and security
      • S3 supported APIs and limitations
      • S3 examples using boto3
      • Configure and use AWS CLI with WEKA S3 storage
    • Manage the SMB protocol
      • Manage SMB using the GUI
      • Manage SMB using the CLI
  • Security
    • WEKA security overview
    • Obtain authentication tokens
    • Manage token expiration
    • Manage account lockout threshold policy
    • Manage KMS
      • Manage KMS using GUI
      • Manage KMS using CLI
    • Manage TLS certificates
      • Manage TLS certificates using GUI
      • Manage TLS certificates using CLI
    • Manage Cross-Origin Resource Sharing
    • Manage CIDR-based security policies
    • Manage login banner
  • Secure cluster membership with join secret authentication
  • Licensing
    • License overview
    • Classic license
  • Operation Guide
    • Alerts
      • Manage alerts using the GUI
      • Manage alerts using the CLI
      • List of alerts and corrective actions
    • Events
      • Manage events using the GUI
      • Manage events using the CLI
      • List of events
    • Statistics
      • Manage statistics using the GUI
      • Manage statistics using the CLI
      • List of statistics
    • Insights
    • System congestion
    • User management
      • Manage users using the GUI
      • Manage users using the CLI
    • Organizations management
      • Manage organizations using the GUI
      • Manage organizations using the CLI
      • Mount authentication for organization filesystems
    • Expand and shrink cluster resources
      • Add a backend server
      • Expand specific resources of a container
      • Shrink a cluster
    • Background tasks
      • Set up a Data Services container for background tasks
      • Manage background tasks using the GUI
      • Manage background tasks using the CLI
    • Upgrade WEKA versions
    • Manage WEKA drivers
  • Monitor the WEKA Cluster
    • Deploy monitoring tools using the WEKA Management Station (WMS)
    • WEKA Home - The WEKA support cloud
      • Local WEKA Home overview
      • Deploy Local WEKA Home v3.0 or higher
      • Deploy Local WEKA Home v2.x
      • Explore cluster insights
      • Explore performance statistics in Grafana
      • Manage alerts and integrations
      • Enforce security and compliance
      • Optimize support and data management
      • Export cluster metrics to Prometheus
    • Set up WEKAmon for external monitoring
    • Set up the SnapTool external snapshots manager
  • Kubernetes
    • Composable clusters for multi-tenancy in Kubernetes
    • WEKA Operator deployment
    • WEKA Operator day-2 operations
  • WEKApod
    • WEKApod Data Platform Appliance overview
    • WEKApod servers overview
    • Rack installation
    • WEKApod initial system setup and configuration
    • WEKApod support process
  • AWS Solutions
    • Amazon SageMaker HyperPod and WEKA Integrations
      • Deploy a new Amazon SageMaker HyperPod cluster with WEKA
      • Add WEKA to an existing Amazon SageMaker HyperPod cluster
    • AWS ParallelCluster and WEKA Integration
  • Azure Solutions
    • Azure CycleCloud for SLURM and WEKA Integration
  • Best Practice Guides
    • WEKA and Slurm integration
      • Avoid conflicting CPU allocations
    • Storage expansion best practice
  • Support
    • Get support for your WEKA system
    • Diagnostics management
      • Traces management
        • Manage traces using the GUI
        • Manage traces using the CLI
      • Protocols debug level management
        • Manage protocols debug level using the GUI
        • Manage protocols debug level using the CLI
      • Diagnostics data management
  • Appendices
    • WEKA CSI Plugin
      • Deployment
      • Storage class configurations
      • Tailor your storage class configuration with mount options
      • Dynamic and static provisioning
      • Launch an application using WEKA as the POD's storage
      • Add SELinux support
      • NFS transport failback
      • Upgrade legacy persistent volumes for capacity enforcement
      • Troubleshooting
    • Convert cluster to multi-container backend
    • Create a client image
    • Update WMS and WSA
    • BIOS tool
Powered by GitBook
On this page
  • Workflow
  • Prepare for installation
  • Install hardware
  • Connect cables
  • Configure the iDRAC
  • Configure the WEKA software using WMS
  • Next steps
  1. WEKApod

WEKApod initial system setup and configuration

Workflow

Follow these procedures to complete the installation, initial setup, and configuration for the WEKApod system.

  1. Prepare for installation

  2. Install hardware

  3. Connect cables

  4. Configure the iDRAC (if the WMS server and Ethernet switch are unavailable)

  5. Configure the WEKA software using WMS

Prepare for installation

Ensure the customer site is ready for deployment according to the site requirements outlined during the service personnel's site survey.

A detailed site requirements document will be provided before installation, which includes, but is not limited to, the following:

  • Power: Estimated consumption (for an 8-server setup, approximately 7,712 watts).

  • Cooling: Required capacity (for an 8-server setup, approximately 30,027.2 BTU/hour).

  • Space: Rack dimensions and required space (one server requires 1 rack unit with a maximum depth of 787 mm).

Install hardware

Heavy load: Use proper lifting techniques, and seek help if the load is too heavy or awkward. Consider using lifting equipment if necessary.

  1. Rack preparation: Confirm that the rack is securely mounted according to the rack installation guidelines.

  2. Device mounting: Mount the following devices according to the rack installation guidelines:

    • Ethernet switch: Mount on the top rail of the rack.

    • WMS server: Mount on the rail directly below the Ethernet switch.

    • WEKApod servers: Mount on the rails below the WMS server in the order specified in the provided spreadsheet. Match each server's service tag, which is available on the front panel and on the box, to the corresponding entry in the spreadsheet.

Related topic

Rack installation

Connect cables

  1. Connect the peripherals to the system as follows:

    • OS management:

      • Connect the first WMS Ethernet port to the 1 Gbps Ethernet switch (if the switch is not available, connect to the customer's Ethernet network).

      • Connect the second WMS Ethernet port to the customer's Ethernet network.

      • Connect the NIC port of each WEKApod server to the 1 Gbps Ethernet switch (if the switch is not available, connect to the customer's Ethernet network).

    • BMC/iDRAC/iLO/IPMI: Connect the BMC Ethernet port of each WEKApod server to the 1 Gbps Ethernet switch.

    • InfiniBand (IB): Connect the two IB ports of each WEKApod server to the IB network.

    • 25 Gbps Ethernet: Connect the two OPC NIC ports of each WEKApod server to the customer's network, enabling tiering to object store.

  2. Connect the system to the electrical outlet.

  3. Power on the system.

Configure the iDRAC

iDRAC (Integrated Dell Remote Access Controller) is a proprietary technology developed by Dell. It provides remote management capabilities for Dell servers, allowing administrators to manage and monitor the server hardware independently of the operating system.

When the WEKApod system is shipped with a WMS server and Ethernet switch, the WSA servers come pre-configured with IP address information. Therefore, perform this procedure only if the WMS server and Ethernet switch are unavailable; otherwise, skip this step.

The pre-configured IP address of the iDRAC/BMC interfaces of the backend servers is 192.168.2.x, as indicated in the provided spreadsheet and Packing List included with the shipment.

Repeat this procedure for all WSA servers:

  1. Connect a crash cart (KVM) to the server.

  2. Power on or reboot the server.

  1. Press F2 when prompted to enter the System Setup.

Alternatively, you can configure these settings using the Lifecycle Controller (press F10 during boot).

  1. Navigate to Network settings.

  1. In NETWORK SETTINGS, ensure the NIC is enabled.

  1. Scroll to the IPV4 SETTINGS section and configure the settings as shown in the following example according to your environment. If necessary, configure the settings in the additional sections.

  1. Select Finish and exit the System Setup.

Configure the WEKA software using WMS

For WEKApod systems that include a WMS server and Ethernet switch, follow the steps below to configure the software using the WMS.

If your WEKApod system does not include a WMS server and Ethernet switch, refer to the instructions for reinstalling the operating system, WEKA software, and configuring the system. See Install the WEKA cluster using the WMS with WSA.

Configuration tips and troubleshooting

  • Installation troubleshooting: If the installation halts without error messages, access the system console and review the logs located in the /tmp/ directory. The primary log file is /tmp/ks-pre.log.

  • Accessing logs: To open a command prompt from the installation GUI for log review:

    • On macOS, press Ctrl+Option+F2

    • On Windows, press Ctrl+Alt+F2

  • BMC access: In some cases, you may need to use the Baseboard Management Controller (BMC) virtual console to complete the configuration.

  • Best practice: Run the dnf update command on all WEKApod servers and the WMS. Applying necessary security patches before configuration is essential for system security.

Procedure

  1. Log in on the console or through SSH as the weka user (root password: WekaService; weka user password: weka.io123).

  2. Browse the WMS Admin UI using the URL: http://<WMS-hostname-or-ip>:8501.

  1. Enter username and password (default: admin/admin), and select Login. The Landing Page appears.

  2. Select Deploy a WEKA Cluster and ensure any popup blockers are disabled.

  1. Select WEKApod Install.

  2. In Step 1 - Number of servers, the default Server Count is set to 8. If your deployment requires a different number, adjust this value as needed, then click Next.

  1. In Step 2 - Verify IPMI Connectivity, the WMS automatically fills in the IPMI IPs. Ensure the IPMI/iDRAC first IP, username, and password are correct (default: root/WekaService). Click Verify IPMI IPs and confirm that the Brand column shows Dell. Then, click Next.

  1. In Step 3 - Dataplane Settings, do the following:

    1. Enter the required IP information for the Dataplane network, then click Update Dataplanes.

    2. Ensure the Dataplanes are configured correctly, then click Next.

  1. In Step 4 - Save Files and Run Validation Checks, click Save Files and Run Validation Checks.

  1. Confirm that all settings are correct. Click Download Configuration CSV File to save the configuration, then click Next.

  1. In Step 5 - Optional (Re)install WEKA Software, you can update the WEKA version if needed (the current version may be outdated based on the WSA version used to image the servers). If you do not want to update the WEKA version, click Next/Skip. To update the WEKA version:

    1. Place the required WEKA version in the weka user's home directory (~/weka) on the WSA server.

    2. Click Refresh Weka Software File List.

    3. Select the new version from the list.

    4. Click Start WEKA Software Install. This process may take a few minutes.

    5. Once the installation is complete, click Next/Skip.

  1. In Step 6 - Apply OS and Dataplane settings, click Run system configuration scripts. This process typically takes 3-5 minutes for an 8-server cluster, but larger clusters take longer.

  1. Optional. You can review the messages providing a summary of the installation. To display more details, click Show Data.

  1. Upon completion of the preceding steps, proceed with the standard configuration of the cluster as outlined in Configure the WEKA cluster using the WEKA Configurator.

Next steps

After configuring the WEKApod servers, start managing the system using the GUI, CLI, or REST API, and add clients to your WEKA cluster.

Related topics

Getting Started with WEKA

Add clients to an on-premises WEKA cluster

PreviousRack installationNextWEKApod support process

Last updated 1 month ago

Connections diagram example of a WEKApod cluster with 8 servers