digna रिलीज 2026.11 के लिए Linux स्थापना मार्गदर्शिका¶

रिलीज़: 2026.11

अंतिम अपडेट: 7 नवंबर, 2026

सामग्री सूची¶

1. परिचय
2. सिस्टम आवश्यकताएँ
3. पूर्व-स्थापन सेटअप
4. PostgreSQL सर्वर सेटअप
5. वेब सर्वर विन्यास
6. प्रारम्भिक स्थापना
7. बैकएंड कॉन्फ़िगरेशन
8. डैशबोर्ड कॉन्फ़िगरेशन
9. digna को systemd सेवा के रूप में चलाना
10. नए रिलीज़ में अपग्रेड करना

परिचय¶

digna के बारे में¶

digna एक व्यापक AI-संचालित प्लेटफ़ॉर्म है जो वेयरहाउस, लेक्स और लेकहाउस जैसे विभिन्न डेटा वातावरणों में डेटा गुणवत्ता प्रबंधन को अनुकूलित करने के लिए डिज़ाइन किया गया है। यह उच्च मात्रा में स्केलेबल और अनुकूलनीय है और ऑटोमेशन, वास्तविक समय निगरानी और अनोमली डिटेक्शन के माध्यम से आधुनिक डेटा चुनौतियों को संबोधित करता है।

digna दो मुख्य घटकों से मिलकर बनता है:

• digna: एप्लिकेशन का केंद्र, जो डेटा संसाधित करने और गुणवत्ता जाँच चलाने के लिए ज़िम्मेदार है। यह बैकएंड और कमांड लाइन इंटरफ़ेस को एक ही निष्पादन योग्य फ़ाइल में जोड़ता है और पिछली रिलीज़ के अलग-अलग प्रोग्राम dignabackend तथा dignacli की जगह लेता है।
• dignadashboard: एक वेब-आधारित इंटरफ़ेस जो वेब सर्वर पर होस्ट किया जाता है और digna प्लेटफ़ॉर्म के साथ इंटरैक्ट करने व डेटा गुणवत्ता मेट्रिक्स को विज़ुअलाइज़ करने का यूजर-फ्रेंडली तरीका प्रदान करता है।

रिलीज 2026.11 में क्या नया है¶

यह रिलीज़ digna Data Reconciliation, digna MCP Server के साथ digna Agentic, और digna Engine जोड़ती है, जो digna के भीतर डेटा को प्रोफाइल कर सकता है और अलग-अलग डेटाबेस तकनीकों के बीच रेफरेंशियल इंटीग्रिटी की जाँच कर सकता है। पूर्ण विवरण के लिए देखें रिलीज़ नोट्स।

इंस्टॉलेशन के लिए यह रिलीज़ एक नया रिपॉज़िटरी माइग्रेशन तंत्र, digna Engine के लिए config.toml में एक वैकल्पिक [duckdb] सेक्शन, और एक नई लाइसेंस फ़ाइल लाती है। अपग्रेड सेक्शन इनमें से हर एक को कवर करता है।

Windows या macOS के लिए मार्गदर्शिका चाहिए?¶

यह गाइड Linux को कवर करता है। अन्य प्लेटफार्मों के लिए देखें Windows Installation Guide या macOS Installation Guide।

यह गाइड किस वितरण के लिए है?¶

निर्देश दोनों सामान्य सर्वर परिवारों के लिए लिखे गए हैं। जहाँ फर्क होता है, दोनों कमान्ड दिए गए हैं:

• Debian परिवार — Debian, Ubuntu। पैकेज मैनेजर: apt.
• RHEL परिवार — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora। पैकेज मैनेजर: dnf.

कोई भी आधुनिक वितरण जिसमें systemd है काम करेगा; केवल पैकेज नाम और कुछ कॉन्फ़िगरेशन पाथ बदलते हैं।

सिस्टम आवश्यकताएँ¶

स्थापना शुरू करने से पहले सुनिश्चित करें कि आपका सिस्टम निम्न न्यूनतम आवश्यकताओं को पूरा करता है:

डेटाबेस इंस्टॉलेशन विकल्प¶

यदि PostgreSQL पहले से इंस्टॉल है: आप अपने मौजूदा PostgreSQL सर्वर में digna के लिए नया डेटाबेस जोड़ सकते हैं।

यदि आप PostgreSQL को उसी मशीन पर इंस्टॉल कर रहे हैं जहाँ digna चलेगा:

अपना वितरण और आर्किटेक्चर कैसे जाँचें¶

इस गाइड में कई कमान्ड Debian और RHEL परिवारों के बीच अलग हैं। यह जाँचने के लिए चलाएँ:

cat /etc/os-release
uname -m

• ID=ubuntu या ID=debian — apt कमान्ड का उपयोग करें।
• ID=rhel, rocky, almalinux या fedora — dnf कमान्ड का उपयोग करें।
• x86_64 या aarch64 — उस आर्किटेक्चर का नाम जिसका इंस्टॉलेशन पैकेज आपको चाहिए।

पूर्व-स्थापन सेटअप¶

digna स्थापित करने से पहले सुनिश्चित करें कि दो प्रमुख पूर्वापेक्षाएँ मौजूद हैं:

1. PostgreSQL सर्वर – गणना किए गए मेट्रिक्स और प्रदर्शन डेटा संग्रहीत करने के लिए
2. वेब सर्वर – digna Dashboard को होस्ट करने के लिए

यदि ये कंपोनेंट पहले से सेटअप नहीं हैं, तो उन्हें इंस्टॉल और कॉन्फ़िगर करने के लिए नीचे दिए गए सेक्शन का पालन करें।

पैकेज इंडेक्स रिफ्रेश करना¶

कुछ भी इंस्टॉल करने से पहले अपने पैकेज लिस्ट अपडेट करें:

sudo apt update

sudo dnf check-update

PostgreSQL सर्वर सेटअप¶

यदि आपके पास पहले से PostgreSQL है¶

यदि PostgreSQL स्थानीय मशीन पर पहले से इंस्टॉल और चल रहा है या आप किसी मैनेज्ड रिमोट PostgreSQL सर्वर का उपयोग कर रहे हैं, तो आप अगले सेक्शन पर जा सकते हैं।

PostgreSQL इंस्टॉल करना¶

चरण 1: सर्वर पैकेज इंस्टॉल करें¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

चरण 2: डेटाबेस क्लस्टर इनिशियलाइज़ करें¶

Debian परिवार पर पैकेज क्लस्टर स्वतः बना देता है और शुरू कर देता है — अगले चरण पर जाएँ।

RHEL परिवार पर क्लस्टर को स्पष्ट रूप से बनाया जाना चाहिए:

sudo postgresql-setup --initdb

चरण 3: सेवा शुरू और सक्षम करें¶

sudo systemctl enable --now postgresql

यह PostgreSQL को तुरंत शुरू कर देता है और बूट पर ऑटो स्टार्ट के लिए कॉन्फ़िगर कर देता है।

चरण 4: इंस्टॉलेशन सत्यापित करें¶

psql --version
sudo systemctl status postgresql

आपको PostgreSQL का वर्ज़न और active (running) सेवा दिखना चाहिए।

चरण 5: सर्वर से कनेक्ट करें¶

एक Linux PostgreSQL पैकेज postgres सिस्टम अकाउंट बनाता है जो क्लस्टर का मालिक होता है। इसके माध्यम से कनेक्ट करें:

sudo -u postgres psql

चरण 6: पोर्ट की पुष्टि करें¶

डिफ़ॉल्ट PostgreSQL पोर्ट 5432 है। यह पुष्टि करने के लिए कि आपका सर्वर किस पोर्ट पर सुन रहा है:

sudo -u postgres psql -c "SHOW port;"

मान नोट कर लें — आपको इसे digna backend कॉन्फ़िगरेशन में चाहिए होगा।

चरण 7: digna उपयोगकर्ता के लिए पासवर्ड प्रमाणीकरण सक्षम करें¶

digna TCP पर digna_user के रूप में PostgreSQL से कनेक्ट करता है, जिसे peer प्रमाणीकरण के बजाय पासवर्ड प्रमाणीकरण की आवश्यकता होती है। सुनिश्चित करें कि आपका pg_hba.conf इसे अनुमति देता है।

फ़ाइल का स्थान खोजें:

sudo -u postgres psql -c "SHOW hba_file;"

इसे किसी संपादक में खोलें और पुष्टि करें कि स्थानीय TCP लाइनों में ident की बजाय scram-sha-256 (या पुराने सर्वरों पर md5) का उपयोग हो रहा है:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

किसी भी परिवर्तन के बाद PostgreSQL को रीलोड करें:

sudo systemctl reload postgresql

चरण 8: यदि PostgreSQL किसी अन्य मशीन पर चलता है¶

यदि किसी अन्य होस्ट से कनेक्शन्स स्वीकार करना है, तो postgresql.conf में listen_addresses सेट करें और अपने नेटवर्क के लिए pg_hba.conf में एक मेल खाने वाली host लाइन जोड़ें:

listen_addresses = '*'

फिर फ़ायरवॉल में पोर्ट खोलें और सेवा को पुनरारंभ करें:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

वेब सर्वर विन्यास¶

digna को डैशबोर्ड होस्ट करने के लिए एक वेब सर्वर की आवश्यकता है। निम्न में से किसी एक विकल्प को चुनें:

• nginx — हल्का और अनुशंसित
• Apache httpd — व्यापक रूप से उपयोग किया जाने वाला विकल्प

आपको केवल इनमें से एक सर्वर इंस्टॉल और कॉन्फ़िगर करना है।

दोनों सेक्शन उन दो चीज़ों को कॉन्फ़िगर करते हैं जिन पर डैशबोर्ड निर्भर है:

• एक सिंगल-पेज-एप्लिकेशन फॉलबैक, ताकि डैशबोर्ड URL रिफ्रेश करने पर 404 न लौटे
• एक .md MIME टाइप, ताकि Markdown फाइलें सही ढंग से सर्व हों

nginx सेटअप¶

अवलोकन¶

nginx एक हल्का, उच्च-प्रदर्शन वेब सर्वर है जो static digna डैशबोर्ड सर्व करने के लिए उपयुक्त है।

इंस्टॉलेशन¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx शुरू करना¶

sudo systemctl enable --now nginx

इंस्टॉलेशन सत्यापित करें¶

1. अपना ब्राउज़र खोलें
2. http://localhost पर नेविगेट करें
3. आपको nginx स्वागत पृष्ठ दिखाई देना चाहिए

फ़ायरवॉल खोलना¶

यदि सर्वर अन्य मशीनों से पहुँचा जाता है, तो HTTP ट्रैफ़िक की अनुमति दें:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

डैशबोर्ड के लिए साइट कॉन्फ़िगर करना¶

nginx दोनों वितरण परिवारों पर अपने conf.d डायरेक्टरी में हर फ़ाइल को शामिल करता है। वहाँ digna के लिए एक समर्पित कॉन्फ़िगरेशन फ़ाइल बनाएँ:

sudo nano /etc/nginx/conf.d/digna.conf

निम्न पेस्ट करें, /opt/digna/dashboard को आपके निकाले गए dashboard फ़ोल्डर के वास्तविक पाथ से बदलना सुनिश्चित करें:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

डिफ़ॉल्ट साइट अक्षम करें¶

किसी पोर्ट के लिए केवल एक सर्वर ब्लॉक default_server हो सकता है। Debian परिवार पर पैकेज्ड डिफ़ॉल्ट को हटाएँ ताकि यह टकराव न करे:

sudo rm /etc/nginx/sites-enabled/default

RHEL परिवार पर /etc/nginx/nginx.conf के अंदर server { ... } ब्लॉक को कमेंट या डिलीट करें।

कॉन्फ़िगरेशन लागू करें¶

सिनटैक्स त्रुटियों के लिए कॉन्फ़िगरेशन परीक्षण करें, फिर nginx रीलोड करें:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd सेटअप¶

अवलोकन¶

Apache httpd हर समर्थित वितरण के डिफ़ॉल्ट रिपॉज़िटरीज़ में उपलब्ध है। पैकेज Debian परिवार पर apache2 नाम से और RHEL परिवार पर httpd नाम से आता है।

इंस्टॉलेशन¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache शुरू करना¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

इंस्टॉलेशन सत्यापित करें¶

1. अपना ब्राउज़र खोलें
2. http://localhost पर नेविगेट करें
3. आपको वितरण का डिफ़ॉल्ट Apache पेज दिखाई देना चाहिए

आवश्यक: mod_rewrite सक्षम करें¶

डैशबोर्ड को URL rewriting की आवश्यकता है।

Debian परिवार पर मॉड्यूल सक्षम करें और पुनरारंभ करें:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL परिवार पर mod_rewrite डिफ़ॉल्ट रूप से लोड होता है। यह पुष्टि करें:

httpd -M | grep rewrite

आवश्यक: .htaccess ओवरराइड अनुमति दें¶

अपने डॉक्यूमेंट रूट के लिए कॉन्फ़िगरेशन फ़ाइल खोलें:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

अपने डॉक्यूमेंट रूट (/var/www/html दोनों परिवारों पर) को कवर करने वाले <Directory> ब्लॉक को ढूँढें और बदलें:

AllowOverride None

को:

AllowOverride All

आवश्यक: Markdown फाइलों के लिए MIME टाइप¶

इसी फ़ाइल में निम्न लाइन जोड़ें ताकि Markdown फाइलें सही ढंग से सर्व हो सकें:

AddType text/markdown .md

कॉन्फ़िगरेशन लागू करें¶

सिनटैक्स त्रुटियों के लिए कॉन्फ़िगरेशन जांचें, फिर Apache पुनरारंभ करें:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

प्रारम्भिक स्थापना¶

चरण 1: digna रिपॉज़िटरी सेटअप करें¶

digna रिपॉज़िटरी सभी मेट्रिक्स को संग्रहित करती है जो digna द्वारा गणना किए जाते हैं। यह विश्लेषणात्मक और प्रदर्शन डेटा के लिए केंद्रीय डेटाबेस के रूप में कार्य करती है।

रिपॉज़िटरी स्कीमा और उपयोगकर्ता बनाएँ¶

अपना PostgreSQL क्लाइंट (psql, pgAdmin, या समान) खोलें और निम्न SQL कमान्ड्स चलाएँ:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

निम्न प्लेसहोल्डर्स को बदलें:

• <digna_repo_schema> — अपनी इच्छित स्कीमा का नाम (उदा., dignarepo)
• <digna_repo_user> — अपना इच्छित उपयोगकर्ता नाम (उदा., digna_user)
• <digna_repo_password> — इस उपयोगकर्ता के लिए एक सुरक्षित पासवर्ड

उदाहरण:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

शेल से इन्हें एक ही चरण में चलाने के लिए:

sudo -u postgres psql

फिर postgres=# प्रॉम्प्ट पर स्टेटमेंट पेस्ट करें और बाहर निकलने के लिए \q टाइप करें।

चरण 2: digna इंस्टॉलेशन पैकेज निकालें¶

1. आपको प्रदान किया गया digna इंस्टॉलेशन ZIP फाइल ढूँढें
2. इसे अपने इच्छित इंस्टॉलेशन लोकेशन पर निकालें — उदाहरण के लिए /opt/digna
3. निकाले जाने के बाद, आपको निम्न आइटम दिखाई देने चाहिए:
4. dashboard/ — वेब डैशबोर्ड इंटरफ़ेस
5. digna — मुख्य executable (backend + CLI संयुक्त)

शेल से निकालने के लिए:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

executable को runnable बनाएं¶

यह निर्भर करता है कि आर्काइव कैसे ट्रांसफर किया गया था, executable बिट extraction के दौरान सुरक्षित नहीं रह सकता। इसे स्पष्ट रूप से सेट करें:

cd /opt/digna
sudo chmod +x digna

सर्विस अकाउंट बनाएं¶

प्रोडक्शन डिप्लॉयमेंट के लिए बैकएंड को एक समर्पित अनप्रिविलेज्ड उपयोगकर्ता के रूप में चलाना अनुशंसित है:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

चरण 3: लाइसेंस फ़ाइल इंस्टॉल करें¶

1. आपको दिया गया license.toml फ़ाइल ढूँढें
2. इसे root digna इंस्टॉलेशन डायरेक्टरी में कॉपी करें (जहाँ config.toml और digna executable स्थित हैं)

क्यों यह महत्वपूर्ण है: लाइसेंस फ़ाइल में आपका ग्राहक जानकारी, लाइसेंस समाप्ति तिथि, और डिजिटल सिग्नेचर होता है। इस फ़ाइल में कोई परिवर्तन न करें — किसी भी परिवर्तन से यह अमान्य हो जाएगी।

सेटअप के बाद निर्देशिका संरचना:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

बैकएंड कॉन्फ़िगरेशन¶

चरण 1: कॉन्फ़िगरेशन फ़ाइल बनाएं और संपादित करें¶

config_template.toml फ़ाइल आपके digna इंस्टॉलेशन डायरेक्टरी में प्रदान की गई है। आपको इसे केवल config.toml में नाम बदलना है।

cd /opt/digna
sudo mv config_template.toml config.toml

स्थान: /opt/digna/config.toml

config.toml को किसी टेक्स्ट एडिटर में खोलें और नीचे दिए प्रत्येक सेक्शन को कॉन्फ़िगर करें।

[app] सेक्शन¶

यह सेक्शन डैशबोर्ड और बैकएंड के बीच क्रॉस-ओरिजिन रिसोर्स शेयरिंग (CORS) को कॉन्फ़िगर करता है:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

[repo] सेक्शन¶

यह सेक्शन PostgreSQL डेटाबेस से कनेक्शन को कॉन्फ़िगर करता है:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

[base] सेक्शन¶

यह सेक्शन सुरक्षा, कुकी और निरीक्षण सेटिंग्स रखता है:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

[encryption] सेक्शन¶

इस सेक्शन में वह कुंजी होती है जिससे रिपॉज़िटरी में संग्रहीत संवेदनशील मान एन्क्रिप्ट किए जाते हैं। यह आवश्यक है — कुंजी न होने पर config check सेक्शन [encryption] को FAILED बताता है।

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] सेक्शन¶

यह सेक्शन लॉगिंग व्यवहार को कॉन्फ़िगर करता है:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] सेक्शन (वैकल्पिक)¶

रिलीज़ 2026.11 में नया। यह सेक्शन digna Engine के संसाधन निर्धारित करता है, जो उन डेटाबेस कनेक्शनों के लिए digna के भीतर डेटा को प्रोफाइल करता है जिनकी प्रोफाइलिंग लोकेशन digna Engine है, और अलग-अलग डेटाबेस कनेक्शनों पर स्थित डेटा स्रोतों के बीच रेफरेंशियल इंटीग्रिटी जाँच चलाता है। देखें प्रोफाइलिंग लोकेशन।

यह सेक्शन वैकल्पिक है। इसके बिना नीचे दिए गए डिफ़ॉल्ट लागू होते हैं।

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

चरण 2: कॉन्फ़िगरेशन जाँचें¶

रिपॉज़िटरी आरंभ करने से पहले जाँचें कि config.toml पूर्ण और सही ढंग से बना है। अपनी digna संस्थापन निर्देशिका में चलाएँ:

./digna config check

प्रत्येक सेक्शन की जाँच अलग से होती है, इसलिए एक अकेली गलती बाकी की स्थिति नहीं छिपाती:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

जो कुछ भी FAILED बताया जाए उसे ठीक करें और आगे बढ़ने से पहले कमांड फिर चलाएँ। Unknown keys के अंतर्गत WARNING उन कुंजियों को सूचीबद्ध करता है जो config.toml में हैं लेकिन जिन्हें digna नहीं पढ़ता; उनका कोई प्रभाव नहीं होता, इसलिए उन्हें हटाएँ या उनकी वर्तनी ठीक करें। विकल्पों की पूरी सूची CLI संदर्भ में है।

चरण 3: रिपॉज़िटरी इनिशियलाइज़ करें¶

1. एक टर्मिनल खोलें
2. अपनी digna इंस्टॉलेशन डायरेक्टरी में नेविगेट करें (जहाँ config.toml और digna executable स्थित हैं)
3. कनेक्शन टेस्ट चलाएँ:

cd /opt/digna
./digna repo check

नए स्कीमा पर कमांड कनेक्ट होती है और फिर बताती है कि अभी कोई रिपॉज़िटरी इंस्टॉल नहीं है:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

इस चरण पर यही अपेक्षित परिणाम है: यह पुष्टि करता है कि digna PostgreSQL और स्कीमा तक पहुँचता है। इसके बजाय कोई कनेक्शन या प्रमाणीकरण त्रुटि [repo] सेक्शन या PostgreSQL सेटअप की ओर इशारा करती है।

sudo ln -s /opt/digna/digna /usr/local/bin/digna

चरण 4: रिपॉज़िटरी स्कीमा इंस्टॉल करें¶

एक ही डायरेक्टरी में चलाएँ:

./digna repo upgrade

यह कमांड रिपॉज़िटरी स्कीमा में आवश्यक टेबल इंस्टॉल करती है और इस संदेश के साथ समाप्त होती है:

✅ Repo schema 'dignarepo' is up to date.

चरण 5: एक एडमिन उपयोगकर्ता बनाएं¶

1. एक नई टर्मिनल विंडो खोलें
2. अपनी digna इंस्टॉलेशन डायरेक्टरी में जाएँ
3. निम्न कमान्ड चलाकर एक एडमिन उपयोगकर्ता बनाएँ:

./digna user add <email> <password> "<display_name>" --admin

उदाहरण:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

इससे admin@example.com ईमेल पते और पूर्ण प्रशासनिक अधिकारों वाला एक उपयोगकर्ता बनता है।

चरण 6: digna सर्वर शुरू करें¶

digna इंस्टॉलेशन डायरेक्टरी में, सर्वर शुरू करें:

./digna serve --address <host> --port <port>

पैरामीटर्स: - --address — सर्वर होस्टनाम/IP (डिफ़ॉल्ट 127.0.0.1) - --port — सर्वर पोर्ट (डिफ़ॉल्ट 8000)

सर्वर चालू होने पर, वह उस पते को प्रिंट करता है जिस पर वह सुनता है:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

डैशबोर्ड कॉन्फ़िगरेशन¶

चरण 1: डैशबोर्ड को वेब सर्वर पर डिप्लॉय करें¶

digna डैशबोर्ड अपनी कॉन्फ़िगरेशन dashboard/dashboard_config.toml से पढ़ता है। यह फ़ाइल इंस्टॉलेशन के साथ नहीं आती — आप इसे dashboard/ डायरेक्टरी में डैशबोर्ड फ़ाइलों के साथ बनाते हैं।

इसकी सामग्री सिंगल साइन-ऑन के अंतर्गत बताई गई है, और वहीं इस फ़ाइल की आवश्यकता भी होती है: इसमें वे लॉगिन विकल्प होते हैं जो डैशबोर्ड प्रदान करता है और, मल्टी-इंस्टेंस डिप्लॉयमेंट के लिए, बैकएंड कनेक्शन।

अपने वेब सर्वर का चयन करें और संबंधित डिप्लॉयमेंट स्टेप्स का पालन करें।

nginx पर डिप्लॉय करना¶

यदि आपने nginx सेटअप का पालन किया है, तो server block पहले से ही आपके dashboard फ़ोल्डर की ओर पॉइंट करता है और कॉपी करने की आवश्यकता नहीं है।

1. पाथ की पुष्टि करें
2. /etc/nginx/conf.d/digna.conf खोलें

3. पुष्टि करें कि root आपके निकाले गए dashboard फ़ोल्डर की ओर पॉइंट करता है

4. यह सुनिश्चित करें कि फ़ोल्डर पढ़ने योग्य है

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. nginx रीलोड करें

   sudo nginx -t
   sudo systemctl reload nginx
   

6. इंस्टॉलेशन का परीक्षण करें

7. अपना ब्राउज़र खोलें
8. http://localhost (या आपका कॉन्फ़िगर किया गया URL) पर नेविगेट करें
9. आपको digna डैशबोर्ड लॉगिन पेज दिखाई देना चाहिए

Apache httpd पर डिप्लॉय करना¶

1. डैशबोर्ड को डॉक्यूमेंट रूट में कॉपी करें

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. रीराइट नियम जोड़ें

डैशबोर्ड रूट होने पर ब्राउज़र रिफ्रेश से बचने के लिए तैनात फ़ोल्डर के अंदर एक .htaccess फ़ाइल बनाएँ:

sudo nano /var/www/html/digna/.htaccess

निम्न पेस्ट करें:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Apache पुनरारंभ करें

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. डैशबोर्ड तक पहुँचें

3. अपना ब्राउज़र खोलें
4. http://localhost/digna पर नेविगेट करें
5. आपको digna डैशबोर्ड लॉगिन पेज दिखाई देना चाहिए

चरण 2: SELinux (केवल RHEL परिवार)¶

RHEL, Rocky, AlmaLinux और Fedora पर SELinux डिफ़ॉल्ट रूप से enforcing होता है और यह वेब सर्वर को उसकी अपेक्षित लोकेशनों के बाहर फाइलें पढ़ने से ब्लॉक कर देगा। जाँचें कि यह सक्रिय है या नहीं:

getenforce

यदि परिणाम Enforcing है और आप /opt/digna/dashboard से डैशबोर्ड सर्व कर रहे हैं, तो डायरेक्टरी को लेबल करें ताकि वेब सर्वर इसे पढ़ सके:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

digna को systemd सेवा के रूप में चलाना¶

digna को सेवा के रूप में क्यों चलाएँ?¶

digna बैकएंड को systemd सेवा के रूप में चलाने से यह सुनिश्चित होता है कि यह:

• मशीन बूट होने पर स्वचालित रूप से शुरू हो जाए
• बैकग्राउंड में बिना खुले टर्मिनल विंडो के चले
• यदि क्रैश करे तो स्वतः पुनरारंभ हो
• systemctl के माध्यम से मैनेज किया जा सके — जो कि मानक Linux सेवा प्रबंधक है

सेवा प्रबंधन फ़ाइलें¶

सभी आवश्यक फ़ाइलें digna इंस्टॉलेशन डायरेक्टरी के अंतर्गत: bin/ में स्थित हैं

उपलब्ध shell स्क्रिप्ट्स:

• install_service.sh — digna को systemd के साथ रजिस्टर करता है
• uninstall_service.sh — सेवा का रजिस्ट्रेशन हटाता है
• start_service.sh — रजिस्टर की गई सेवा शुरू करता है
• stop_service.sh — चल रही सेवा को रोकता है

स्क्रिप्ट्स को executable बनाना¶

Extraction executable बिट को संरक्षित नहीं कर सकता। पहली बार उपयोग से पहले:

cd /opt/digna/bin
sudo chmod +x *.sh

सेवा इंस्टॉल करना¶

1. एक टर्मिनल खोलें

2. bin फ़ोल्डर में नेविगेट करें

   cd /opt/digna/bin
   

3. इंस्टॉलेशन स्क्रिप्ट चलाएँ

   sudo ./install_service.sh
   

digna सर्वर अब systemd के साथ स्वचालित स्टार्टअप सक्षम करके रजिस्टर हो गया है। सेवा तुरंत शुरू नहीं होती — इसे शुरू करने के लिए अगले सेक्शन को देखें।

सेवा शुरू और रोकना¶

सेवा शुरू करने के लिए¶

1. एक टर्मिनल खोलें
2. /opt/digna/bin में नेविगेट करें
3. चलाएँ:

   sudo ./start_service.sh
   

सेवा रोकने के लिए¶

1. एक टर्मिनल खोलें
2. /opt/digna/bin में नेविगेट करें
3. चलाएँ:

   sudo ./stop_service.sh
   

systemctl के साथ सेवा प्रबंधन¶

एक बार रजिस्टर हो जाने पर, सेवा को किसी भी डायरेक्टरी से मानक systemd कमांड्स से नियंत्रित किया जा सकता है:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

सेवा सत्यापित करना¶

सुनिश्चित करने के लिए कि सेवा रजिस्टर और चल रही है:

systemctl is-enabled digna
systemctl is-active digna

enabled का अर्थ है सेवा बूट पर शुरू होगी; active का अर्थ है यह अभी चल रही है।

सेवा लॉग देखना¶

systemd कंसोल पर बैकएंड द्वारा लिखी गई सभी चीज़ें कैप्चर करता है। इसे पढ़ने के लिए:

sudo journalctl -u digna -n 100

समस्या उत्पन्न करते समय लाइव रूप में लॉग फॉलो करने के लिए:

sudo journalctl -u digna -f

सेवा को नई डायरेक्टरी में स्थानांतरित करना¶

यूनिट फ़ाइल executable के absolute पाथ को स्टोर करती है, इसलिए इंस्टॉलेशन को स्थानांतरित करने पर सेवा को फिर से रजिस्टर करना आवश्यक है:

1. वर्तमान सेवा अनइंस्टॉल करें

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. एप्लिकेशन फ़ाइलें स्थानांतरित करें

   sudo mv /old/path/digna /new/path/digna
   

3. सेवा फिर से इंस्टॉल करें

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. सेवा शुरू करें

   sudo ./start_service.sh
   

सेवा अनइंस्टॉल करना¶

1. चल रही सेवा को रोकें

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. सेवा अनइंस्टॉल करें

   sudo ./uninstall_service.sh
   

अब digna सर्वर systemd से अनरजिस्टर कर दिया गया है।

नए रिलीज़ में अपग्रेड करना¶

यह सेक्शन रिलीज़ 2026.06 के इंस्टॉलेशन को रिलीज़ 2026.11 में अपग्रेड करता है। यदि आपका इंस्टॉलेशन इससे पुराना है, तो पहले रिलीज़ 2026.06 से पहले की रिलीज़ से अपग्रेड करना पढ़ें।

अपग्रेड करने से पहले¶

digna रिपॉज़िटरी का बैकअप बनाना अनिवार्य है

digna को अपग्रेड करने से पहले अपने रिपॉज़िटरी (PostgreSQL) का बैकअप लें ताकि डेटा लॉस से बचा जा सके। बैकअप यह सुनिश्चित करता है कि यदि अपग्रेड के दौरान अनपेक्षित समस्याएँ आयीं तो आप रिकवर कर सकें।

शेल से बैकअप बनाने के लिए:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

रिलीज़ 2026.11 के लिए लाइसेंस फ़ाइल का अनुरोध करना

रिलीज़ 2026.11 को एक नई license.toml की आवश्यकता है। शुरू करने से पहले digna टीम से इसका अनुरोध करें, और इसे चरण 7 के लिए तैयार रखें।

रिलीज़ 2026.06 से पहले की रिलीज़ से अपग्रेड करना¶

रिलीज़ 2026.06 तीन ऐसे बदलाव लाई थी जो तब भी लागू होते हैं जब आप किसी पुराने इंस्टॉलेशन को सीधे 2026.11 में अपग्रेड करते हैं:

• केवल ODBC। digna हर स्रोत तकनीक तक ODBC के माध्यम से पहुँचता है। हर वह डेटाबेस कनेक्शन जो अभी ODBC का उपयोग नहीं करता, अपग्रेड के बाद ODBC में बदलना होगा; कोई स्वचालित रूपांतरण नहीं है। ODBC ड्राइवर पहले से digna होस्ट पर संस्थापित करें, देखें digna होस्ट पर ODBC ड्राइवर संस्थापित करना, और हर कनेक्शन के गुण तकनीक-वार मार्गदर्शिकाओं से तैयार रखें। Databricks Legacy कनेक्टर अब मौजूद नहीं है; उन कनेक्शनों को Databricks कनेक्टर पर ले जाएँ।
• एक ही executable। dignabackend और dignacli की जगह एकल digna executable ले लेती है, जो बैकएंड और CLI को जोड़ती है।
• config.toml। [encryption] सेक्शन आवश्यक है, और DIGNA_APP_HOST तथा DIGNA_APP_PORT अब नहीं पढ़े जाते: सर्वर अपना पता और पोर्ट digna serve से लेता है। अपनी फ़ाइल की तुलना बैकएंड कॉन्फ़िगरेशन से करें।

नीचे दिए गए चरण बताते हैं कि किसी पुराने इंस्टॉलेशन में कहाँ कुछ अलग करना होता है। चरण 8 का रिपॉज़िटरी अपग्रेड किसी भी पिछली रिलीज़ की रिपॉज़िटरी को सीधे 2026.11 तक ले आता है।

अपग्रेड प्रक्रिया¶

चरण 1: digna सेवा बंद करें¶

यदि digna systemd सेवा के रूप में चल रहा है, तो पहले उसे बंद करें:

cd /opt/digna/bin
sudo ./stop_service.sh

यदि digna फ़ोरग्राउंड में चल रहा है, तो उसकी टर्मिनल विंडो में Ctrl+C दबाएँ।

चरण 2: वर्तमान इंस्टॉलेशन का बैकअप लें¶

अपनी digna इंस्टॉलेशन डायरेक्टरी में वर्तमान इंस्टॉलेशन की executable और डैशबोर्ड फ़ोल्डर के नाम बदलें, ताकि नई रिलीज़ उनके साथ डिप्लॉय की जा सके:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

digna_old को तब तक रखें जब तक आप अपग्रेड की पुष्टि न कर लें, और dashboard_old को तब तक जब तक आप उससे अपनी कॉन्फ़िगरेशन फ़ाइलें पुनर्स्थापित न कर लें (चरण 4 देखें)। उसके बाद आप दोनों को हटा सकते हैं।

चरण 3: नया वर्शन निकालें और डिप्लॉय करें¶

1. नई digna इंस्टॉलेशन ZIP फ़ाइल निकालें
2. नई digna executable और dashboard फ़ोल्डर को अपनी इंस्टॉलेशन डायरेक्टरी में कॉपी करें
3. executable बिट और सर्विस अकाउंट के स्वामित्व को पुनर्स्थापित करें:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

चरण 4: अपनी कॉन्फ़िगरेशन फ़ाइलें पुनर्स्थापित करें¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

रिलीज़ 2026.11 को config.toml में किसी बदलाव की आवश्यकता नहीं है: जो फ़ाइल रिलीज़ 2026.06 के साथ काम करती है, वह काम करती रहती है। दो बदलाव वैकल्पिक हैं:

• यदि डेटाबेस कनेक्शनों को digna Engine का उपयोग करना है और उसके डिफ़ॉल्ट आपके होस्ट के अनुकूल नहीं हैं, तो एक [duckdb] सेक्शन जोड़ें।
• यदि कोई रिवर्स प्रॉक्सी डैशबोर्ड और बैकएंड को एक ही origin के अंतर्गत सर्व करता है, तो [app] सेक्शन छोड़ दें।

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

चरण 5: वेब सर्वर रीलोड करें¶

डैशबोर्ड स्टैटिक फ़ाइलों का एक सेट है, इसलिए आपका वेब सर्वर — और ब्राउज़र — अभी भी पिछला वर्शन दिखा सकते हैं। जो भी वेब सर्वर dashboard फ़ोल्डर को होस्ट करता है, उसे रीलोड या रीस्टार्ट करें, फिर हार्ड रिफ़्रेश (Ctrl+F5) के साथ पेज रीलोड करें।

चरण 6: कॉन्फ़िगरेशन जाँचें¶

रिपॉज़िटरी को छूने से पहले पुष्टि करें कि config.toml पूर्ण है:

./digna config check

प्रत्येक सेक्शन को OK बताना चाहिए। जो कुछ भी FAILED बताया जाए उसे ठीक करें, Unknown keys के अंतर्गत सूचीबद्ध कुंजियाँ हटाएँ, और आगे बढ़ने से पहले कमांड फिर चलाएँ।

चरण 7: लाइसेंस फ़ाइल बदलें¶

सामान्यतः लाइसेंस फ़ाइल एक रिलीज़ से अगली रिलीज़ में भी काम करती रहती है। रिलीज़ 2026.11 इसका अपवाद है: यह दो लाइसेंस वाले मॉड्यूल जोड़ती है, digna Data Reconciliation और digna Agentic, और 2026.11 से पहले जारी किए गए लाइसेंस में ये शामिल नहीं हैं। digna टीम द्वारा रिलीज़ 2026.11 के लिए दी गई license.toml को इंस्टॉलेशन डायरेक्टरी में कॉपी करें, जिससे पुरानी फ़ाइल बदल जाए:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

चरण 8: रिपॉज़िटरी स्कीमा अपग्रेड करें¶

अपनी digna इंस्टॉलेशन डायरेक्टरी में चलाएँ:

cd /opt/digna
./digna repo upgrade

रिलीज़ 2026.11 रिपॉज़िटरी स्कीमा को संस्करणबद्ध माइग्रेशनों से प्रबंधित करती है। किसी पिछली रिलीज़ से पहला अपग्रेड स्कीमा को पिछली पद्धति के अंतिम संस्करण तक लाता है, उसे अपने प्रारंभिक बिंदु के रूप में दर्ज करता है, और फिर रिलीज़ 2026.11 के माइग्रेशन लागू करता है। यह इस संदेश के साथ समाप्त होता है:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

सभी मौजूदा डेटा संरक्षित रहता है। किसी भी समय रिपॉज़िटरी की स्थिति देखने के लिए ./digna repo check चलाएँ: यह अंतिम लागू माइग्रेशन और कोई भी लंबित माइग्रेशन सूचीबद्ध करता है।

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

चरण 9: सेवाएँ पुनः प्रारंभ करें¶

यदि systemd सेवा के रूप में चल रहा है:

cd /opt/digna/bin
sudo ./start_service.sh

यदि मैन्युअल रूप से चला रहे हैं, तो सर्वर पुनरारंभ करें:

cd /opt/digna
./digna serve --address <address> --port <port>

यदि nginx या Apache का उपयोग कर रहे हैं, तो संबंधित वेब सर्वर रीलोड करें:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL परिवार पर, यदि dashboard डायरेक्टरी प्रतिस्थापित की गई थी तो SELinux लेबलिंग फिर से लागू करें:

sudo restorecon -Rv /opt/digna/dashboard

चरण 10: अपग्रेड सत्यापित करें¶

1. नई executable की रिलीज़ की पुष्टि करें:

   ./digna version
   

   पहली पंक्ति में Release: 2026.11 होना चाहिए।

2. digna डैशबोर्ड एक्सेस करें और सुनिश्चित करें कि इंटरफ़ेस सही ढंग से लोड हो रहा है।

3. त्रुटियों के लिए सर्वर लॉग्स जाँचें:

   sudo journalctl -u digna -n 100
   

4. अपने डेटाबेस कनेक्शनों का परीक्षण करें — देखें कनेक्शन का परीक्षण। रिलीज़ 2026.06 से पहले की रिलीज़ से अपग्रेड के बाद, पहले हर उस कनेक्शन को ODBC में बदलें जो अभी तक ODBC का उपयोग नहीं करता था।

नए मॉड्यूल के साथ शुरुआत करने के लिए देखें digna Data Reconciliation, digna MCP Server के लिए AI एजेंट कनेक्ट करना, और digna Engine के लिए प्रोफाइलिंग लोकेशन।