Upgrade guides

Upcoming


Prior to yum update run the following commands (needed for ProvMon only)
yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
yum update nmsprime-repos


Version 2.5.4

for file in ppp-*; do rrdtool tune "$file" -d ifHCInOctets:DERIVE -d ifHCOutOctets:DERIVE; done


Version 2.4.4 to upcoming release

  • if you are not using the default billing LaTeX templates (storage/app/config/billingbase/template/default-cdr-template.tex and storage/app/config/billingbase/template/default-invoice-template.tex):

    # utf8x causes problems with German umlauts in longtables which are possibly used in the extended CDR content
    # replace
    \usepackage[utf8x]{inputenc}
    # by
    \usepackage[utf8]{inputenc}
    
    # utf8 input encoding does not support the direct use of the Euro character “€”
    # if you are using the Euro character “€” in your templates directly
    # replace
    €
    # by
    \euro

Version 2.4.3 to 2.4.4

  • Only if you dont use the default-invoice-template.tex!

    placeholder 'canceled_to' is now used for cancelation date of contract - so change if-then-else condition & text placeholder in LaTeX invoice template

    # replace
    \ifthenelse{\equal{{last\_cancel\_date}}{}}
        {Der Vertrag wurde gekündigt zum: {end\_of\_term}.}
    %else
    {
        \begin{tabular} {@{}ll}
            % Vertragsbeginn: {start\_of\_term}\\
            Tariflaufzeit: & {maturity}\\
            Nächstmögliches Laufzeitende: & {end\_of\_term}\\
            Kündigungsfrist: & {period\_of\_notice}\\
            Spätester Kündigungszeitpunkt: & {last\_cancel\_date}\\
        \end{tabular}
    }
    # by 
    \ifthenelse{\equal{{canceled\_to}}{}}
    {
        \begin{tabular} {@{}ll}
            % Vertragsbeginn: {start\_of\_term}\\
            Tariflaufzeit: & {maturity}\\
            Nächstmögliches Laufzeitende: & {end\_of\_term}\\
            Kündigungsfrist: & {period\_of\_notice}\\
            Spätester Kündigungszeitpunkt: & {last\_cancel\_date}\\
        \end{tabular}
    }
    %else
    {Der Vertrag wurde gekündigt zum: {canceled\_to}.}
  • After updating the new major release of cacti one needs to:
    • Run the migration via the WebGUI wizard (/cacti)
    • Copy the number of concurrent poller processes from Configuration → Setting → Poller → Default Data Collector Processes to Data Collection → Data Collectors → Main Poller → Processes, alternatively you can run the following command:

      echo "UPDATE poller SET processes = (SELECT value FROM settings WHERE name = 'concurrent_processes') WHERE name = 'Main Poller';" | mysql cacti -u cactiuser -p