Generellt

En vanlig fil med Java-properties kan användas för att ändra inställningar. Aktivera genom att sätta flaggan -Dspring.config.import=/etc/ei-backend/application.properties

Parameter	Defaultvärde/exempel	Kommentar
server.port	8881	Spring-boot serverport
update.webservice.url	http://localhost:8081/skltp-ei/update-service/v1	URL för Update webbtjänsten
processnotification.webservice.url	http://localhost:8081/skltp-ei/notification-service/v1	URL för ProcessNotification webbtjänsten
findcontent.webservice.url	http://localhost:8082/skltp-ei/find-content-service/v1	URL för FindContent webtjänsten
management.endpoints.web.exposure.include	hawtio,jolokia	Behöver vara 'hawtio,jolokia' för att hawtio ska köras, 'health' behövs för probes
management.endpoint.health.probes.enabled	true (sedan v3.2.1)	Exponera liveness/readiness probes
management.endpoint.health.show-details	always (sedan v3.2.1)	Visa detaljer om health indicators
management.health.livenessState.enabled	true (sedan v3.2.1)	Aktivera inbyggd livess-indikator
management.health.readinessState.enabled	true (sedan v3.2.1)	Aktivera inbyggd readiness-indikator
ei.hsa.id	ei-hsa-id	EIs egna HSA id
ei.alternative.hsa.id	ei-hsa-id	Alternativ till EIs HSA-ID
vp.hsa.id	vp-hsa-id	VP's sender-ID för interna anrop
vp.instance.id	vp-instance-id	VP's instans-ID för interna anrop
getlogicaladdresses.serviceEndpointUrl	http://localhost:8080/vp/getlogicaladdreesses	Utgående URL till GLABSC tjänsten
getlogicaladdresses.logicalAddress	${vp.hsa.id}	HSA id till GLABSC producenten
getlogicaladdresses.vpSenderId	${vp.hsa.id}	VP's sender-ID för interna anrop
getlogicaladdresses.vpInstanceId	${vp.instance.id}	VP's instans-ID för interna anrop
getlogicaladdresses.connectTimeoutMs	5000	Connect timeout ms för GLABSC anrop
getlogicaladdresses.requestTimeoutMs	5000	Request timeout ms för GLABSC anrop
processnotification.serviceEndpointUrl	http://localhost:8080/vp/processnotification	Utgående URL för ProcessNotifications
processnotification.vpSenderId	${vp.hsa.id}	VP's sender-ID för interna anrop
processnotification.vpInstanceId	${vp.instance.id}	VP's instans-ID för interna anrop
subscriber.cache.file.name		Filnamn för lokal cache av subscribers
subscriber.cache.timeToLiveSeconds	7200	Timeout innan subscriber cachen förnyas genom anrop med GLABSC tjänsten
subscriber.cache.reset.url	http://localhost:8083/skltp-ei/resetcache	Adress för att tömma prenumerantcachen
subscriber.cache.status.url	http://localhost:8083/skltp-ei/subscriber/status	Adress för att få status på prenumeranter
ei.status.url	http://localhost:8083/skltp-ei/status	Adress för att få status på EI
update-notification.not.allowed.hsaid.list	${ei.hsa.id},${vp.hsa.id}	Otillåtna HSA-IDn för att undvika recirkulation av anrop

Databas

Serverinställningar

Servern ska sättas upp med olika disk-partitioner för log-, data-, och operativsystem.

En riktlinje för storleken på databasen är att det krävs ca 8GB per 10 millioner poster. Dvs. utrymmet som krävs för en kapacitet om 250 millioner poster är då 200GB disk för datalagring.

Som server kan ett standardblock användas med följande rekommendationer med avseende på resurser:

1x CPU (2.5GHz) med dubbla kärnor eller liknande
4GB RAM
200GB disk-partition för Datafiler
8GB separat disk-partition för OS
4GB separat disk-partition för Logfiler
Linux OS
MySQL 5.5 eller senare

Rekommendation avseende inställningar för MySQL:

Parameter	Värde	Kommentar
innodb	on	Default engine ska vara InnoDB
innodb_log_buffer_size	8M	Rekommendation
innodb_file_per_table	on	Reorganisering av data underlättas om en tabell har egen fil för lagring
innodb_buffer_pool_size	2G	Någonstans mellan 50-75% av RAM är rekommenderat
innodb_log_file_size	512M	Runt 25% av innodb_buffer_pool_size är rekommenderat
innodb_log_group_home_dir	<på egen partition>	Logfiler ska inte lagras på samma disk-partition som datafiler.
innodb_data_home_dir	<på egen partition>	Datafiler ska lagras på separat egen disk-partition, dvs. ej samma som root eller logfiler.
innodb_data_file_path	ibdata1:100M:autoextend:max:5G	...vad är kravet till denna parameter?
innodb_log_arch_dir	<på egen partition>	Arkivfiler ska lagras på separat egen disk-partition, dvs. ej samma som root eller logfiler.
bind-address	<ipadress>	Ipadress mysql skall lyssna på. Notera att bind-address behöver kommenteras bort i globala filen (/etc/mysql/my.cnf)
default-character-set	utf8	TBD
collation-server	utf8_unicode_ci	TBD
character-set-server	utf8	TBD

Det ska baktas att inställningar som ökar prestanda på bekostnad av transaktionssäkerhet som tex innodb_flush_method och innodb_flush_log_at_trx_commit inte ska ställas in på ett sätt som äventyrar konsistensen i databasen.

Observera att databasen ska backas upp online, dvs. en så kallad "hot" backup där rekommendation är:

Full backup 1 ggr per vecka
Inkrementell backup 2 ggr per dygn
Media för backup ska lagras på annan geografisk plats

Applikationsinställningar

Inställningar för applikation:

Applikationen använder Springs standardinställningar för JDBC.

Parameter	Exempel
spring.datasource.url	jdbc:mysql://ei-db:3306/ei?serverTimezone=Europe/Stockholm
spring.datasource.username	ei
spring.datasource.password	secret
spring.datasource.driver-class-name	com.mysql.jdbc.Driver
spring.datasource.jpa.database-platform	org.hibernate.dialect.MySQL5InnoDBDialect
spring.datasource.jpa.hibernate.ddl-auto	update

Köhantering Active MQ

Parameter	Värde	Kommentar
collect.queue.name	skltp.ei.collect	Namn på collect kön i AMQ
collect.queue.completion.size	1000	Antal anrop i kön innan den collectas och skickas till process kön \|
collect.queue.completion.timeout	5	Max sekunder meddelande kan ligga i collect kön innan de skickas till processkön
update.collect.threshold	1	Tröskelvärde för antal engagemang i ett anrop för att de ska hamna direkt i Processkön
process.queue.name	skltp.ei.process	Namn på processkön i AMQ
notification.queue.prefix	EI.NOTIFICATION.	Prefix för namn på notification-köer i AMQ. Kö-namnet bildas av prefixet och prenumerantens logiska adress. Konfigurerbar sedan v3.2.1, default är tidigare hårdkodat värde.
activemq.broker.url	vm://localhost?broker.persistent=false	URL till AMQ broker
activemq.broker.user	admin	Användarnamn för ActiveMQ-användare
activemq.broker.password	secret	Lösenord för ActiveMQ-användare
activemq.broker.maximum-redeliveries	2	Antal leveransförsök som görs innan meddelanden hamnar i dead letter-kön. Standardinställningen är 2
activemq.broker.redelivery-delay	5000	Tid mellan leveransförsök i millisekunder. Standardinställningen är 5000 ms
activemq.broker.use-exponential-backoff (1)	false	Sätt till true om exponential backoff ska användas, annars false.
activemq.broker.backoff-multiplier (1)	3	Om exponential backoff ovan är satt till true, kommer varje omsändningsförsök n att fördröjas med föregående delay * multiplier. Det första omsändningsförsöket sker efter 5 sekunder i exemplet. Exempel: försök 1: 5 sek försök 2: 5* 3 = 15 sek försök 3: 15* 3 = 45 sek försök 4: 45 * 3 = 135 sek försök 5: 135 * 3 = 405 sek
activemq.broker.maximum-redelivery-delay (1)	600000	Maximal tid mellan leveransförsök i millisekunder, om exponential backoff används. Standardinställningen är 600000 ms (10 minuter).
activemq.broker.notification.maximum-redeliveries (1)	${activemq.broker.maximum-redeliveries}	Frivillig parameter med möjlighet att sätta activemq.broker.maximum-redeliveries endast för notification-köer.
activemq.broker.notification.redelivery-delay (1)	${activemq.broker.redelivery-delay}	Frivillig parameter med möjlighet att sätta activemq.broker.redelivery-delay endast för notification-köer.
activemq.broker.notification.use-exponential-backoff (1)	${activemq.broker.use-exponential-backoff}	Frivillig parameter med möjlighet att sätta activemq.broker.use-exponential-backoff endast för notification-köer.
activemq.broker.notification.backoff-multiplier (1)	${activemq.broker.backoff-multiplier}	Frivillig parameter med möjlighet att sätta activemq.broker.backoff-multiplier endast för notification-köer.
activemq.broker.notification.maximum-redelivery-delay (1)	${activemq.broker.maximum-redelivery-delay}	Frivillig parameter med möjlighet att sätta activemq.broker.maximum-redelivery-delay endast för notification-köer.
camel.component.activemq.broker-url	${activemq.broker.url}	Adress till ActiveMQ
camel.component.activemq.trust-all-packages	true	Standard för ActiveMQ är att inte tillåta serialisering av godtyckliga Javaobjekt. Denna inställning ändrar detta beteende.

Not (1): Tillagd i EI version 3.2.0

Loggning

Exempel på loggfil för ei-backend

log4j2.xml

  <Configuration status="WARN" monitorInterval="30">

  <Properties>
    <Property name="LOG_PATTERN">
      %d %-5p [%t] %-30c - %X{corr.id} %m%n
    </Property>
    <Property name="log.dir">
       /var/log/ei-backend
    </Property>
  </Properties>

  <Appenders>

    <RollingRandomAccessFile name="BackendLogFile"
      fileName="${log.dir}/skltp-ei-backend-app.log"
      filePattern="${log.dir}/skltp-ei-backend-app.%i">
      <PatternLayout  pattern="${LOG_PATTERN}"/>
      <Policies>
        <!-- KB, MB -->
        <SizeBasedTriggeringPolicy size="50 MB"/>
      </Policies>
      <DefaultRolloverStrategy fileIndex="min" max="10"/>
    </RollingRandomAccessFile>
  </Appenders>
  <Loggers>


    <!-- Ei application-->
    <Logger name="se.skltp.ei" level="INFO"/>
    <Logger name="se.skltp.ei.subscriber" level="INFO"/>
    <Logger name="se.skltp.ei.service.GetLogicalAddresseesServiceClient" level="WARN"/>
    <Logger name="se.skltp.ei.EiApplication" level="INFO"/>

    <!-- Ei application routes-->
    <Logger name="eiBackendLog" level="debug"/>
      
   <!--Apache camel-->
    <Logger name="org.apache.camel" level="INFO"/>
    <Logger name="org.apache.camel.impl.engine.InternalRouteStartupManager" level="INFO"/>

    <!--Jetty-->
    <Logger name="org.eclipse.jetty" level="WARN"/>

    <!--  ActiveMQ-->
    <Logger name="org.apache.activemq" level="WARN"/>

    <!--  Hibernate -->
    <Logger name="org.hibernate.SQL" level="WARN"/>

    <!--  Cxf -->
    <Logger name="org.apache.cxf" level="WARN"/>

    <Root level="WARN">
      <AppenderRef ref="BackendLogFile"/>
    </Root>

  </Loggers>
</Configuration>

Webbläsaren stöds inte