macOS इंस्टॉलेशन गाइड — digna रिलीज 2026.11¶

रिलीज: 2026.11

अंतिम अद्यतन: 7 नवम्बर, 2026

सामग्री तालिका¶

1. परिचय
2. सिस्टम आवश्यकताएँ
3. पूर्व-इंस्टॉलेशन सेटअप
4. PostgreSQL सर्वर सेटअप
5. वेब सर्वर कॉन्फ़िगरेशन
6. प्रारम्भिक इंस्टॉलेशन
7. बैकएंड कॉन्फ़िगरेशन
8. डैशबोर्ड कॉन्फ़िगरेशन
9. digna को बैकग्राउंड सेवा के रूप में चलाना
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 या Linux ढूंढ रहे हैं?¶

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

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

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

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

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

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

अपनी आर्किटेक्चर की जाँच¶

इस गाइड में कई पाथ Apple Silicon और Intel Mac के बीच अलग होते हैं। यह जाँचने के लिए Terminal खोलकर चलाएँ:

uname -m

• arm64 — Apple Silicon. Homebrew /opt/homebrew पर इंस्टॉल होता है।
• x86_64 — Intel. Homebrew /usr/local पर इंस्टॉल होता है।

पूर्व-इंस्टॉलेशन सेटअप¶

digna इंस्टॉल करने से पहले सुनिश्चित करें कि तीन प्रमुख पूर्वापेक्षित चीज़ें मौजूद हों:

1. Homebrew – पैकेज मैनेजर जिसका उपयोग नीचे दिए गए कंपोनेंट्स को इंस्टॉल करने के लिए किया जाता है
2. PostgreSQL Server – गणना किए गए मीट्रिक्स और प्रदर्शन डेटा को स्टोर करने के लिए
3. Web Server – digna Dashboard की होस्टिंग के लिए

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

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

Homebrew macOS के लिए मानक पैकेज मैनेजर है और इस गाइड में PostgreSQL और nginx इंस्टॉल करने के लिए उपयोग किया जाता है।

चरण 1: जाँचें कि Homebrew पहले से इंस्टॉल है या नहीं¶

Terminal खोलें (press Cmd + Space, type Terminal, press Enter) और चलाएँ:

brew --version

यदि कोई वर्शन नंबर लौटता है, तो PostgreSQL Server Setup अनुभाग पर जाएँ।

चरण 2: Homebrew इंस्टॉल करें¶

यदि कमांड नहीं मिला, तो Homebrew इंस्टॉल करने के लिए official Homebrew site पर दिए निर्देशों का पालन करें। इंस्टॉलर Xcode Command Line Tools भी इंस्टॉल कर देता है यदि वे पहले से मौजूद नहीं हैं।

चरण 3: Homebrew को अपने PATH में जोड़ें¶

Apple Silicon पर, इंस्टॉलर आपके शेल पर्यावरण में Homebrew जोड़ने के लिए दो कमांड प्रिंट करता है। उन्हें निर्देशानुसार चलाएँ, फिर पुष्टि करें:

brew --prefix

यह Apple Silicon पर /opt/homebrew या Intel पर /usr/local प्रिंट करेगा।

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

यदि आपके पास पहले से PostgreSQL मौजूद है¶

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

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

macOS दो सरल तरीकों की पेशकश करता है PostgreSQL इंस्टॉल करने के लिए। एक चुनें:

• Homebrew — कमांड-लाइन इंस्टॉलेशन, सर्वर डिप्लॉयमेंट के लिए अनुशंसित
• Postgres.app — ग्राफिकल इंस्टॉलेशन, लोकल मूल्यांकन के लिए सुविधाजनक

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

चरण 1: PostgreSQL फॉर्मूला इंस्टॉल करें¶

brew install postgresql@16

चरण 2: PostgreSQL को अपने PATH में जोड़ें¶

वर्ज़न्ड PostgreSQL फॉर्मूलाज keg-only होते हैं, जिसका मतलब है कि Homebrew उनके कमांड्स को अपने PATH में स्वतः लिंक नहीं करता। इन्हें स्वयं जोड़ें:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

चरण 3: PostgreSQL सर्विस शुरू करें¶

brew services start postgresql@16

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

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

psql --version

यदि इंस्टॉलेशन सफल रहा तो PostgreSQL वर्शन दिखाई देगा।

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

psql postgres

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

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

psql postgres -c "SHOW port;"

मान नोट कर लें — आपको digna बैकएंड कॉन्फ़िगर करते समय इसकी आवश्यकता होगी।

Postgres.app के साथ PostgreSQL इंस्टॉल करना¶

यदि आप ग्राफिकल इंस्टॉलेशन पसंद करते हैं:

1. Postgres.app डाउनलोड करें और उसे Applications फ़ोल्डर में ड्रैग करें
2. ऐप खोलें और नई सर्वर बनाने के लिए Initialize पर क्लिक करें
3. ऐप के निर्देशों का पालन करके उसके कमांड-लाइन टूल्स को अपने PATH में जोड़ें
4. इंस्टॉलेशन सत्यापित करें:

psql --version

Postgres.app भी आपके macOS अकाउंट के नाम का एक सुपरयूज़र बनाता है।

वेब सर्वर कॉन्फ़िगरेशन¶

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

• nginx — Homebrew के माध्यम से इंस्टॉल, अनुशंसित
• Apache httpd — macOS के साथ शामिल

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

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

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

nginx सेटअप¶

अवलोकन¶

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

इंस्टॉलेशन¶

brew install nginx

nginx शुरू करना¶

brew services start nginx

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

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

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

Homebrew की nginx कॉन्फ़िगरेशन उसकी servers डायरेक्टरी में हर फ़ाइल को शामिल करती है। वहां digna के लिए एक समर्पित कॉन्फ़िगरेशन फ़ाइल बनाएँ:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

निम्नलिखित पेस्ट करें, /path/to/digna/dashboard को अपने एक्सट्रैक्ट किए हुए dashboard फ़ोल्डर के वास्तविक पाथ से बदलें:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

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

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

nginx -t
brew services restart nginx

Apache httpd सेटअप¶

अवलोकन¶

macOS में Apache httpd शामिल है, इसलिए इंस्टॉलेशन की आवश्यकता नहीं है। यह डिफ़ॉल्ट रूप से अक्षम होता है।

Apache शुरू करना¶

sudo apachectl start

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

1. ब्राउज़र खोलें
2. http://localhost पर नेविगेट करें
3. आपको "It works!" संदेश दिखाई देना चाहिए

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

डैशबोर्ड के लिए URL री-राइटिंग आवश्यक है। Apache कॉन्फ़िगरेशन खोलें:

sudo nano /etc/apache2/httpd.conf

निम्नलिखित लाइन ढूँढें और उसके आगे का # हटा दें ताकि यह अनकमेंट हो जाए:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

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

उसी फ़ाइल में <Directory "/Library/WebServer/Documents"> ब्लॉक खोजें और बदलें:

AllowOverride None

से:

AllowOverride All

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

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

AddType text/markdown .md

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

सिंटैक्स की जाँच करें, फिर Apache को रीस्टार्ट करें:

sudo apachectl configtest
sudo apachectl restart

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

चरण 1: digna Repository सेट करें¶

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

Repository Schema और यूज़र बनाएँ¶

अपना 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> — आपकी इच्छित 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;

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

psql postgres

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

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

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

Terminal से अनज़िप करने के लिए:

unzip digna-2026.11-macos.zip -d /opt/digna

Executable को runnable बनाएँ¶

किस तरह का आर्काइव ट्रांसफर हुआ है उसके आधार पर executable bit रह न भी सकता है। इसे स्पष्ट रूप से सेट करें:

cd /opt/digna
chmod +x digna

यदि macOS ऐप को ब्लॉक करता है¶

ब्राउज़र या मेल क्लाइंट के माध्यम से डाउनलोड की गई फ़ाइलों पर क्वारैंटाइन एट्रिब्यूट हो सकता है। यदि macOS रिपोर्ट करता है कि ऐप "cannot be opened because the developer cannot be verified", तो इंस्टॉलेशन डायरेक्टरी से एट्रिब्यूट हटाएं:

xattr -dr com.apple.quarantine /opt/digna

वैकल्पिक रूप से, System Settings → Privacy & Security खोलें, पेज के नीचे नज़दीक ब्लॉक किए गए आइटम को खोजें और Open Anyway पर क्लिक करें।

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

1. आपको प्रदान की गई license.toml फ़ाइल का पता लगाएँ
2. इसे रूट 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
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

[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"

mkdir -p /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: Repository इनिशियलाइज़ करें¶

1. Terminal खोलें
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 सेटअप की ओर इशारा करती है।

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

चरण 4: Repository Schema इंस्टॉल करें¶

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

./digna repo upgrade

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

✅ Repo schema 'dignarepo' is up to date.

चरण 5: एक Admin यूज़र बनायें¶

1. एक नया Terminal विंडो खोलें
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

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

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

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

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

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

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

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

1. पाथ की पुष्टि करें
2. खोलें $(brew --prefix)/etc/nginx/servers/digna.conf

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

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

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

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

   nginx -t
   brew services restart nginx
   

6. इंस्टॉलेशन टेस्ट करें

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

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

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

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

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

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

sudo nano /Library/WebServer/Documents/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 apachectl restart
   

2. डैशबोर्ड एक्सेस करें

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

digna को बैकग्राउंड सेवा के रूप में चलाना¶

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

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

• मशीन के बूट होने पर स्वचालित रूप से शुरू हो
• बिना खुले Terminal विंडो के बैकग्राउंड में चले
• क्रैश होने पर स्वतः पुनः आरंभ हो
• macOS के सेवा प्रबंधक launchctl के माध्यम से प्रबंधित किया जा सके

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

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

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

• install_service.sh — digna को launchd के साथ रजिस्टर करता है
• uninstall_service.sh — सर्विस का अनरजिस्टर करता है
• start_service.sh — रजिस्टर की गई सर्विस को स्टार्ट करता है
• stop_service.sh — चल रही सर्विस को स्टॉप करता है

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

एक्सट्रैक्शन executable बिट को बनाए नहीं रख सकता। पहले उपयोग से पहले:

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

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

1. Terminal खोलें

2. bin फोल्डर पर जाएँ

   cd /opt/digna/bin
   

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

   sudo ./install_service.sh
   

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

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

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

1. Terminal खोलें
2. /opt/digna/bin पर जाएँ
3. चलाएँ:

   sudo ./start_service.sh
   

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

1. Terminal खोलें
2. /opt/digna/bin पर जाएँ
3. चलाएँ:

   sudo ./stop_service.sh
   

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

यह पुष्टि करने के लिए कि सर्विस रजिस्टर और रन कर रही है:

sudo launchctl list | grep digna

यदि पहली कॉलम में प्रक्रिया ID के साथ एक लाइन शुरू होती है तो सर्विस चल रही है। पहले कॉलम में - होने का मतलब है कि यह रजिस्टर तो है पर रुकी हुई है।

सर्विस को नई डायरेक्टरी पर ले जाना¶

launchd 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 सर्वर launchd से अनरजिस्टर हो चुका है।

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

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

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

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

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

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

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 बैकग्राउंड सेवा के रूप में चल रहा है, तो पहले उसे बंद करें:

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

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

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

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

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

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

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

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

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

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

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 फ़ोल्डर को होस्ट करता है, उसे रीलोड या रीस्टार्ट करें, फिर हार्ड रिफ़्रेश (Cmd+Shift+R) के साथ पेज रीलोड करें।

चरण 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 को इंस्टॉलेशन डायरेक्टरी में कॉपी करें, जिससे पुरानी फ़ाइल बदल जाए:

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: सेवाएँ पुनः प्रारंभ करें¶

यदि बैकग्राउंड सेवा के रूप में चल रहा है:

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

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

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

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

brew services restart nginx

sudo apachectl restart

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

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

   ./digna version
   

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

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

3. त्रुटियों के लिए सर्वर आउटपुट और logs डायरेक्टरी की फ़ाइलें जाँचें।
4. अपने डेटाबेस कनेक्शनों का परीक्षण करें — देखें कनेक्शन का परीक्षण। रिलीज़ 2026.06 से पहले की रिलीज़ से अपग्रेड के बाद, पहले हर उस कनेक्शन को ODBC में बदलें जो अभी तक ODBC का उपयोग नहीं करता था।

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