<chapter id="ora2pgpro-installation-and-setup">
  <title>Установка и подготовка</title>

    <sect1 id="ora2pgpro-install-oracle-instant-client">
     <title>Установка Oracle Instant Client</title>

    <para>Для пакетов <literal>perl-DBD-Oracle</literal> и <literal>libdbd-oracle-perl</literal>, которые включены в поставку <application>ora2pgpro</application>, требуется Oracle Instant Client Package 12.1 (например, <literal>oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm</literal>). Если вы используете Debian, обратите внимание, что пакет <literal>libdbd-oracle-perl</literal> не поставляется с <application>ora2pgpro</application>, поскольку он доступен из дистрибутива в разделе <literal>contrib</literal>. Версия этого пакета для более старых версий (Debian 10, 11) также требует Oracle Instant Client версии 12.1, тогда как пакет <literal>libdbd-oracle-perl</literal> в Debian 12 требует Oracle Instant Client 21 или выше (имя пакета <literal>oracle-instantclient-basic-xx.xx.x.x.x.x86_64.rpm</literal>). При использовании системы на базе Debian (Ubuntu, Astra Linux) необходимо конвертировать RPM-пакет в Debian-пакет, воспользовавшись <application>alien</application>, а затем установить его с помощью <application>dpkg</application>. Пакеты можно загрузить <ulink url="https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html">отсюда</ulink> или из другого источника и следовать инструкциям по установке.</para>
    </sect1>

    <sect1 id="ora2pgpro-connect-distribution">
     <title>Подключение дистрибутива</title>

    <itemizedlist>
      <listitem>
      <para>Загрузите скрипт подключения <ulink url="https://repo.postgrespro.ru/ora2pgpro/keys/pgpro-repo-add.sh"><filename>pgpro-repo-add.sh</filename></ulink>. Это также можно сделать, используя <application>wget</application>: <programlisting>  $ wget --user your-username --ask-password https://repo.postgrespro.ru/ora2pgpro/keys/pgpro-repo-add.sh
  </programlisting></para>
      </listitem>

      <listitem>
      <para>Запустите его с правами <literal>root</literal>. Если дистрибутив поддерживается, то репозиторий будет подключён. Обратите внимание, что для системы на базе Debian следует подключить не только раздел <literal>main</literal>, но и раздел <literal>contrib</literal>, поскольку необходимый пакет <literal>libdbd-oracle-perl</literal> находится именно в нём.</para>
      </listitem>
    </itemizedlist>
    </sect1>

    <sect1 id="ora2pgpro-install-package">
     <title>Установка пакета</title>

    <para>Установите пакет <application>ora2pgpro</application> с помощью пакетного менеджера. В зависимости от дистрибутива это может быть: <itemizedlist spacing="compact">
        <listitem><simpara><literal>apt-get</literal>: Debian, Ubuntu, Astra, Альт Линукс</simpara></listitem>
        <listitem><simpara><literal>dnf</literal>: Системы Red Hat Enterprise Linux (RHEL) и производные от них: РЕД ОС, РОСА</simpara></listitem>
        <listitem><simpara><literal>yum</literal>: старые версии РОСА</simpara></listitem>
        <listitem><simpara><literal>zypper</literal>: SLES</simpara></listitem>
      </itemizedlist> В любом случае укажите параметры <command>install ora2pgpro</command>.</para>
    </sect1>

    <sect1 id="ora2pgpro-supported-distributions">
     <title>Поддерживаемые дистрибутивы</title>

     <para>Двоичные пакеты <application>ora2pgpro</application> предоставляются для следующих систем на базе Linux:</para>
     <itemizedlist spacing="compact">
      <listitem><simpara>Системы на базе Debian: Debian 11/12/13, Ubuntu 22.04/24.04/26.04</simpara></listitem>
      <listitem><simpara>Системы Red Hat Enterprise Linux (RHEL) и производные от них: Red Hat Enterprise Linux 8/9/10, РЕД ОС МУРОМ 7.3/8, РОСА «ХРОМ» 2021.1</simpara></listitem>
      <listitem><simpara>Альт 10/11, Альт СП 8.2/10</simpara></listitem>
      <listitem><simpara>SUSE Linux Enterprise Server (SLES) 15/16</simpara></listitem>
      <listitem><simpara>МосОС 15</simpara></listitem>
     </itemizedlist>
    </sect1>
</chapter>
