writtenlocalhost

Date:20/07/2017EUROPEANCOMMISSIONDIGITConnectingEuropeFacilityQuickStartGuidefortheBusinessDocumentMetadataServiceLocation(BDMSL)DocumentApprover(s):ApproverNameRoleJoaoRODRIGUESCEFeDeliveryDocumentReviewers:ReviewerNameRoleAdrienFERIALProductOwnerSummaryofChanges:VersionDateCreatedbyShortDescriptionofChanges1.
526/08/2016AdrienFERIALVersion1.
630/09/2016YvesADAMAligntonewtemplate1.
719/07/2017FlavioSANTOSAddconfigurationparametersTableofContents1.
INTRODUCTION41.
1.
PurposeoftheQuickStartGuide.
41.
2.
Pre-requisites42.
PROCEDURE53.
CONFIGURATION.
73.
1.
Initialparameters74.
CONTACTINFORMATION.
81.
INTRODUCTIONBDMSLstandsforBusinessDocumentMetadataServiceLocation.
BDMSListhesampleimplementationoftheSMLmaintainedbyDGDIGIT.
TheversionoftheBDMSLreferedinthisdocumentis3.
1.
Thisversionimplementsthee-SENSBDXLprofile(putthereferenceinthetableofreferences:http://wiki.
ds.
unipi.
gr/display/ESENS/PR+-+BDXL)1.
1.
PurposeoftheQuickStartGuideThisdocumentprovidesabriefdescriptionoftheinstallationoftheBDMSLcomponent.
ThisapplicationusesLiquibaseasadatabasemanagementtool.
EverywarincludestheSQLupdateswrittenasXMLLiquibasefiles.
Fortheinstallationofthecomponent,toavoidafaileddeployment,itisnecessarytoextracttheXMLLiquibasefiles,configurethemandthenexecutethedatabaseupdates.
Thentheapplicationcanbelaunched.
ThisguideillustratesthedifferentstepsforaninstallationonaTomcatserverwithaMySQLdatabase.
Ifyouuseadifferentapplicationserverand/oradifferentdatabaseprovider,pleaseadaptthecommandlines.
1.
2.
Pre-requisitesJDK7+Tomcat8oUnzipTomcatinthedirectorytomcatDirMySQLdriveroPutthisdriverintothefoldertomcatDir/libLiquibase3.
4TheuserconfiguredforthedatasourceinTomcatmusthaveadministrativerightsonthedatabase2.
PROCEDUREFortheexamplebelowwewillassumetheversionis3.
1.
UnzipLiquibaseinadirectory.
WewillrefertothisdirectoryasliquibaseDirintherestofthisdocument.
Downloadbdmsl-webapp-3.
1-tomcat-mysql.
waronCEFDigitalRepositoryandputitattherootofliquibaseDirOpenacommandpromptinliquibaseDirRunthefollowingcommandlines:unzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-master.
xml>db.
changelog-master.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-default-data-inserts.
xml>db.
changelog-default-data-inserts.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-create.
xml>db.
changelog-create.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-update-3.
0.
1.
xml>db.
changelog-update-3.
0.
1.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-update-3.
1.
RC1.
xml>db.
changelog-update-3.
1.
RC1.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-update-3.
1.
RC2.
xml>db.
changelog-update-3.
1.
RC2.
xmlunzip-pbdmsl-webapp-3.
1-tomcat-mysql.
warWEB-INF/classes/liquibase/db.
changelog-version.
xml>db.
changelog-version.
xmlOpenthefile"db.
changelog-default-data-inserts.
xml":itcontainstheconfigurationsettingsforthefirstlaunch.
Changethevaluesaccordinglywithyourenvironmentbyuncommentingthelastchangeset(underEnvironmentSpecificcomment:id="999999")andaddingupdatestotheexistingData.
Forinstance,youcanchangethedefaultconfigurationpathbymodifyingtheconfigurationDirpropertylikethis:Createanewfileliquibase.
propertiesattherootofliquibaseDirandputthefollowingcontentinthisfile.
Youneedtoadaptthevaluesforyourenvironment:driver:com.
mysql.
jdbc.
Driverclasspath:/lib/mysql-connector-java-5.
1.
34.
jarurl:jdbc:mysql://localhost:3306/bdmslusername:rootpassword:rootchangeLogFile:db.
changelog-master.
xmlRunthefollowingcommandlineinliquibaseDir:liquibaseupdateCopybdmsl-webapp-3.
1-tomcat-mysql.
warinthetomcatDir/webappfolderCreateanewdatasourceinTomcatnamedjava:comp/env/jdbc/edelivery.
ForthatgotoTOMCAT_HOME/conf/context.
xmlandaddtheblock:Starttomcat3.
CONFIGURATIONIntheconfigurationdirectorythatyouspecifiedintheconfigurationDirproperty,youneedtoputthefollowingfiles:keystore.
jks(thenamecanbechangedinthepropertykeystoreFileName).
ThiskeystoremustcontainyourprivatekeywiththealiasandpassworddefinedinpropertieskeystoreAliasandkeystorePassword.
sig0.
private(thenamecanbechangedinthepropertydnsClient.
SIG0KeyFileName).
ThisfileisonlyrequiredifyouuseDNSSEC(i.
e.
propertydnsClient.
SIG0Enabledsettotrue)3.
1.
InitialparametersAftertheexecutionoftheliquibasescriptforthedatabaseapplythefollowings:Switchthenewpropertyauthentication.
bluecoat.
enabledinthetableBDMSL_CONFIGURATIONtotrueiftheSMLmustmanageBlueCoatauthentication.
CreatethefollowingpropertyforeachexistingsubdomainfromthetableBDMSL_SUBDOMAINlikesubdomain.
validation.
smpLogicalAddressProtocolRestriction.
sampleSubDomaininthetableBDMSL_CONFIGURATIONwheresampleSubDomainisthesubdomainname.
Thevalueofthepropertycanbeall,httporhttps.
CreatethefollowingpropertyforeachexistingsubdomainfromthetableBDMSL_SUBDOMAINlikesubdomain.
validation.
participantIdRegex.
sampleSubDomainintableBDMSL_CONFIGURATIONwheresampleSubDomainisthesubdomainname.
ThevalueofthispropertymustbepopulatedwitharegularexpressiontodefinethesyntaxofacceptedsubdomainnamesinadditiontoISO15459constraintsgoverningtheseidentifiers.
Bydefault,theregularexpression^.
*$maybeused.
Itacceptsanysequenceofcharactersandthereforeaddsnorestriction.
ConfigurepropertiesdataInconsistencyAnalyzer.
senderEmailanddataInconsistencyAnalyzer.
recipientEmailforsendingandreceivingDataInconsistencyreportswithappropriateemailaddresses.
CreatethefollowingpropertyforeachexistingsubdomainfromthetableBDMSL_SUBDOMAINlikednsClient.
domain.
sampleSubDomainintableBDMSL_CONFIGURATIONwheresampleSubDomainisthedomainname.
Thevalueofthepropertymustbethedomain.
Restarttheserver(s).
4.
CONTACTINFORMATIONCEFSupportTeamByemail:CEF-EDELIVERY-SUPPORT@ec.
europa.
euByphone:+3222990909StandardService:8amto6pm(NormalECworkingDays)StandbyService*:6pmto8am(CommissionandPublicHolidays,Weekends)*Onlyforcriticalandurgentincidentsandonlybyphone