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

रिलीज: 2026.06

अंतिम अद्यतन: 5 सितम्बर, 2026

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

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

परिचय¶

digna के बारे में¶

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

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

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

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

यह रिलीज़ डेटा ऑब्ज़र्वेबिलिटी क्षमताएँ सीधे आपके कोड के अंदर लाती है, जिससे डेवलपर स्रोत पर ही डेटा गुणवत्ता की निगरानी कर सकते हैं। पूर्ण विवरण के लिए देखें release notes.

क्या आप 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.06-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] सेक्शन¶

यह सेक्शन digna बैकएंड एप्लिकेशन सेटिंग्स को कॉन्फ़िगर करता है:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

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

[base] सेक्शन¶

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

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption] सेक्शन¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] सेक्शन¶

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

चरण 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

Overall: OK

जो कुछ भी FAILED बताया जाए उसे ठीक करें और आगे बढ़ने से पहले कमांड फिर चलाएँ। विकल्पों की पूरी सूची CLI संदर्भ में है।

चरण 3: Repository इनिशियलाइज़ करें¶

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

cd /opt/digna
./digna repo check

आपको पुष्टि दिखनी चाहिए कि कनेक्शन स्थापित है (रिपॉज़िटरी स्वयं अभी इनिशियलाइज़ नहीं हुई है)।

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

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

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

./digna repo install

यह कमांड आपके PostgreSQL डेटाबेस में आवश्यक टेबल और schema इंस्टॉल करती है।

चरण 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 - --port — सर्वर पोर्ट

आपको स्टार्टअप संदेश दिखाई देने चाहिए जो पुष्टि करें कि सर्वर चल रहा है:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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 से digna हर स्रोत तकनीक तक ODBC के माध्यम से पहुँचता है। पिछली रिलीज़ में प्रति तकनीक अलग ड्राइवर और ODBC के बीच चुनाव था, जिसे Use ODBC स्विच से तय किया जाता था। digna टीम ने केवल ODBC पर आधारित रहने का निर्णय लिया, क्योंकि एक ही मानक इंटरफ़ेस विशेष रूप से बनाए गए ड्राइवरों के समूह से अधिक देता है:

• प्रमाणीकरण — प्रमाणीकरण ODBC का हिस्सा है, इसलिए कोई कनेक्शन वह सब उपयोग कर सकता है जो उसका ड्राइवर समर्थित करता है: पासवर्ड, टोकन और PAT, Kerberos और Active Directory, MFA और ब्राउज़र-आधारित सिंगल साइन-ऑन, क्लाउड पहचान, क्लाइंट प्रमाणपत्र और TLS। नई विधियाँ digna की रिलीज़ की प्रतीक्षा किए बिना, ड्राइवर अपडेट के साथ आती हैं।
• डेटाबेस निर्माताओं द्वारा अनुरक्षित ड्राइवर — निर्माता का अपना ड्राइवर नए सर्वर संस्करणों और सुरक्षा सुधारों का अनुसरण करता है, और आप उसे digna से स्वतंत्र रूप से, अपनी सुविधा के अनुसार अपडेट कर सकते हैं।
• सब कुछ कॉन्फ़िगर करने का एक ही तरीका — हर तकनीक कुंजी/मान गुणों की एक सूची है, उसी इंटरफ़ेस, संवेदनशील मानों के उसी एन्क्रिप्शन और उसी समस्या-निवारण के साथ, न कि प्रति स्रोत अलग-अलग फ़ील्ड।
• समायोजन और पहुँच — ड्राइवर-स्तर के विकल्प जैसे टाइमआउट, TLS सेटिंग्स, प्रॉक्सी और फ़ेच आकार हर स्रोत के लिए उपलब्ध हैं, और अनुरूप ODBC ड्राइवर वाली कोई भी तकनीक जोड़ी जा सकती है, वे भी जिनके लिए digna अलग मार्गदर्शिका प्रकाशित नहीं करता।

व्यवहार में इसका अर्थ है कि Use ODBC स्विच तथा होस्ट, पोर्ट, डेटाबेस, उपयोगकर्ता और पासवर्ड के अलग फ़ील्ड अब मौजूद नहीं हैं। हर वह कनेक्शन जो पहले से ODBC का उपयोग नहीं करता, उसे ODBC में बदलना होगा — कोई स्वचालित रूपांतरण नहीं है, इसलिए अपग्रेड से पहले इसकी योजना बनाएँ:

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

अपग्रेड के बाद प्रभावित प्रत्येक कनेक्शन को ODBC में बदलें और डैशबोर्ड से उसका परीक्षण करें — देखें डेटाबेस कनेक्शन बनाना और कनेक्शन का परीक्षण।

digna Repository बैकअप बनाना अनिवार्य है

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

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

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

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

चरण 1: digna सर्विस रोकें¶

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

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

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

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

चरण 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

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

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

[oidc_clients.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 बताया जाए उसे ठीक करें और आगे बढ़ने से पहले कमांड फिर चलाएँ।

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

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

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

./digna license check

चरण 8: Repository Schema को अपग्रेड करें¶

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

cd /opt/digna
./digna repo upgrade

यह PostgreSQL schema को नवीनतम वर्ज़न में अपडेट करेगा जबकि सभी मौजूदा डेटा सुरक्षित रहेंगे।

चरण 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. digna डैशबोर्ड एक्सेस करें
2. सत्यापित करें कि इंटरफ़ेस सही ढंग से लोड होता है
3. किसी भी त्रुटि के लिए सर्वर लॉग्स की जाँच करें
4. हर उस कनेक्शन को ODBC में बदलें जो अभी तक इसका उपयोग नहीं करता था, फिर सभी कनेक्शनों का परीक्षण करें — देखें कनेक्शन का परीक्षण