Docs update on website and multi-db

Author: DraTeots

docs/_sidebar.md

@@ -23,10 +23,10 @@
 
 **Advanced**:
 - [Development guide](development/development.md)
-- [Database selector](development/database-selector.md)
 - [Migrate to RCDB2](development/rcdb2-migration.md)
 - [DAQ Setup](daq/daq.md)
-- [Website](web_site_setup.md)
+- [Website install](website/install.md)
+- [Muli-Database](website/database-selector.md)
 
 
 

docs/development/database-selector.md docs/website/database-selector.mddocs/development/database-selector.md renamed to docs/website/database-selector.md

@@ -4,7 +4,7 @@ The RCDB web interface supports switching between multiple databases from the br
 When configured, a dropdown selector appears in the navbar allowing users to pick a database.
 The selection is saved in a cookie and persists across sessions.
 
-## How It Works
+### How It Works
 
 - The Flask app has two config keys: `AVAILABLE_DATABASES` (a dict of `name -> connection_string`)
   and `DEFAULT_DATABASE` (the connection string to use when no cookie is set).
@@ -14,9 +14,8 @@ The selection is saved in a cookie and persists across sessions.
   is not in the available list, it logs a warning and uses the first entry.
 - When `AVAILABLE_DATABASES` is empty (the default), all behavior is identical to a single-database setup.
 
-## Configuration
 
-### CLI (`rcdb web`)
+## CLI (`rcdb web`)
 
 Use the `--add-db` flag (repeatable) to register named databases:
 
@@ -30,6 +29,9 @@ rcdb -c mysql+pymysql://rcdb@prodhost/rcdb web \
 - The `-c` / `--connection` / `RCDB_CONNECTION` value becomes the default database.
 - If no `-c` is provided, the first `--add-db` entry is used as the default.
 
+
+## Server Configuration
+
 ### WSGI
 
 Set the config keys directly in the WSGI script:

docs/website/index.md

@@ -0,0 +1,5 @@
+# Website
+
+[install.md](install.md ':include')
+
+[database-selector.md](database-selector.md ':include')

docs/web_site_setup.md docs/website/install.mddocs/web_site_setup.md renamed to docs/website/install.md

@@ -1,9 +1,18 @@
-# Installing RCDB Website
+# Install on server
 
 Instruction on how to install central RCDB website.  
 
-We use RHEL9 + Apache Server + mod_wsgi as the example, as this is what usually is used at Jefferson Lab (now is 2025).
+RHEL9 + Apache Server + mod_wsgi is used as the example, 
+as this is what usually is used at Jefferson Lab (now is 2025).
 
+***Notes:***
+
+- The RCDB web interface requires the proper database schema to be installed
+- For production use, consider setting up HTTPS with SSL certificates
+- Consider adjusting the number of threads in the WSGIDaemonProcess directive based on your server's capacity and expected load
+
+
+### Preinstalled docker image
 There is [a dockerfile with example Rocky Linux 9](https://github.com/JeffersonLab/rcdb/tree/main/docker/rocky) 
 (binary compatible with RHEL9) setup with config files. To build and run it:
 
@@ -17,15 +26,16 @@ docker run --rm -it --init -p 8888:80 rcdb-rocky:latest
 http://localhost:8888/rcdb/
 ```
 
-
 - RHEL9 (or compatible) server with Apache HTTP Server installed
 - Root access or sudo privileges
 - Python 3.9+ (default on RHEL9)
 - `mod_wsgi` package for Apache
 
-## Install Required Packages
+## Requirements 
 
-First, install the necessary packages:
+### System Packages
+
+Required system packages:
 
 ```bash
 # Install Apache and mod_wsgi
@@ -35,7 +45,7 @@ sudo dnf install httpd python3-mod_wsgi python3-pip python3-devel
 sudo systemctl enable --now httpd
 ```
 
-There are two ways of managing rcdb and dependencies: 
+There are two ways of managing python rcdb and dependencies: 
 
 - Install centrally on the server e.g. via RPM
 - Install venv and use mod_wsgi with python and packages from venv
@@ -68,11 +78,11 @@ dnf install -y \
 ```
 
 
-## Install RCDB Library
+### Python dependencies
 
 You have two options for installing the RCDB library:
 
-### Option A: System-wide Installation
+#### Option A: System-wide Installation
 
 ```bash
 git clone --depth=1 https://github.com/JeffersonLab/rcdb.git /opt/rcdb
@@ -93,9 +103,9 @@ pip install rcdb
 deactivate
 ```
 
-## 3. Create the WSGI Script
+## WSGI Script
 
-Create a WSGI script at `/group/halld/www/halldwebdev/html/rcdb/rcdb_www.wsgi`:
+Example HallD WSGI script is at `/group/halld/www/halldwebdev/html/rcdb/rcdb_www.wsgi`:
 
 If RCDB is installed as a system-wide library: 
 
@@ -131,7 +141,7 @@ rcdb.web.app.config["SQL_CONNECTION_STRING"] = "mysql://rcdb@hallddb.jlab.org/rc
 application = rcdb.web.app
 ```
 
-## 4. Configure Apache
+## Apache Configuration
 
 Create an Apache configuration file at `/etc/httpd/conf.d/rcdb.conf`:
 
@@ -164,16 +174,10 @@ Create an Apache configuration file at `/etc/httpd/conf.d/rcdb.conf`:
 ```
 
 
-## 5. Restart Apache
+**Restart Apache**
 
 ```bash
 sudo systemctl restart httpd
 ```
 
-## Additional Notes
-
-- The RCDB web interface requires the proper database schema to be installed
-- For production use, consider setting up HTTPS with SSL certificates
-- Consider adjusting the number of threads in the WSGIDaemonProcess directive based on your server's capacity and expected load
-
 Now your RCDB web interface should be up and running on your RHEL9 Apache server!