ऑरेंजHRM | TurnKey Linux

OrangeHRM अपग्रेड

मान्यताओं और सीमाओं

OrangeHRM and TurnKey बेस OS

इस डॉक्टर ने स्पष्ट रूप से ऑरेंज एचआरएम v4.x (TurnKey v17.x) और/या ऑरेंज एचआरएम v5.x (TurnKey v18.x) को नवीनतम स्थिर ऑरेंज एचआरएम रिलीज (लेखन के समय v5.7) में अपग्रेड किया है। यह करता है NOT अंतर्निहित TurnKey/Debian OS को नवीनतम रिलीज़ में अपग्रेड करना।

TurnKey v17.x Debian 11/Bullseye पर आधारित है। वर्तमान में बुल्सेये "LTS" (लंबी अवधि का समर्थन) में हैं और कम से कम जब तक सुरक्षा अद्यतन प्राप्त करेंगे तब तक सुरक्षा अद्यतन प्राप्त होगा। अगस्त 31, 2026TurnKey v18.x Debian 12 / बुकवर्म पर आधारित है। कम से कम तक बुकवर्म समर्थित होगा। जून 30, 2028.

यह भी माना जाता है:

TKLBAM सक्षम है (या आप इसे सक्षम) - ध्यान दें कि यह आवश्यक नहीं है, लेकिन अत्यधिक अनुशंसित है।
आपके सर्वर में अपग्रेड के लिए पर्याप्त मुफ्त स्पेस है - 2GB की सिफारिश की जाती है लेकिन अधिक हमेशा बेहतर होता है।

यह डॉक अधिकांश प्रक्रिया के लिए टर्मिनल कमांड का उपयोग करता है। Webmin के माध्यम से कई कदम संभव हो सकते हैं लेकिन टर्मिनल कमांड संक्षिप्त हैं और इसे कॉपी / पेस्ट किया जा सकता है ताकि इसका पालन करना काफी आसान हो। किसी भी कदम जहां आप जानते हैं कि Webmin के माध्यम से उसी परिणाम को कैसे प्राप्त किया जाए, इसके बजाय इसका उपयोग करने के लिए स्वतंत्र महसूस किया।

अपने TurnKey सर्वर के CLI तक पहुंच "SSH" (सिक्योर शेल) के माध्यम से अनुशंसित है। हाल ही में विंडोज 11 रिलीज़, मैक OSX और सभी Linux डेस्कटॉप स्वाद सभी ओपनएसएसएच क्लाइंट के साथ पहले से स्थापित किया गया है लेकिन कई वैकल्पिक SSH क्लाइंट भी हैं जो अच्छी तरह से काम करते हैं।

वैकल्पिक रूप से TurnKey v17.x पर आप अपने सर्वर के "वेबशेल" का उपयोग अपने ब्राउज़र के माध्यम से कर सकते हैं; https://www.e.g. https://your.domain.com:12320. TurnKey v18.x पर आप Webmin "proper" इंटरैक्टिव टर्मिनल मॉड्यूल (v18.x में WebShell शामिल नहीं है) का उपयोग कर सकते हैं।

DO NOT TurnKey v17.x Webmin टर्मिनल का उपयोग करता है! यह एक वास्तविक इंटरैक्टिव टर्मिनल नहीं है और समस्याओं का कारण बन जाएगा।

आम तौर पर एक स्थानीय SSH क्लाइंट को बेहतर उपयोगकर्ता अनुभव (जैसे) दिया जाएगा। प्रतिलिपि / पेस्ट को विश्वसनीय रूप से काम करना चाहिए) लेकिन v17.x के Webshell या v18.x के Webmin इंटरैक्टिव टर्मिनल मॉड्यूल को ठीक काम करना चाहिए।

SSH सत्र शुरू करने के लिए:

ssh root@DOMAIN_OR_PUBLIC_IP

यदि आप पासवर्ड के बजाय प्रमाणीकरण कुंजी का उपयोग कर रहे हैं, तो आपको स्पष्ट रूप से अपने स्थानीय सिस्टम पर निजी कुंजी के रास्ते को शामिल करना होगा:

# Linux/OSX
ssh -i ~/path/to/my_private_key root@DOMAIN_OR_PUBLIC_IP

# Windows
C:\Users\ME\path\to\my_private_key root@DOMAIN_OR_PUBLIC_IP

AWS मार्केटप्लेस उपयोगकर्ताओं के लिए नोट

AWS मार्केटप्लेस उदाहरणों में डिफ़ॉल्ट रूप से 'रूट' खाता अक्षम होता है। तो या तो जड़ को सक्षम करें या फिर 'admin' के रूप में लॉग इन करें और फिर इस तरह जड़ बन जाएं:

sudo su -

पहला कदम - तैयारी

ऑरेंज एचआरएम अपग्रेड शुरू करने से पहले यह सुनिश्चित करें कि आपके पास वर्तमान बैकअप और पर्याप्त मुफ्त स्थान है। मैं यह भी सलाह देता हूं कि आप सभी सिस्टम पैकेज को अपग्रेड कर सकें और अपग्रेड शुरू करने से पहले सिस्टम को पुनः आरंभ करें।

बैकअप

मैं एक "स्नैपशॉट" और "प्रोपर" बैकअप दोनों बनाने की सलाह देता हूं। एक स्नैपशॉट तकनीकी रूप से बैकअप नहीं है, लेकिन एक स्नैपशॉट लोड करना वास्तव में वापस पाने का एक त्वरित और आसान तरीका है जहां आप अभी जरूरत पड़ने पर हैं।

यदि आपका सर्वर TurnKey Hub के माध्यम से चल रहा है, तो आप हब के माध्यम से स्नैपशॉट ट्रिगर कर सकते हैं "सर्वर" पेजकृपया ध्यान दें कि यह पूरा करने के लिए कुछ समय ले सकता है। अन्य वर्चुअलाइजेशन / क्लाउड प्लेटफॉर्म में भी इस कार्यक्षमता को होना चाहिए - यदि आप सुनिश्चित नहीं हैं तो प्रासंगिक डॉक्स से परामर्श करें। बेयर मेटल सर्वर एक टूल का उपयोग कर सकते हैं जैसे कि कोलोंज़िला.

आप TKLBAM का उपयोग कर रहे हैं, मैन्युअल रूप से अपने सर्वर का एक पूर्ण TKLBAM बैकअप ट्रिगर करते हैं। आप या तो Webmin के माध्यम से या टर्मिनल के माध्यम से ऐसा कर सकते हैं:

tklbam-backup --full-backup now

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

मुफ्त अंतरिक्ष की जाँच करने के लिए:

df -h /

उदाहरण आउटपुट ( 10GB रूट वॉल्यूम के साथ हब सर्वर):

Filesystem                Size   Used Avail Use% Mounted on
/dev/xvda                 10.0G  2.1G  8.0G  21% /

"Avail" कॉलम (8.0G उपरोक्त उदाहरण में) को देखें। मैं कम से कम 1GB नंगे न्यूनतम मुफ्त स्थान की सिफारिश करता हूं, जो कि कम से कम 2GB है। यदि आपके पास पर्याप्त नहीं है, तो पहले नीचे की तरह साफ करें। कृपया do NOT केवल अंधा ढंग से दूसरे (ऑटोरिमोव) कमांड पर 'y' दर्ज करें:

apt clean
apt autoremove

'ऑटोरिमोव' कमांड को केवल कुछ पैकेजों की सूची होनी चाहिए, जिनमें शायद पुराने कर्नेल (पैकेज जो linux-image) से शुरू होते हैं। यदि यह बड़ी संख्या में पैकेज सूचीबद्ध करता है या किसी भी कोर पैकेज को सूचीबद्ध करता है तो कृपया अपने कार्य की जांच करना सुनिश्चित करें और यदि कोई भी उठा हुआ चिंता आप मैन्युअल रूप से उन लोगों को हटा सकते हैं जो दिखाई देते हैं 'apt हटाने PKG1 PKG2 ...' का उपयोग करके हटाने के लिए सुरक्षित है। यदि आपके पास चिंता है और पर्याप्त मुफ्त स्थान है, तो अभी इस कदम को छोड़ दें।

OS सॉफ्टवेयर को अपग्रेड करें (वैकल्पिक)

सिस्टम सॉफ्टवेयर को नवीनतम पैकेज्ड संस्करणों में अद्यतन करने के लिए:

apt update
apt upgrade

यदि आप इस कदम को चलाते हैं, तो मैं उपरोक्त उपयुक्त सफाई आदेशों को फिर से चलाने की सलाह देता हूं, अपने सर्वर को दोहराने और मुक्त स्थान की जाँच करने की सलाह देता हूं।

मैनुअल स्थानीय बैकअप (वैकल्पिक)

एक स्नैपशॉट और TKLBAM बैकअप दोनों के साथ, बनाना दूसरा बैकअप को अतिकुशलता की तरह लग सकता है। हालांकि मैं तर्क दूंगा कि अतिरेक की कई परतें हमेशा वांछनीय होती हैं। फिर अगर कुछ गलत हो जाता है तो आपके पास कार्यक्षमता को बहाल करने के लिए कई रिकवरी विकल्प और रास्ते हैं। भले ही, यह कदम पूरी तरह से वैकल्पिक है और एक स्नैपशॉट और एक पूर्ण TKLBAM बैकअप पर्याप्त वसूली विकल्प प्रदान करता है।

मैनुअल डीबी डंप

mysqldump orangehrm > orangehrm_db.sql.orig

ऑरेंजHRM v4.x को v4.10.1 में अपग्रेड करें

नवीनतम OrangeHRM (Sorbital) v5.7 है। लेकिन आपको v4.10.1 (v4.x) को अपग्रेड करने के लिए v5.x (v4.x) को चलाना होगा। यदि आप पहले से ही v4.10.1 चल रहे हैं या बाद में, तो कृपया इस कदम को छोड़ दें।

OrangeHRM प्रदान करता है अद्यतन प्रलेखन लेकिन मैं यहां एक विस्तृत और TurnKey विशिष्ट चरण-दर-चरण प्रदान करूंगा।

डाउनलोड v4.10.1

wget https://sourceforge.net/projects/orangehrm/files/stable/4.10.1/orangehrm-4.10.1.zip

मौजूदा इंस्टॉल करें

mv /var/www/orangehrm /var/www/orangehrm.orig

Unpack नया संस्करण

unzip orangehrm-4.10.1.zip
mv orangehrm-4.10.1 /var/www/orangehrm

वेबसर्वर को आवश्यक OrangeHRM फ़ाइलों तक पहुंच प्रदान करें:

chown -R www-data:www-data /var/www/orangehrm/lib/{confs,logs}
chown -R www-data:www-data /var/www/orangehrm/symfony/{config,apps/orangehrm,cache,log}

मौजूदा DB 'orangehrm' उपयोगकर्ता पासवर्ड प्राप्त करें (पुराने विन्यास फ़ाइल से):

grep -m 1 password /var/www/orangehrm.orig/symfony/config/databases.yml

PHP ज़िप एक्सटेंशन को स्थापित और सक्षम करें:

apt install --yes php-zip
systemctl restart apache2

अपने वेब ब्राउज़र में अपग्रेड पेज लोड करें

अपने वेब ब्राउज़र में खोलें और अपने OrangeHRM साइट डोमेन के "upgrade" पृष्ठ पर ब्राउज़ करें:

https://DOMAIN_OR_PUBLIC_IP/upgrader/web

E.g.:

https://orangehrm.domain.com/upgrader/web

Unless you want to do a “clean” install DO NOT just load your domain without the ‘/upgrader/web’ URL. Otherwise it will overwrite your existing data.

DB विवरण दर्ज करें

Host*:          127.0.0.1
Port:           3306
Username*       orangehrm
Password        <password from the above 'grep' command>
Database Name:  orangehrm

फिर "प्रोसेस" बटन पर क्लिक करें।

सिस्टम चेक

सब कुछ ठीक होना चाहिए, लेकिन डबल चेक कि प्रत्येक लाइन में सिस्टम चेक पेज पर एक ग्रीन "OK" होता है।

सब को अच्छी तरह से मानते हुए, "प्रोसेस" बटन पर क्लिक करें।

वर्तमान OrangeHRM संस्करण का चयन करें

ड्रॉपडाउन से, वर्तमान / पुराने OrangeHRM संस्करण का चयन करें। जब तक आप पहले से ही अपग्रेड कर चुके हैं, TurnKey v17.1 को OrangeHRM संस्करण '4.9' होना चाहिए। भले ही आप इस आदेश के साथ वर्तमान / पुराने संस्करण की पुष्टि कर सकते हैं:

grep -m 1 'OrangeHRM ver' /var/www/orangehrm.orig/CHANGELOG.TXT

डिफ़ॉल्ट रूप से यह वापस होना चाहिए:

New & Changed Features for OrangeHRM ver 4.9

प्रासंगिक संस्करण का चयन करें और "प्रोसेस" बटन पर क्लिक करें।

मैनुअल परिवर्तन लागू करें - यदि आवश्यक हो

अगले पृष्ठ में किसी भी मैनुअल चरणों/परिवर्तन को प्रदर्शित किया जाएगा जिसे आपको करने की आवश्यकता हो सकती है। मेरे परीक्षण के दौरान, डेटा एन्क्रिप्शन पर लागू एकमात्र अतिरिक्त मैनुअल चरण।

यदि आपने डेटा एन्क्रिप्शन सक्षम किया है, तो अपने पुराने OrangeHRM निर्देशिका से क्रिप्टोग्राफिक कुंजी की प्रतिलिपि बनाएँ। I.e.:

cp /var/www/orangehrm.orig/lib/confs/cryptokeys/key.ohrm /var/www/orangehrm/lib/confs/cryptokeys/

एक बार जब आपने कोई अतिरिक्त मैनुअल कदम किया है, तो "प्रोसेस" बटन पर क्लिक करें।

डेटाबेस अद्यतन

अगले पृष्ठ वास्तव में डेटाबेस उन्नयन करेगा। जैसा कि उल्लेखित है, अपग्रेड थोड़ी देर लग सकता है और यह VERY महत्वपूर्ण है कि आप उस पृष्ठ को बंद नहीं करते हैं या फिर लोड नहीं करते हैं जब तक कि प्रगति 100% तक नहीं पहुंचती है और "स्टार्ट" बटन बदल जाता है। "प्रोसेस" बटन।

"स्टार्ट" बटन पर क्लिक करें और एक बार यह पूरा हो गया है, "प्रोसेस" बटन पर क्लिक करें।

नई विन्यास फाइलें बनाएं

अगले पृष्ठ नए विन्यास फ़ाइलों को उत्पन्न करेगा। इस कदम को लंबे समय तक नहीं लेना चाहिए बल्कि पिछले डेटाबेस अपग्रेड पेज के अनुसार, DO NOT उस पृष्ठ को बंद या फिर से लोड करना चाहिए।

उन्नयन को अंतिम रूप देना

आपको "Congratulations!" नामक एक पृष्ठ के साथ बधाई दी जानी चाहिए, यह ध्यान दें कि आप अब OrangeHRM v4.10.1 चल रहे हैं।

जैसा कि उस पृष्ठ पर उल्लेख किया गया है, यह सुनिश्चित करें कि कोई भी मैनुअल चरण पूरा हो गया है (पिछले "ऐप्ली मैनुअल चेंज" चरण के भीतर संभाला गया है, लेकिन आप उन्हें डबल से चेक कर सकते हैं अपने OrangeHRM डायरेक्टरी के भीतर नोटेड फाइल:

cat /var/www/orangehrm/upgrader/log/notes.log

"प्रोसेस" बटन पर क्लिक करें।

अपने उन्नत OrangeHRM डेटा को मान्य करें

पिछले चरण के बाद आप लॉग इन पृष्ठ पर वापस भेज दिए जाएंगे। अपने व्यवस्थापक उपयोगकर्ता और पासवर्ड का उपयोग करके लॉग इन करें।

जैसा कि अंतिम "Congratulations!" पेज पर उल्लेख किया गया था: > [...] डेटा सत्यापन का पूरा दौर यह देखने के लिए कि पिछले> संस्करण से डेटा ठीक से आयात किया गया है।

विशेष रूप से जांचें कि ये पृष्ठ उपलब्ध हैं और आपके डेटा को शामिल करते हैं: - व्यवस्थापक - PIM - छोड़ें

ऑरेंजHRM v4.10.1 को v5.7 में अपग्रेड करें

V5.7 में अपग्रेड करने के लिए कई कदम पिछले उन्नयन के समान हैं। ये कदम बाद में v5.x अद्यतन पर भी लागू होंगे। हालांकि OrangeHRM v5.x में एक CLI इंस्टॉलर / अपग्रेडर शामिल है जो इन निर्देशों को कवर करेगा।

v4.10.1 उन्नयन के अनुसार, OrangeHRM प्रदान करता है अद्यतन प्रलेखन लेकिन यह केवल वेबयूआई अपग्रेड को कवर करता है। ये निर्देश TurnKey विशिष्ट नोट्स को CLI टूल का उपयोग करके प्रदान करेंगे।

तैयारी

डबल चेक फ्री स्पेस और प्रारंभिक OrangeHRM v4 अपग्रेड के अनुसार एक नया OS बैकअप और स्नैपशॉट बनाती है।

इसके अलावा एक मैनुअल डेटाबेस स्थानीय बैकअप बनाएँ:

mysqldump orangehrm > orangehrm_v4.10.1_db.sql

डाउनलोड v5.7

wget https://sourceforge.net/projects/orangehrm/files/stable/5.7/orangehrm-5.7.zip

मौजूदा इंस्टॉल करें

mv /var/www/orangehrm /var/www/orangehrm-4.10.1

Unpack नया संस्करण

unzip -o orangehrm-5.7.zip
mv orangehrm-5.7 /var/www/orangehrm

CLI के माध्यम से स्थापित अपग्रेड करें

CLI अपग्रेड बहुत तेज और आसान IMO है।

सुनिश्चित करें कि आपके पास आपका मौजूदा डेटाबेस पासवर्ड है:

grep -m 1 password /var/www/orangehrm.*/symfony/config/databases.yml

फिर नई OrangeHRM निर्देशिका में परिवर्तन (जिसे आपने ऊपर डाउनलोड और अनपैक किया) और CLI टूल चलाते हैं। ध्यान दें कि आपको 'की जगह' की आवश्यकता होगी।अपने वास्तविक डीबी पासवर्ड (ऊपर से कमांड से) के साथ, यदि आप '4.10.1' के अलावा एक संस्करण से अपग्रेड कर रहे हैं, तो भी "-वर्तमान संस्करण" का मूल्य बदल सकते हैं।

cd /var/www/orangehrm
php installer/console upgrade:run \
    --dbHost=127.0.0.1 \
    --dbPort=3306 \
    --dbName=orangehrm \
    --dbUser=orangehrm \
    --dbUserPassword=<db password> \
    --currentVersion=4.10.1

वातावरण सत्यापित करें

उपरोक्त आदेश में पाठ का उचित बिट प्रस्तुत किया जाएगा। इसमें से अधिकांश को सुरक्षित रूप से अनदेखा किया जा सकता है, लेकिन कृपया डबल चेक करें 'सिस्टम चेक' अनुभाग। सभी मूल्यों को हरा होना चाहिए (या यदि उपयोग नहीं किया जाता है तो पीला)।

यदि सिस्टम की कोई जांच लाल हो जाती है, तो आपको "n" का जवाब देने की आवश्यकता होगी और इससे पहले आपको अपग्रेड कमांड को फिर से शुरू करने की आवश्यकता होगी।

यह मानते हुए कि सभी सिस्टम चेक ok हैं, हिट एंटर ("yes" डिफ़ॉल्ट है)।

अपग्रेड थोड़ी देर लग सकता है, लेकिन अंततः यह बिना किसी त्रुटि संदेश के पूरा और निकास करेगा।

अपने उन्नत OrangeHRM डेटा को मान्य करें

एक बार अपग्रेड स्क्रिप्ट पूरा हो जाने पर, अपने वेब ब्राउज़र के माध्यम से अपने OrangeHRM उदाहरण में लॉग इन करें और यह सत्यापित करें कि आपका सभी डेटा वहां है और सब कुछ ऐसा होना चाहिए।

ऐसा मानते हुए, बधाई - अब आप नवीनतम OrangeHRM चल रहे हैं! :)