Skip to content
  • Categorieën
  • Recent
  • Tags
  • Populair
  • Gebruikers
  • Groepen
  • Zoeken
Collapse
Brand Logo

Kennisbank

administrators

Prive

Berichten


  • Ubuntu Pro Setup Handleiding
    nikitaskliarovN nikitaskliarov

    Ubuntu Pro Setup & Documentatie

    Huidige Status

    • Machine: HP Laptop (Nikita's werk laptop)
    • Subscription: Ubuntu Pro - free personal subscription
    • Account: helpdesk@thefreighthero.com
    • Machines gebruikt: 1/5
    • Kosten: €0,00
    • Verloopt: Nooit

    Wat doet Ubuntu Pro?

    Automatische bescherming:

    • ✅ ESM Apps - Extended Security Maintenance voor applicaties
    • ✅ ESM Infra - Extended Security Maintenance voor infrastructuur
    • ✅ Livepatch - Kernel updates zonder reboot

    Voordelen:

    • 10 jaar beveiligingsupdates (i.p.v. 5 jaar)
    • 23.000+ extra packages krijgen security patches
    • Kernel updates zonder systeem te rebooten
    • Minder downtime tijdens werk

    Dagelijkse Routine

    Niets verandert!

    Blijf gewoon je normale update routine doen:

    sudo apt update && sudo apt upgrade
    

    ESM updates zijn automatisch inbegrepen. Geen extra stappen nodig.

    Optioneel: Maandelijkse check

    Als je wilt verifiëren dat alles werkt:

    pro status
    canonical-livepatch status
    

    Let op: Dit is niet verplicht - het systeem werkt automatisch op de achtergrond.


    Setup Instructies voor Nieuwe IT Laptop

    Stap 1: Ubuntu installeren

    Installeer Ubuntu 24.04 LTS (of nieuwste LTS versie)

    Stap 2: Ubuntu Pro koppelen

    sudo pro attach <token-uit-password-manager>
    

    Het systeem zal automatisch ESM en Livepatch enablen.

    Stap 3: Verifieer installatie

    pro status
    

    Verwachte output:

    SERVICE          ENTITLED  STATUS       DESCRIPTION
    esm-apps         yes       enabled      Expanded Security Maintenance for Applications
    esm-infra        yes       enabled      Expanded Security Maintenance for Infrastructure
    livepatch        yes       enabled      Canonical Livepatch service
    

    Stap 4: Eerste update

    sudo apt update && sudo apt upgrade
    

    Credential Opslag

    Bewaar dit in password manager:

    Service: Ubuntu Pro Free Personal
    Account: helpdesk@thefreighthero.com
    Password: [wachtwoord voor Ubuntu One account]
    Token: [de attach token - zie dashboard]
    Dashboard URL: https://ubuntu.com/pro/dashboard
    Machines limiet: 5
    Huidige machines: HP Laptop
    

    Troubleshooting

    Pro status checken

    pro status
    

    Livepatch status checken

    canonical-livepatch status
    

    Pro opnieuw koppelen (bij problemen)

    sudo pro detach
    sudo pro attach <token>
    

    Welke packages worden beschermd?

    apt list --installed | grep esm
    

    Disaster Recovery

    Als laptop kapot gaat of gestolen wordt:

    1. Nieuwe Ubuntu installatie

      • Installeer Ubuntu 24.04 LTS
      • Herstel backup van oude laptop
    2. Pro opnieuw activeren

      sudo pro attach <token>
      
    3. Verifieer

      pro status
      

    Belangrijk: Je kunt dezelfde token gebruiken op een nieuwe machine. De oude machine wordt automatisch losgekoppeld na een tijdje inactiviteit, of je kunt deze handmatig loskoppelen via het dashboard.

    Dashboard beheer

    • Ga naar: https://ubuntu.com/pro/dashboard
    • Login met: helpdesk@thefreighthero.com
    • Hier zie je alle gekoppelde machines
    • Je kunt machines handmatig loskoppelen indien nodig

    Belangrijke Notities

    Wat Ubuntu Pro NIET verandert:

    • ❌ Geen nieuwe cron jobs nodig
    • ❌ Geen monitoring scripts nodig
    • ❌ Geen extra onderhoudstaken
    • ❌ Geen veranderingen in dagelijkse workflow

    Wat Ubuntu Pro WEL doet:

    • ✅ Automatisch kernel patches toepassen (zonder reboot)
    • ✅ Meer security updates in normale apt upgrade
    • ✅ Langere support periode (10 jaar i.p.v. 5)
    • ✅ Bescherming voor development packages (PHP, Composer, FFmpeg, etc.)

    Gratis tier limieten:

    • Maximum 5 machines
    • Voor persoonlijk of klein zakelijk gebruik
    • Alle enterprise features inbegrepen
    • Geen support contract (community support only)

    Voor Volgende IT Medewerker

    Onboarding checklist:

    • Ubuntu Pro token locatie in password manager
    • Dashboard toegang (
      helpdesk@thefreighthero.com)
    • Verificeer dat HP Laptop nog steeds attached is
    • Test
      pro status command
    • Review deze documentatie

    Belangrijker dan Ubuntu Pro:

    Zorg dat je ook documentatie hebt voor:

    • 🔑 SSH keys voor server toegang
    • 🔑 Database credentials
    • 🔑 API keys (Brevo, Retell AI, Google Maps, etc.)
    • 🔑 GitHub/GitLab toegang
    • 🔑 Hosting/server provider accounts
    • 🔑 Domain registrar toegang

    Ubuntu Pro is nice-to-have, maar bovenstaande zijn mission-critical!


    Updates & Onderhoud

    Normale updates (wanneer systeem vraagt):

    sudo apt update && sudo apt upgrade
    

    Kernel updates:

    • Worden automatisch toegepast door Livepatch
    • Meestal geen reboot nodig
    • Als reboot WEL nodig: je krijgt een notificatie

    Distributie upgrades (bijv. 24.04 → 26.04):

    sudo do-release-upgrade
    

    Ubuntu Pro blijft actief na distributie upgrade.


    Contact & Support

    Ubuntu Pro Dashboard

    https://ubuntu.com/pro/dashboard

    Canonical Support

    • Community forum: https://discourse.ubuntu.com/
    • Documentatie: https://ubuntu.com/pro/docs

    Interne vragen

    Contact Nikita of check deze documentatie eerst.


    Changelog

    Datum Wijziging Door
    22-01-2026 Initiële setup HP Laptop Nikita
    22-01-2026 Documentatie aangemaakt Nikita

    Snelle Referentie

    # Status checken
    pro status
    
    # Livepatch status
    canonical-livepatch status
    
    # Normale updates (inclusief ESM)
    sudo apt update && sudo apt upgrade
    
    # Machine koppelen
    sudo pro attach <token>
    
    # Machine loskoppelen
    sudo pro detach
    
    # Alle Pro services bekijken
    pro status --all
    
    # Specifieke service enablen (normaal niet nodig)
    sudo pro enable <service-name>
    

  • Factuur / quote maken code workflow
    nikitaskliarovN nikitaskliarov

    Invoice System - Zendingspagina

    Overzicht

    Stack: PHP 7.3, Pagekit, Vue 1, Webpack 1


    Functionaliteiten

    • Factuur aanmaken
    • Voortschrijdende factuur aanmaken
    • Knop voor PDF regenereren
    • Creditfactuur aanmaken via wissen knop

    Architectuur

    InvoiceApiController.php

    Doel: API-endpoints voor invoice operaties
    Routes: /invoice, /advanceinvoice
    Verantwoordelijkheid: Request handling, render/rerender functies

    Twee if-else opties voor render:

    • Optie 1: Direct render
    • Optie 2: Render met cache

    InvoiceFactory.php

    Doel: Business logic en invoice-object creatie


    InvoiceMakerModule.php

    Doel: Module initialisatie


    Invoice Generatie

    Invoice.php

    Locatie: packages/bixie/freighthero/invoice_templates/

    Stappen:

    1. Invoice::create()
    2. DOMPDF generate html
    3. Render
    4. Output

    Templates & Vertalingen

    Locatie: packages/bixie/freighthero/invoice_templates/

    Drie templates (taal-gebaseerd):

    • 'en' → TFH-Invoice
    • 'de' → thefreighthero_de
    • 'nl' → thefreighthero

    Vertaalde tekst: invoice_templates/languages/ (3 talen)

    Vertaling gebeurt op de plek in template met vertaalde calculatie lijnen (zie ShipmentApiController)


    Shipment & Invoice Koppeling

    ShipmentApiController.php

    Doel: Return van vertaalde calculatie lijnen

    Property: $shipment->language

    • Gebruikt om template te definiëren van komende factuur

    PDF Opslag

    Locatie:
    root/../invoices/INVOICENUMMER - COMPANY NAME - facturen
    storage/pdf/quotes/zendingsnummer/Quote-S{{ZENDINGSNUMMER}}-{{QUOTE ID VAN hero_freighthero_quote db tabel}}-{{BEDRIJFSNAAM}}-.pdf - offertes

    Proces:

    1. Invoices aanmaken/regenereren
    2. PDF genereren via DOMPDF
    3. Opslaan in gestructureerde directory

    Quote System

    QuoteApiController.php

    Doel: API-endpoints voor quote operaties
    Routes: /quote
    Verantwoordelijkheid: Request handling


    Quote.php

    Locatie: packages/bixie/freighthero/quote_templates/

    Functie: Bevat alle render logica

    Workflow: Identiek aan invoice workflow


    Templates & Vertalingen - Quote

    Locatie: Frontend invoicemaker -> settings -> offertes

    Tekstinstellingen:

    • Drie textvelden (per taal)
    • Achtergrondafbeelding uploader

    Opslaan: Deze instellingen worden opgeslagen in settings, niet in invoice_templates/languages/ (behalve sommige text in quote, zie quote.php bestand


    Versie: 1.0
    Status: Documentatie van huidige implementatie


  • Update dev database
    nikitaskliarovN nikitaskliarov
    1. Export db van production, drop .sql file ergens in /home/dev
    2. Run
    mysql -u dev_portal -p dev_portal < freighther_nl.sql
    

    waar dev_portal is gebruikersnaam en db naam
    wachtwoord vind je in /home/dev/domains/api.development.thefreighthero.nl/public_html/config.php

    Wachtwoord vergeten / niet kan vinden?
    DirectAdmin -> users -> dev -> login as dev -> mysql -> dev_portal -> generate nieuwe wachtwoord en sla deze op
    Vergeet ook niet config.php wachtwoord aan te passen.

    Niet live db aanraken aub, dit mag alleen in dev gedaan worden.

Ledenlijst

nikitaskliarovN nikitaskliarov
M mikewestera
F ferd
  • Login

  • Login or register to search.
  • First post
    Last post
0
  • Categorieën
  • Recent
  • Tags
  • Populair
  • Gebruikers
  • Groepen
  • Zoeken