import Tabs from '@/components/docs/Tabs.astro';
import Steps from '@/components/docs/Steps.astro';
import FileTree from '@/components/docs/FileTree.astro';
import Image from '@/components/docs/Image.astro';
import Alert from '@/components/docs/Alert.astro';
import Details from '@/components/docs/Details.astro';
import Cards from '@/components/docs/Cards.astro';
import Card from '@/components/docs/Card.astro';

<Alert type="note">
  قبل أن تبدأ، تأكد من أن الخادم والعملاء يستوفون [متطلبات النظام](/ar/platform/v3/requirements).
</Alert>

## تنزيل ملفات التثبيت

يمكنك تنزيل صور تثبيت منصة IIoT بطريقتين.

<Tabs labels={['من وسيط خارجي', 'عبر الإنترنت']}>
  <Fragment slot="panel-0">
    عندما لا يتوفر للخادم اتصال بالإنترنت — على سبيل المثال بموجب سياسة أمنية للمؤسسة — يمكنك تثبيت
    المنصة دون اتصال. تُنقل صور التثبيت إلى الخادم من وسيط خارجي.
  </Fragment>
  <Fragment slot="panel-1">
    عندما يتوفر للخادم اتصال بالإنترنت، تُسحب صور التثبيت إلى الخادم من مستودع بعيد.
  </Fragment>
</Tabs>

## خطوات التثبيت

<Steps>

### انسخ حزمة البيانات المطلوبة

انسخ حزمة التثبيت إلى الخادم (تتطلب صلاحيات المسؤول):

- انسخ الأرشيف الذي نزّلته `unicloud.tgz` ومجلد `images` (حزمة التثبيت المستقلة مع الصور
  المؤرشفة) إلى المجلد الرئيسي للمستخدم. يحتوي الأرشيف أيضًا على ملفي الإعداد
  `docker-compose.yml` و`.env` (الملف `.env` مخفي، لذا فعّل إظهار الملفات المخفية).

<FileTree
  tree={[
    {
      name: 'images',
      children: [
        { name: 'vadtel-nginx-latest.tar.gz' },
        { name: 'vadtel-app-latest.tar.gz' },
        { name: 'anytelemetry-latest.tar.gz' },
        { name: 'pgbouncer-latest.tar.gz' },
        { name: 'vadteljsondaemon-latest.tar.gz' },
        { name: 'logrotate-latest.tar.gz' },
        { name: 'postgres-15.1-alpine.tar.gz' },
        { name: 'redis-6.0.16-alpine.tar.gz' },
        { name: 'vector-latest.tar.gz' },
      ],
    },
  ]}
/>

- انسخ ملفات الإعداد إلى `/opt/vadtelnewweb/`.

- عيّن أسماء الدخول وكلمات المرور للنظام في الملف `.env`:

```bash title=".env"
#key
SECRET_KEY_BASE=0356080kcn0ejgk4lwekrf

#DB PGSQL login
PG_APP_USER=ppppp

#DB PGSQL password
PG_APP_PASSWORD= ppppp

#WEB interface login
VADTEL_SUPER_ADMIN_EMAIL=NEED_USERNAME

#WEB interface password
VADTEL_SUPER_ADMIN_PASSWORD=NEED_PASSWORD

#DB PGSQL unicloud login
VADTEL_UNICLOUD_TEST_USERNAME=NEED_USERNAME

#DB PGSQL unicloud password
VADTEL_UNICLOUD_TEST_PASSWORD=NEED_PASSWORD
```

### ثبّت Docker وDocker Compose

#### على توزيعة مبنية على CentOS

ثبّت Docker وDocker Compose:

```bash
sudo dnf install docker-ce docker-compose
```

شغّل Docker وفعّل تشغيله عند الإقلاع:

```bash
sudo systemctl enable --now docker && systemctl start docker
```

#### على توزيعة مبنية على Debian

ثبّت Docker وDocker Compose:

```bash
sudo apt update
sudo apt install docker docker-compose
```

### ثبّت النظام

الخطوات المتبقية واحدة على جميع أنظمة التشغيل. أضف المستخدم الذي سيشغّل التطبيق إلى
مجموعة `docker`:

```bash
sudo usermod -aG docker ${USER}
```

<Alert type="warning">
  بعد تشغيل هذا الأمر، أنهِ الجلسة ثم سجّل الدخول من جديد لتطبيق الصلاحيات الجديدة.
</Alert>

فُكّ الأرشيف `unicloud.tgz` في المجلد الرئيسي للمستخدم:

```bash
tar -xf unicloud.tgz
```

<FileTree
  tree={[
    {
      name: 'unicloud',
      children: [
        {
          name: 'run',
          state: 'closed',
          children: [{ name: 'db-unicloud', type: 'folder', state: 'closed' }],
        },
        { name: 'remote_install.sh' },
        { name: 'init-db', children: [{ name: 'create_tables.sql' }] },
        { name: 'script_conf.sh' },
        { name: 'docker-compose.yml' },
        {
          name: 'logs',
          state: 'closed',
          children: [
            { name: 'crontab', type: 'folder', state: 'closed' },
            { name: 'vadteljsondaemon', type: 'folder', state: 'closed' },
            { name: 'anytelemetry', type: 'folder', state: 'closed' },
          ],
        },
        { name: 'backups', type: 'folder', state: 'closed' },
        {
          name: 'data',
          state: 'closed',
          children: [{ name: 'db-unicloud', type: 'folder', state: 'closed' }],
        },
        {
          name: 'local-images',
          children: [
            { name: 'pgbouncer.tar.gz' },
            { name: 'postgres.tar.gz' },
            { name: 'vadteljsondaemon.tar.gz' },
            { name: 'anytelemetry.tar.gz' },
            { name: 'logrotate.tar.gz' },
          ],
        },
        { name: 'unicloud.service' },
      ],
    },
  ]}
/>

افتح مجلد `unicloud` الذي فُكّ في المجلد الرئيسي للمستخدم وشغّل سكربت التثبيت:

```bash
sudo ./remote_install.sh
```

بعد تثبيت الحزمة، افتح `/var/lib/unicloud` بصلاحيات المسؤول وغيّر مالك الملف `.env`
ومجموعته إلى المستخدم الحالي.

يولّد السكربت اسم الدخول وكلمة المرور لقاعدة البيانات في `/var/lib/unicloud/.env`. انسخ هذه
القيم إلى `/opt/vadtelnewweb/.env`:

```bash
VADTEL_UNICLOUD_TEST_USERNAME=NEED_USERNAME

VADTEL_UNICLOUD_TEST_PASSWORD=NEED_PASSWORD
```

### استخرج الصور وحمّلها

فُكّ ضغط ملفات الصور في مجلد `images` الذي نسخته سابقًا:

```bash
gunzip vadtel-nginx-latest.tar.gz
gunzip vadtel-app-latest.tar.gz
gunzip anytelemetry-latest.tar.gz
gunzip pgbouncer-latest.tar.gz
gunzip vadteljsondaemon-latest.tar.gz
gunzip logrotate-latest.tar.gz
gunzip postgres-15.1-alpine.tar.gz
gunzip redis-6.0.16-alpine.tar.gz
gunzip vector-latest.tar.gz
```

حمّل الصور إلى Docker:

```bash
docker load -i vadtel-nginx-latest.tar
docker load -i vadtel-app-latest.tar
docker load -i anytelemetry-latest.tar
docker load -i pgbouncer-latest.tar
docker load -i vadteljsondaemon-latest.tar
docker load -i logrotate-latest.tar
docker load -i postgres-15.1-alpine.tar
docker load -i redis-6.0.16-alpine.tar
docker load -i vector-latest.tar.gz
```

تحقق من توفر الصور:

```bash
docker images
```

ينبغي أن تظهر في القائمة الصور التسع التي حمّلتها كلها.

إذا حُمّلت الصور دون أخطاء، فشغّل الأمر التالي من مجلد `/var/lib/unicloud`:

```bash
docker-compose up -d
```

أنشئ دليلًا لتطبيق `vadtelnewweb` ضمن `/opt`:

```bash
sudo mkdir /opt/vadtelnewweb
cd /opt/vadtelnewweb
```

ثم انسخ الملفين `docker-compose.yml` و`.env` (إن لم تكن قد نسختهما سابقًا لتثبيت جديد) إلى
`/opt/vadtelnewweb`.

عند التشغيل الأول، أنشئ قاعدة البيانات:

```bash
docker-compose run app bundle exec rails db:create
```

والآن شغّل التطبيق:

```bash
docker-compose up -d
```

<Details title="استكشاف الأعطال وإصلاحها">
إذا أبلغ التطبيق عن الخطأ التالي بعد بدء التشغيل:

```bash
network unicloud_unicloud-net declared as external, but could not be found
```

فإن الشبكة الخارجية لم تُنشأ أثناء التثبيت. نفّذ التثبيت الأولي من الأرشيف
`unicloud.tar.tgz` كما هو موضح في [تثبيت النظام](#ثبّت-النظام)، ثم شغّل التطبيق من جديد:

```bash
docker-compose up -d
```

</Details>

تحقق من الحاويات قيد التشغيل:

```bash
docker ps
```

ينبغي أن تظهر كل الحاويات في القائمة بالحالة `Up`.

### تحقق من النظام

بعد بدء تشغيل التطبيق، افتح في متصفحك عنوان IP للخادم الذي يعمل عليه للتأكد من أن النظام يعمل:

```bash
http://127.0.0.1/auth/users/sign_in
```

<Image
  src="/images/deployment/sign-in-en.webp"
  alt="صفحة تسجيل الدخول إلى منصة IIoT مع حقلي البريد الإلكتروني وكلمة المرور"
  caption="صفحة تسجيل الدخول إلى منصة IIoT"
  width={1873}
  height={902}
/>

يُضبط البريد الإلكتروني وكلمة المرور لتسجيل الدخول في `/opt/vadtelnewweb/.env`:

```shell title=".env"
VADTEL_SUPER_ADMIN_EMAIL= (login)
VADTEL_SUPER_ADMIN_PASSWORD= (password)
```

</Steps>

## الخطوات التالية

بعد تثبيت المنصة وتشغيلها، اضبطها لتُحدَّث بسلاسة ولتُعاد تشغيلها تلقائيًا مع الخادم.

<Cards>
  <Card
    icon="refresh-cw"
    title="التحديث والتشغيل التلقائي"
    description="حدّث المنصة إلى إصدارات صور جديدة واجعلها تبدأ تلقائيًا مع الخادم."
    href="/ar/platform/v3/installation/updates"
  />
</Cards>