.. _sap-admin-install-uninstall:

Установка и удаление xDE для SAP ERP
=====================================

Установка нового модуля xDE для SAP ERP выполняется посредством
установки SAP Add-On продукта TerraLink xDE, который находится в поставке Продукта в папке *xDE SAP*.

Альтернативным способом установки модуля xDE для SAP ERP является
стандартная процедура импорта транспортных запросов (подробнее см. раздел :ref:`import-trans`).

Требования к SAP-системе для установки SAP Add-On
-------------------------------------------------

Перед началом установки SAP Add-On необходимо проверить
следующие условия.

#. В системе должны использоваться актуальные версии **Kernel (ядра)** и утилит **R3Trans** и \ **tp**.

#. В системе должны использоваться актуальные версии утилит для установки обновлений:

   * Support Package Manager (Диспетчер пакетов поддержки) – транзакция SPAM;
   * Add-On Installation Tool (Инструмент инсталляции SAP Add-On) – транзакция SAINT.

#. В системе должны использоваться следующие версии программных компонентов:

   *  SAP_BASIS – 740;
   *  SAP_APPL – 600.

#. Для всех установленных компонентов должны быть импортированы требуемые дополнительные языки.

.. note:: 

    Для проверки актуальных версий утилит и программных компонентов обратитесь на портал поддержки SAP (SAP Support Portal) по ссылке https://support.sap.com/en/index.html.

Установка SAP Add-On
--------------------

#. Откройте SAP Logon и войдите в систему, в мандант **000** – пользователем, имеющим права SAP_ALL, на английском языке.

   .. important:: Установка Add-On производится **только** в эталонном манданте 000, на английском языке, под логином, имеющим права SAP_ALL.
   
    Не используйте пользователей *SAP* или *DDIC*.

   .. image:: ris1.png
      :scale: 81
      :align: center
      :alt: Вход в систему


#. Вызовите ``Add-On Installation Tool (Инструмент инсталляции SAP Add-On)`` – загрузите транзакцию ``SAINT``.

   .. image:: ris2.png
      :scale: 58
      :align: center
      :alt: Запуск транзакции SAINT


#. Отобразится начальный экран транзакции ``(Add-On Installation Tool : Installed Add-ons)``, в котором перечислены уже установленные компоненты и расширения. 
   Нажмите ``Start``, чтобы начать процесс установки.

   .. image:: ris3.png
      :scale: 58
      :align: center
      :alt: Список установленных Add-On

#. Отобразится первое диалоговое окно ``(Add-On Installation Tool : Add-on selection)`` со списком пакетов, доступных для установки (при их наличии).

   .. image:: ris4.png
      :scale: 71
      :align: center
      :alt: Выбор установочного пакета Add-On


   Если установочный пакет еще не загружен в систему, загрузите его. Для этого выполните следующие действия:

   * Выберите в меню ``Installation Package`` -> ``Load packages`` -> ``From Front End``.

   .. image:: ris5.png
      :scale: 100 %
      :align: center
      :alt: Переход к загрузке установочного пакета


   * В открывшемся окне (``Select CAR/SAR archive``) выберите архивный файл для установки (файл с расширением \*.sar) из поставки Продукта (в папке ``xDE SAP``) и нажмите ``Открыть (Open)``.

   .. image:: ris6.png
      :scale: 100
      :align: center
      :alt: Загрузка установочного пакета Add-On


   * Распакуйте файл, нажав ``Decompress`` в открывшемся окне (``Content of the compressed file``).

   .. image:: ris7.png
      :scale: 75
      :align: center
      :alt: Распаковка архивного файла с расширением ``*.sar``


   * Выберите требуемый Add-on в списке и нажмите ``Continue``.

   .. image:: ris8.png
      :scale: 56
      :align: center
      :alt: Выбор установочного пакета Add-On


#. На странице выбора дополнительных пакетов поддержки ``(Add-On Installation Tool : Support Package selection)`` нажмите ``Continue``, чтобы перейти к подготовке очереди установки.

   .. image:: ris9.png
      :scale: 82
      :align: center
      :alt: Выбор пакетов поддержки


#. Откроется страница подготовки очереди установки ``(Installation of several Add-ons : Calculated queue)``. На вкладке ``Installation queue (Очередь установки)`` проверьте соответствие загруженного
   Add-On версии, которую следует установить. Если загружен корректный Add-On, нажмите ``Continue``.

   .. note:: Вкладка ``Software Components`` при установке Add-on не используется.

   .. image:: ris10.png
      :scale: 69
      :align: center
      :alt: Очередь установки


#. В появившемся окне (``Add Modification Adjustment Transports to the Queue``) нажмите ``Yes``.

   .. image:: ris11.png
      :scale: 69
      :align: center
      :alt: Добавление переноса сравнения модификаций


#. На следующей открывшейся странице (``Installation of several Add-ons : Add adjustment transports``) нажмите ``Continue``.

   .. image:: ris12.png
      :scale: 88
      :align: center
      :alt: Перенос сравнения модификаций


#. В появившемся окне запуска установки (``SAINT: Add-on installation``) нажмите |ok|.

   .. image:: ris13.png
      :scale: 99
      :align: center
      :alt: Запуск установки Add-On


   Произойдет переход к следующей странице (``Installation of several Add-ons: Import of the queue``) и начнется установка Add-on, которая может занять достаточно продолжительное время.

   .. image:: ris14.png
      :scale: 85
      :align: center
      :alt: Выполнение установки Add-On


#. По окончании установки появится окно с информацией об измененных объектах в системе (``Information on Modified Objects``). Система сообщит об успешном окончании установки (все
   импортированные объекты успешно активированы) и выдаст предупреждение об изменениях объекта в системе и о возможности отменить изменения. Нажмите ``Continue``.

   .. image:: ris15.png
      :scale: 82
      :align: center
      :alt: Информация об измененных объектах


#. Произойдет переход к заключительной странице установки (``Installation of several Add-ons: Imported queue``). Нажмите ``Logs``, чтобы проверить журналы импорта.

   .. image:: ris16.png
      :scale: 80
      :align: center
      :alt: Установленный Add-On


#. Откроется окно просмотра журналов (``Overview of All Transport Logs``). Проверьте логи и вернитесь назад к предыдущей странице, нажав |back|.

   .. image:: ris17.png
      :scale: 63
      :align: center
      :alt: Просмотр журналов


#. Нажмите **Finish**.

#. Появится дополнительное окно ``Sending the runtime analysis`` с предложением переслать в компанию SAP информацию о времени выполнения анализа данных. Нажмите ``Do not send``.

   .. image:: ris18.png
      :scale: 83
      :align: center
      :alt: Обратная связь


#. Система вернется к начальному экрану со списком установленных Add-on (``Add-On Installation Tool : Installed Add-ons``). Установка Add-On успешно завершена.

   .. image:: ris19.png
      :scale: 73
      :align: center
      :alt: Список установленных Add-On


Удаление SAP Add-On
-------------------

Для деинсталляции Add-On необходимо авторизоваться в системе SAP под мандантом 000 на английском языке. 
После этого необходимо запустить транзакцию ``SAINT``.
В данной транзакции на вкладке ``Deinstallable Components`` будет виден компонет ``TRL``.

.. note:: 
    Сначала можно произвести тестовое удаление компонента, 
    однако это не является обязательным и носит рекомендательный характер.
    
    Для тестового удаления компонента выберите в меню ``Extras``->``Settings``.
    
        .. image:: media/img232.png
           :scale: 90
           :align: center
           :alt: Список для удаления Add-On
    
     Далее необходимо выбрать тестовый режим.
        
        .. image:: media/img233.png
           :scale: 90
           :align: center
           :alt: Список для удаления Add-On

    Последующие шаги одинаковы для тестового или продуктового запуска. 

На основном экране транзакции нужно выбрать компонент ``TRL`` и нажать кнопку ``Start``.

      .. image:: media/img234.png
         :scale: 90
         :align: center
         :alt: Старт

В появившемся окне с настройками процесса удаления выберите опцию ``Start in dialog`` и нажмите |ok|.

      .. image:: media/img235.png
         :scale: 80
         :align: center
         :alt: Старт

Процесс может прерваться для того чтобы показать на возможные ошибки или необходимые шаги, 
которые необходимо произвести в ручном режиме (зависимости в кастомной части, кастомные настройки и т.д).
Подробности отобразятся в журнале или в ALV-списке внизу экрана.

      .. image:: media/img236.png
         :scale: 80
         :align: center
         :alt: Ошибки

После выполнения шагов в ручном режиме и подготовительных действий нужно вернуться назад и нажать кнопку ``Repeat``. 

      .. image:: media/img237.png
         :scale: 100
         :align: center
         :alt: Ошибки

.. note:: Следует учитывать, что окно с описанием проблем может появляться неоднократно.

.. note:: Некоторые проверки не требуют выполнения каких-либо действий и их можно пропустить, нажав кнопку ``Skip``. 
          Например, это возможно, если некоторые объекты были изменены, и система предупреждает о том, что 
          данные будут утеряны вместе с измененными объектами.

В конце будет выведен экран завершения удаления компонента, где нужно нажать ``Finish`` 
(также можно посмотреть журнал, нажав кнопку ``Logs``).

      .. image:: media/img238.png
         :scale: 90
         :align: center
         :alt: Завершение

Далее, если вы выполняли все вышеописанные действия в тестовом режиме, необходимо переключиться на стандартный режим 
и повторить операцию.
В конце система предложит отправить информацию об операции на почту (``Send``), вывести информацию об операции 
на экране (``Display``) или отказаться от каких-либо дейсттвий (``Do not send``).

      .. image:: media/img239.png
         :scale: 90
         :align: center
         :alt: Завершение

.. _import-trans:

Импорт транспортных запросов
----------------------------

Установка модуля xDE для SAP ERP может также производиться при помощи импорта транспортных запросов. Запросы для SAP системы находятся в ZIP-архиве Продукта.

Для установки xDE для SAP путем импорта транспортных запросов выполните следующие действия.

#. Распакуйте архив.

#. Перенесите все файлы из каталога ``data`` в каталог ``\usr\sap\trans\data`` сервера приложений.

#. Перенесите все файлы из каталога ``cofiles`` в каталог ``\usr\sap\trans\cofiles`` сервера приложений.

#. Чтобы поставить запрос в очередь импорта системы, перейдите в транзакцию управления переносами (``STMS``).

   .. image:: ris20.png
      :scale: 100 %
      :align: center
      :alt: Запуск транзакции STMS


#. Перейдите в ``Обзор импорта`` (``F5``).

   .. image:: ris21.png
      :scale: 100 %
      :align: center
      :alt: Переход к обзору импорта


   Обзор импорта представлен на рисунке ниже.
   
   .. image:: ris22.png
      :scale: 48
      :align: center
      :alt: Обзор импорта


#. Перейдите в список очереди импорта для целевой системы и добавьте запрос к очереди импорта через меню ``Дополнительная информация`` -> ``Другие запросы`` -> ``Добавить``.

   .. image:: ris23.png
      :scale: 68
      :align: center
      :alt: Переход к добавлению запроса на перенос


#. Укажите номер запроса, подтвердите импорт.

   .. image:: ris24.png
      :scale: 100 %
      :align: center
      :alt: Добавление запроса в очередь импорта


#. Осуществите импорт запроса с параметрами, представленными на рисунке ниже.

   .. image:: ris25.png
      :scale: 100 %
      :align: center
      :alt: Опции импорта


.. _install-errors:

Ошибки при установке и обновлении
---------------------------------

Ошибки при установке или обновлении Продукта могут возникнуть по следующим причинам:

#. SAP-система заказчика не соответствует минимальным требованиям Продукта (подробнее см. :ref:`sap-admin-requirements`, :ref:`checklist`).
#. При обновлении у заказчика в Z* коде существуют прямые вызовы xDE (программ, функций, классов и т.п.) без использования API функций.


        
        
.. |ok| image:: ok.png
   :width: 21
   :height: 20

.. |back| image:: back.png
   :width: 24
   :height: 33