Installasjonsveiledning
=======================

Arkade 5
********

**Skrivebordsapplikasjon for Windows**

Installer .NET
~~~~~~~~~~~~~~

For å kjøre Arkade 5 må .NET 8 Desktop Runtime være installert:

   * Last ned |dotnet_desktop_x64_download_link| eller |dotnet_desktop_x86_download_link|

.. |dotnet_desktop_x64_download_link| raw:: html

   <a href="https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-desktop-8.0.6-windows-x64-installer" target="_blank">.NET 8 Desktop Runtime  <b>x64</b></a>

.. |dotnet_desktop_x86_download_link| raw:: html

   <a href="https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-desktop-8.0.6-windows-x86-installer" target="_blank">.NET 8 Desktop Runtime <b>x86</b></a>


Installer Arkade 5 
~~~~~~~~~~~~~~~~~~

Last ned siste versjon av Arkade 5 fra `<https://arkade.arkivverket.no/>`_

Start installasjonen ved å dobbeltklikke den nedlastede msi-filen.

.. image:: img/NedlastningerFilViser.png

**Merk: Windows Smart Screen advarsel**
Den følgende advarselen vil vises om Windows-maskinen har "Windows Smart Screen" satt på (Windows 10).

.. image:: img/WinSmartScreenWarning.png

* Klikk på "Mer info"
* Klikk "Kjør likevel"


**Følg installasjonsveiviseren og aksepter alle de foreslåtte installasjonsvalgene.**


Aktiver støtte for validering av SIARD-2.1-filer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For at Arkade skal støtte bruk av verktøyet |database_preservation_toolkit_link| for validering av Siard-filer må følgende instruksjoner utføres:

* Installer Java Runtime Environment (`hjelp <Installasjonsveiledning.html#jre-info>`_)

* Tilgjengeligjør DBPTK Developer for Arkade

	- Last ned :download:`dbptk-app-2.11.0.jar <https://github.com/keeps/dbptk-developer/releases/download/v2.11.0/dbptk-app-2.11.0.jar>`
	- Lagre den nedlastede filen under :file:`<arkadeinstallasjonsmappe>/ThirdPartySoftware/DBPTK/`.

.. image:: img/dbptk_save_location.png

.. |database_preservation_toolkit_link| raw:: html

   <a href="https://database-preservation.com/#developer" target="_blank">Database Preservation Toolkit Developer (DBPTK Developer)</a>

.. note:: Unngå tegnsettproblematikk ved kjøring av DBPTK-jar-fil og Siard-uttrekksfil på Windows ved å velge filbaner for Arkade-installasjon og Arkades prosesseringsområde uten tegn som f.eks. :code:`æøå`
	

Kjør programmet
~~~~~~~~~~~~~~~
.. image:: img/RunTool.png

* Start -> Alle apper
* Finn "Arkade 5" i applikasjons-listen
* Klikk på "Arkade 5" for å kjøre programmet

Avinstallasjon av programmet (Windows 10)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. image:: img/Uninstall_02.png

* Klikk Start -> Instillinger -> System -> Apper og funksjoner
* Velg "Sorter etter installasjonsdato"
* Velg "Arkade" i listen over installerte programmer
* Klikk "Avinstaller"
* Klikk "Avinstaller" igjen i nytt vindu
* Klikk "Ja" på Brukerkontokontroll-advarselen fra Windows

__________________________________________________________________________

Arkade 5 CLI 
************

**Frittstående kommandolinjegrensesnitt for Linux, macOS og Windows**


Installer .NET
~~~~~~~~~~~~~~

For å kjøre Arkade 5 CLI må .NET 8 Runtime være installert.

Med Ubuntu/Debian kan .NET 8 Runtime installeres med følgende kommando:
    
.. code-block:: bash

	sudo apt-get install -y dotnet-runtime-8.0

* **Linux:** Se |dotnet_linux_instructions_link| for din Linux-distribusjon
* **macOS:** Last ned |dotnet_macos_x64_download_link|
* **Windows:** Last ned |dotnet_windows_x64_download_link| eller |dotnet_windows_x86_download_link|

.NET 8 Runtime er inkludert i, og ikke nødvendig å installere i tillegg til, .NET 8 **Desktop** Runtime (som er krevet av Arkade 5 skrivebordsapplikasjon).

.. |dotnet_linux_instructions_link| raw:: html

   <a href="https://docs.microsoft.com/dotnet/core/install/linux" target="_blank">installasjonsinstruksjoner</a>

.. |dotnet_macos_x64_download_link| raw:: html

   <a href="https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-8.0.6-macos-x64-installer" target="_blank">.NET 8 Runtime <b>x64</b></a>

.. |dotnet_windows_x64_download_link| raw:: html

   <a href="https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-8.0.6-windows-x64-installer" target="_blank">.NET 8 Runtime <b>x64</b></a>

.. |dotnet_windows_x86_download_link| raw:: html

   <a href="https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-8.0.6-windows-x86-installer" target="_blank">.NET 8 Runtime <b>x86</b></a>


Installer Arkade 5 CLI
~~~~~~~~~~~~~~~~~~~~~~

Last ned siste versjon av Arkade 5 CLI fra `<https://arkade.arkivverket.no/>`_

Linux/Mac
---------

Pakk ut den nedlastede zip-filen til ønsket plassering. Eksemplet bruker :file:`/opt/Arkade5CLI-{2.x.x}/`, der "*2.x.x*" viser til aktuell versjon.

Gjør deretter :file:`arkade.sh` kjørbar med følgende kommando:

.. code-block:: bash

	chmod +x /opt/Arkade5CLI-2.x.x/arkade.sh

Gjør `Siegfried <https://www.itforarchivists.com/siegfried/>`_ (bundlet programvare for PRONOM formatsjekking) kjørbar:

.. code-block:: bash

	chmod +x /opt/Arkade5CLI-2.x.x/ThirdPartySoftware/Siegfried/siegfried*

**Merk: macOS brukere må i tillegg sikkerhetsklarere** :file:`siegfried_mac` **med følgende kommando\*:**

.. code-block:: bash

	sudo xattr -rd com.apple.quarantine /opt/Arkade5CLI-2.x.x/ThirdPartySoftware/Siegfried/siegfried_mac

Informasjon om hva som skjer i kulissene kan blant annet leses `her <https://support.apple.com/en-us/HT202491>`_.

*\*Det er ikke anbefalt å sikkerhetsklarere en hvilken som helst applikasjon. Bare dersom du er helt sikker på at applikasjonen er trygg bør den sikkerhetsklareres.*


Tilgjengeliggjør :code:`arkade` fra hvor som helst i filsystemet
................................................................

Kjør følgende kommandoer:

.. code-block:: bash

	sudo ln -s -f /opt/Arkade5CLI-2.x.x/arkade.sh /usr/local/bin/arkade
	
	sudo chmod +x /usr/local/bin/arkade

Windows
-------

Pakk ut den nedlastede zip-filen til ønsket plassering. Eksemplet bruker :file:`C:\\Programfiler\\Arkade5CLI-{2.x.x}\\`, der "*2.x.x*" viser til aktuell versjon.

Tilgjengeliggjør :code:`arkade` fra hvor som helst i filsystemet
................................................................

* Åpne Ledetekst (cmd) som administrator

.. image:: img/OpenCmdAsAdmin.png

* Kjør følgende kommando

.. code-block:: batch

	echo "C:\Programfiler\Arkade5CLI-2.x.x\arkade.bat" > C:\Windows\arkade.bat


Aktiver støtte for validering av SIARD-2.1-filer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For at Arkade skal støtte bruk av verktøyet |database_preservation_toolkit_link| for validering av Siard-filer må følgende instruksjoner utføres:

* Installer Java Runtime Environment (`hjelp <Installasjonsveiledning.html#jre-info>`_)

* Tilgjengeligjør DBPTK Developer for Arkade

	- Last ned :download:`dbptk-app-2.11.0.jar <https://github.com/keeps/dbptk-developer/releases/download/v2.11.0/dbptk-app-2.11.0.jar>`
	- Lagre den nedlastede filen under :file:`<arkadeinstallasjonsmappe>/ThirdPartySoftware/DBPTK/`.

.. image:: img/dbptk_save_location.png

.. note:: Unngå tegnsettproblematikk ved kjøring av DBPTK-jar-fil og Siard-uttrekksfil på Windows ved å velge filbaner for Arkade-installasjon og Arkades prosesseringsområde uten tegn som f.eks. :code:`æøå`

Aktiver støtte for validering av PDF/A 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Linux/Mac
---------
For å kunne validere PDF/A-filer må Java Runtime Environment være installert:

* Installer Java Runtime Environment (`hjelp <Installasjonsveiledning.html#jre-info>`_)

Windows
-------
Ingen handling er nødvendig siden biblioteket som brukes for PDF/A-valideringen inkluderer avhengighetene som Windows trenger.


Kjør Arkade 5 CLI
~~~~~~~~~~~~~~~~~

*Det spiller ingen rolle hvor i filsystemet Arkade 5 CLI kjøres fra; plassering for alle inn- og ut-data velges som parametre ved kjøring.*

`Se brukerveiledning for Arkade 5 CLI <Brukerveiledning.html#arkade-5-cli>`_


Avinstaller Arkade 5 CLI
~~~~~~~~~~~~~~~~~~~~~~~~

* Slett katalogen Arkade5CLI-<versjon>
* Slett eventuelle gjenværende systemlogger
* **Linux/Mac:** kjør :code:`sudo rm /usr/local/bin/arkade`
* **Windows:** Åpne ledetekst som administrator og kjør :code:`del C:\Windows\arkade.bat`

*Mindre enn 1 uke gamle system- og feillogger slettes ikke automatisk etter kjøring.* `Les mer ... <Brukerveiledning.html#prosesseringsomrade-cli>`_



.. tip:: Installer Java Runtime Environment
	:name: jre-info
	
	* Last ned installasjonsfil for JRE fra |java_download_link|
	* Installer JRE ved å dobbeltklikke den nedlastede filen


.. |java_download_link| raw:: html

   <a href="https://java.com/en/download/" target="_blank" >https://java.com/en/download/</a>