master: remove TiDB Lightning web interface

TOC.md

@@ -542,7 +542,6 @@
       - [Configuration File](/tidb-lightning/tidb-lightning-configuration.md)
       - [Command Line Flags](/tidb-lightning/tidb-lightning-command-line-full.md)
       - [Monitoring](/tidb-lightning/monitor-tidb-lightning.md)
-      - [Web Interface](/tidb-lightning/tidb-lightning-web-interface.md)
       - [FAQ](/tidb-lightning/tidb-lightning-faq.md)
       - [Glossary](/tidb-lightning/tidb-lightning-glossary.md)
   - [Dumpling](/dumpling-overview.md)

get-started-with-tidb-lightning.md

@@ -1,10 +1,10 @@
 ---
-title: Quick Start for TiDB Lightning
+title: Get Started with TiDB Lightning
 aliases: ['/docs/dev/get-started-with-tidb-lightning/','/docs/dev/how-to/get-started/tidb-lightning/']
 summary: TiDB Lightning is a tool for importing MySQL data into a TiDB cluster. It is recommended for test and trial purposes only, not for production or development environments. The process involves preparing full backup data, deploying the TiDB cluster, installing TiDB Lightning, starting TiDB Lightning, and checking data integrity. For detailed features and usage, refer to the TiDB Lightning Overview.
 ---
 
-# Quick Start for TiDB Lightning
+# Get Started with TiDB Lightning
 
 This document provides a quick guide on getting started with TiDB Lightning by importing MySQL data into a TiDB cluster.
 

migrate-aurora-to-tidb.md

@@ -165,7 +165,6 @@ If you need to enable TLS in the TiDB cluster, refer to [TiDB Lightning Configur
 
     - `grep` the keyword `progress` in the log. The progress is updated every 5 minutes by default.
     - Check progress in [the monitoring dashboard](/tidb-lightning/monitor-tidb-lightning.md).
-    - Check progress in [the TiDB Lightning web interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
 3. After TiDB Lightning completes the import, it exits automatically. Check whether `tidb-lightning.log` contains `the whole procedure completed` in the last lines. If yes, the import is successful. If no, the import encounters an error. Address the error as instructed in the error message.
 

migrate-from-csv-files-to-tidb.md

@@ -131,7 +131,6 @@ After the import starts, you can check the progress of the import by either of t
 
 - `grep` the keyword `progress` in the log. The progress is updated every 5 minutes by default.
 - Check progress in [the monitoring dashboard](/tidb-lightning/monitor-tidb-lightning.md).
-- Check progress in [the TiDB Lightning web interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
 After TiDB Lightning completes the import, it exits automatically. Check whether `tidb-lightning.log` contains `the whole procedure completed` in the last lines. If yes, the import is successful. If no, the import encounters an error. Address the error as instructed in the error message.
 

migrate-from-parquet-files-to-tidb.md

@@ -115,7 +115,6 @@ For more information on the configuration file, refer to [TiDB Lightning configu
 
     - Search for the keyword `progress` in the log using `grep`. The progress is updated every 5 minutes by default.
     - Check progress in the [monitoring dashboard](/tidb-lightning/monitor-tidb-lightning.md).
-    - Check progress in [TiDB Lightning web interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
     After TiDB Lightning completes the import, it exits automatically.
 

migrate-from-sql-files-to-tidb.md

@@ -88,7 +88,6 @@ After the import is started, you can check the progress in one of the following
 
 - Search the `progress` keyword in the `grep` log, which is updated every 5 minutes by default.
 - Use the Grafana dashboard. For details, see [TiDB Lightning Monitoring](/tidb-lightning/monitor-tidb-lightning.md).
-- Use web interface. For details, see [TiDB Lightning Web Interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
 After the import is completed, TiDB Lightning automatically exits. Check whether `tidb-lightning.log` contains `the whole procedure completed` in the last lines. If yes, the import is successful. If no, the import encounters an error. Address the error as instructed in the error message.
 

migrate-large-mysql-shards-to-tidb.md

@@ -217,7 +217,6 @@ Follow these steps to start `tidb-lightning`:
 
    - Use `grep` tool to search the keyword `progress` in the log. By default, a message reporting the progress is flushed into the log file every 5 minutes.
    - View progress via the monitoring dashboard. For more information, see [TiDB Lightning Monitoring]( /tidb-lightning/monitor-tidb-lightning.md).
-   - View the progress via the Web page. See [Web Interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
 After TiDB Lightning completes the import, it exits automatically. Check whether `tidb-lightning.log` contains `the whole procedure completed` in the last lines. If yes, the import is successful. If no, the import encounters an error. Address the error as instructed in the error message.
 

migrate-large-mysql-to-tidb.md

@@ -157,7 +157,6 @@ The target TiKV cluster must have enough disk space to store the imported data.
 
     - `grep` the keyword `progress` in the log. The progress is updated every 5 minutes by default.
     - Check progress in [the monitoring dashboard](/tidb-lightning/monitor-tidb-lightning.md).
-    - Check progress in [the TiDB Lightning web interface](/tidb-lightning/tidb-lightning-web-interface.md).
 
 4. After TiDB Lightning completes the import, it exits automatically. Check whether `tidb-lightning.log` contains `the whole procedure completed` in the last lines. If yes, the import is successful. If no, the import encounters an error. Address the error as instructed in the error message.
 

resources/doc-templates/template-task.md

@@ -81,11 +81,10 @@ You can divide the step into smaller sub-steps by using ordered lists (1, 2, 3,
     ### tidb-lightning global configuration
 
     [lightning]
-    # The HTTP port used to pull the web interface and Prometheus metrics. Set to 0 to disable the port.
+    # The HTTP port used to pull Prometheus metrics and expose debug data. Set to 0 to disable the port.
     status-addr = ':8289'
 
-    # Switch to server mode and use the web interface
-    # For details, see the "TiDB Lightning Web UI" document.
+    # Switch to server mode and submit import tasks through the HTTP API.
     server-mode = false
 
     # log

tidb-lightning/tidb-lightning-command-line-full.md

@@ -22,7 +22,7 @@ You can configure the following parameters using `tidb-lightning`:
 | `-f <rule>` | [Table filter rules](/table-filter.md). Can be specified multiple times. | `mydumper.filter` |
 | `--backend <backend>` | Select an import mode. `local` refers to [physical import mode](/tidb-lightning/tidb-lightning-physical-import-mode.md); `tidb` refers to [logical import mode](/tidb-lightning/tidb-lightning-logical-import-mode.md). | `tikv-importer.backend` |
 | `--log-file <file>` | Log file path. By default, it is `/tmp/lightning.log.{timestamp}`. If set to '-', it means that the log files will be output to stdout. | `lightning.log-file` |
-| `--status-addr <ip:port>` | Listening address of the TiDB Lightning server | `lightning.status-port` |
+| `--status-addr <ip:port>` | Listening address of the TiDB Lightning HTTP server | `lightning.status-addr` |
 | `--pd-urls <host1:port1,host2:port2,...,hostn:portn>` | PD endpoint address. Starting from v7.6.0, TiDB supports setting multiple PD addresses. | `tidb.pd-addr` |
 | `--tidb-host <host>` | TiDB server host | `tidb.host` |
 | `--tidb-port <port>` | TiDB server port (default = 4000) | `tidb.port` |
@@ -36,7 +36,7 @@ You can configure the following parameters using `tidb-lightning`:
 | `--ca <file>` | CA certificate path for TLS connection | `security.ca-path` |
 | `--cert <file>` | Certificate path for TLS connection | `security.cert-path` |
 | `--key <file>` | Private key path for TLS connection | `security.key-path` |
-| `--server-mode` | Start TiDB Lightning in server mode | `lightning.server-mode` |
+| `--server-mode` | Start TiDB Lightning in server mode. In this mode, TiDB Lightning waits for you to submit import tasks through the HTTP API instead of starting the import immediately. | `lightning.server-mode` |
 
 If you specify both a command line parameter and the corresponding setting in the configuration file, the command line parameter takes precedence. For example, running `tiup tidb-lightning -L debug --config cfg.toml` would always set the log level to "debug" regardless of the content of `cfg.toml`.
 

tidb-lightning/tidb-lightning-configuration.md

@@ -8,15 +8,15 @@ aliases: ['/docs/dev/tidb-lightning/tidb-lightning-configuration/','/docs/dev/re
 
 This document provides samples for global configuration and task configuration, and describes the usage of command-line parameters. You can find a sample configuration file in [`lightning/tidb-lightning.toml`](https://github.com/pingcap/tidb/blob/master/lightning/tidb-lightning.toml).
 
-TiDB Lightning has two configuration classes: "global" and "task", and they have compatible structures. Their distinction arises only when the [server mode](/tidb-lightning/tidb-lightning-web-interface.md) is enabled. When server mode is disabled (the default), TiDB Lightning will only execute one task, and the same configuration file is used for both global and task configurations.
+TiDB Lightning has two configuration classes: "global" and "task", and they have compatible structures. Their distinction arises only when server mode is enabled. When server mode is disabled (the default), TiDB Lightning executes only one task and uses the same configuration file for both global and task configurations.
 
 ## TiDB Lightning (Global)
 
 ### lightning
 
 #### `status-addr`
 
-- The HTTP port for displaying the task progress on the web interface, pulling Prometheus metrics, exposing debug data, and submitting import tasks (in server mode).
+- The HTTP port for pulling Prometheus metrics, exposing debug data, and submitting import tasks in server mode.
 - Setting it to `0` disables the port.
 
 <!-- Example: `:8289` -->
@@ -27,7 +27,7 @@ TiDB Lightning has two configuration classes: "global" and "task", and they have
 - Default value: `false`
 - Value options:
     - `false`: an import task starts immediately after you execute the command.
-    - `true`: after you execute the command, TiDB Lightning waits until you submit an import task in the web interface. For more information, see [TiDB Lightning Web Interface](/tidb-lightning/tidb-lightning-web-interface.md).
+    - `true`: after you execute the command, TiDB Lightning waits until you submit an import task through its HTTP API.
 
 #### `level`
 

tidb-lightning/tidb-lightning-distributed-import.md

@@ -63,7 +63,7 @@ TiDB Lightning exclusively uses some resources when it is running. If you need t
     - If you set checkpoint.driver = "file" (default), make sure that the path to the checkpoint is unique for each instance.
     - If you set checkpoint.driver = "mysql", you need to set a unique schema for each instance.
 - The log file for each TiDB Lightning should be set to a unique path. Sharing the same log file will impact log querying and troubleshooting.
-- If you use the [Web Interface](/tidb-lightning/tidb-lightning-web-interface.md) or Debug API, you need to set `lightning.status-addr` to a unique address for each instance; otherwise, the TiDB Lightning process fails to start due to port conflict.
+- If you use the Debug API or the HTTP API in server mode, you need to set `lightning.status-addr` to a unique address for each instance; otherwise, the TiDB Lightning process fails to start due to port conflict.
 
 ## Example 1: Use Dumpling + TiDB Lightning to Import Sharded Databases and Tables into TiDB in Parallel
 

tidb-lightning/tidb-lightning-web-interface.md

@@ -1,84 +1,20 @@
 ---
 title: TiDB Lightning Web Interface
-summary: Control TiDB Lightning through the web interface.
+summary: Learn about the removal of the TiDB Lightning Web Interface and the recommended alternatives.
 aliases: ['/docs/dev/tidb-lightning/tidb-lightning-web-interface/','/docs/dev/reference/tools/tidb-lightning/web/']
 ---
 
 # TiDB Lightning Web Interface
 
 > **Warning:**
 >
-> Starting from v8.5.6, the TiDB Lightning Web Interface is deprecated and will be removed in v8.5.7. The web UI build has been broken since v8.4.0. Use the [`tidb-lightning` CLI](/tidb-lightning/tidb-lightning-overview.md) or the [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) statement instead. If this affects your workflow, comment on [#67697](https://github.com/pingcap/tidb/issues/67697).
+> Starting from TiDB v8.5.7, TiDB Lightning no longer supports the web interface.
 
-TiDB Lightning provides a webpage for viewing the import progress and performing some simple task management. This is called the *server mode*.
+To import data with TiDB Lightning, use the TiDB Lightning command-line tools: `tidb-lightning` for import tasks and `tidb-lightning-ctl` for checkpoint and troubleshooting operations.
 
-To enable server mode, either start `tidb-lightning` with the `--server-mode` flag
+- For a basic procedure, see [Get Started with TiDB Lightning](/get-started-with-tidb-lightning.md).
+- For command-line options, see [TiDB Lightning Command Line Flags](/tidb-lightning/tidb-lightning-command-line-full.md).
 
-```sh
-tiup tidb-lightning --server-mode --status-addr :8289
-```
+To check the import progress, search for the `progress` keyword in the TiDB Lightning log, or use the [TiDB Lightning monitoring dashboard](/tidb-lightning/monitor-tidb-lightning.md).
 
-or set the `lightning.server-mode` setting in the configuration file.
-
-```toml
-[lightning]
-server-mode = true
-status-addr = ':8289'
-```
-
-After TiDB Lightning is launched, visit `http://127.0.0.1:8289` to control the program (the actual URL depends on the `status-addr` setting).
-
-In server mode, TiDB Lightning does not start running immediately. Rather, users submit (multiple) *tasks* via the web interface to import data.
-
-## Front page
-
-![Front page of the web interface](/media/lightning-web-frontpage.png)
-
-Functions of the title bar, from left to right:
-
-| Icon | Function |
-|:----|:----|
-| "TiDB Lightning" | Click to go back to the front page |
-| ⚠ | Display any error message from *previous* task |
-| ⓘ | List current and queued tasks; a badge may appear here to indicate number of queued tasks |
-| + | Submit a task |
-| ⏸/▶ | Pause/resume current execution |
-| ⟳ | Configure auto-refresh of the web page |
-
-Three panels below the title bar show all tables in different states:
-
-* Active: these tables are currently being imported
-* Completed: these tables have been imported successfully or failed
-* Pending: these tables are not yet processed
-
-Each panel contains cards describing the status of the table.
-
-## Submit task
-
-Click the **+** button on the title bar to submit a task.
-
-![Submit task dialog](/media/lightning-web-submit.png)
-
-Tasks are TOML files described as [task configurations](/tidb-lightning/tidb-lightning-configuration.md#tidb-lightning-task). One could also open a local TOML file by clicking **UPLOAD**.
-
-Click **SUBMIT** to run the task. If a task is already running, the new task will be queued and executed after the current task succeeds.
-
-## Table progress
-
-Click the **>** button of a table card on the front page to view the detailed progress of a table.
-
-![Table progress](/media/lightning-web-table.png)
-
-The page shows the import progress of every engine and data files associated with the table.
-
-Click **TiDB Lightning** on the title bar to go back to the front page.
-
-## Task management
-
-Click the **ⓘ** button on the title bar to manage the current and queued tasks.
-
-![Task management page](/media/lightning-web-queue.png)
-
-Each task is labeled by the time it was submitted. Clicking the task would show the configuration formatted as JSON.
-
-Manage tasks by clicking the **⋮** button next to a task. You can stop a task immediately, or reorder queued tasks.
+For new data import workloads, you can also use the [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) statement.