اجرای نصب هدایت‌شده (Running the guided installation)

برای شروع نصاب، دستور زیر را در جدیدترین ISO آرچ لینوکس اجرا کنید:

archinstall

از آنجا که نصاب هدایت‌شده https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py اسکریپت پیش‌فرض است، اجرای این دستور معادل اجرای archinstall guided می‌باشد.

نصب هدایت‌شده همچنین از نصب با پاسخ‌های از پیش پیکربندی‌شده برای تمام مراحل هدایت‌شده پشتیبانی می‌کند. این روش می‌تواند شیوه‌ای سریع و راحت برای اجرای دوباره یک یا چند نصب باشد.

دو فایل پیکربندی وجود دارد که استفاده از هر دوی آن‌ها اختیاری است.

--config

این پارامتر یک فایل محلی .json را به عنوان آرگومان می‌پذیرد و شامل پیکربندی کلی و پاسخ‌های منوها برای نصاب هدایت‌شده است.

--config-url

این پارامتر یک فایل راه دور .json را به عنوان آرگومان می‌پذیرد و شامل پیکربندی کلی و پاسخ‌های منوها برای نصاب هدایت‌شده است.

نکته:

نمونه‌های کاربردی (Example usage)

archinstall --config config.json

archinstall --config-url https://domain.lan/config.json

محتویات فایل https://domain.lan/config.json:

{
  "additional-repositories": [],
  "archinstall-language": "English",
  "audio_config": null,
  "bootloader_config": {
    "bootloader": "Systemd-boot",
    "uki": false,
    "removable": false
  },
  "bootloader": "Systemd-boot",
  "debug": false,
  "disk_config": {
    "config_type": "manual_partitioning",
    "device_modifications": [
      {
        "device": "/dev/sda",
        "partitions": [
          {
            "btrfs": [],
            "flags": [
              "boot"
            ],
            "fs_type": "fat32",
            "length": {
              "sector_size": null,
              "total_size": null,
              "unit": "B",
              "value": 99982592
            },
            "mount_options": [],
            "mountpoint": "/boot",
            "obj_id": "369f31a8-2781-4d6b-96e7-75680552b7c9",
            "start": {
              "sector_size": {
                "sector_size": null,
                "total_size": null,
                "unit": "B",
                "value": 512
              },
              "total_size": null,
              "unit": "sectors",
              "value": 34
            },
            "status": "create",
            "type": "primary"
          },
          {
            "btrfs": [],
            "flags": [],
            "fs_type": "fat32",
            "length": {
              "sector_size": null,
              "total_size": null,
              "unit": "B",
              "value": 100000000
            },
            "mount_options": [],
            "mountpoint": "/efi",
            "obj_id": "13cf2c96-8b0f-4ade-abaa-c530be589aad",
            "start": {
              "sector_size": {
                "sector_size": null,
                "total_size": null,
                "unit": "B",
                "value": 512
              },
              "total_size": {
                "sector_size": null,
                "total_size": null,
                "unit": "B",
                "value": 16106127360
              },
              "unit": "MB",
              "value": 100
            },
            "status": "create",
            "type": "primary"
          },
          {
            "btrfs": [],
            "flags": [],
            "fs_type": "ext4",
            "length": {
              "sector_size": null,
              "total_size": null,
              "unit": "B",
              "value": 15805127360
            },
            "mount_options": [],
            "mountpoint": "/",
            "obj_id": "3e75d045-21a4-429d-897e-8ec19a006e8b",
            "start": {
              "sector_size": {
                "sector_size": null,
                "total_size": null,
                "unit": "B",
                "value": 512
              },
              "total_size": {
                "sector_size": null,
                "total_size": null,
                "unit": "B",
                "value": 16106127360
              },
              "unit": "MB",
              "value": 301
            },
            "status": "create",
            "type": "primary"
          }
        ],
        "wipe": false
      }
    ]
  },
  "disk_encryption": {
    "encryption_type": "luks",
    "partitions": [
      "3e75d045-21a4-429d-897e-8ec19a006e8b"
    ]
  },
  "hostname": "archlinux",
  "kernels": [
    "linux"
  ],
  "locale_config": {
    "kb_layout": "us",
    "sys_enc": "UTF-8",
    "sys_lang": "en_US"
  },
  "mirror_config": {
    "custom_servers": [
      {
        "url": "https://mymirror.com/$repo/os/$arch"
      }
    ],
    "mirror_regions": {
      "Australia": [
        "http://archlinux.mirror.digitalpacific.com.au/$repo/os/$arch"
      ]
    },
    "optional_repositories": [
      "testing"
    ],
    "custom_repositories": [
      {
        "name": "myrepo",
        "url": "https://myrepo.com/$repo/os/$arch",
        "sign_check": "Required",
        "sign_option": "TrustAll"
      }
    ]
  },
  "network_config": {},
  "no_pkg_lookups": false,
  "ntp": true,
  "offline": false,
  "packages": [],
  "parallel downloads": 0,
  "profile_config": null,
  "save_config": null,
  "script": "guided",
  "silent": false,
  "swap": true,
  "timezone": "UTC",
  "version": "2.6.0"
}

گزینه‌های --config

هشدار:

نکته:

گزینه‌های JSON

نکته:

گزینه‌های مربوط به --creds

فایل creds یک فایل پیکربندی جداگانه است تا گزینه‌های عادی را از داده‌های حساس‌تر مانند گذرواژه‌ها تفکیک کند. در زیر نمونه‌ای از نحوه تنظیم گذرواژه ریشه آورده شده و در ادامه، توضیحات سایر مقادیر قابل تنظیم آمده است.

{
    "root_enc_password" : "SecretSanta2022"
}

گزینه‌های --creds

نکته:

https://github.com/archlinux/archinstall/issues/2144'>انتظار برای همگام‌سازی زمان (Waiting for time sync) #2144 https://github.com/archlinux/archinstall/issues/2144

علت ریشه‌ای معمول این مشکل، توپولوژی شبکه است. به‌طور خاص، timedatectl show https://github.com/archlinux/archinstall/blob/e6344f93f7e476d05bbcd642f2ed91fdde545870/archinstall/lib/installer.py#L136 نمی‌تواند یک همگام‌سازی صحیح زمان را در برابر سرورهای پیش‌فرض انجام دهد.

راه‌اندازی مجدد systemd-timesyncd.service ممکن است کارساز باشد، اما در بیشتر مواقع لازم است فایل /etc/systemd/timesyncd.conf را متناسب با ساختار شبکه خود پیکربندی کنید.

نکته:

https://github.com/archlinux/archinstall/issues/2679'>انتظار برای اتمام همگام‌سازی جاکلیدی آرچ لینوکس (archlinux-keyring-wkd-sync) #2679 https://github.com/archlinux/archinstall/issues/2679

سرویس archlinux-keyring-wkd-sync.service یا تایمر archlinux-keyring-wkd-sync.timer ممکن است گاهی اوقات "برای همیشه" معلق بماند (هنگ کند). این وضعیت معمولاً به دلیل عدم امکان دسترسی به سرورهای کلید یا کندی اتصال به آن‌ها رخ می‌دهد.

اسکریپت /usr/bin/archlinux-keyring-wkd-sync را می‌توان به صورت دستی اجرا کرد تا مشخص شود آیا به کندی اجرا می‌شود یا خیر.

اگر دستور systemctl show --property=ActiveEnterTimestamp --no-pager archlinux-keyring-wkd-sync.timer چیزی نشان ندهد، به این معنی است که همگام‌سازی داخلی هرگز به پایان نرسیده است. به همین ترتیب، دستور systemctl show --no-pager -p SubState --value archlinux-keyring-wkd-sync.service به احتمال زیاد مقدار dead را نشان می‌دهد که یعنی سرویس هرگز تکمیل نشده است.

برای رفع این مشکل، موارد زیر را امتحان کنید:

# killall gpg-agent
# rm -rf /etc/pacman.d/gnupg
# pacman-key --init
# pacman-key --populate
# pacman -Sy archlinux-keyring
# systemctl restart archlinux-keyring-wkd-sync.timer

نکته:

> error: archinstall: signature from "Anton Hvornum (Torxed) <torxed@archlinux.org>" is unknown trust
> :: File /var/cache/pacman/pkg/archinstall-1.2.3-4-x86_64.pkg.tar.xz is corrupted (invalid or corrupted package (PGP signature)).
> Do you want to delete it? [Y/n]

https://github.com/archlinux/archinstall/issues/2002'>نبود درایور اختصاصی انویدیا (Missing Nvidia Proprietary Driver) #2002 https://github.com/archlinux/archinstall/issues/2002

در برخی موارد، ممکن است درایور nvidia تمام بسته‌های لازم را به صورت نصب‌شده نداشته باشد. این موضوع به دلیل انتخاب هسته (کرنل) و/یا تنظیمات سخت‌افزاری است که برای عملکرد صحیح نیاز به بسته‌های اضافی دارند.

یک راهکار معمول، نصب بسته linux-headers https://archlinux.org/packages/core/x86_64/linux-headers و nvidia-dkms https://archlinux.org/packages/extra/x86_64/nvidia-dkms است.

https://github.com/archlinux/archinstall/issues/1686،_#2185_https://github.com/archlinux/archinstall/issues/2185'>خطای پردازنده‌های ARM، ۳۲ بیتی و سایر انواع پردازنده #1686 https://github.com/archlinux/archinstall/issues/1686، #2185 https://github.com/archlinux/archinstall/issues/2185

این یک مسئله شناخته‌شده تا حدی فراگیر و کلی است. به‌طور رسمی تنها معماری x86_64 <https://wiki.archlinux.org/title/Frequently_asked_questions#What_architectures_does_Arch_support?> توسط آرچ لینوکس پشتیبانی می‌شود. از این رو، تلاش چندانی برای پشتیبانی از سایر پلتفرم‌ها صورت نگرفته است.

از نظر تئوری، سایر معماری‌ها باید کار کنند اما ممکن است اشکالات و رفتارهای پیش‌بینی‌نشده‌ای رخ دهند.

درخواست‌های ادغام (PR) مورد استقبال قرار می‌گیرند، اما لطفاً تأخیر در ادغام آن‌ها را پذیرا باشید. سایر اصلاحات، مسائل یا ویژگی‌ها به دلایل فوق در اولویت قرار خواهند گرفت.

https://github.com/archlinux/archinstall/issues/2213'>قدیمی بودن جاکلیدی (Keyring is out of date) #2213 https://github.com/archlinux/archinstall/issues/2213

مشکلات مربوط به کلیدهای مفقود معمولاً به دلیل قدیمی بودن بسته archlinux-keyring https://archlinux.org/packages/core/any/archlinux-keyring است که اغلب در نتیجه یک ISO قدیمی رخ می‌دهد. تلاشی از سوی پروژه بالادست برای رفع این مشکل صورت گرفته است که همان سرویس archlinux-keyring-wkd-sync.service https://gitlab.archlinux.org/archlinux/archlinux-keyring/-/blob/7e672dad10652a80d1cc575d75cdb46442cd7f96/wkd_sync/archlinux-keyring-wkd-sync.service.in می‌باشد.

این سرویس تقریباً بلافاصله در حین بوت شروع به کار می‌کند و اگر شبکه به موقع پیکربندی نشود — سرویس با شکست مواجه می‌شود. متعاقباً، با وجود فعال بودن سرویس به‌روزرسانی برای این کار، ممکن است اجرای archinstall با یک جاکلیدی قدیمی انجام شود.

در عمل هیچ راه پایدار و قابل اعتمادی در طول زمان برای رفع این مشکل در درون archinstall وجود ندارد. در عوض، تلاش‌ها برای بهبود سرویس بالادست و/یا عدم انقضای کلیدها در تعداد معقولی از نسخه‌های ISO باید به عنوان راهکار اصلی مد نظر قرار گیرد.

نکته:

نکته:

بسته‌های مخزن کاربری آرچ (AUR packages)

این نیز یک موضوع کلی و فراگیر است. مخزن AUR پشتیبانی نمی‌شود https://wiki.archlinux.org/title/Arch_User_Repository#Updating_packages و تا زمانی که این وضعیت تغییر نکند، نمی‌توانیم از بسته‌های AUR برای حل درخواست‌های قابلیت در archinstall استفاده کنیم.

این بدان معناست که امکان افزودن درخواست‌های قابلیتی مانند پشتیبانی از سیستم‌های پرونده نظیر ZFS https://aur.archlinux.org/packages/zfs-linux وجود ندارد و مشکلات نیز با استفاده از بسته‌های AUR قابل حل نیستند.

نکته:

# archinstall --plugin https://archlinux.life/aur-plugin

# archinstall --plugin https://raw.githubusercontent.com/phisch/archinstall-aur/master/archinstall-aur.py

فایل‌های گزارش (Log files)

هنگام ارسال تیکت راهنمایی، لطفاً فایل /var/log/archinstall/install.log را ضمیمه کنید. این فایل هم در محیط زنده (Live ISO) و هم در سیستم پرونده نصب‌شده (در صورتی که بسته‌های پایه نصب شده باشند) قابل دسترسی است.

نکته کاربردی:

یک روش آسان برای ارسال گزارش‌ها استفاده از دستور archinstall share-log است که فایل install.log را در paste.rs آپلود کرده و یک پیوند قابل اشتراک‌گذاری چاپ می‌کند.
هنگام ارسال سایر فایل‌های گزارش احتیاط کنید، اما archinstall تضمین می‌کند که install.log برای انتشار عمومی ایمن باشد!

فایل‌های گزارش دیگری در مسیر /var/log/archinstall/ وجود دارند که می‌توانند مفید باشند:

هشدار:

نصب با pacman (Installing with pacman)

بسته Archinstall در مخازن رسمی https://wiki.archlinux.org/index.php/Official_repositories موجود است. و همچنین archinstall را به عنوان یک کتابخانه پایتون نصب خواهد کرد.

برای نصب هم‌زمان کتابخانه و اسکریپت archinstall:

pacman -S archinstall

همچنین می‌توانید با استفاده از بسته python-archinstall تنها کتابخانه را بدون فایل اجرایی کمکی نصب کنید.

نصب از PyPI (Installing from PyPI)

مفهوم پایه PyPI با استفاده از pip اعمال می‌شود.

pip install archinstall

نصب با استفاده از کد منبع (Install using source code)

همچنین می‌توانید برنامه را با استفاده از کد منبع نصب کنید. برای سادگی در این مثال از git clone استفاده می‌کنیم.

git clone https://github.com/archlinux/archinstall

می‌توانید پوشه را به درون پروژه خود منتقل کرده و به سادگی دستور زیر را اجرا کنید:

import archinstall

یا می‌توانید از ابزارهای build https://github.com/pypa/build و installer https://github.com/pypa/installer مربوط به PyPA برای نصب آن در مسیر ماژول‌های پایتون استفاده کنید.

$ cd archinstall
$ python -m build .
$ python -m installer dist/*.whl

پیش‌نیازها (Pre-requisites)

فرض می‌کنیم که روش «نصب با استفاده از کد منبع» <#installing-python-manual> را دنبال کرده‌اید. پیش از نصب واقعی کتابخانه، لازم است اسکریپت‌های نصب سفارشی خود را به صورت یک فایل پایتون در پوشه scripts https://github.com/archlinux/archinstall/tree/master/archinstall/scripts قرار دهید.

توضیحات بیشتر در مورد نحوه ساخت این اسکریپت‌ها در بخش بعدی آمده است.

هشدار:

ایجاد یک اسکریپت (Creating a script)

بیایید به عنوان مثال یک نصاب test_installer ایجاد کنیم. با این فرض که پوشه ./archinstall یک کلون گیت از مخزن اصلی است. کار را با ایجاد "scripts https://github.com/archlinux/archinstall/tree/master/archinstall/scripts/test_installer.py" آغاز می‌کنیم. جای‌گذاری این فایل بعداً حائز اهمیت خواهد بود.

این اسکریپت اکنون پس از نصب موفقیت‌آمیز خود کتابخانه، می‌تواند با استفاده از python -m archinstall --script test_installer فراخوانی شود. اما این اسکریپت کار زیادی انجام نخواهد داد. بنابراین به عنوان نمونه کار ساده‌ای مانند فهرست کردن تمام دیسک‌های سخت را انجام می‌دهیم.

برای این کار، با وارد کردن archinstall در "scripts https://github.com/archlinux/archinstall/tree/master/archinstall/scripts/test_installer.py" شروع کرده و تابعی را درون archinstall فراخوانی می‌کنیم.

from archinstall.lib.disk.device_handler import device_handler
from pprint import pprint
pprint(device_handler.devices)

اکنون به روش «نصب با استفاده از کد منبع» <#installing-python-manual> مراجعه فرمایید. پس از اجرای python -m archinstall test_installer باید خروجی‌ای مشابه زیر چاپ شود:

[
    BDevice(
        disk=<parted.disk.Disk object at 0x7fbe17156050>,
        device_info=_DeviceInfo(
            model='PC801 NVMe SK hynix 512GB',
            path=PosixPath('/dev/nvme0n1'),
            type='nvme',
            total_size=Size(value=512110190592, unit=<Unit.B: 1>,
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
            free_space_regions=[
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4250>,
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4c50>,
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4a10>],
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>),
            read_only=False,
            dirty=False
        ),
        partition_infos=[
            _PartitionInfo(
                partition=<parted.partition.Partition object at 0x7fbe166c4a90>,
                name='primary',
                type=<PartitionType.PRIMARY: 'primary'>,
                fs_type=<FilesystemType.FAT32: 'fat32'>,
                path='/dev/nvme0n1p1',
                start=Size(value=2048, unit=<Unit.sectors: 'sectors'>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                length=Size(value=535822336, unit=<Unit.B: 1>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                flags=[
                    <PartitionFlag.BOOT: flag_id=1, alias=None>,
                    <PartitionFlag.ESP: flag_id=18, alias=None>
                ],
                partn=1,
                partuuid='a26be943-c193-41f4-9930-9341cf5f6b19',
                uuid='6EE9-2C00',
                disk=<parted.disk.Disk object at 0x7fbe17156050>,
                mountpoints=[
                    PosixPath('/boot')
                ],
                btrfs_subvol_infos=[]
            ),
            _PartitionInfo(...)
        ]
    )
]

این بدان معناست که اسکریپت شما در مکان درستی قرار دارد و archinstall مطابق انتظار عمل می‌کند.

نکته:

پارامتر --plugin

این پارامتر این مزیت را دارد که در وضعیت --conf ذخیره می‌شود؛ به این معنا که هنگام اجرای مجدد یک فرآیند نصب، افزونه به طور خودکار بارگذاری خواهد شد. محدودیت آن این است که نیازمند مشخص بودن و وارد کردن یک مسیر اولیه است که می‌تواند کمی دشوار باشد.

شناسایی افزونه (Plugin Discovery)

این روش امکان بارگذاری چندین افزونه را فراهم می‌کند، با این محدودیت که افزونه‌ها باید از قبل بر روی سیستمی که archinstall را اجرا می‌کند نصب شده باشند. این روش عمدتاً کسانی را هدف قرار می‌دهد که ایمیج‌های ISO اختصاصی خود را می‌سازند و پیکربندی‌های خاصی را برای نیازهای خود بسته‌بندی می‌کنند.

چه مواردی پشتیبانی می‌شوند؟ (What's supported?)

در حال حاضر مستندات مربوط به این بخش محدود است. تا زمانی که این موضوع برطرف شود، بهترین راه برای یافتن ویژگی‌های پشتیبانی‌شده جستجوی عبارات plugin.on_ در کد منبع <https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code> است؛ چرا که این کار تصویر روشنی از فراخوانی‌های انجام‌شده به افزونه‌ها ارائه می‌دهد.

چگونه کار می‌کند؟ (How does it work?)

افزونه‌های archinstall از رویکرد مبتنی بر کشف (discovery-driven) استفاده می‌کنند که در آن توابع خاصی از افزونه‌ها استعلام می‌شوند. به عنوان مثال، اگر یک افزونه تابع زیر را داشته باشد:

def on_pacstrap(*packages):
    ...

تابع archinstall.Pacman().strap(["some packages"]) به صورت ثابت روی افزونه‌ها پیمایش کرده و به دنبال on_pacstrap در افزونه می‌گردد. اگر تابع موجود باشد، .strap() تابع افزونه را فراخوانی کرده و لیست اولیه بسته‌ها را با نتیجه دریافتی از افزونه جایگزین می‌کند.

بهترین شیوه برای مستندسازی این فراخوانی‌ها در حال حاضر مشخص نیست، زیرا مستندسازی پویای این رفتار دشوار است.

نوشتن افزونه خودتان؟ (Writing your own?)

ساده‌ترین راه در حال حاضر بررسی پیاده‌سازی‌های مرجع یا نمونه‌های جامعه کاربری است. دو مورد از آن‌ها عبارت‌اند از:

همچنین می‌توانید به جستجوی plugin.on_ در مخزن کد <https://github.com/search?q=repo%3Aarchlinux%2Farchinstall+%22plugin.on_%22&type=code> بپردازید تا ببینید archinstall به دنبال چه چیزهایی می‌گردد. از درخواست‌های ادغام (PR) برای گسترش این پشتیبانی استقبال می‌شود.