Installationshandbok
Site-Wide Analysis Tool tillhandahåller prestandaövervakning, rapporter och rekommendationer i realtid dygnet runt, alla dagar för att säkerställa Adobe Commerce säkerhet och användbarhet vid installation av molninfrastruktur. Här finns också detaljerad information om tillgängliga och installerade korrigeringsfiler, tillägg från tredje part och din Adobe Commerce-installation.
Om du har en lokal installation av Adobe Commerce installerar du en agent på din infrastruktur för att använda verktyget. Du behöver inte installera agenten på Adobe Commerce i molninfrastrukturprojekt.
Agent
Med agenten Site-Wide Analysis Tool kan du använda Site-Wide Analysis Tool för lokala installationer av Adobe Commerce.
Agenten Site-Wide Analysis Tool samlar in program- och affärsdata, analyserar dem och ger ytterligare insikter om installationstillståndet så att du kan förbättra kundupplevelsen. Den övervakar ditt program och hjälper dig att identifiera problem med prestanda, säkerhet, tillgänglighet och program.
Följande steg krävs för att installera agenten:
-
Kontrollera systemkraven.
-
Konfigurera API-nycklar i tillägget Commerce Services Connector.
-
Installera agenten.
-
Kör agenten.
Systemkrav
Din lokala infrastruktur måste uppfylla följande krav innan du installerar agenten:
-
Operativsystem
- Linux x86-64-fördelningar, som Red Hat® Enterprise Linux (RHEL), CentOS, Ubuntu, Debian och liknande
note important IMPORTANT Adobe Commerce stöds inte på Microsoft Windows eller macOS. -
Adobe Commerce 2.4.5-p1 eller senare (på grund av beroendet av Service Connector)
-
Commerce Services Connector extension
-
PHP CLI
-
Bash/shell-verktyg
-
php
-
wget
-
awk
-
nice
-
grep
-
openssl
-
Commerce Services Connector
Agenten kräver att tillägget Commerce Services Connector är installerat på datorn och konfigurerat med API-nycklar. Kontrollera att tillägget är installerat genom att köra följande kommando:
bin/magento module:status Magento_ServicesId
Om du har installerat tillägget och konfigurerat det med en befintlig API-nyckel för en annan tjänst, MÅSTE du generera om API-nyckeln och uppdatera den i Adobe Commerce Admin för agenten.
-
Placera webbplatsen i underhållsläge.
-
Logga in på account.magento.com.
note note NOTE Om du har problem med att få åtkomst till ditt konto kan du läsa Det går inte att logga in på Adobe Commerce support eller molnkontot för att få hjälp med felsökning. -
Klicka på API Portal.
-
Klicka på Delete bredvid den befintliga API-nyckeln.
-
Konfigurera en ny API-nyckel.
Om tillägget inte är installerat följer du instruktionerna nedan för att installera det:
-
Lägg till tillägget i din
composer.json
-fil och installera det.code language-bash composer require magento/services-id
-
Aktivera tillägget.
code language-bash bin/magento module:enable Magento_ServicesId
-
Uppdatera databasschemat.
code language-bash bin/magento setup:upgrade
-
Rensa cachen.
code language-bash bin/magento cache:clean
-
Konfigurera API-nycklar för att ansluta tillägget till systemet.
Installera agenten
Vi har skapat ett gränssnittsskript som förenklar installationen. Vi rekommenderar att du använder gränssnittsskriptet, men du kan följa metoden manuell installation om det behövs.
Skript
-
Hämta och kör gränssnittsskriptet.
code language-bash bash -c "$(wget -qO - https://raw.githubusercontent.com/magento-swat/install-agent-helpers/main/install.sh)"
note tip TIP Vi rekommenderar att agenten installeras utanför Adobe Commerce rotprojektkatalog. -
Verifiera installationen.
code language-bash ./scheduler -v
code language-bash Version: 1.0.1 Success exit.
-
När du har hämtat och installerat agenten konfigurerar du den så att den körs på något av följande sätt:
Manuell manual
Om du inte vill använda vårt gränssnittsskript för att installera agenten måste du installera den manuellt genom att följa de här stegen:
-
Skapa en katalog där du vill hämta agenten.
note tip TIP Vi rekommenderar att agenten installeras utanför Adobe Commerce rotprojektkatalog. -
Hämta den binära filen och packa upp den.
note info INFO Om du vill använda Site-Wide Analysis Tool måste du först läsa och godkänna användningsvillkoren som presenteras när du öppnar instrumentpanelen från Adobe Commerce Admin. För AMD64-arkitekturen:
-
Ladda ned startarkivet.
code language-bash curl -O https://updater.supportinsights.adobe.com/launcher/launcher.linux-amd64.tar.gz
-
Packa upp startarkivet.
code language-bash tar -xf launcher.linux-amd64.tar.gz
För ARM64-arkitekturen:
-
Ladda ned startarkivet.
code language-bash curl -O https://updater.supportinsights.adobe.com/launcher/launcher.linux-arm64.tar.gz
-
Packa upp startarkivet.
code language-bash tar -xf launcher.linux-arm64.tar.gz
-
-
(Valfritt) Verifiera signaturen för kontrollsummefilen.
code language-bash echo -n "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQ0lqQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FnOEFNSUlDQ2dLQ0FnRUE0M2FBTk1WRXR3eEZBdTd4TE91dQpacG5FTk9pV3Y2aXpLS29HendGRitMTzZXNEpOR3lRS1Jha0MxTXRsU283VnFPWnhUbHZSSFhQZWt6TG5vSHVHCmdmNEZKa3RPUEE2S3d6cjF4WFZ3RVg4MEFYU1JNYTFadzdyOThhenh0ZHdURVh3bU9GUXdDcjYramFOM3ErbUoKbkRlUWYzMThsclk0NVJxWHV1R294QzBhbWVoakRnTGxJUSs1d1kxR1NtRGRiaDFJOWZqMENVNkNzaFpsOXFtdgorelhjWGh4dlhmTUU4MUZsVUN1elRydHJFb1Bsc3dtVHN3ODNVY1lGNTFUak8zWWVlRno3RFRhRUhMUVVhUlBKClJtVzdxWE9kTGdRdGxIV0t3V2ppMFlrM0d0Ylc3NVBMQ2pGdEQzNytkVDFpTEtzYjFyR0VUYm42V3I0Nno4Z24KY1Q4cVFhS3pYRThoWjJPSDhSWjN1aFVpRHhZQUszdmdsYXJSdUFacmVYMVE2ZHdwYW9ZcERKa29XOXNjNXlkWApBTkJsYnBjVXhiYkpaWThLS0lRSURnTFdOckw3SVNxK2FnYlRXektFZEl0Ni9EZm1YUnJlUmlMbDlQMldvOFRyCnFxaHNHRlZoRHZlMFN6MjYyOU55amgwelloSmRUWXRpdldxbGl6VTdWbXBob1NrVnNqTGtwQXBiUUNtVm9vNkgKakJmdU1sY1JPeWI4TXJCMXZTNDJRU1MrNktkMytwR3JyVnh0akNWaWwyekhSSTRMRGwrVzUwR1B6LzFkeEw2TgprZktZWjVhNUdCZm00aUNlaWVNa3lBT2lKTkxNa1cvcTdwM200ejdUQjJnbWtldm1aU3Z5MnVMNGJLYlRoYXRlCm9sdlpFd253WWRxaktkcVkrOVM1UlNVQ0F3RUFBUT09Ci0tLS0tRU5EIFBVQkxJQyBLRVktLS0tLQ==" | base64 -d > release.pub
code language-bash openssl dgst -sha256 -verify release.pub -signature launcher.sha256 launcher.checksum
-
(Valfritt) Verifiera kontrollsumman.
code language-bash shasum -a 512 -c launcher.checksum
-
Skapa filen
config.yaml
med följande innehåll.code language-yaml project: appname: "Acme Inc" # Company or site name that you provided when installing the agent application: phppath: php # Path to your PHP CLI interpreter (usually /usr/bin/php) magentopath: /var/www/html/example.com # Root directory where your Adobe Commerce application is installed (usually /var/www/html) checkregistrypath: /path/to/swat-agent/tmp # Temporary directory for the agent (usually /usr/local/swat-agent/tmp) issandbox: false # Enabling sandbox mode to use the agent on staging environment (true or false) database: user: your-adobe-commerce-db-username # Database user for your Adobe Commerce installation password: your-password # Database password for the specified user for your Adobe Commerce installation host: 127.0.0.1 # Database host for your Adobe Commerce installation dbname: your-adobe-commerce-db-name # Database name for your Adobe Commerce installation port: 3306 # Database port for your Adobe Commerce installation (usually 3306) tableprefix: # Table Prefix for your Adobe Commerce installation (default value: empty) enableautoupgrade: true # Enables automatic upgrade (restart required after an upgrade; agent does not check for upgrades if the option is disabled; true or false) runchecksonstart: true # Collect data on the first run (Usually 1) loglevel: error # Determines what events are logged based on severity (usually error)
-
Verifiera installationen.
code language-bash scheduler -v
code language-bash Version: 1.0.1 Success exit.
-
När du har hämtat och installerat agenten måste du konfigurera den så att den körs på något av följande sätt:
Kör agenten run-the-agent
Vi rekommenderar att du konfigurerar agenten så att den körs som en tjänst. Om du har begränsad åtkomst till din infrastruktur och inte har rotbehörigheter måste du använda cron i stället.
Tjänst service
-
Skapa en systemenhetsfil
(/etc/systemd/system/scheduler.service)
med följande konfiguration (ersätt<filesystemowner>
med UNIX®-användaren som äger katalogen där agenten och Adobe Commerce-programvaran är installerade). Om du hämtade agenten som rotanvändare ändrar du ägare av katalogen och de kapslade filerna.code language-config [Unit] Wants=network.target After=network.target [Service] Type=simple User=<filesystemowner> ExecStart=/path/to/agent/scheduler Restart=always RestartSec=3 [Install] WantedBy=multi-user.target
-
Starta tjänsten.
code language-bash systemctl daemon-reload
code language-bash systemctl start scheduler
code language-bash systemctl enable scheduler
-
Verifiera att tjänsten körs.
code language-bash journalctl -u scheduler | grep "Application is going to update" | tail -1 && echo "Agent is successfully installed"
Cron cron
Om du inte har rotbehörighet eller inte har behörighet att konfigurera en tjänst som rot kan du använda cron i stället.
Uppdatera ditt kundschema:
( crontab -l ; echo "* * * * * flock -n /tmp/swat-agent.lockfile -c '/path/to/agent/scheduler' >> /path/to/agent/errors.log 2>&1" ) | sort - | uniq - | crontab -
Avinstallera
Kör följande kommandon för att avinstallera tjänsten från datorn och ta bort alla genererade filer:
-
Stoppa schemaläggaren.
code language-bash systemctl stop scheduler
-
Inaktivera schemaläggaren.
code language-bash systemctl disable scheduler
-
Ta bort enhetsfilen
systemd
för schemaläggningstjänsten.code language-bash rm /etc/systemd/system/scheduler.service
-
Läs in hanterarkonfigurationen för
systemd
igen.code language-bash systemctl daemon-reload
-
Återställ eventuella
systemd
enheter från ett felaktigt tillstånd.code language-bash systemctl reset-failed
-
Ta bort tjänstkatalogen för schemaläggaren.
code language-bash rm -rf <CHECK_REGISTRY_PATH> #see SWAT_AGENT_APPLICATION_CHECK_REGISTRY_PATH in /etc/systemd/system/scheduler.service
-
Ta bort den binära filen för schemaläggare.
code language-bash rm /usr/local/bin/scheduler
Om du konfigurerade agenten att köras med cron i stället, ska du göra följande:
-
Ta bort agenten från crontab-listan.
code language-bash crontab -e
-
Stoppa det pågående jobbet.
code language-bash ps aux | grep scheduler
-
Ta bort katalogen där du installerade agenten.
code language-bash rm -rf swat-agent
Felsökning
Åtkomstnycklar har inte tolkats korrekt
Följande fel kan uppstå om dina nycklar inte tolkas som de ska:
ERRO[2022-10-10 00:01:41] Error while refreshing token: error while getting jwt from magento: invalid character 'M' looking for beginning of value
FATA[2022-12-10 20:38:44] bad http status from https://updater.supportinsights.adobe.com/linux-amd64.json: 403 Forbidden
Lös det här felet genom att försöka med följande steg:
- Gör en skriptad installation, spara utdata och granska utdata för fel.
- Granska den genererade
config.yaml
-filen och kontrollera att sökvägen till din Commerce-instans och PHP är korrekt. - Kontrollera att användaren som kör schemaläggaren finns i Unix-gruppen för filsystemet eller är samma användare som filsystemets ägare.
- Kontrollera att nycklarna för Commerce Services Connector är korrekt installerade och försök uppdatera dem för att ansluta tillägget till systemet.
- Avinstallera agenten efter att nycklarna har uppdaterats och installera om med installationsskriptet.
- Kör schemaläggaren och se om du fortfarande får samma fel.
- Om du fortfarande får samma fel kan du öka loggnivån i
config.yaml
för att felsöka och öppna en supportanmälan.
SIGFAULT Fel
Om du får ett SIGFAULT-fel när du kör binära filer, kommer du förmodligen inte att köra detta som filägare för Adobe Commerce- och agentfiler.
Kontrollera också om alla filer i agentkatalogen som har samma användare som fileägaren som Adobe Commerce-filer har och binärfiler ska köras under den användaren.
Du kan använda kommandot chown
för att ändra filägaren och växla till lämplig användare.
Kontrollera att din daemoniseringsmekanism (Cron eller System.d) kör processen under rätt användare.