digna Release 2026.06 के लिए Windows स्थापना मार्गदर्शिका¶

रिलीज़: 2026.06

अंतिम अपडेट: August 30, 2026

विषय-सूची¶

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

परिचय¶

digna के बारे में¶

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

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

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

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

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

macOS या Linux ढूँढ रहे हैं?¶

यह गाइड Windows के लिए है। अन्य प्लेटफ़ॉर्म के लिए, देखिए macOS स्थापना मार्गदर्शिका या Linux स्थापना मार्गदर्शिका।

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

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

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

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

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

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

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

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

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

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

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

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

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

Windows पर PostgreSQL इंस्टॉल करने के लिए निम्न चरणों का पालन करें:

चरण 1: PostgreSQL डाउनलोड करें¶

1. PostgreSQL Downloads पेज पर जाएँ
2. Windows चुनें
3. नवीनतम इंस्टॉलर डाउनलोड करें

चरण 2: इंस्टॉलर चलाएँ¶

1. डाउनलोड किए गए इंस्टॉलर फ़ाइल पर डबल-क्लिक करें
2. सेटअप विज़ार्ड में दिए गए निर्देशों का पालन करें

चरण 3: इंस्टॉलेशन डायरेक्टरी चुनें¶

PostgreSQL किस डायरेक्टरी में इंस्टॉल होगा यह चुनें। डिफ़ॉल्ट लोकेशन आम तौर पर उपयुक्त होती है।

चरण 4: कंपोनेंट्स चुनें¶

मानक सेटअप के लिए, डिफ़ॉल्ट कंपोनेंट विकल्पों को चुन कर रखें।

चरण 5: PostgreSQL सुपरयूज़र पासवर्ड सेट करें¶

PostgreSQL सुपरयूज़र (postgres) के लिए एक पासवर्ड दर्ज करें और पुष्टि करें। इस पासवर्ड को सुरक्षित रखें — आपको बाद में इसकी आवश्यकता होगी।

चरण 6: पोर्ट नंबर कॉन्फ़िगर करें¶

डिफ़ॉल्ट PostgreSQL पोर्ट 5432 है। आप डिफ़ॉल्ट उपयोग कर सकते हैं या आवश्यकता अनुसार अलग पोर्ट निर्दिष्ट कर सकते हैं।

चरण 7: स्थानीयकरण (Locale) चुनें¶

अपने डेटाबेस के लिए लोकेल चुनें। अधिकांश इंस्टॉलेशन के लिए डिफ़ॉल्ट सामान्यतः उपयुक्त होता है।

चरण 8: इंस्टॉलेशन पूर्ण करें¶

बचे हुए चरणों में Next पर क्लिक करें, फिर Finish पर क्लिक करें।

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

Command Prompt खोलें और सत्यापित करें कि PostgreSQL इंस्टॉल हुआ है:

psql --version

यदि इंस्टॉलेशन सफल था तो आपको PostgreSQL संस्करण दिखाई देगा।

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

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

• Internet Information Services (IIS)
• Apache Tomcat

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

IIS सेटअप¶

अवलोकन¶

Internet Information Services (IIS) माइक्रोसॉफ्ट का वेब सर्वर है जो वेबसाइट्स और वेब एप्लिकेशन होस्ट करने के लिए उपयोग होता है।

IIS सक्षम करना¶

1. Control Panel खोलें
2. Win + R दबाएँ

3. टाइप करें control और Enter दबाएँ

4. Windows Features पर जाएँ

5. Programs पर क्लिक करें

6. Turn Windows features on or off चुनें

7. Internet Information Services सक्षम करें

8. नीचे स्क्रॉल करें और Internet Information Services (IIS) ढूँढें
9. इसे सक्षम करने के लिए चेकबॉक्स पर टिक करें

10. विस्तार के लिए + पर क्लिक करें और सुनिश्चित करें कि ये सबकंपोनेंट्स चुने गए हैं:

    • Web Management Tools
    • World Wide Web Services

11. परिवर्तन लागू करने के लिए OK पर क्लिक करें

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

13. अपना ब्राउज़र खोलें
14. http://localhost पर जाएँ
15. आपको IIS Welcome पेज दिखाई देना चाहिए

आवश्यक: URL Rewrite मॉड्यूल¶

IIS के लिए URL Rewrite कंपोनेंट आवश्यक है। इसे आधिकारिक Microsoft पेज से डाउनलोड और इंस्टॉल करें।

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

यह सुनिश्चित करने के लिए कि Markdown फ़ाइलें (.md) IIS द्वारा सही ढंग से सर्व हों:

1. IIS Manager खोलें ( Win + R, टाइप करें inetmgr, Enter दबाएँ )
2. Your Site > MIME Types पर नेविगेट करें
3. Add... पर क्लिक करें
4. कॉन्फ़िगर करें:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat सेटअप¶

अवलोकन¶

Apache Tomcat एक ओपन-सोर्स Java servlet कंटेनर और वेब सर्वर है।

इंस्टॉलेशन¶

1. Apache Tomcat डाउनलोड करें
2. Apache Tomcat Downloads पर जाएँ

3. Windows ZIP distribution डाउनलोड करें

4. आर्काइव एक्सट्रैक्ट करें

5. ZIP फ़ाइल को अपने सिस्टम की किसी डायरेक्टरी में एक्सट्रैक्ट करें

6. उदाहरण: C:\Program Files\Apache Tomcat

7. Tomcat चल रहा है यह सत्यापित करें

8. अपना ब्राउज़र खोलें
9. http://localhost:8080 पर जाएँ
10. आपको Apache Tomcat welcome पेज दिखाई देना चाहिए

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

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

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

रिपॉज़िटरी स्कीमा और यूज़र बनाएं¶

अपना PostgreSQL क्लाइंट (pgAdmin, psql, या समान) खोलें और निम्न 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;

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

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

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

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

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

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

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

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

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

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

स्थान: digna_installation/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: रिपॉज़िटरी इनिशियलाइज़ करें¶

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

digna repo check

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

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

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

digna repo install

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

चरण 5: एक एडमिन यूज़र बनाएं¶

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

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

उदाहरण:

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

यह पूरा प्रशासनिक अधिकारों वाला उपयोगकर्ता बना देगा।

चरण 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/ डायरेक्टरी में डैशबोर्ड फ़ाइलों के साथ बनाते हैं।

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

अपना वेब सर्वर चुनें और संबंधित तैनाती चरणों का पालन करें।

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

1. IIS Manager खोलें

2. Win + R दबाएँ, टाइप करें inetmgr, Enter दबाएँ

3. नई वेबसाइट बनाएं

4. बाएँ पैनल में, Sites पर राइट-क्लिक करें

5. Add Website... चुनें

6. वेबसाइट कॉन्फ़िगर करें

7. Site Name: एक नाम दर्ज करें (उदा., "dignaDashboard")
8. Physical Path: Browse पर क्लिक करें और अपनी dashboard फ़ोल्डर चुनें

9. Binding: IP पता और पोर्ट सेट करें (HTTP के लिए डिफ़ॉल्ट पोर्ट 80, HTTPS के लिए 443)

10. वेबसाइट शुरू करें

11. साइट बनाने के लिए OK पर क्लिक करें

12. नई साइट पर राइट-क्लिक करें और Start चुनें

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

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

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

1. डैशबोर्ड को Tomcat में कॉपी करें
2. dashboard फ़ोल्डर को अपने Tomcat webapps डायरेक्टरी में कॉपी करें
3. आवश्यकता अनुसार नाम बदलें (उदा., digna)

4. उदाहरण: C:\Program Files\Apache Tomcat\webapps\digna

5. तैनाती सत्यापित करें

6. Tomcat प्रबंधन पेज (http://localhost:8080) को रिफ्रेश या रीलोड करें

7. आप "digna" (या आपने जो नाम चुना है) को सूचीबद्ध एप्लीकेशन्स में देखेंगे

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

9. अपना ब्राउज़र खोलें
10. http://localhost:8080/digna पर जाएँ
11. आपको digna डैशबोर्ड लॉगिन पेज दिखाई देना चाहिए

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

Windows सेवा क्यों उपयोग करें?¶

digna बैकएंड को Windows सेवा के रूप में चलाने से यह सुनिश्चित होता है कि यह: - सर्वर बूट होने पर स्वचालित रूप से शुरू हो जाए - बैकग्राउंड में खुले Command Prompt के बिना चले - क्रैश होने पर स्वतः पुनरारंभ हो सके - Windows Services के माध्यम से प्रबंधित किया जा सके

windows कमांड¶

सेवा का प्रबंधन स्वयं digna executable करता है, digna windows सबकमांड के माध्यम से। कोई बैच फ़ाइल चलाने की आवश्यकता नहीं है।

हर कमांड --name लेता है, ताकि गैर-डिफ़ॉल्ट नाम से रजिस्टर की गई सेवा को संबोधित किया जा सके। विकल्पों की पूरी सूची CLI संदर्भ में है।

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

1. Command Prompt को Administrator के रूप में खोलें
2. Command Prompt पर राइट-क्लिक करें

3. "Run as Administrator" चुनें

4. अपनी digna इंस्टॉलेशन डायरेक्टरी में नेविगेट करें

   cd C:\path\to\digna
   

5. सेवा रजिस्टर करें

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

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

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

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

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

digna windows start

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

digna windows stop

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

यदि आपको digna इंस्टॉलेशन को स्थानांतरित करने की आवश्यकता है:

1. वर्तमान सेवा को रोकें और अनरजिस्टर करें

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

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

3. पूरी digna इंस्टॉलेशन फ़ोल्डर को नई लोकेशन पर ले जाएँ

4. नई लोकेशन से सेवा को फिर से रजिस्टर करें

   cd C:\new\path\digna
   digna windows install
   

पहली बार उपयोग किए गए कोई भी --address, --port या --account मान दोहराएँ — पिछला रजिस्ट्रेशन हट चुका है।

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

   digna windows start
   

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

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

   cd C:\path\to\digna
   digna windows stop
   

2. सेवा अनरजिस्टर करें

   digna windows uninstall
   

अब digna सर्वर Windows सेवा के रूप में अनरजिस्टर हो चुका है।

नई रिलीज़ में उन्नयन¶

उन्नयन से पहले¶

पहले सभी डेटाबेस कनेक्शन जाँचें

रिलीज़ 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 रिपॉज़िटरी का बैकअप बनाना अनिवार्य है

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

उन्नयन प्रक्रिया¶

चरण 1: पुरानी सेवा को रोकें और अनरजिस्टर करें¶

यदि digna Windows सेवा के रूप में चल रहा है, तो उसे अपने वर्तमान इंस्टॉलेशन की बैच फ़ाइलों से रोकें — digna windows कमांड नई रिलीज़ का हिस्सा हैं और अभी उपलब्ध नहीं हैं:

cd C:\path\to\digna\bin
stop_service.bat

फिर सेवा को अनरजिस्टर करें, फिर से पुरानी बैच फ़ाइल से। रजिस्ट्रेशन पुराने executable और उसकी स्क्रिप्ट्स की ओर इंगित करता है, जिन दोनों को यह अपग्रेड बदल देता है, इसलिए इसका पुनः उपयोग नहीं किया जा सकता:

uninstall_service.bat

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

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

चरण 3: नई संस्करण निकालें और तैनात करें¶

1. नए digna इंस्टॉलेशन ZIP फ़ाइल को एक्सट्रैक्ट करें
2. नई digna executable और dashboard फ़ोल्डर को अपनी इंस्टॉलेशन डायरेक्टरी में कॉपी करें

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

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

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

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

digna config check

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

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

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

copy /Y C:\path\to\new\license.toml license.toml

digna license check

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

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

digna repo upgrade

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

चरण 9: सेवा रजिस्टर करें और शुरू करें¶

पुराना रजिस्ट्रेशन चरण 1 में हटा दिया गया था, इसलिए सेवा को फिर से रजिस्टर किया जाता है — इस बार digna executable के साथ, जिसमें कोई बैच फ़ाइल नहीं है:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

--address और --port को वही मान दें जिन पर पुरानी सेवा चलती थी, जब तक कि आप नए डिफ़ॉल्ट 127.0.0.1 और 8000 नहीं चाहते; ये रजिस्ट्रेशन में दर्ज होते हैं और अब config.toml से नहीं पढ़े जाते। यदि पुरानी सेवा किसी डोमेन खाते के अंतर्गत चलती थी, तो --account और --password जोड़ें। विकल्पों की पूरी सूची के लिए digna को Windows सेवा के रूप में चलाना देखें।

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

यदि आप IIS या Tomcat का उपयोग कर रहे हैं, तो संबंधित वेब सर्वर को पुनरारंभ करें।

चरण 10: उन्नयन सत्यापित करें¶

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