Selvhjelp og nyttig informasjon om eFormidling

Eformidling på 2 minutter - dette må du vite

  • DPV = Digital post til virksomheter. Eget brukernamn/passord. Brukernamn/passord opprettes av Altinn og passord mottas på SMS. Mer
  • DPF = . Brukernamn/passord for både svarut og svarinn (ulike). Begge settene med brukernamn/passord genereres/hentes på https://svarut.ks.no/. Veiledning finner du her
  • DPO = Digital post til offentlige virksomheter. Eget brukernamn/passord. Opprettes selv
  • Virksomheten må ha et virksomhetssertifikat. Offentlig nøkkel sendes til Difi.
  • Integrasjonspunktet både sender og mottar meldinger.
  • “Started IntegrasjonspunktApplication …” blir logget i \integrasjonspunkt\integrasjonspunkt-logs\application.log like etter fullført oppstart.
  • Bruksvilkår/avtale må være på plass for å bruke eFormidling. Se lenke under.
  • Mer om eFormidling og hvordan det fungerer
  • Standard tid før en melding som feiler blir lagt på DLQ er ca 21t.

For informasjon om ikke tekniske ting og bruksvilkår/avtaler se Samarbeidsportalen

Loggrullering ved installasjon som Windows service

Om integrasjonspunktet ditt er satt opp til å kjøre som en Windows-tjeneste så kan en enkelt også aktivere loggrullering.

Du kan rotere logger på størrelse og samtidig velge hvor mange en ønsker å ta vare på. standardstørrelsen her er 10MB, denne kan du endre til ønsket størrelse. Antall filer som blir tatt vare på er 8. Dette kan også endres. Sørg for at dette er innenfor <service> </service> taggen slik som resten av konfigurasjonen.

<log mode="roll-by-size">
	<sizeThreshold>10240</sizeThreshold>
	<keepFiles>8</keepFiles>
</log> 

Ferdig konfigurert ser det feks slik ut:

<service>
            <id>einnsyn-integrasjonspunkt</id>
            <name>einnsyn-integrasjonspunkt</name>
            <description>Klient for opplasting av journaldata og nedlasting av innsynskrav</description>
            <argument>-jar</argument>
            <argument>integrasjonspunkt-1.7.94.jar</argument>
            <argument>--app.logger.enableSSL=false</argument>
            <logpath>%BASE%/integrasjonspunkt-logs</logpath>
            <log mode="roll-by-size">
                <sizeThreshold>10240</sizeThreshold>
                <keepFiles>8</keepFiles>
            </log>
            <executable>java</executable>
</service>

Justere tilgjengelig minne

For å justere hvor mye minne integrasjonspunktet kan bruke så kan dette gjøres ved å endre oppstartkommandoen. Dette kan være veldig nyttig ved forsendelser via eFormidling (dpo,dpv,dpi,dpf) for å være sikker på at applikasjonen har nok minne til å sende større filer. 1GB minne burde holde for eInnsyn, men for eFormidling bør en gjerne sette minst 2GB, gjerne mer. Dette sørger for at alle integrasjonspunkt kan sende og motta filstørrelser inntil 75MB. Det er viktig at alle setter minimum 2GB minne ved bruk av eFormidling.

-Xmx2048m setter minimum minne som applikasjonen har tilgjengelig

fra kommandolinje

Du må legge inn -Xmx2048m i oppstartskommandoen for å sette feks 2048 MB. Antallet kan justeres til ønske. Feks: java -jar integrasjonspunkt-[versjon].jar --app.logger.enableSSL=false -Xmx2048m

I Windows service

For å gjøre dette på en service så må en legge inn enda et argument i integrasjonspunkt-service.xml-filen. feks slik: <argument>-Xmx2048m</argument>. Sørg for at det er innen for <service>...</service> om du har satt opp integrasjonspunktet som en Windows tjeneste.

Feks:

<service>
            <id>einnsyn-integrasjonspunkt</id>
            <name>einnsyn-integrasjonspunkt</name>
            <description>Klient for opplasting av journaldata og nedlasting av innsynskrav</description>
            <argument>-jar</argument>
            <argument>integrasjonspunkt-1.7.94.jar</argument>
            <argument>--app.logger.enableSSL=false</argument>
            <argument>-Xmx2048m</argument>
            <logpath>%BASE%/integrasjonspunkt-logs</logpath>
            <log mode="roll-by-size">
                <sizeThreshold>10240</sizeThreshold>
                <keepFiles>8</keepFiles>
            </log>
            <executable>java</executable>
</service>

Øke loggnivået ved behov

Det er mulig å øke loggnivået på integrasjonspunktet. Dette gjøres hovedsaklig kun under feilsøking og vil føre til mye ekstra loggmeldinger. Legg inn følgende i “integrasjonspunkt-local.properties” filen.

logging.level.org.springframework.ws.client.MessageTracing=TRACE
logging.level.org.springframework.ws.server.MessageTracing=TRACE

Batch read for eInnsyn-meldinger

Fra og med versjon 1.7.82 av integrasjonspunktet er det mulig å bruke batch read når en leser meldinger fra Azure Service-bus. Dette gjøres ved å benytte Advanced Message Queuing Protocol (AMQP). Les mer her Dette fungerer ikke via rest-grensesnittet.

For å aktivere Batch read i ditt integrasjonspunkt så må du ha versjon 1.7.82 eller nyere og legge inn følgende i integrasjonspunkt-local.properties filen difi.move.nextmove.serviceBus.batchRead=true. I tillegg må du åpne port 5671 for utgående trafikk.

Fersk installasjon av integrasjonspunktet

Etter oppgraderinger kan det skje at det blir liggande igjen gamle kvitteringer i integrasjonspunktet. Dette kan føre til warnings og i nokre tilfeller errors. For å få en fersk installasjon av integrasjonspunktet bør du gjere følgande:

  1. Stopp integrasjonspunktet.
  2. Ta backup av activemq-data mappa og receipts.mv.db fila.
  3. Flytt så desse utav mappa. Sørg for at dei er fjerna frå integrasjonspunktmappa før du går vidare.
  4. Start integrasjonspunktet igjen. Nå vil desse filene bli lasta ned på nytt.