इंस्टॉल और अपडेट करना

Signal Lab, GitHub पर रिलीज़ होता है: हर रिलीज़ में Windows और Linux के लिए डेस्कटॉप ऐप, अलग से signallab कमांड लाइन और चेकसम की सूची होती है। इसके बजाय इसे सर्वर पर चलाकर ब्राउज़र से उपयोग करने के लिए देखें सर्वर।

क्या डाउनलोड करें

नवीनतम रिलीज़ खोलें और अपने सिस्टम की फ़ाइल चुनें। <version> रिलीज़ का संस्करण है, जैसे 1.0.0।

फ़ाइल	किसके लिए
Signal.Lab_<version>_x64-setup.exe	Windows 10 और 11, x64 — वह सेटअप जो ज़्यादातर लोगों को चाहिए
Signal.Lab_<version>_x64_en-US.msi	Windows, IT द्वारा डिप्लॉयमेंट (Intune, Group Policy): हर उपयोगकर्ता के लिए इंस्टॉल करता है
Signal.Lab_<version>_amd64.deb	Linux x86_64: Debian, Ubuntu और उनसे जुड़े डिस्ट्रीब्यूशन
Signal.Lab-<version>-1.x86_64.rpm	Linux x86_64: Fedora, RHEL, openSUSE और उनसे जुड़े डिस्ट्रीब्यूशन
Signal.Lab_<version>_amd64.AppImage	Linux x86_64, कोई भी डिस्ट्रीब्यूशन, बिना इंस्टॉल किए
signallab-<version>-windows-x64.zip	केवल कमांड लाइन, Windows के लिए
signallab-<version>-linux-x64.tar.gz	केवल कमांड लाइन, Linux के लिए
SHA256SUMS.txt	ऊपर की हर फ़ाइल का SHA-256 चेकसम

इनके पास रखी .sig फ़ाइलें और latest.json ऐप के अपने अपडेटर के लिए हैं; आपको इनकी ज़रूरत नहीं है।

Windows

Signal Lab, Windows 10 और 11, x64 पर चलता है। यह WebView2 रनटाइम का उपयोग करता है, जो दोनों में शामिल है।

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

1. Signal.Lab_<version>_x64-setup.exe चलाएँ।
2. अगर Windows SmartScreen कहे कि उसने आपके PC को सुरक्षित रखा, तो अधिक जानकारी चुनें, फिर फिर भी चलाएँ (नीचे SmartScreen देखें)।
3. सेटअप की भाषा चुनें। यह वही 11 भाषाएँ देता है जो ऐप में हैं।
4. चुनें कि यह किसके लिए है:
   • केवल आपके लिए: यह %LOCALAPPDATA%\Signal Lab में इंस्टॉल होता है और इसे व्यवस्थापक अधिकारों की ज़रूरत नहीं होती।
   • इस कंप्यूटर के हर उपयोगकर्ता के लिए: यह C:\Program Files\Signal Lab में इंस्टॉल होता है और व्यवस्थापक अधिकार माँगता है।
5. फ़ोल्डर की पुष्टि करें और इंस्टॉल करें।
6. अंतिम पेज पर Signal Lab तुरंत शुरू करने और डेस्कटॉप शॉर्टकट बनाने का विकल्प मिलता है।

इंस्टॉल किए गए संस्करण पर नए संस्करण का सेटअप चलाने से वही इंस्टॉलेशन अपग्रेड हो जाता है।

सेटअप क्या जोड़ता है

ऐप के अलावा सेटअप दो चीज़ें और जोड़ता है, और अनइंस्टॉलर दोनों को हटाता है:

• कमांड लाइन। signallab.exe ऐप के पास रखा जाता है और उसका फ़ोल्डर PATH में जोड़ा जाता है — केवल आपके लिए इंस्टॉल में आपका अपना PATH, सबके लिए इंस्टॉल में कंप्यूटर का — ताकि इसके बाद खोले गए हर टर्मिनल में signallab काम करे। देखें कमांड लाइन।
• फ़ायरवॉल नियम, केवल सबके लिए इंस्टॉल में। Windows Defender Firewall दूसरी मशीनों को किसी प्रोग्राम तक तभी पहुँचने देता है जब कोई नियम इसकी अनुमति दे, और प्रोग्राम के पहली बार सुनने पर स्क्रीन के सामने बैठे व्यक्ति से पूछता है; वहाँ रद्द करें दबाने पर दूसरी मशीनें जो भी भेजती हैं, वह चुपचाप ड्रॉप हो जाता है। सबके लिए इंस्टॉल, जिसके पास व्यवस्थापक अधिकार होते हैं, निजी और डोमेन नेटवर्क पर signal-lab.exe (ऐप) और signallab.exe (कमांड लाइन) के लिए एक-एक इनबाउंड अनुमति नियम जोड़ता है। केवल आपके लिए इंस्टॉल फ़ायरवॉल नहीं बदल सकता: जब पहली बार कोई चीज़ सुनती है, तो ऐप Windows के अपने व्यवस्थापक प्रॉम्प्ट के साथ यह करने का विकल्प देता है — देखें फ़ायरवॉल सूचना।

इसी कंप्यूटर के भीतर का ट्रैफ़िक (127.0.0.1) कभी फ़िल्टर नहीं होता, इसलिए लूपबैक पर आप जो भी करते हैं, वह बिना किसी नियम के काम करता है।

बिना निगरानी के इंस्टॉल

सेटअप अपनी कमांड लाइन पर ये स्विच लेता है:

स्विच	यह क्या करता है
/S	चुपचाप इंस्टॉल करता है, कुछ नहीं पूछता।
/P	प्रोग्रेस बार के साथ, बिना सवालों के इंस्टॉल करता है।
/ALLUSERS	सबके लिए इंस्टॉल करता है (व्यवस्थापक प्रॉम्प्ट चाहिए)।
/CURRENTUSER	केवल वर्तमान उपयोगकर्ता के लिए इंस्टॉल करता है।
/NS	कोई शॉर्टकट नहीं बनाता।
/D=C:\Tools\Signal Lab	इस फ़ोल्डर में इंस्टॉल करता है। यह सबसे अंत में आना चाहिए और उद्धरण चिह्नों में नहीं होता।
/NOPATH	PATH को नहीं छूता: signallab इंस्टॉल होता है, पर PATH में नहीं।
/NOFIREWALL	कोई फ़ायरवॉल नियम नहीं जोड़ता।

उदाहरण के लिए, व्यवस्थापक प्रॉम्प्ट से, सबके लिए, बिना फ़ायरवॉल नियमों के, चुपचाप इंस्टॉल:

.\Signal.Lab_1.0.0_x64-setup.exe /S /ALLUSERS /NOFIREWALL

MSI

Signal.Lab_<version>_x64_en-US.msi IT द्वारा डिप्लॉयमेंट के लिए है। यह हर उपयोगकर्ता के लिए इंस्टॉल होता है और signallab.exe को ऐप के पास तथा उस फ़ोल्डर को कंप्यूटर के PATH में रखता है, पर कोई फ़ायरवॉल नियम नहीं जोड़ता: यह डिप्लॉय करने वाले पर छोड़ा गया है (उदाहरण के लिए, Group Policy)। ऐप पहली बार सुनने पर फिर भी नियम का विकल्प देता है। इसे चुपचाप इंस्टॉल करने के लिए:

msiexec /i "Signal.Lab_1.0.0_x64_en-US.msi" /qn

SmartScreen

इंस्टॉलर अभी कोड-साइन नहीं किए गए हैं, इसलिए Windows SmartScreen उनके प्रकाशक को नहीं पहचानता और चेतावनी के साथ सेटअप रोक सकता है। अधिक जानकारी चुनें, जाँच लें कि फ़ाइल वही है जो आपने रिलीज़ पेज से डाउनलोड की थी, फिर फिर भी चलाएँ चुनें। यह पक्का करने के लिए कि फ़ाइल बदली नहीं है, पहले उसे SHA256SUMS.txt से मिलाएँ।

ऐप के अपने अपडेट साइन किए जाते हैं और अलग से जाँचे जाते हैं; देखें अपडेट।

डाउनलोड की जाँच

SHA256SUMS.txt में रिलीज़ की हर फ़ाइल का SHA-256 चेकसम है, हर पंक्ति में एक, उसके बाद फ़ाइल का नाम। इसे फ़ाइल के पास डाउनलोड करें और मिलाएँ।

Windows पर, PowerShell में:

Get-FileHash .\Signal.Lab_1.0.0_x64-setup.exe -Algorithm SHA256
Select-String "Signal.Lab_1.0.0_x64-setup.exe" .\SHA256SUMS.txt

दोनों हैश एक जैसे होने चाहिए (Get-FileHash इसे बड़े अक्षरों में छापता है; अक्षरों के छोटे-बड़े होने से फ़र्क नहीं पड़ता)।

Linux पर, उस फ़ोल्डर में जिसमें दोनों फ़ाइलें हैं:

sha256sum --check --ignore-missing SHA256SUMS.txt

यह मिली हुई हर फ़ाइल के बाद OK छापता है। इसके अलावा कुछ भी छपे, तो डाउनलोड रिलीज़ की गई फ़ाइल नहीं है: इसे फिर से डाउनलोड करें।

Linux

Linux ऐप x86_64 के लिए (Ubuntu 22.04 पर) बनाया गया है और उसे WebKitGTK 4.1 चाहिए, वह वेब व्यू जिससे वह अपनी विंडो बनाता है। Arm प्रोसेसर के लिए कोई बिल्ड नहीं है; Arm मशीन पर इसके बजाय सर्वर चलाएँ।

.deb पैकेज

sudo apt install ./Signal.Lab_1.0.0_amd64.deb

apt पैकेज की ज़रूरत की चीज़ें भी साथ में इंस्टॉल करता है। पैकेज कमांड लाइन को भी /usr/bin/signallab में रखता है।

.rpm पैकेज

sudo dnf install ./Signal.Lab-1.0.0-1.x86_64.rpm

openSUSE पर उसी फ़ाइल के साथ sudo zypper install उपयोग करें। .deb की तरह यह पैकेज भी कमांड लाइन को /usr/bin/signallab में रखता है।

AppImage

AppImage बिना इंस्टॉल किए चलता है:

chmod +x Signal.Lab_1.0.0_amd64.AppImage
./Signal.Lab_1.0.0_amd64.AppImage

इसमें signallab कमांड लाइन शामिल नहीं है; ज़रूरत हो, तो उसे कमांड लाइन के आर्काइव से लें।

Linux पर फ़ायरवॉल

Linux पर ऐप कोई फ़ायरवॉल सूचना नहीं दिखाता: ufw और firewalld पोर्ट के हिसाब से काम करते हैं, प्रोग्राम के हिसाब से नहीं। अगर इनमें से कोई चालू है और दूसरी मशीनों को किसी मॉनिटर, लिसनर, एमुलेटर या रिले तक पहुँचना है, तो वहाँ उसका पोर्ट खोलें, उदाहरण के लिए:

sudo ufw allow 9000/udp

लूपबैक ट्रैफ़िक पर इसका असर नहीं पड़ता।

अलग से कमांड लाइन

डेस्कटॉप इंस्टॉलर signallab को साथ लाते हैं। ऐप के बिना किसी मशीन के लिए — बिल्ड एजेंट, सर्वर, लैब PC — हर रिलीज़ में कमांड लाइन अलग से भी होती है:

• signallab-<version>-windows-x64.zip में signallab.exe और लाइसेंस है।
• signallab-<version>-linux-x64.tar.gz में signallab और लाइसेंस है।

इसे अपने PATH के किसी फ़ोल्डर में खोलें। Linux पर:

tar -xzf signallab-1.0.0-linux-x64.tar.gz signallab
sudo install signallab /usr/local/bin/
signallab version

सर्वर की Docker इमेज में भी यह शामिल है। इसका उपयोग कैसे करें: कमांड लाइन।

अपडेट

डेस्कटॉप ऐप

डेस्कटॉप ऐप केवल प्रकाशित रिलीज़ से, और केवल आपके कहने पर, ख़ुद को अपडेट करता है।

• यह दिन में एक बार देखता है। दिन में एक बार जाँचें पर टिक होने पर (डिफ़ॉल्ट रूप से होता है) ऐप शुरू होने के कुछ ही देर बाद नई रिलीज़ खोजता है, अगर पिछली बार देखे हुए एक दिन या उससे ज़्यादा हो गया हो, और चलते रहने के दौरान हर बार एक और दिन बीतने पर फिर देखता है। इसे अपने आप देखने से रोकने के लिए “Signal Lab के बारे में” में इसका टिक हटाएँ।
• आप अभी देख सकते हैं। “Signal Lab के बारे में” खोलें — हेडर में ? — और अपडेट के नीचे अपडेट जाँचें दबाएँ।
• जाँच क्या भेजती है। यह स्टूडियो की अपडेट सेवा (hub.proanima.net) से पूछती है कि इस इंस्टॉलेशन को कौन-सी रिलीज़ मिलनी चाहिए, और GitHub की नवीनतम रिलीज़ तक तभी जाती है जब उस सेवा तक न पहुँचा जा सके। रिक्वेस्ट में ऐप का संस्करण, सिस्टम और प्रोसेसर का प्रकार, और इस इंस्टॉलेशन के लिए बनाई गई एक रैंडम संख्या होती है, जिससे कोई नई रिलीज़ पहले कुछ ही इंस्टॉलेशन तक पहुँच सकती है। ऐसा कुछ नहीं भेजा जाता जिससे आपकी या इस कंप्यूटर की पहचान हो।
• रिलीज़ मिलने पर कंसोल इसकी सूचना देता है और हेडर में एक अपडेट बटन दिखता है, जो “Signal Lab के बारे में” खोलता है। वहाँ नया क्या है रिलीज़ नोट दिखाता है।
• आपके क्लिक किए बिना कुछ इंस्टॉल नहीं होता। इंस्टॉल और रीस्टार्ट करें दबाएँ (जॉब चल रहे हों, तो बटन बताता है कि वह उन्हें रोक देगा)। Signal Lab जो कुछ भी अभी सहेजा जाना बाकी है उसे सहेजता है, हर चल रहा जॉब रोकता है, अपडेट डाउनलोड करता है और उसके हस्ताक्षर को ऐप में बनी कुंजी से जाँचता है — जो अपडेट रिलीज़ प्रक्रिया द्वारा साइन नहीं किया गया, उसे अस्वीकार कर दिया जाता है — फिर उसे इंस्टॉल करता है और नए संस्करण के रूप में फिर से शुरू होता है।

Windows पर अपडेट बिना सवालों के सेटअप चलाता है और आपका फ़ोल्डर, PATH और फ़ायरवॉल नियम बनाए रखता है। Linux पर यह AppImage को बदल देता है, या नया .deb या .rpm पैकेज इंस्टॉल करता है — पैकेज के लिए सिस्टम पहले आपका पासवर्ड माँगता है।

प्री-रिलीज़ और ड्राफ़्ट कभी नहीं दिए जाते। किसी मशीन के हर इंस्टॉलेशन को अपने आप देखने से रोकने के लिए — जैसे, जब IT ख़ुद अपडेट डिप्लॉय करता हो — एनवायरनमेंट वैरिएबल SIGNALLAB_NO_UPDATE_CHECK को कोई भी मान दें; दबाने पर अपडेट जाँचें तब भी काम करता है। डेवलपमेंट बिल्ड कभी अपने आप नहीं देखते।

सर्वर

सर्वर, और ब्राउज़र में उससे खुलने वाला पेज, अपनी Docker इमेज के साथ अपडेट होता है, कभी अपने आप नहीं: “Signal Lab के बारे में” यही बताता है। इसे कैसे अपडेट करें: सर्वर।

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

Windows। सेटिंग्स → ऐप्स → इंस्टॉल किए गए ऐप्स खोलें, Signal Lab ढूँढें और अनइंस्टॉल करें चुनें। सेटअप का अनइंस्टॉलर signallab.exe को PATH से हटाता है और, जब यह व्यवस्थापक अधिकारों के साथ चलता है (जैसा सबके लिए इंस्टॉल में होता है), ऐप और कमांड लाइन के हर इनबाउंड फ़ायरवॉल नियम को हटाता है, उनके भी जो Windows के प्रॉम्प्ट ने बनाए थे। यह ऐप्लिकेशन का डेटा भी हटाने के लिए एक बॉक्स देता है: यह ऐप की अपनी सेटिंग्स हैं — भाषा, पैनल के आकार, वह स्क्रीन जिस पर आप थे, स्क्रीन में पिछली बार टाइप किए गए मान — आपकी फ़ाइलें नहीं। MSI इंस्टॉलेशन भी इसी तरह हटता है; यह अपनी PATH प्रविष्टि साथ ले जाता है और फ़ायरवॉल को डिप्लॉय करने वाले पर छोड़ देता है।

Linux। पैकेज को उसी पैकेज मैनेजर से हटाएँ जिससे आपने उसे इंस्टॉल किया था, या AppImage फ़ाइल डिलीट करें।

दोनों में से कोई भी आपके डेटा फ़ोल्डर को नहीं छूता: प्रयोग, सिग्नल और एमुलेटर लाइब्रेरी, रन रिपोर्ट और निर्यात आपके होम फ़ोल्डर के Documents/SignalLab में रहते हैं। अगर आप इन्हें हटाना चाहते हैं, तो वह फ़ोल्डर ख़ुद डिलीट करें।

आपका डेटा कहाँ रहता है

आप जो कुछ भी बनाते हैं, वह एक ही फ़ोल्डर, आपके होम फ़ोल्डर के Documents/SignalLab, में सादी फ़ाइलों के रूप में रखा जाता है, Windows और Linux दोनों पर: वर्तमान प्रयोग, सिग्नल लाइब्रेरी, एमुलेटर लाइब्रेरी, रन रिपोर्ट, निर्यात और इंस्पेक्टर कैप्चर। हर फ़ाइल और उसका फ़ॉर्मेट फ़ाइलें और फ़ोल्डर में बताया गया है।

इसे सर्वर के रूप में चलाना

Signal Lab को ब्राउज़र से उपयोग करने के लिए — उपकरणों के पास किसी लैब PC पर, Linux बॉक्स पर, Docker में — देखें सर्वर। Docker वाली Linux मशीन पर एक ही कमांड इसे इंस्टॉल करके शुरू कर देती है।