Cenaly-ის აპლიკაციების დაყენება Ubuntu-ზე

ბიზნესის სამუშაო ადგილები ხშირად Linux-ზე მუშაობს: სალარო დახლთან, ეკრანი სამზარეულოში ან შეკვეთების აწყობის ზონაში, ოპერატორის კომპიუტერი ყურსასმენით. მათთვის Cenaly-ს აქვს მშობლიური პროგრამები Ubuntu-სთვის — იგივე ანგარიში, იგივე ფილიალები და მონაცემები, რაც ადმინ-პანელსა და Android-აპლიკაციებში. შესაფერისია ნებისმიერი ბიზნესისთვის: კაფე და რესტორანი, მაღაზია, სალონი, სასტუმრო, გაცემის პუნქტი.

რა არის საჭირო#

რა	მოთხოვნა
სისტემა	Ubuntu 22.04, 24.04 ან 26.04 LTS (GNOME სამუშაო მაგიდა, ასევე Kubuntu, Xubuntu და სხვა ვერსიები იმავე ბაზაზე)
პროცესორი	amd64 — ჩვეულებრივი კომპიუტერები და ლეპტოპები Intel-ით და AMD-ით; arm64 — ARM კომპიუტერები
უფლებები	ადმინისტრატორის პაროლი (`sudo`) — პაკეტის დასაყენებლად
ანგარიში	შესვლა იმავე ელფოსტითა და პაროლით, რაც Cenaly-ის ადმინ-პანელში (მფლობელი ან თანამშრომელი განყოფილებაზე წვდომით)
ქსელი	ინტერნეტი შესვლისა და მუშაობისთვის (მონაცემები Cenaly-ის ღრუბელშია)

კომპიუტერის არქიტექტურის გასაგებად გახსენით „ტერმინალი“ და გაუშვით dpkg --print-architecture — პასუხი იქნება amd64 ან arm64.

რომელი აპლიკაციებია#

აპლიკაცია	პაკეტი	ვისთვის
Cenaly Phone	`cenaly-phone`	ოპერატორი, ადმინისტრატორი, რეცეფცია: ზარები ბიზნესის ატს-ით, რიგი, გადამისამართება, ისტორია
Cenaly KDS	`cenaly-kds`	სამზარეულო, ბარი, შეკვეთების აწყობა და გაცემა: ტიკეტები სადგურების მიხედვით, ტაიმერები, „მზადაა“ და „გაცემულია“
Cenaly POS	`cenaly-pos`	სალარო: გაყიდვა, გადახდა, ჩეკი, დაბრუნება; მოწყობილობები — ხიდის მეშვეობით
Cenaly Hardware Bridge	`cenaly-bridge`	ფონური სერვისი: ჩეკისა და სამზარეულოს პრინტერები, ფისკალური აპარატები, სასწორები, სკანერები, ფულის უჯრა

პროგრამები ერთმანეთზე არ არის დამოკიდებული: დააყენეთ მხოლოდ საჭირო. სალაროს პრინტერით ან ფისკალური აპარატით ხიდიც სჭირდება — იმავე კომპიუტერზე ან ფილიალის სხვა კომპიუტერზე.

ნაბიჯი 1. ჩამოტვირთეთ პაკეტი#

გახსენით აპლიკაციის გვერდი საიტზე — მაგალითად, „Cenaly KDS“ განყოფილებაში „აპლიკაციები“.
ბლოკში Ubuntu დააჭირეთ თქვენი არქიტექტურის ღილაკს: .deb · amd64 ან .deb · arm64. თუ ბრაუზერმა არქიტექტურა შეატყობინა, საჭირო ღილაკი პირველი დგას.
cenaly-kds_1.0.0_amd64.deb ტიპის ფაილი შეინახება საქაღალდეში „ჩამოტვირთვები“.

ღილაკი ყოველთვის ბოლო გამოშვებულ ვერსიაზე მიდის.

ნაბიჯი 2. დააყენეთ#

ორმაგი დაწკაპებით. გახსენით „ჩამოტვირთვები“ და ორჯერ დააწკაპეთ ფაილს .deb — გაიხსნება App Center (22.04-ში — „Ubuntu Software“). დააჭირეთ „დაყენებას“ და შეიყვანეთ ადმინისტრატორის პაროლი.

ბრძანებით. „ტერმინალში“, ფაილის საქაღალდეში:

cd ~/Downloads
sudo apt install ./cenaly-kds_*_amd64.deb

apt საჭირო სისტემურ ბიბლიოთეკებს თავად მოიტანს. წერტილი და დახრილი ხაზი ./ აუცილებელია — მათ გარეშე apt პაკეტს ინტერნეტში ეძებს და არა საქაღალდეში არსებულ ფაილს.

დაყენება ტერმინალიდან#

სერვერებისთვის, კიოსკებისთვის და SSH-ით დისტანციური დაყენებისთვის არის ერთხაზიანი ბრძანება: ის ამატებს Cenaly-ის რეპოზიტორიას (ხელმოწერის გასაღები მოწმდება ანაბეჭდით) და აპლიკაციას apt-ით აყენებს.

ანგარიში	ბრძანება
cenaly.com და სხვა ბრენდის დომენები	`curl -fsSL https://cdn.cenaly.com/linux/install.sh \| sudo bash -s -- kds`
cenaly.ru	`curl -fsSL https://cdn.cenaly.ru/linux/install.sh \| sudo bash -s -- kds`

kds-ის ნაცვლად — phone, pos ან bridge; შეიძლება რამდენიმეც, ჰარით გამოყოფილი: … -- kds pos. აპლიკაციის გვერდი თქვენი ბრენდის მზა ბრძანებას „კოპირების“ ღილაკით აჩვენებს.

ნაბიჯი 3. პირველი გაშვება და შესვლა#

გახსენით Ubuntu-ს აპლიკაციების მენიუ და იპოვეთ Cenaly KDS (Phone, POS).
შედით Cenaly-ის ანგარიშის ელფოსტითა და პაროლით ან მოწყობილობის კოდით — ისევე, როგორც Android-აპლიკაციაში.
აირჩიეთ ფილიალი. შემდეგ აპლიკაცია შესვლას იმახსოვრებს: სესია ინახება სისტემის გასაღებების საცავში (GNOME Keyring) და არა ღია ფაილში.

Phone, KDS და POS სისტემურ უჯრაში ცხოვრობენ და სისტემაში შესვლისას ეშვებიან — ასე სამზარეულოს ეკრანი შეკვეთას არ გამოტოვებს, ტელეფონი კი — ზარს. ავტოგაშვება უჯრის ხატულის მენიუში ითიშება.

განახლებები#

დაყენებისას პაკეტი თავისი ბრენდის Cenaly-ის რეპოზიტორიას თავად ამატებს (/etc/apt/sources.list.d/cenaly.sources, Cenaly-ის გასაღებით ხელმოწერილი). ახალი ვერსიები Ubuntu-ს ჩვეულებრივ განახლებებთან ერთად მოდის — „პროგრამების განახლებაში“ ან ბრძანებით:

sudo apt update && sudo apt upgrade

ფაილის საიტიდან ხელახლა ჩამოტვირთვა საჭირო არ არის. თუ თქვენი პოლიტიკა მესამე მხარის რეპოზიტორიებს კრძალავს, დაყენებამდე შექმენით ფაილი /etc/default/cenaly სტრიქონით CENALY_APT_REPO=off — მაშინ განახლება ხელით მოგიწევთ, საიტიდან ახალი .deb-ით.

წაშლა#

sudo apt remove cenaly-kds      # პროგრამის წაშლა, სისტემის პარამეტრები რჩება
sudo apt purge cenaly-kds       # წაშლა სისტემის პარამეტრებთან ერთად

კომპიუტერზე ბოლო Cenaly-პაკეტის purge რეპოზიტორიასა და გასაღებსაც შლის. აპლიკაციის პირადი მონაცემები (ქეში, არჩეული ფილიალი) საშინაო საქაღალდეშია — ~/.local/share/cenaly/<აპლიკაცია>; წაშალეთ, თუ კომპიუტერს სხვას გადასცემთ. იგივეს აკეთებს ერთხაზიანი ბრძანებაც: curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- remove kds.

Snap Store#

ოთხივე პროგრამის snap-ვერსიები Snap Store-ში გამოსაქვეყნებლად მზადდება. როცა გამოჩნდება, აპლიკაციის გვერდზე იქნება ღილაკი Snap Store, დაყენება კი — sudo snap install cenaly-kds. სალაროსთვის ფისკალური აპარატით ან სასწორით USB-COM-ზე აიღეთ .deb: Ubuntu-ს წესებით snap COM-პორტებს ვერ ხედავს.

მოწყობილობების ხიდი Ubuntu-ზე#

Cenaly Hardware Bridge Ubuntu-ზე სისტემური სერვისია: კომპიუტერის ჩართვისას ეშვება და თავად გადაიტვირთება. პაკეტის cenaly-bridge დაყენების შემდეგ გახსენით მდგომარეობის გვერდი http://127.0.0.1:9100 (მენიუში მალსახმობი „Cenaly Hardware Bridge“) და ხიდი ფილიალს მიაბით — დეტალები სტატიაში Cenaly Hardware Bridge. თუ ხიდი უკვე იყო დაყენებული ძველი ერთხაზიანი ბრძანებით გვერდიდან „მოწყობილობები“, პაკეტი მის პარამეტრებსა და მიბმას აიყვანს — სერვისი ერთი დარჩება.

შეზღუდვები#

Linux-ზე ტელეფონის მსგავსი push-შეტყობინებები არ არის: ახალი შეკვეთები და ზარები მხოლოდ გაშვებულ აპლიკაციას აღწევს. ამიტომ პროგრამები უჯრაში ცხოვრობენ და სისტემაში შესვლისას ეშვებიან — ნუ დახურავთ „გასვლით“, თუ ზარებს ან შეკვეთებს ელოდებით.
Cenaly Phone: ატს-ის დაყენების ოსტატი, პარამეტრები და გუნდი ბრაუზერში (ადმინ-პანელში) იხსნება და არა პროგრამის შიგნით. ყურსასმენის მედია-ღილაკები მუშაობს, მაგრამ ყურმილის აღების ღილაკი (HID-ტელეფონია) ჯერ არ არის მხარდაჭერილი — უპასუხეთ ფანჯრის ან შეტყობინების ღილაკით.
Cenaly POS მოწყობილობებს თავად არ ესაუბრება — მხოლოდ ხიდის მეშვეობით. კომპიუტერის კამერა შტრიხკოდის სკანერად არ არის მხარდაჭერილი; USB-სკანერი კლავიატურასავით მუშაობს.
ფანჯრები X11-ზე მუშაობს; Wayland-სესიაში — XWayland-ით, რომელიც Ubuntu-ში ნაგულისხმევად ჩართულია.

პრობლემების მოგვარება#

სიმპტომი	მიზეზი	რა უნდა გააკეთოთ
უჯრაში ხატულა არ არის	სამუშაო მაგიდას არ აქვს ხატულების არე (AppIndicator)	Ubuntu-ში გაფართოება ნაგულისხმევად ჩართულია; თუ გამორთეთ — `gnome-extensions enable ubuntu-appindicators@ubuntu.com` და ხელახლა შედით. უჯრის გარეშე „დახურვა“ ფანჯარას ამოცანების პანელში ჩაკეცავს — ზარები და შეკვეთები არ იკარგება
ფანჯარა Wayland-სესიაში არ იხსნება	XWayland არ არის	`sudo apt install xwayland` და ხელახლა შედით სისტემაში
არ ისმის ზარი ან არ მუშაობს მიკროფონი (Phone), ახალი შეკვეთის ზარი დუმს (KDS)	ხმა სხვა PipeWire-მოწყობილობაზე მიდის	„პარამეტრები“ → „ხმა“: აირჩიეთ ყურსასმენი გამოსასვლელად და შესასვლელად; შემოწმება — `wpctl status`
Phone: „Chromium-ის sandbox მიუწვდომელია“	24.04+-ზე პაკეტის AppArmor-პროფილი არ არის ჩატვირთული	`sudo apparmor_parser -r /etc/apparmor.d/cenaly-phone` ან `sudo apt install --reinstall cenaly-phone`. ნუ გაუშვებთ `--no-sandbox`-ით
`apt update`: `NO_PUBKEY` ან „ხელმოუწერელია“	რეპოზიტორიის გასაღები წაშლილია	ერთხაზიანი ბრძანება `--repo-only`-ით: `curl -fsSL https://cdn.cenaly.com/linux/install.sh \| sudo bash -s -- --repo-only`
`Unable to locate package cenaly-kds`	რეპოზიტორია არ არის დამატებული	იგივე `--repo-only`, შემდეგ `sudo apt update`
`.deb`-ზე ორმაგი დაწკაპება არქივატორს ხსნის	ფაილი App Center-თან არ არის დაკავშირებული	მარჯვენა ღილაკი → „გახსნა პროგრამით“ → App Center, ან `sudo apt install ./ფაილი.deb`

ხშირი კითხვები#

რით განსხვავდება Ubuntu-ს პაკეტი Android-აპლიკაციისგან?#

ეკრანებითა და მოქმედებებით ეს იგივე პროგრამაა, მაგრამ კომპიუტერისთვის: მაუსი და კლავიატურა, სენსორული ეკრანი სალაროსა და სამზარეულოსთვის, უჯრა, სამუშაო მაგიდის შეტყობინებები. ანგარიში, ფილიალები და მონაცემები საერთოა.

გამოდგება Linux Mint, Debian ან Pop!_OS?#

დაყენებას ვამოწმებთ Ubuntu 22.04, 24.04 და 26.04 LTS-ზე. იმავე ბაზაზე აგებული სისტემები (Linux Mint 21–22, Pop!_OS 22.04–24.04) პაკეტს ჩვეულებრივ ასევე აყენებენ, მაგრამ ჩვენ მათ არ ვამოწმებთ.

საჭიროა თუ არა ინტერნეტი დასაყენებლად?#

sudo apt install ./ფაილი.deb-ისთვის — დიახ, apt ჩამოტვირთავს სისტემურ ბიბლიოთეკებს, თუ აკლია. პროგრამის პაკეტი სრულია; .NET-ის ცალკე დაყენება საჭირო არ არის.

როგორ დავაყენო ბევრ კომპიუტერზე ერთდროულად?#

ერთხაზიანი ბრძანებით SSH-ით ან თქვენი მართვის სისტემით (Ansible და ა.შ.): apt install cenaly-kds რეპოზიტორიის დამატების შემდეგ (--repo-only).

დაკავშირებული განყოფილებები#

მობილური აპლიკაციები — იმავე პროგრამების Android-ვერსიები
Cenaly Hardware Bridge — მოწყობილობების ხიდი
მოწყობილობები: რა უერთდება
სამზარეულო (KDS) · სალარო (POS) · ტელეფონია: საკუთარი ატს