multiapachetomcat
apachetomcat 时间:2021-01-11 阅读:()
TechnicalManualSeptember2020AuthorTecnotecasrlwww.
tecnoteca.
comENGwww.
cmdbuild.
orgVersion3.
3TechnicalManualNopartofthisdocumentmaybereproduced,inwholeorinpart,withouttheexpresswrittenpermissionofTecnotecas.
r.
l.
CMDBuildusesmanygreattechnologiesfromtheopensourcecommunity:PostgreSQL,Apache,Tomcat,Eclipse,ExtJS,JasperSoft,JasperReports,IReport,EnhydraShark,TWE,OCSInventory,Liferay,Alfresco,GeoServer,OpenLayers,Quartz,BiMserver.
Wearethankfulforthegreatcontributionsthatledtothecreationoftheseproducts.
CMDBuildisaproductofTecnotecaS.
r.
l.
whichisresponsibleofsoftwaredesignanddevelopment,it'stheofficialmaintainerandhasregisteredtheCMDBuildlogo.
CMDBuildisreleasedunderAGPLopensourcelicense(http://www.
gnu.
org/licenses/agpl-3.
0.
html)CMDBuildisaregisteredtrademarkofTecnotecaSrl.
EverytimetheCMDBuildlogoisused,theofficialmaintainer"Tecnotecasrl"mustbementioned;inaddition,theremustbealinktotheofficialwebsite:http://www.
cmdbuild.
org.
CMDBuildlogo:cannotbemodified(color,proportion,shape,font)inanyway,andcannotbeintegratedintootherlogoscannotbeusedasacorporatelogo,northecompanythatusesitmayappearasauthor/owner/maintaineroftheprojectcannotberemovedfromtheapplication,andinparticularfromtheheaderatthetopofeachpageTheofficialwebsiteishttp://www.
cmdbuild.
orgCMDBuild–OpenSourceConfigurationandManagementDatabasePage2TechnicalManualContents1.
Introduction.
51.
1.
Theapplication.
51.
2.
Officialwebsite.
61.
3.
CMDBuildmodules.
61.
4.
Availablemanuals.
61.
5.
ApplicationsbasedonCMDBuild.
62.
Systemconfiguration.
82.
1.
Hardwarerequirements.
82.
2.
Softwarerequirements.
82.
3.
Clientrequirements.
103.
InstallingCMDBuild.
113.
1.
Gettingstarted.
113.
2.
CMDBuildinstallation.
113.
3.
CMDBuildinstallationviaGUI(WindowsandLinux)113.
4.
CMDBuildmanualinstallation(LinuxandWindows)183.
5.
CMDBuilddatabaseconfigurationviaDbConfigWizard(LinuxandWindows)183.
6.
CMDBuildmanualdatabaseconfigurationforWindows.
193.
7.
CMDBuildmanualdatabaseconfigurationforLinux.
204.
CMDBuildversionupdate.
214.
1.
CMDBuildupdate.
215.
CMDBuildlogs.
225.
1.
CMDBuildlogfiles.
225.
2.
CMDBuildloggerlevels.
225.
3.
CMDBuildlogrotation.
226.
ConfigurationtoaccessaDMSthroughCMIS.
236.
1.
Introduction.
236.
2.
Configurationofcategoriesmanagement.
236.
3.
ConfigurationoftheDMSinCMDBuild.
257.
BackupofCMDBuilddata.
277.
1.
Databasebackup.
277.
2.
Databaserestore.
278.
BackupofAlfrescodata.
288.
1.
Backupschedule.
299.
Authenticationmodes.
309.
1.
Introduction.
309.
2.
Configurationoftheauthenticationtype.
309.
3.
ConfiguringLDAPauthentication.
309.
4.
SinglesignonconfigurationthroughCAS.
3210.
Mobileinterfaceactivation.
3410.
1.
Introduction.
3410.
2.
Componentsandarchitecture.
3410.
3.
Compatibility.
3410.
4.
Limitationofuse.
3511.
GUIFrameworkactivation.
3611.
1.
Introduction.
36CMDBuild–OpenSourceConfigurationandManagementDatabasePage3TechnicalManual11.
2.
Configuration.
3612.
GeoServer.
3812.
1.
GeoServerintroduction.
3812.
2.
InstallingGeoServer.
3813.
BIMServer.
3913.
1.
BIMServerintroduction.
3913.
2.
Installation.
3914.
CMDBuildconfigurationinclustermode.
4214.
1.
Clusterintroduction.
4214.
2.
Clusterconfiguration.
4314.
3.
ConfiguringtheloadbalanceronApache.
4414.
4.
CheckiftheClusterisworking.
4414.
5.
ApplyingpatchesinClustermode.
4415.
Appendix:Glossary.
45CMDBuild–OpenSourceConfigurationandManagementDatabasePage4TechnicalManual1.
Introduction1.
Introduction1.
1.
TheapplicationCMDBuildisanopensourcewebenvironmentfortheconfigurationofcustomapplicationsfortheAssetManagement.
Ontheonehand,itprovidesnativemechanismsfortheadministrator,implementedina"core"codewhichhasbeenkeptseparatedfromthebusinesslogic,sothatthesystemcanbeconfiguredwithallitsfeatures.
Ontheotherhand,itgeneratesdynamicallyawebinterfacefortheoperators,sothattheycankeeptheassetsituationundercontrolandalwaysknowtheircomposition,detachment,functionalrelationsandhowtheyupdate,inordertomanagetheirlife-cycleinacomprehensiveway.
Thesystemadministratorcanbuildandextendhis/herownCMDB(hencethenameoftheproject),modelingtheCMDBaccordingtothecompanyneeds;aproperinterfaceallowsyoutoprogressivelyaddnewclassesofitems,newattributesandnewrelations.
Youcanalsodefinefilters,"views"andaccesspermissionslimitedtorowsandcolumnsofeveryclass.
Usingexternalvisualeditors,theadministratorcandesignworkflows,importthemintoCMDBuildandputthematoperators'disposal,sothattheycanexecutethemaccordingtotheconfiguredautomatism.
Inasimilarway,usingexternalvisualeditors,theadministratorcandesignvariousreportsonCMDBdata(printouts,graphs,barcodelabels,etc.
),importthemintothesystemandputthematoperators'disposal.
Theadministratorcanalsoconfiguresomedashboardsmadeupofchartswhichimmediatelyshowthesituationofsomeindicatorsinthecurrentsystem(KPI).
AtaskmanagerincludedintheuserinterfaceoftheAdministrationModuleallowsyoutoschedulevariousoperations(processstarts,e-mailreceivingandsending,connectorexecutions)andvariouscontrolsontheCMDBdata(synchronousandasynchronousevents).
Basedontheirfindings,itsendsnotifications,startsworkflowsandexecutesscripts.
ThankstodocumentmanagementsystemsthatsupporttheCMISstandard(ContentManagementinteroperabilityServices)-amongwhichthereisalsotheopensourcesolutionAlfresco-youwillbeabletoattachdocuments,pictures,videosandotherfiles.
ThereisalsoaScheduling,whichcanbesuppliedbothautomaticallywhenfillinginadatacardandmanually.
ThisSchedulingwillmanagesingleorrecurringdeadlinesrelated,forexample,tocertifications,warranties,contractswithcustomersandsuppliers,administrativeprocedures,etc.
Moreover,youcanuseGISfeaturestogeoreferenceanddisplayassetsonageographicalmap(externalmapservices)and/oronvectormaps(localGeoServerandspatialdatabasePostGIS)andBIMfeaturestoview3Dmodels(IFCformat).
ThesystemalsoincludesaRESTwebservice,sothatCMDBuilduserscanimplementcustominteroperabilitysolutionswithexternalsystems.
Furthermore,CMDBuildincludestwoexternalframeworks:theAdvancedConnectorCMDBuild,whichiswritteninJavaandcanbeconfiguredinGroovy:ithelpstheimplementationofconnectorswithexternaldatasources,i.
eautomaticinventorysystems,virtualizationormonitoringones(suppliedwithnon-opensourcelicensetotheusersthatsubscribetheannualSubscriptionwithTecnoteca)theGUIFrameworkCMDBuild,whichhelpstheimplementationofadditionalgraphicalCMDBuild–OpenSourceConfigurationandManagementDatabasePage5TechnicalManual1.
Introductioninterfaces,i.
e.
webpages(simplifiedfornontechnicians)thathavetobepublishedonexternalportalsandthatareabletointeractwiththeCMDBthroughtheRESTwebserviceCMDBuildincludesamobileinterface(forsmartphoneandtablet).
Itisimplementedasmulti-platformapp(iOS,Android)andisabletointeractwiththeCMDBthroughtheRESTwebservice(suppliedwithnon-opensourcelicensetotheusersthatsubscribetheannualSubscriptionwithTecnoteca).
CMDBuildisanenterprisesystem:server-sideJava,webAjaxGUI,SOAarchitecture(ServiceOrientedArchitecture),basedonwebserviceandimplementedbyusingthebestopensourcetechnologiesandfollowingthesectorstandards.
CMDBuildisanever-evolvingsystem,whichhasbeenreleasedforthefirsttimein2006andupdatedseveraltimesayearinordertooffermorefeaturesandtosupportnewtechnologies.
1.
2.
OfficialwebsiteCMDBuildhasadedicatedwebsite:http://www.
cmdbuild.
orgThewebsitegathersalotofdocumentsontechnicalandfunctionalfeaturesoftheproject:brochures,slides,manuals(seenextparagraph),testimonials,casehistories,newsletters,forums.
1.
3.
CMDBuildmodulesTheCMDBuildapplicationincludestwomainmodules:theAdministrationModulefortheinitialdefinitionandthenextchangesofthedatamodelandthebaseconfiguration(relationclassesandtypologies,usersandauthorization,dashboards,uploadreportandworkflows,optionsandparameters)theManagementModule,usedtomanagecardsandrelations,addattachments,runworkflowprocesses,visualizedashboardsandexecutereportsTheAdministrationModuleisavailableonlytotheuserswiththe"administrator"role;theManagementModuleisusedbyalltheuserswhoviewandeditdata.
1.
4.
AvailablemanualsThismanualisforthosewhoneedcertainfirstintroductoryinformationonCMDBuildandwhoareinterestedinknowingthegeneralphilosophyoftheproject.
Youcanfindallthemanualsontheofficialwebsite(http://www.
cmdbuild.
org):systemoverview("OverviewManual")systemusageforoperators("UserManual")systemadministration("AdministratorManual")workflowconfiguration("WorkflowManual")webservicedetailsandconfiguration("WebserviceManual")1.
5.
ApplicationsbasedonCMDBuildTecnotecahasusedtheCMDBuildenvironmentinordertoimplementtwodifferentpre-configuredsolutions:CMDBuildREADY2USE,forthemanagementofassetsandITservices,orientedtointernalITinfrastructuresorservicesforexternalclients(http://www.
cmdbuild.
org/it/prodotti/ready2use)accordingtotheITILbestpractice(InformationTechnologyInfrastructureLibrary)openMAINT,fortheinventorymanagementofassets,propertiesandrelatedmaintenanceCMDBuild–OpenSourceConfigurationandManagementDatabasePage6TechnicalManual1.
Introductionactivities(http://www.
openmaint.
org)Bothapplicationsarereleasedwithopensourcelicense,exceptforcertainexternalcomponents(datasyncconnectors,Self-Serviceportal,mobileAPP,etc.
),thatarereservedtotheusersthatsubscribetheannualSubscriptionwithTecnoteca.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage7TechnicalManual2.
Systemconfiguration2.
SystemconfigurationInthefollowingparagraphsthesoftwarerequirementsneededbytheCMDBuildsystemandhowtoinstallandconfigureitscomponentswillbepresented.
Whenplanningthesystemconfiguration,informationsecurityissuesmustbetakenintoaccount.
TheactivationofawebapplicationlikeCMDBuilddemandstheavailabilityofhardwareandnetworkcomponentswithsuitablelevelsofsecurity.
Thisisrequiredinordertoavoidunwantedexternalaccesses(firewall,DMZ)andtodeliveragoodsystemon-lineavailabilityandsuitableresponsetimes.
2.
1.
HardwarerequirementsFortheCMDBuildinstallationaphysicalorvirtualserverisrequired,withthefollowingcharacteristics:recentgenerationCPUaminimumof12GBofRAM,16GBiftherewillbeanintensiveusageofadditionalfunctionalities,suchasDMS,mapserver,BIMserver.
minimaldiskstorage120GB,itshouldbemuchhigherifyouneedtomanageextensivearchivesofdocuments(fedbythemanagementoftheattachments).
Wealsoadvisethat:thediskstorageshouldbeinRAIDconfigurationtheCMDBuildsystemdatashouldbebackedupdailyanavailableUPSinordertoavoidsuddenelectricpowerfailures2.
2.
SoftwarerequirementsCMDBuildinstallationanduserequirethefollowingsoftwarecomponents.
OperatingsystemEveryoperativesystemthatsupportsJVMandtheneededsoftwarewillsupportCMDBuild.
LinuxoperatingsystemissuggestedbecauseCMDBuildismoreextensivelytestedonit.
DatabasePostgreSQLversion10.
1isrequired.
Youshouldcheckwhether"plpgsql"isactiveandwhetherthedatabaseissetwithanUTF-8encoding.
CMDBuildusesthelibrary"tomcat-dbcp"toconnecttothedatabase,thislibraryisdistributedwithTomcatbutisnotincludedinsomeLinuxdistributions.
InsuchcasesthelibrarycanbefoundintheofficialTomcatdistributionorintheextras/tomcat-libs/{Tomcatversiondir}folderinsidetheCMDBuildzipfile;thelibrarymustbeplacedin/usr/share/{Tomcatversiondir}/lib.
CMDBuildsupportsonlythePostgreSQLdatabase,becauseitistheonlyonethatimplementsthefunctionalityof"derivation"oftablesinthe"objectoriented"meaning.
ThisisusedformanagingCMDBuild–OpenSourceConfigurationandManagementDatabasePage8TechnicalManual2.
Systemconfigurationthesubclassesandformanagingthehistoryofcards.
IfyouusetheGISfeaturesofCMDBuildyouhavetoalsoinstallthePostGISspatialextensionforPostGRES.
IfyourequiresupportinstallingandconfiguringPostGISrefertopostgisofficialdocsandsupport:http://www.
postgis.
net/installServletContainer/WebServerCMDBuildneedsApacheTomcat8.
5ormorerecent(suggestedTomcat9.
0.
31).
IfCMDBuildisinstalledviaGUIafreshtomcatinstallationwillbeprovided.
InordertosupporttheUTF-8characterswhenusingattachments(seeInstallationofDMSsystem),edittheconfigurationfile"server.
xml"andspecifytheattributeURIEncoding="UTF-8"forthemain"Connector"element.
YoucanusethewebserverApache2.
2inordertoaccessmanyCMDBuildinstancesthroughvirtualhostssupportingdifferentdomains.
ReferenceWebsiteforboth:http://www.
apache.
org/DocumentManagementSystem(DMS)AnyDMSthatsupportstheCMISprotocolcanbeinstalledfortheDocumentManagementSystemfunctionalities(thatareoptional).
AlfrescoisthesuggestedDMS.
Referencewebsite:http://www.
alfresco.
com/JavaLibrariesTheJavaLibrariesarerequiredbyApacheTomcat.
CMDBuildrequiresOracleJDK11orOpenJDK11.
Referencewebsite:http://www.
oracle.
com/LibrariesincludedinthereleaseTheCMDBuildfiledownloadablefromtheprojectwebsitecontainssomelibrariesalreadyinsidetheinstallationpackage,namely:thelibraryfortheJDBCconnectiontothePostgreSQLdatabasetheJasperReportslibrariesfortheproductionofreports(http://www.
jasperforge.
org/)TWSTogetherWorkflowServer4.
4librarieswhichimplementtheworkflowengineusedbyCMDBuild(http://www.
together.
at/prod/workflow/tws)thewebserviceavailablefromtheDMSAlfrescosysteminordertouseitsrepository(http://www.
alfresco.
com/)theExtJSlibrariesforthegenerationoftheAjaxuserinterface(http://extjs.
com/)theserverandclientcomponentsforthepublicationofgeoreferencedcartography(http://geoserver.
org/ehttp://openlayers.
org/)theserverandclientcomponentsforthevisualizationofBIMcomponentsInordertodesigncustomreports,youcanusethevisualeditorJasperStudio(6.
x)orIReport(version5.
x),whichproducetheirdescriptorincompatibleformatwiththeJasperReportsengineCMDBuild–OpenSourceConfigurationandManagementDatabasePage9TechnicalManual2.
Systemconfiguration(http://jasperforge.
org/projects/ireport).
FordesigningpersonalizedworkflowswesuggestusingthevisualeditorTWETogetherWorkflowEditor5.
5-1orolder(http://www.
together.
at/prod/workflow/twe).
TheeditorproducesanXPDL2.
0filecompatiblewiththeTogetherWorkflowServer4.
4engine.
ForintegratingsystemsofautomaticinventorywesuggestusingtheOCSInventoryversion1.
3.
3(http://www.
ocsinventory-ng.
org/).
SomefunctionalitiesofCMDBuildcanbeintegratedasportletswithinsystemscompatiblewithPortalJSR,amongthemLiferayversion6.
0.
6ormorerecent(http://www.
liferay.
com/).
AllsoftwarelistedabovearereleasedwithanOpenSourcelicense(theoperatingsystemisnotincludedifyouchoosetonotusetheLinuxoperatingsystem).
2.
3.
ClientrequirementsEveryinteractionmadewithCMDBuild(using,administrating,updatingthesystemandstructuringthedatabase)ismadeviawebapplication.
Thismeansthattheuser,inordertointeractwiththesystem,willberequiredtohavearecentgenerationwebbrowserinstalled(supportedbrowser:MozillaFirefox,GoogleChrome,MicrosoftExplorer11,MicrosoftEdge,AppleSafari).
ThewebarchitectureensurescompleteusabilitytoanyITorganizationthatoperatesinmultiplelocations(iecollaborativeworkflow);anyentrustedclientcanconnectandinteractwiththesystemusingastandardwebbrowser.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage10TechnicalManual3.
InstallingCMDBuild3.
InstallingCMDBuild3.
1.
GettingstartedCMDBuildcanbeinstalledindifferentways,theinstallationviaGUIissuggested.
Anyhowthefollowinglistofsoftwarearerequiredbeforetheinstallation:PostgreSQLdatabase(itmustbestartedandaccessible)Tomcatapplicationserver(onlyifmanualinstallationisperformed)theDMSAlfresco(orotherssupportingtheCMISprotocol,ifyouintendtousethemanagementofattacheddocuments)theJavaenvironmentAsafirststepisthereforenecessarytoensuredownloadingandinstallingtheseproducts,retrievingthemfromthelinksmentionedinthepreviouschapter.
Warning:youmusttobecarefultousedirectoriesnotcontainingspaceswithintheentirepath.
3.
2.
CMDBuildinstallationAfterobtainingandinstallingthepreviouslyrequiredprogramswecanproceedwiththeCMDBuildinstallation.
TheinstallationsfilesareprovidedontheofficialCMDBuildwebsiteatthefollowinglink:http://www.
cmdbuild.
org/en/download/A.
warfileisprovidedtoproceedwithbothgraphicalormanualinstallation.
3.
3.
CMDBuildinstallationviaGUI(WindowsandLinux)TosimplifythestandardinstallationandconfigurationofCMDBuild,aguidedGUIinstallationhasbeenprovidedforbothwindowsandunixoperatingsystems.
Oncehavingdownloadedthe.
warfileopenaterminal(onlinux)oracmdwindow(onwindows)andmovetothefoldercontainingthe.
warfile.
ToruntheGUItypethefollowingcommand:java-jarcmdbuild.
war-vThiscommandwilllaunchthegraphicalinterfacelikeinthefollowingscreenshot:Byclicking"installCMDBuildV3"we'llbetakentothefirstconfigurationsteps:CMDBuild–OpenSourceConfigurationandManagementDatabasePage11TechnicalManual3.
InstallingCMDBuildCMDBuild–OpenSourceConfigurationandManagementDatabasePage12TechnicalManual3.
InstallingCMDBuildInthisformwecandecidethebasicconfigurationofCMDBuild,thevariousfieldarenowdescribed:Tomcatdir:thepathwheretoinstallafreshtomcatTomcatport:theportthattomcatwillusetocommunicateDatabasetype:twobasicdatabasesarepresented,anemptyonewhereonlythebasicstructureispresentedbutnodataisadded,orademoonewhereotherthanthebasicstructuresomedataareaddedinfordemonstrationpurposesDatabasehost:thehostwheretoinstalltomcat,localhostifwewanttorunitonourmachineDatabaseport:theportusedtocommunicatetothedatabaseDatabasename:thenameofthedatabasethatwillbecreatedDatabaseuser:thebasicuserofthedatabase,default:cmdbuildDatabasepassword:thebasicuserpasswordofthedatabase,default:cmdbuildDatabaseadminuser:theadminuserofthedatabase,default:postgresDatabaseadminpassword:theadminuserpasswordofthedatabase,default:postgresAgoodpracticeistotesttheconfigurationwiththebutton"TestConfig",ifeverythingiscorrectlyconfiguredthefollowingpop-upwillappear:CMDBuild–OpenSourceConfigurationandManagementDatabasePage13TechnicalManual3.
InstallingCMDBuildWecannowproceedwiththe"INSTALL"button.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage14TechnicalManual3.
InstallingCMDBuildApachetomcatandCMDBuildwillbeinstalled,alsotheselecteddatabasewillbeloaded:CMDBuild–OpenSourceConfigurationandManagementDatabasePage15TechnicalManual3.
InstallingCMDBuildAssoonastheinstallationwillbecompletedapop-upwillaskusifwewanttostarttheapplicationornot:CMDBuild–OpenSourceConfigurationandManagementDatabasePage16TechnicalManual3.
InstallingCMDBuildBychoosingyesApachetomcatwillloadandtheinstallerwillnotifyusassoonastheapplicationisreadytobeused:CMDBuild–OpenSourceConfigurationandManagementDatabasePage17TechnicalManual3.
InstallingCMDBuild3.
4.
CMDBuildmanualinstallation(LinuxandWindows)IfinsteadofthegraphicalinstallationwewanttomanuallyinstallandconfigureCMDBuild,adifferentprocedurehastobefollowed.
FirstofallApacheTomcat(andeveryrequiredsoftwarepreviouslylisted)hastobemanuallyinstalled(checkthechapterabovefordownloadlinksandsupportedversions).
OnceTomcatissuccessfullyinstalledwecanproceedwiththemanualinstallation.
Note:ifyouareinstallingOpenMAINTyoushouldreplacethereferencesto"cmdbuild"with"openmaint".
Thedownloadedfile(cmdbuild-3.
2.
war)containsthewebapplicationfilesthatcanbeextractedinthetomcatinstallationfolderunder/webapps/cmdbuild.
DoingthiswillprovideuswithaworkingCMDBuildinstallation,butnodatabasehasyetbeencreated.
Toconfigurethedatabasewecaneitherusethedatabaseconfigurationwizardprovidedafterthefirsttomcatstartup,orwecanproceedwithamanualconfigurationviacommandline.
3.
5.
CMDBuilddatabaseconfigurationviaDbConfigWizard(LinuxandWindows)AsinCMDBuildversion2.
5orolder,awizardtoperformthedatabaseconfigurationhasbeenprovidedfornewCMDBuildinstallations.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage18TechnicalManual3.
InstallingCMDBuildAfterconfiguringandlaunchingatomcatinstancewiththecmdbuildwebapp,byaccessingtheapplicationviabrowserwewillberedirectedtothedatabaseconfigurationpage:Inthisformwecanconfigurethedatabasewiththefollowingfields:Type:thedatabasewewanttoconfigure,eitheroneoftheprovidedones(demo,empty),anexistingoneorfromafileName:thenameusedbypostgresHost:postgreshostPort:postgresportUsername:standardpostgresusername(suggestedcmdbuild)Password:standardpostgrespassword(suggestedcmdbuild)Adminusername:administratorpostgresusername(suggestedpostgres)Adminpassword:administratorpostgrespassword(suggestedpostgres)Onceeveryfieldhasbeencompileditissuggestedtousethe"Testdatabaseconnection"toverifythevalidityoftheconfiguration,ifnoerrorsaredisplayedwecanproceedbypressingtheconfigurebutton.
Afterasuccessfulconfigurationalistofpatchesthathavetobeappliedtotheuploadeddatabasemightbeshown,bypressing"Applypatches"thesystemwillproceedwiththeapplication.
Assoonastheloginpageisdisplayedthesystemisreadytobeused.
3.
6.
CMDBuildmanualdatabaseconfigurationforWindowsIftheOSinuseisWindows,thedatabaseimporthastobedonemanuallyeitherviasoftwarelikepgAdminorviapostgrescommandline,thedumpfileforthedatabaseisprovidedunderWEB-INF/sql/dumplocatedinthewebappfolder.
Ifyouwanttoloadadumpwhichincludesgis/postgisCMDBuild–OpenSourceConfigurationandManagementDatabasePage19TechnicalManual3.
InstallingCMDBuildfeatures,refertopostgisdocsforanyissueregardingpostgisconfigurationand/orpostgisversionupgrade/migration.
Exampleofpostgisinstallationwithpostgres9.
5andpostgis2.
5forWindows10:-DownloadandInstallpostgres9.
5fromtheofficialwebsitehttp://postgresql.
org/download/windows-Downloadandinstallpostgisforpostgres9.
5fromtheofficialonlinerepository:http://download.
osgeo.
org/postgis/windows/pg95Connecttothepostgresdatabasebyusingasoftwarelikepgadmin4.
Asthedefaultadministrationusercreateanewusernamedcmdbuildwithpassword.
Nextcreateadatabasefortheusercmdbuild,youcannowreconnecttothisdatabaseasusercmdbuildandcreateagisschema:createschemagis;Ceatethepostgisextension(note:youmayhavetograntsuperuserpermissionstocmdbuilduserforthiscommand;youshouldrevokesuperuserpermissionafter):createextensionpostgisschemagis;Youcannowproceedwithimportingadatabase.
Wecanuse,forexample,oneofthedumpsprovidedwiththeCMDBuildinstallation.
Byusingpgadminasusercmdbuild,wecanperformarestorewithcmdbuildastargetdatabase,theimportwillgeneratevariouswarningsthatcanbeignored,thosearecausedbysomeduplicatedinformationinthedumpfileandintheexistingdatabase(gisfunctionandtypes).
Aftertheprocessiscompletedtheapplicationcanbeexecutedbylaunchingtomcatwiththestartupfile,rememberthatiftheportoranytomcatconfigurationshavetobechanged,thiscanbedonebymodifyingthetomcatconfigurationfilecalledserver.
xmlinthefolder/conf.
3.
7.
CMDBuildmanualdatabaseconfigurationforLinuxForthelinuxsystemsthecommandthatwillbeusedisdbconfig,anditcanbecalledbyusingthecmdbuild.
shfileinthewebappfolder.
Thiscommandcanperformthecreationofanewdatabasebasedonadump,andotherfunctionsdescribedintheotherdocumentations.
AtthispointthedemodatabaseprovidedwiththeCMDBuildwarfilecanbeimported.
Todosoyoucanusethedbconfigcommandlikeinthefollowing:bashwebapps/cmdbuild/cmdbuild.
shdbconfigcreatedemo-configfile/path/to/configfileCMDBuildwillnowsetupanewdatabasewiththenameprovidedintheconfigurationandwillloadthedemodumpprovidedinthewarfile.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage20TechnicalManual4.
CMDBuildversionupdate4.
CMDBuildversionupdate4.
1.
CMDBuildupdateInordertoupdateCMDBuildtoanewerversionfollowthisprocedure:Turnofftomcatexecutionandbackupanyneededinformation(i.
e.
thedatabase)Saveanyneededconfigurationfromtheconfigurationfolder:/webapps//WEB-INF/confDeletethedirectoryofyourCMDBuildwebapplicationintomcat(/webapps/)UnpackthewarfileofthenewerversionofCMDBuildinthesamefolderCleanyourbrowsercachetomakesurethateverythingisupdatedWhentheapplicationisnextlaunched,ontheloginscreenapop-upnotifyingthatthereisanewversioninstalledwillappear.
Torestorethepreviouslysavedconfigurationstomcathastobeturnedoffagainandtheoldconfigurationshavetobemovedtotheconfigurationfolder.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage21TechnicalManual5.
CMDBuildlogs5.
CMDBuildlogs5.
1.
CMDBuildlogfilesAfterlaunchingaproperlyconfiguredtomcatwithaninstallationofCMDBuild,inthetomactconffoldervariouslogfileswillbecreatedOfthedifferentfilestheonenamedcmdbuild.
logwillbethemainsourceoflogscomingfromCMDBuild.
Inadditionthecmdbuild_sql.
log(ifenabledinthesystemconfiguration),willprovidealistofthequeriesmadetothedb.
5.
2.
CMDBuildloggerlevelsToavoidasaturationofthelogfile,thestandardloggingprocesswillprovideinformationregardingthemainprogramactivity.
Inneedofamoredetailedloggingitispossibletochangetheloglevelofspecificmodulesbyusingthefollowingrestwscommand:cmdbuild.
shrestwssetloggermodulenameloglevelWherethemodulenamereferstothepackagetolog,inexampleifwewanttochangetheleveloftheworkflowmodulewecoulduseasmodulename`org.
cmdbuild.
workflow`.
Theloglevelcanbeoneof:ERROR,WARN,INFO,DEBUG,TRACEorDEFAULT.
Itisalsopossibletoobtainalistofthecurrentloggerlevelswiththecommandcmdbuild.
shrestwsgetloggers5.
3.
CMDBuildlogrotationCMDBuildalsooffersalogrotationsystem,thismeansthatsomepolicycanbedefinedtosplitandbackupthelogfiles.
NormallyCMDBuildoffersthefollowingconfiguration:Forfilescmdbuild.
log,cmdbuild_req.
log,cmdbuild_job.
log,cmdbuild_sys.
log:limitlogfileto100MBmaxsize;rotatedailyORwhensizeexceedlimit;uponrotation,oldfilesarecompressedandarchivedon/archive/;logfilesareretainedfor90ggORmaxarchivesizeof500MB(pereachsource).
Forfilescmdbuild_sql.
log,cmdbuild_ddl.
log:limitlogfileto100MBmaxsize;whensizeexceedlimit;uponrotation,oldfilesarecompressedandarchivedon/archive/;exactlyonearchivedfileiskeptpereachsource.
Thosepolicycanbechangedintheautogeneratedfilecalledlogback.
xml,inthetomcatconffolder.
AsystemrestartisrequiredafterthechangeshavebeenmadeCMDBuild–OpenSourceConfigurationandManagementDatabasePage22TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS6.
ConfigurationtoaccessaDMSthroughCMIS6.
1.
IntroductionCMDBuildallowstheintegrationwithanydocumentmanagementsystemthatsupportsCMIS,anopenstandardtoexchangedocumentdatathroughthewebprotocol,supportedbyallthemainproductsofthesector.
Theacceptanceofsuchprotocolallowstosupportbasefeaturesto:AttachanykindoffiletoanydatacardAssignacategorytoeveryfileDisplaytheuploadedfilesThemanagementofcategoriesandmetadataatthemomentissupportedonlyfortheprotocolCMIS1.
1,butCMDBuildsupportsevenDMSbasedonCMIS1.
0.
IncaseoftheneedforcategoriesandmetadataaDMSbasedonCMIS1.
1hastobeused.
6.
2.
ConfigurationofcategoriesmanagementInthissectionyouwilllearnhowtoconfigureaDMSthatcansupporttheprotocolCMIS1.
1,inordertomanagetheclassificationofattachmentswhenupdatingandrefreshingthemonCMDBuildcards.
Here'sanexampleoftheconfigurationforAlfresco5.
0.
Notethatthenamesusedhereareunbinding.
Tosetupsomecustomcategorieswithalfresco,twofileshavetobecreatedandsavedinthealfrescofolder:${ALFRESCO_HOME}/tomcat/shared/classes/alfresco/extension1)cmdbuild-model-context.
xmlalfresco/extension/cmdbuild-model.
xmlCMDBuild–OpenSourceConfigurationandManagementDatabasePage23TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS2)cmdbuild-model.
xmlCustomModelforCMDBuildCMDBuildTeam1.
0Classficationd:textCMDBuild–OpenSourceConfigurationandManagementDatabasePage24TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS6.
3.
ConfigurationoftheDMSinCMDBuildViaRESTcommandstheconfigurationsoftheDMSonCMDBuildcanbechanged,eitherviaeditconfigrestcommandtoopenaguishowingalltheavailableconfigurations(ifCMDBuildisonthelocalmachine)orviasetconfig/setconfigsrestcommand,inexample:cmdbuild.
shrestwssetconfigorg.
cmdbuild.
dms.
enabledtrueAlistoftheavailableconfigurationswillnowbepresented:org.
cmdbuild.
dms.
category.
lookupThelookupdefiningthecategoriesofthedocumentsExample:org.
cmdbuild.
dms.
category.
lookupAlfrescoCategoryorg.
cmdbuild.
dms.
enabledTheconfigurationthatenablesordisablesthedmsserviceExample:org.
cmdbuild.
dms.
enabledtrueorg.
cmdbuild.
dms.
service.
cmis.
userTheusernameusedtoaccessthedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
useradminorg.
cmdbuild.
dms.
service.
cmis.
passwordThepasswordusedbythedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
passwordadminorg.
cmdbuild.
dms.
service.
cmis.
pathWheretolocatethedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
path/UserHomes/cmdbuildorg.
cmdbuild.
dms.
service.
cmis.
urlTheurlofthedmsserviceCMDBuild–OpenSourceConfigurationandManagementDatabasePage25TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMISExample:org.
cmdbuild.
dms.
service.
cmis.
urlhttp://localhost:10080/alfresco/api/-default-/public/cmis/versions/1.
1/atomorg.
cmdbuild.
dms.
service.
typeThetypeofprotocolusedbythedmsserviceExample:org.
cmdbuild.
dms.
service.
typecmisCMDBuild–OpenSourceConfigurationandManagementDatabasePage26TechnicalManual7.
BackupofCMDBuilddata7.
BackupofCMDBuilddata7.
1.
DatabasebackupInCMDBuildeveryinformationisstoredinthePostgreSQLDatabase,soinordertoperformabackupoftheinformationweneedtobackupthedatabase.
Variouswayscanperformabackupofthedatabase,programslikePgAdmincanperformthisactionwiththesupportofagraphicalinterface.
OtherwisePostgreSQLprovidesafunctiontoperformadatabasebackup.
Inexample:pg_dump--hostlocalhost--port5432--username"postgres"--formatcustom--verbose--file/backup/cmdbuild/cmdbuild.
backupcmdbuild_dbThiscommandwillcreateabackupofthedatabasewiththename"cmdbuild.
backup".
Thisfilewillbethebackupofthedatabase"cmdbuild_db"onthePostgreSQLinstalledonlocalhostatport5432,performingtheauthenticationastheuser"postgres",compressingthedatabasewithacustomformatandnotifyingtheuserwithwhattheprogramisexecuting(withtheverboseparameter).
Thelocationofwherethebackupfilewillbesavedis/backup/cmdbuild.
7.
2.
DatabaserestoreAbackupcanberestoredatanytimewithasimpleprocedure.
CMDBuildprovidesdifferentfunctionstoperformvariousactions,suchasdatabaserelatedactions.
Ifthepurposeistorestoreabackupthiscommandwillrestorethepreviouslysavedbackupbydroppingthecurrentdatabaseandcreatinganewone:bashwebapps/cmdbuild/cmdbuild.
shdbconfigrecreate/path/to/database/backup.
backupCMDBuild–OpenSourceConfigurationandManagementDatabasePage27TechnicalManual8.
BackupofAlfrescodata8.
BackupofAlfrescodataTobackupdatainAlfrescoyoujusthavetobackupthePostgreSQLdatabase(hereafterwewillassumethatitisinthedatabasePostgreSQL).
AsforCMDBuild,thecommandtobackupthedatabaseoncommandlineisasfollows:pg_dump--hostlocalhost--port5433--username"postgres"--formatcustom--verbose--file/backup/alfresco/alfresco.
backupalfresco_dbItisalsonecessarybackup-asziportar.
gzfile-alsothewholedirectorycontainingtherepositorywherefilesaresaved(e.
g.
:C:/alfresco/repositoryforWindowssystemsor/var/alfresco/repositoryfor*nixsystems).
#!
/bin/shALFRESCO_SERVICE="/etc/init.
d/alfresco"TT_PG_BACKUP="/usr/local/bin/tt_pg_backup.
sh"BACKUP_HOME="/backup"ALFRESCO_BACKUP_HOME="${BACKUP_HOME}/alfresco"BACKUP_LOG="/var/log/cmdbuild/crontab-backup.
log2>&1"ALFRESCO_DATABASE="alfresco"ALFRESCO_DATA="/var/lib/alfresco/data"TIMESTAMP=`date+%Y%m%d%H%M%S`ALFRESCO_DATA_BACKUP="alfresco-data-${TIMESTAMP}.
tar.
gz"logger"StoppingAlfrescoservice"${ALFRESCO_SERVICE}stopsleep5logger"BackuppingAlfrescodatabase"${TT_PG_BACKUP}"${ALFRESCO_BACKUP_HOME}""${ALFRESCO_DATABASE}">${BACKUP_LOG}logger"BackuppingAlfrescodata"tarczf"${ALFRESCO_BACKUP_HOME}/${ALFRESCO_DATA_BACKUP}"${ALFRESCO_DATA}logger"Alfrescodatabase/datahavebeenbackedup.
"logger"StartingAlfrescoservice"${ALFRESCO_SERVICE}startCMDBuild–OpenSourceConfigurationandManagementDatabasePage28TechnicalManual8.
BackupofAlfrescodata8.
1.
BackupscheduleToscheduleaperiodicaldatabackuponLinuxsystems,wesuggestyoutogoonasfollows:1.
createa/etc/cron.
d/backupfile2.
insertthecommandsintothebackupfile,withthepropercronsyntax.
Foramoreefficientcleaningwerecommendyoutocreatevarioussinglescripts,oneforeachsystem,andcalltheminthisfileratherthanwritethecommandsdirectlyintothecronfileitself.
Anexample:0019***root/usr/local/bin/tt_pg_backup.
sh/backup/cmdbuildcmdbuild&>>/var/log/cmdbuild/backup/backup.
log1019**7root/usr/local/bin/alfresco-backup.
sh&>>/var/log/cmdbuild/backup/backup.
logCMDBuild–OpenSourceConfigurationandManagementDatabasePage29TechnicalManual9.
Authenticationmodes9.
Authenticationmodes9.
1.
IntroductionThankstoproperconfigurationsofCMDBuild,theauthenticationcontrolcanbedelegatedtoexternalservices.
Thispossibilityconcernsthecontroloftheaccount(usernameandpassword).
ProfilesandpermissionswillstillbemanagedwithingtheCMDBuildgrouptowhichtheuserbelongs.
ViaRESTcommandstheconfigurationsoftheauthenticationcanbechanged,eitherviaeditconfigrestcommandtoopenaguishowingalltheavailableconfigurations(ifCMDBuildisonthelocalmachine)orviasetconfig/setconfigsrestcommand,inexample:cmdbuild.
shrestwssetconfigorg.
cmdbuild.
auth.
methodsLdapAuthenticator9.
2.
ConfigurationoftheauthenticationtypeBelowthevariousparametersthathavetobesetduringtheconfigurationaredescribed:org.
cmdbuild.
auth.
methodsWiththisparameteryoucandefinetheauthentication"chain"ofCMDBuild.
Itispossible,i.
e.
,todefineincascadewhichtypesofauthenticationyoucanusetoallowaccesstotheuserandsetthepriority.
Exampleorg.
cmdbuild.
auth.
methods=LdapAuthenticator,DBAuthenticatorTheconfigurationinthepreviousexampleindicatesthatwheneverauserlogsintothesystem,CMDBuildmustfirstverifythecredentialsviaLDAP,andiftheyfail,viathedatabaseinCMDBuild.
Theacceptedparametersare:HeaderAuthenticator(authenticationviaheadercontrol)LdapAuthenticator(authenticationviacredentialverificationonLDAP)CasAuthenticator(singlesignthroughCAS)DBAuthenticator(standardauthentication)9.
3.
ConfiguringLDAPauthenticationThissectiondocumentshowtoconfigureauthenticationwithinCMDBuildviaLDAP.
InordertomanagetheuserpermissionswithinCMDBuildisnecessarythatusersthathavetoaccesstoCMDBuildtheyarealsopresentwithinthewebapp.
Forexample,ifauserwithLDAPUIDj.
doeneedsaccessingCMDBuildasauserofthe"technicians"group,youhavetoperformthesesteps:usercreationinj.
doeCMDBuildwithadefaultpassword(notnecessarilythatofLDAP)creationoftheTechnicalGroupanddefinitionoftherelevantpermitsCMDBuild–OpenSourceConfigurationandManagementDatabasePage30TechnicalManual9.
Authenticationmodesaddingusertogroupj.
doeTechniciansAtthispoint,whenyouauthenticatej.
doe,hiscredentialswillbeverified(usingtheauthenticationchaindefinedinauth.
methods)againsttheLDAPtree.
Belowthereisadescriptionoftheconfigurationparameters.
org.
cmdbuild.
auth.
ldap.
server.
addressThisattributeisusedtospecifytheaddresstowhichyoucanreachtheLDAPserver.
Example:org.
cmdbuild.
auth.
ldap.
server.
address=localhostorg.
cmdbuild.
auth.
ldap.
server.
portThisattributeisusedtospecifytheporttheLDAPserver.
Thedefaultis389.
Example:org.
cmdbuild.
auth.
ldap.
server.
port=389org.
cmdbuild.
auth.
ldap.
use.
sslItspecifieswhethertouseanencryptedconnectiontotheLDAPserver.
Thedefaultisdisabled.
Example:org.
cmdbuild.
auth.
ldap.
use.
ssl=trueorg.
cmdbuild.
auth.
ldap.
use.
tlsItspecifieswhethertousetlswiththeLDAPserver.
Thedefaultisdisabled.
Example:org.
cmdbuild.
auth.
ldap.
use.
tls=trueorg.
cmdbuild.
auth.
ldap.
basednThisattributeindicatestheBaseDNthatwillbeusedtoquerytheLDAPtree.
Example:org.
cmdbuild.
auth.
ldap.
basedn=dc=example,dc=comorg.
cmdbuild.
auth.
ldap.
bind.
attributeThisattributeindicatestheattributewillberunonthebinduser.
Forexample,asanattributeforspecifyingbinddnuidandconsideringthebasisindicatedabove,theLDAPquerythatwillbegenerateduid=username,dc=example,dc=com.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage31TechnicalManual9.
AuthenticationmodesExample:org.
cmdbuild.
auth.
ldap.
bind.
attribute=cnorg.
cmdbuild.
auth.
ldap.
search.
filterYoucanspecifywiththisattribute,asearchfiltertobeusedforresearch.
Otherconfigurations:org.
cmdbuild.
auth.
ldap.
search.
auth.
method(none,simpleorstrong)org.
cmdbuild.
auth.
ldap.
search.
auth.
passwordorg.
cmdbuild.
auth.
ldap.
search.
auth.
principal9.
4.
SinglesignonconfigurationthroughCASThissectiondocumentshowtoconfigurethesinglesignon(SSO)withinCMDBuildviaCAS.
Theauthenticationrunsasfollows:theuserasksfortheCMDBuildurltheCASauthenticatorsendstherequesttotheCASserver(${cas.
server.
url}+${cas.
login.
page})specifyingtheCMDBuildaccessurl(inthe${cas.
service.
param}paramter)theCASserveranswerswithaticket(${cas.
ticket.
param}paramter)whichyoucanextracttheusernamefromiftheusernameisproperlyvalidated/extracted,thenCMDBuildgetsonwiththeloginInordertomanagetheuserpermissionswithinCMDBuildisnecessarythatusersthathavetoaccesstoCMDBuildtheyarealsopresentwithinthewebapp.
Belowthereisadescriptionoftheconfigurationparameters.
org.
cmdbuild.
auth.
cas.
server.
urlThisattributeisusedtospecifytheaddresstowhichyoucanreachtheCASserver.
Example:org.
cmdbuild.
auth.
cas.
server.
url=https://cas.
mycompany.
com/casorg.
cmdbuild.
auth.
cas.
login.
pageThisattributeisusedtospecifytheCASloginpageExample:org.
cmdbuild.
auth.
cas.
login.
page=/loginorg.
cmdbuild.
auth.
cas.
service.
paramNameoftheparameterthatCASusestospecifytheurloftheauthenticationservice.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage32TechnicalManual9.
AuthenticationmodesExample:org.
cmdbuild.
auth.
cas.
service.
param=serviceorg.
cmdbuild.
auth.
cas.
ticket.
paramNameoftheparameterthatCASusestospecifytheticketreferencethatitgeneratesuntiltheauthenticationisvalid.
Example:org.
cmdbuild.
auth.
cas.
ticket.
param=ticketCMDBuild–OpenSourceConfigurationandManagementDatabasePage33TechnicalManual10.
Mobileinterfaceactivation10.
Mobileinterfaceactivation10.
1.
IntroductionCMDBuild"mobile"isaninterfacethatcanbeusedonsmartphonesandtabletsinordertorunusefulapplicationfeaturesduringtheactivitiesonfield.
Itiscreatedwith"SenchaTouch"(aJavascriptframeworkdevelopedbySencha,thesameproductorofExtJSframeworkusedbytheCMDBuilddesktopinterface),anditisabletointeractwithCMDBuildviaRESTwebservice.
CMDBuildmobileimplementsthemainfeaturesofthedesktopinterface:multilingual,multigrouplogin,navigationmenus,classmanagement,relations,attachments,…10.
2.
ComponentsandarchitectureTheapplicationiscreatedwiththeusageofthefollowingcomponents:SenchaTouch(JavascriptframeworkcreatedbySencha)Cordova(mobilecross-platformframework)DeftJS(mobileenterpriseextensionforapplicationsdevelopedwithSenchaTouch)log4javascript(javascriptloggingframework)Crosswalk(toolfortheapplicationdeploymentonacustomwebviewindependentfromtheandroidversion)Siesta(libraryfortheusageofunit/integrationtests)Ontheserverside,theRESTwebservicelayerisdevelopedusingtheApacheCXFframework,thatisalreadyintegratedinCMDBuild,alsousedfortheSOAPwebservicelayer.
ThesystemretracesthesoftwarearchitectureoftheRESTwebservicewiththefollowingfeatures:featuresdividedinwebresourcesaddressableresources(URI)HTTPstandardmethods(GET,POST,PUT,DELETE)JSONmediatypelinkfortheresourcenavigationstateless10.
3.
CompatibilityThemobilesystemiscompatiblewith:Android4.
0.
3ormorerecentIOS6ormorerecentCMDBuild–OpenSourceConfigurationandManagementDatabasePage34TechnicalManual10.
Mobileinterfaceactivation10.
4.
LimitationofuseThemobileinterfaceisavailableonlywiththenon-opensourcelicense,whichallowsonlythosewhohavesignedwithTecnotecasrlamaintenanceservicefortheCMDBuildapplication,andonlyuntilthemaintenanceisactive,withalimitedadditionalcharge.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage35TechnicalManual11.
GUIFrameworkactivation11.
GUIFrameworkactivation11.
1.
IntroductionTheGUIFrameworkmakesavailableasimplifiedinterfacetonon-technicalstaff.
TheGUIFrameworkincludesthefollowingmainfeatures:itcanbeactivatedinportalsbasedondifferenttechnologiesasitisdevelopedinjavascript/JQueryenvironmentitallowsan(almost)unlimitedfreedomwhenprojectingthegraphiclayout,definedthroughanXMLdescriptorandwiththepossibilityofinterveningontheCSSitgrantsaquickconfigurationthankstopredefinedfunctions(communication,authenticationlogics,etc.
)andtonativegraphicsolutions(forms,grids,uploadbuttonsandotherwidgets)itinteractswithCMDBuildthroughtheRESTwebserviceitisabletogatherdatafromthedatabaseofotherapplications,allowingthemanagementofmixsolutions11.
2.
ConfigurationTheframeworkdefinesHTMLpagesstartingfromtheirdefinitioninXML.
SuchpagescanbeinsertedintoaHTMLfile,allowingtheframeworktoinsertintoexistingportalsaccesspointstoCMDBuilddata.
ThesystemconfigurabilitycanbeachievedthroughthedefinitionofcustomCSSandJavascript.
Theelementthatshouldbeinsertedintotheportalhtmlisahtmlcontainer(DIV,IFRAME.
.
.
)inthefollowingformat:$(document).
ready(function(){$("#cmdbuilForm").
cmdbuildAP({apiUrl:'http://10.
0.
0.
107:8080/cmdbuild/services/rest/',appRootUrl:'http://10.
0.
0.
107:8080/cmdbuild-gui-framework/api/',appConfigUrl:'http://10.
0.
0.
107:8080/cbap/cbap/config/bologna/',cqlUrl:'http://10.
0.
0.
107:8080/cbap/cbap/cql/',customjs:['backend/GUIForm.
js','backend/Process.
js'],start:"home.
xml",theme:["jquery-ui.
theme-crt-toscana.
min.
css","custom.
css"],CMDBuild–OpenSourceConfigurationandManagementDatabasePage36TechnicalManual11.
GUIFrameworkactivation});});
tecnoteca.
comENGwww.
cmdbuild.
orgVersion3.
3TechnicalManualNopartofthisdocumentmaybereproduced,inwholeorinpart,withouttheexpresswrittenpermissionofTecnotecas.
r.
l.
CMDBuildusesmanygreattechnologiesfromtheopensourcecommunity:PostgreSQL,Apache,Tomcat,Eclipse,ExtJS,JasperSoft,JasperReports,IReport,EnhydraShark,TWE,OCSInventory,Liferay,Alfresco,GeoServer,OpenLayers,Quartz,BiMserver.
Wearethankfulforthegreatcontributionsthatledtothecreationoftheseproducts.
CMDBuildisaproductofTecnotecaS.
r.
l.
whichisresponsibleofsoftwaredesignanddevelopment,it'stheofficialmaintainerandhasregisteredtheCMDBuildlogo.
CMDBuildisreleasedunderAGPLopensourcelicense(http://www.
gnu.
org/licenses/agpl-3.
0.
html)CMDBuildisaregisteredtrademarkofTecnotecaSrl.
EverytimetheCMDBuildlogoisused,theofficialmaintainer"Tecnotecasrl"mustbementioned;inaddition,theremustbealinktotheofficialwebsite:http://www.
cmdbuild.
org.
CMDBuildlogo:cannotbemodified(color,proportion,shape,font)inanyway,andcannotbeintegratedintootherlogoscannotbeusedasacorporatelogo,northecompanythatusesitmayappearasauthor/owner/maintaineroftheprojectcannotberemovedfromtheapplication,andinparticularfromtheheaderatthetopofeachpageTheofficialwebsiteishttp://www.
cmdbuild.
orgCMDBuild–OpenSourceConfigurationandManagementDatabasePage2TechnicalManualContents1.
Introduction.
51.
1.
Theapplication.
51.
2.
Officialwebsite.
61.
3.
CMDBuildmodules.
61.
4.
Availablemanuals.
61.
5.
ApplicationsbasedonCMDBuild.
62.
Systemconfiguration.
82.
1.
Hardwarerequirements.
82.
2.
Softwarerequirements.
82.
3.
Clientrequirements.
103.
InstallingCMDBuild.
113.
1.
Gettingstarted.
113.
2.
CMDBuildinstallation.
113.
3.
CMDBuildinstallationviaGUI(WindowsandLinux)113.
4.
CMDBuildmanualinstallation(LinuxandWindows)183.
5.
CMDBuilddatabaseconfigurationviaDbConfigWizard(LinuxandWindows)183.
6.
CMDBuildmanualdatabaseconfigurationforWindows.
193.
7.
CMDBuildmanualdatabaseconfigurationforLinux.
204.
CMDBuildversionupdate.
214.
1.
CMDBuildupdate.
215.
CMDBuildlogs.
225.
1.
CMDBuildlogfiles.
225.
2.
CMDBuildloggerlevels.
225.
3.
CMDBuildlogrotation.
226.
ConfigurationtoaccessaDMSthroughCMIS.
236.
1.
Introduction.
236.
2.
Configurationofcategoriesmanagement.
236.
3.
ConfigurationoftheDMSinCMDBuild.
257.
BackupofCMDBuilddata.
277.
1.
Databasebackup.
277.
2.
Databaserestore.
278.
BackupofAlfrescodata.
288.
1.
Backupschedule.
299.
Authenticationmodes.
309.
1.
Introduction.
309.
2.
Configurationoftheauthenticationtype.
309.
3.
ConfiguringLDAPauthentication.
309.
4.
SinglesignonconfigurationthroughCAS.
3210.
Mobileinterfaceactivation.
3410.
1.
Introduction.
3410.
2.
Componentsandarchitecture.
3410.
3.
Compatibility.
3410.
4.
Limitationofuse.
3511.
GUIFrameworkactivation.
3611.
1.
Introduction.
36CMDBuild–OpenSourceConfigurationandManagementDatabasePage3TechnicalManual11.
2.
Configuration.
3612.
GeoServer.
3812.
1.
GeoServerintroduction.
3812.
2.
InstallingGeoServer.
3813.
BIMServer.
3913.
1.
BIMServerintroduction.
3913.
2.
Installation.
3914.
CMDBuildconfigurationinclustermode.
4214.
1.
Clusterintroduction.
4214.
2.
Clusterconfiguration.
4314.
3.
ConfiguringtheloadbalanceronApache.
4414.
4.
CheckiftheClusterisworking.
4414.
5.
ApplyingpatchesinClustermode.
4415.
Appendix:Glossary.
45CMDBuild–OpenSourceConfigurationandManagementDatabasePage4TechnicalManual1.
Introduction1.
Introduction1.
1.
TheapplicationCMDBuildisanopensourcewebenvironmentfortheconfigurationofcustomapplicationsfortheAssetManagement.
Ontheonehand,itprovidesnativemechanismsfortheadministrator,implementedina"core"codewhichhasbeenkeptseparatedfromthebusinesslogic,sothatthesystemcanbeconfiguredwithallitsfeatures.
Ontheotherhand,itgeneratesdynamicallyawebinterfacefortheoperators,sothattheycankeeptheassetsituationundercontrolandalwaysknowtheircomposition,detachment,functionalrelationsandhowtheyupdate,inordertomanagetheirlife-cycleinacomprehensiveway.
Thesystemadministratorcanbuildandextendhis/herownCMDB(hencethenameoftheproject),modelingtheCMDBaccordingtothecompanyneeds;aproperinterfaceallowsyoutoprogressivelyaddnewclassesofitems,newattributesandnewrelations.
Youcanalsodefinefilters,"views"andaccesspermissionslimitedtorowsandcolumnsofeveryclass.
Usingexternalvisualeditors,theadministratorcandesignworkflows,importthemintoCMDBuildandputthematoperators'disposal,sothattheycanexecutethemaccordingtotheconfiguredautomatism.
Inasimilarway,usingexternalvisualeditors,theadministratorcandesignvariousreportsonCMDBdata(printouts,graphs,barcodelabels,etc.
),importthemintothesystemandputthematoperators'disposal.
Theadministratorcanalsoconfiguresomedashboardsmadeupofchartswhichimmediatelyshowthesituationofsomeindicatorsinthecurrentsystem(KPI).
AtaskmanagerincludedintheuserinterfaceoftheAdministrationModuleallowsyoutoschedulevariousoperations(processstarts,e-mailreceivingandsending,connectorexecutions)andvariouscontrolsontheCMDBdata(synchronousandasynchronousevents).
Basedontheirfindings,itsendsnotifications,startsworkflowsandexecutesscripts.
ThankstodocumentmanagementsystemsthatsupporttheCMISstandard(ContentManagementinteroperabilityServices)-amongwhichthereisalsotheopensourcesolutionAlfresco-youwillbeabletoattachdocuments,pictures,videosandotherfiles.
ThereisalsoaScheduling,whichcanbesuppliedbothautomaticallywhenfillinginadatacardandmanually.
ThisSchedulingwillmanagesingleorrecurringdeadlinesrelated,forexample,tocertifications,warranties,contractswithcustomersandsuppliers,administrativeprocedures,etc.
Moreover,youcanuseGISfeaturestogeoreferenceanddisplayassetsonageographicalmap(externalmapservices)and/oronvectormaps(localGeoServerandspatialdatabasePostGIS)andBIMfeaturestoview3Dmodels(IFCformat).
ThesystemalsoincludesaRESTwebservice,sothatCMDBuilduserscanimplementcustominteroperabilitysolutionswithexternalsystems.
Furthermore,CMDBuildincludestwoexternalframeworks:theAdvancedConnectorCMDBuild,whichiswritteninJavaandcanbeconfiguredinGroovy:ithelpstheimplementationofconnectorswithexternaldatasources,i.
eautomaticinventorysystems,virtualizationormonitoringones(suppliedwithnon-opensourcelicensetotheusersthatsubscribetheannualSubscriptionwithTecnoteca)theGUIFrameworkCMDBuild,whichhelpstheimplementationofadditionalgraphicalCMDBuild–OpenSourceConfigurationandManagementDatabasePage5TechnicalManual1.
Introductioninterfaces,i.
e.
webpages(simplifiedfornontechnicians)thathavetobepublishedonexternalportalsandthatareabletointeractwiththeCMDBthroughtheRESTwebserviceCMDBuildincludesamobileinterface(forsmartphoneandtablet).
Itisimplementedasmulti-platformapp(iOS,Android)andisabletointeractwiththeCMDBthroughtheRESTwebservice(suppliedwithnon-opensourcelicensetotheusersthatsubscribetheannualSubscriptionwithTecnoteca).
CMDBuildisanenterprisesystem:server-sideJava,webAjaxGUI,SOAarchitecture(ServiceOrientedArchitecture),basedonwebserviceandimplementedbyusingthebestopensourcetechnologiesandfollowingthesectorstandards.
CMDBuildisanever-evolvingsystem,whichhasbeenreleasedforthefirsttimein2006andupdatedseveraltimesayearinordertooffermorefeaturesandtosupportnewtechnologies.
1.
2.
OfficialwebsiteCMDBuildhasadedicatedwebsite:http://www.
cmdbuild.
orgThewebsitegathersalotofdocumentsontechnicalandfunctionalfeaturesoftheproject:brochures,slides,manuals(seenextparagraph),testimonials,casehistories,newsletters,forums.
1.
3.
CMDBuildmodulesTheCMDBuildapplicationincludestwomainmodules:theAdministrationModulefortheinitialdefinitionandthenextchangesofthedatamodelandthebaseconfiguration(relationclassesandtypologies,usersandauthorization,dashboards,uploadreportandworkflows,optionsandparameters)theManagementModule,usedtomanagecardsandrelations,addattachments,runworkflowprocesses,visualizedashboardsandexecutereportsTheAdministrationModuleisavailableonlytotheuserswiththe"administrator"role;theManagementModuleisusedbyalltheuserswhoviewandeditdata.
1.
4.
AvailablemanualsThismanualisforthosewhoneedcertainfirstintroductoryinformationonCMDBuildandwhoareinterestedinknowingthegeneralphilosophyoftheproject.
Youcanfindallthemanualsontheofficialwebsite(http://www.
cmdbuild.
org):systemoverview("OverviewManual")systemusageforoperators("UserManual")systemadministration("AdministratorManual")workflowconfiguration("WorkflowManual")webservicedetailsandconfiguration("WebserviceManual")1.
5.
ApplicationsbasedonCMDBuildTecnotecahasusedtheCMDBuildenvironmentinordertoimplementtwodifferentpre-configuredsolutions:CMDBuildREADY2USE,forthemanagementofassetsandITservices,orientedtointernalITinfrastructuresorservicesforexternalclients(http://www.
cmdbuild.
org/it/prodotti/ready2use)accordingtotheITILbestpractice(InformationTechnologyInfrastructureLibrary)openMAINT,fortheinventorymanagementofassets,propertiesandrelatedmaintenanceCMDBuild–OpenSourceConfigurationandManagementDatabasePage6TechnicalManual1.
Introductionactivities(http://www.
openmaint.
org)Bothapplicationsarereleasedwithopensourcelicense,exceptforcertainexternalcomponents(datasyncconnectors,Self-Serviceportal,mobileAPP,etc.
),thatarereservedtotheusersthatsubscribetheannualSubscriptionwithTecnoteca.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage7TechnicalManual2.
Systemconfiguration2.
SystemconfigurationInthefollowingparagraphsthesoftwarerequirementsneededbytheCMDBuildsystemandhowtoinstallandconfigureitscomponentswillbepresented.
Whenplanningthesystemconfiguration,informationsecurityissuesmustbetakenintoaccount.
TheactivationofawebapplicationlikeCMDBuilddemandstheavailabilityofhardwareandnetworkcomponentswithsuitablelevelsofsecurity.
Thisisrequiredinordertoavoidunwantedexternalaccesses(firewall,DMZ)andtodeliveragoodsystemon-lineavailabilityandsuitableresponsetimes.
2.
1.
HardwarerequirementsFortheCMDBuildinstallationaphysicalorvirtualserverisrequired,withthefollowingcharacteristics:recentgenerationCPUaminimumof12GBofRAM,16GBiftherewillbeanintensiveusageofadditionalfunctionalities,suchasDMS,mapserver,BIMserver.
minimaldiskstorage120GB,itshouldbemuchhigherifyouneedtomanageextensivearchivesofdocuments(fedbythemanagementoftheattachments).
Wealsoadvisethat:thediskstorageshouldbeinRAIDconfigurationtheCMDBuildsystemdatashouldbebackedupdailyanavailableUPSinordertoavoidsuddenelectricpowerfailures2.
2.
SoftwarerequirementsCMDBuildinstallationanduserequirethefollowingsoftwarecomponents.
OperatingsystemEveryoperativesystemthatsupportsJVMandtheneededsoftwarewillsupportCMDBuild.
LinuxoperatingsystemissuggestedbecauseCMDBuildismoreextensivelytestedonit.
DatabasePostgreSQLversion10.
1isrequired.
Youshouldcheckwhether"plpgsql"isactiveandwhetherthedatabaseissetwithanUTF-8encoding.
CMDBuildusesthelibrary"tomcat-dbcp"toconnecttothedatabase,thislibraryisdistributedwithTomcatbutisnotincludedinsomeLinuxdistributions.
InsuchcasesthelibrarycanbefoundintheofficialTomcatdistributionorintheextras/tomcat-libs/{Tomcatversiondir}folderinsidetheCMDBuildzipfile;thelibrarymustbeplacedin/usr/share/{Tomcatversiondir}/lib.
CMDBuildsupportsonlythePostgreSQLdatabase,becauseitistheonlyonethatimplementsthefunctionalityof"derivation"oftablesinthe"objectoriented"meaning.
ThisisusedformanagingCMDBuild–OpenSourceConfigurationandManagementDatabasePage8TechnicalManual2.
Systemconfigurationthesubclassesandformanagingthehistoryofcards.
IfyouusetheGISfeaturesofCMDBuildyouhavetoalsoinstallthePostGISspatialextensionforPostGRES.
IfyourequiresupportinstallingandconfiguringPostGISrefertopostgisofficialdocsandsupport:http://www.
postgis.
net/installServletContainer/WebServerCMDBuildneedsApacheTomcat8.
5ormorerecent(suggestedTomcat9.
0.
31).
IfCMDBuildisinstalledviaGUIafreshtomcatinstallationwillbeprovided.
InordertosupporttheUTF-8characterswhenusingattachments(seeInstallationofDMSsystem),edittheconfigurationfile"server.
xml"andspecifytheattributeURIEncoding="UTF-8"forthemain"Connector"element.
YoucanusethewebserverApache2.
2inordertoaccessmanyCMDBuildinstancesthroughvirtualhostssupportingdifferentdomains.
ReferenceWebsiteforboth:http://www.
apache.
org/DocumentManagementSystem(DMS)AnyDMSthatsupportstheCMISprotocolcanbeinstalledfortheDocumentManagementSystemfunctionalities(thatareoptional).
AlfrescoisthesuggestedDMS.
Referencewebsite:http://www.
alfresco.
com/JavaLibrariesTheJavaLibrariesarerequiredbyApacheTomcat.
CMDBuildrequiresOracleJDK11orOpenJDK11.
Referencewebsite:http://www.
oracle.
com/LibrariesincludedinthereleaseTheCMDBuildfiledownloadablefromtheprojectwebsitecontainssomelibrariesalreadyinsidetheinstallationpackage,namely:thelibraryfortheJDBCconnectiontothePostgreSQLdatabasetheJasperReportslibrariesfortheproductionofreports(http://www.
jasperforge.
org/)TWSTogetherWorkflowServer4.
4librarieswhichimplementtheworkflowengineusedbyCMDBuild(http://www.
together.
at/prod/workflow/tws)thewebserviceavailablefromtheDMSAlfrescosysteminordertouseitsrepository(http://www.
alfresco.
com/)theExtJSlibrariesforthegenerationoftheAjaxuserinterface(http://extjs.
com/)theserverandclientcomponentsforthepublicationofgeoreferencedcartography(http://geoserver.
org/ehttp://openlayers.
org/)theserverandclientcomponentsforthevisualizationofBIMcomponentsInordertodesigncustomreports,youcanusethevisualeditorJasperStudio(6.
x)orIReport(version5.
x),whichproducetheirdescriptorincompatibleformatwiththeJasperReportsengineCMDBuild–OpenSourceConfigurationandManagementDatabasePage9TechnicalManual2.
Systemconfiguration(http://jasperforge.
org/projects/ireport).
FordesigningpersonalizedworkflowswesuggestusingthevisualeditorTWETogetherWorkflowEditor5.
5-1orolder(http://www.
together.
at/prod/workflow/twe).
TheeditorproducesanXPDL2.
0filecompatiblewiththeTogetherWorkflowServer4.
4engine.
ForintegratingsystemsofautomaticinventorywesuggestusingtheOCSInventoryversion1.
3.
3(http://www.
ocsinventory-ng.
org/).
SomefunctionalitiesofCMDBuildcanbeintegratedasportletswithinsystemscompatiblewithPortalJSR,amongthemLiferayversion6.
0.
6ormorerecent(http://www.
liferay.
com/).
AllsoftwarelistedabovearereleasedwithanOpenSourcelicense(theoperatingsystemisnotincludedifyouchoosetonotusetheLinuxoperatingsystem).
2.
3.
ClientrequirementsEveryinteractionmadewithCMDBuild(using,administrating,updatingthesystemandstructuringthedatabase)ismadeviawebapplication.
Thismeansthattheuser,inordertointeractwiththesystem,willberequiredtohavearecentgenerationwebbrowserinstalled(supportedbrowser:MozillaFirefox,GoogleChrome,MicrosoftExplorer11,MicrosoftEdge,AppleSafari).
ThewebarchitectureensurescompleteusabilitytoanyITorganizationthatoperatesinmultiplelocations(iecollaborativeworkflow);anyentrustedclientcanconnectandinteractwiththesystemusingastandardwebbrowser.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage10TechnicalManual3.
InstallingCMDBuild3.
InstallingCMDBuild3.
1.
GettingstartedCMDBuildcanbeinstalledindifferentways,theinstallationviaGUIissuggested.
Anyhowthefollowinglistofsoftwarearerequiredbeforetheinstallation:PostgreSQLdatabase(itmustbestartedandaccessible)Tomcatapplicationserver(onlyifmanualinstallationisperformed)theDMSAlfresco(orotherssupportingtheCMISprotocol,ifyouintendtousethemanagementofattacheddocuments)theJavaenvironmentAsafirststepisthereforenecessarytoensuredownloadingandinstallingtheseproducts,retrievingthemfromthelinksmentionedinthepreviouschapter.
Warning:youmusttobecarefultousedirectoriesnotcontainingspaceswithintheentirepath.
3.
2.
CMDBuildinstallationAfterobtainingandinstallingthepreviouslyrequiredprogramswecanproceedwiththeCMDBuildinstallation.
TheinstallationsfilesareprovidedontheofficialCMDBuildwebsiteatthefollowinglink:http://www.
cmdbuild.
org/en/download/A.
warfileisprovidedtoproceedwithbothgraphicalormanualinstallation.
3.
3.
CMDBuildinstallationviaGUI(WindowsandLinux)TosimplifythestandardinstallationandconfigurationofCMDBuild,aguidedGUIinstallationhasbeenprovidedforbothwindowsandunixoperatingsystems.
Oncehavingdownloadedthe.
warfileopenaterminal(onlinux)oracmdwindow(onwindows)andmovetothefoldercontainingthe.
warfile.
ToruntheGUItypethefollowingcommand:java-jarcmdbuild.
war-vThiscommandwilllaunchthegraphicalinterfacelikeinthefollowingscreenshot:Byclicking"installCMDBuildV3"we'llbetakentothefirstconfigurationsteps:CMDBuild–OpenSourceConfigurationandManagementDatabasePage11TechnicalManual3.
InstallingCMDBuildCMDBuild–OpenSourceConfigurationandManagementDatabasePage12TechnicalManual3.
InstallingCMDBuildInthisformwecandecidethebasicconfigurationofCMDBuild,thevariousfieldarenowdescribed:Tomcatdir:thepathwheretoinstallafreshtomcatTomcatport:theportthattomcatwillusetocommunicateDatabasetype:twobasicdatabasesarepresented,anemptyonewhereonlythebasicstructureispresentedbutnodataisadded,orademoonewhereotherthanthebasicstructuresomedataareaddedinfordemonstrationpurposesDatabasehost:thehostwheretoinstalltomcat,localhostifwewanttorunitonourmachineDatabaseport:theportusedtocommunicatetothedatabaseDatabasename:thenameofthedatabasethatwillbecreatedDatabaseuser:thebasicuserofthedatabase,default:cmdbuildDatabasepassword:thebasicuserpasswordofthedatabase,default:cmdbuildDatabaseadminuser:theadminuserofthedatabase,default:postgresDatabaseadminpassword:theadminuserpasswordofthedatabase,default:postgresAgoodpracticeistotesttheconfigurationwiththebutton"TestConfig",ifeverythingiscorrectlyconfiguredthefollowingpop-upwillappear:CMDBuild–OpenSourceConfigurationandManagementDatabasePage13TechnicalManual3.
InstallingCMDBuildWecannowproceedwiththe"INSTALL"button.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage14TechnicalManual3.
InstallingCMDBuildApachetomcatandCMDBuildwillbeinstalled,alsotheselecteddatabasewillbeloaded:CMDBuild–OpenSourceConfigurationandManagementDatabasePage15TechnicalManual3.
InstallingCMDBuildAssoonastheinstallationwillbecompletedapop-upwillaskusifwewanttostarttheapplicationornot:CMDBuild–OpenSourceConfigurationandManagementDatabasePage16TechnicalManual3.
InstallingCMDBuildBychoosingyesApachetomcatwillloadandtheinstallerwillnotifyusassoonastheapplicationisreadytobeused:CMDBuild–OpenSourceConfigurationandManagementDatabasePage17TechnicalManual3.
InstallingCMDBuild3.
4.
CMDBuildmanualinstallation(LinuxandWindows)IfinsteadofthegraphicalinstallationwewanttomanuallyinstallandconfigureCMDBuild,adifferentprocedurehastobefollowed.
FirstofallApacheTomcat(andeveryrequiredsoftwarepreviouslylisted)hastobemanuallyinstalled(checkthechapterabovefordownloadlinksandsupportedversions).
OnceTomcatissuccessfullyinstalledwecanproceedwiththemanualinstallation.
Note:ifyouareinstallingOpenMAINTyoushouldreplacethereferencesto"cmdbuild"with"openmaint".
Thedownloadedfile(cmdbuild-3.
2.
war)containsthewebapplicationfilesthatcanbeextractedinthetomcatinstallationfolderunder/webapps/cmdbuild.
DoingthiswillprovideuswithaworkingCMDBuildinstallation,butnodatabasehasyetbeencreated.
Toconfigurethedatabasewecaneitherusethedatabaseconfigurationwizardprovidedafterthefirsttomcatstartup,orwecanproceedwithamanualconfigurationviacommandline.
3.
5.
CMDBuilddatabaseconfigurationviaDbConfigWizard(LinuxandWindows)AsinCMDBuildversion2.
5orolder,awizardtoperformthedatabaseconfigurationhasbeenprovidedfornewCMDBuildinstallations.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage18TechnicalManual3.
InstallingCMDBuildAfterconfiguringandlaunchingatomcatinstancewiththecmdbuildwebapp,byaccessingtheapplicationviabrowserwewillberedirectedtothedatabaseconfigurationpage:Inthisformwecanconfigurethedatabasewiththefollowingfields:Type:thedatabasewewanttoconfigure,eitheroneoftheprovidedones(demo,empty),anexistingoneorfromafileName:thenameusedbypostgresHost:postgreshostPort:postgresportUsername:standardpostgresusername(suggestedcmdbuild)Password:standardpostgrespassword(suggestedcmdbuild)Adminusername:administratorpostgresusername(suggestedpostgres)Adminpassword:administratorpostgrespassword(suggestedpostgres)Onceeveryfieldhasbeencompileditissuggestedtousethe"Testdatabaseconnection"toverifythevalidityoftheconfiguration,ifnoerrorsaredisplayedwecanproceedbypressingtheconfigurebutton.
Afterasuccessfulconfigurationalistofpatchesthathavetobeappliedtotheuploadeddatabasemightbeshown,bypressing"Applypatches"thesystemwillproceedwiththeapplication.
Assoonastheloginpageisdisplayedthesystemisreadytobeused.
3.
6.
CMDBuildmanualdatabaseconfigurationforWindowsIftheOSinuseisWindows,thedatabaseimporthastobedonemanuallyeitherviasoftwarelikepgAdminorviapostgrescommandline,thedumpfileforthedatabaseisprovidedunderWEB-INF/sql/dumplocatedinthewebappfolder.
Ifyouwanttoloadadumpwhichincludesgis/postgisCMDBuild–OpenSourceConfigurationandManagementDatabasePage19TechnicalManual3.
InstallingCMDBuildfeatures,refertopostgisdocsforanyissueregardingpostgisconfigurationand/orpostgisversionupgrade/migration.
Exampleofpostgisinstallationwithpostgres9.
5andpostgis2.
5forWindows10:-DownloadandInstallpostgres9.
5fromtheofficialwebsitehttp://postgresql.
org/download/windows-Downloadandinstallpostgisforpostgres9.
5fromtheofficialonlinerepository:http://download.
osgeo.
org/postgis/windows/pg95Connecttothepostgresdatabasebyusingasoftwarelikepgadmin4.
Asthedefaultadministrationusercreateanewusernamedcmdbuildwithpassword.
Nextcreateadatabasefortheusercmdbuild,youcannowreconnecttothisdatabaseasusercmdbuildandcreateagisschema:createschemagis;Ceatethepostgisextension(note:youmayhavetograntsuperuserpermissionstocmdbuilduserforthiscommand;youshouldrevokesuperuserpermissionafter):createextensionpostgisschemagis;Youcannowproceedwithimportingadatabase.
Wecanuse,forexample,oneofthedumpsprovidedwiththeCMDBuildinstallation.
Byusingpgadminasusercmdbuild,wecanperformarestorewithcmdbuildastargetdatabase,theimportwillgeneratevariouswarningsthatcanbeignored,thosearecausedbysomeduplicatedinformationinthedumpfileandintheexistingdatabase(gisfunctionandtypes).
Aftertheprocessiscompletedtheapplicationcanbeexecutedbylaunchingtomcatwiththestartupfile,rememberthatiftheportoranytomcatconfigurationshavetobechanged,thiscanbedonebymodifyingthetomcatconfigurationfilecalledserver.
xmlinthefolder/conf.
3.
7.
CMDBuildmanualdatabaseconfigurationforLinuxForthelinuxsystemsthecommandthatwillbeusedisdbconfig,anditcanbecalledbyusingthecmdbuild.
shfileinthewebappfolder.
Thiscommandcanperformthecreationofanewdatabasebasedonadump,andotherfunctionsdescribedintheotherdocumentations.
AtthispointthedemodatabaseprovidedwiththeCMDBuildwarfilecanbeimported.
Todosoyoucanusethedbconfigcommandlikeinthefollowing:bashwebapps/cmdbuild/cmdbuild.
shdbconfigcreatedemo-configfile/path/to/configfileCMDBuildwillnowsetupanewdatabasewiththenameprovidedintheconfigurationandwillloadthedemodumpprovidedinthewarfile.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage20TechnicalManual4.
CMDBuildversionupdate4.
CMDBuildversionupdate4.
1.
CMDBuildupdateInordertoupdateCMDBuildtoanewerversionfollowthisprocedure:Turnofftomcatexecutionandbackupanyneededinformation(i.
e.
thedatabase)Saveanyneededconfigurationfromtheconfigurationfolder:/webapps//WEB-INF/confDeletethedirectoryofyourCMDBuildwebapplicationintomcat(/webapps/)UnpackthewarfileofthenewerversionofCMDBuildinthesamefolderCleanyourbrowsercachetomakesurethateverythingisupdatedWhentheapplicationisnextlaunched,ontheloginscreenapop-upnotifyingthatthereisanewversioninstalledwillappear.
Torestorethepreviouslysavedconfigurationstomcathastobeturnedoffagainandtheoldconfigurationshavetobemovedtotheconfigurationfolder.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage21TechnicalManual5.
CMDBuildlogs5.
CMDBuildlogs5.
1.
CMDBuildlogfilesAfterlaunchingaproperlyconfiguredtomcatwithaninstallationofCMDBuild,inthetomactconffoldervariouslogfileswillbecreatedOfthedifferentfilestheonenamedcmdbuild.
logwillbethemainsourceoflogscomingfromCMDBuild.
Inadditionthecmdbuild_sql.
log(ifenabledinthesystemconfiguration),willprovidealistofthequeriesmadetothedb.
5.
2.
CMDBuildloggerlevelsToavoidasaturationofthelogfile,thestandardloggingprocesswillprovideinformationregardingthemainprogramactivity.
Inneedofamoredetailedloggingitispossibletochangetheloglevelofspecificmodulesbyusingthefollowingrestwscommand:cmdbuild.
shrestwssetloggermodulenameloglevelWherethemodulenamereferstothepackagetolog,inexampleifwewanttochangetheleveloftheworkflowmodulewecoulduseasmodulename`org.
cmdbuild.
workflow`.
Theloglevelcanbeoneof:ERROR,WARN,INFO,DEBUG,TRACEorDEFAULT.
Itisalsopossibletoobtainalistofthecurrentloggerlevelswiththecommandcmdbuild.
shrestwsgetloggers5.
3.
CMDBuildlogrotationCMDBuildalsooffersalogrotationsystem,thismeansthatsomepolicycanbedefinedtosplitandbackupthelogfiles.
NormallyCMDBuildoffersthefollowingconfiguration:Forfilescmdbuild.
log,cmdbuild_req.
log,cmdbuild_job.
log,cmdbuild_sys.
log:limitlogfileto100MBmaxsize;rotatedailyORwhensizeexceedlimit;uponrotation,oldfilesarecompressedandarchivedon/archive/;logfilesareretainedfor90ggORmaxarchivesizeof500MB(pereachsource).
Forfilescmdbuild_sql.
log,cmdbuild_ddl.
log:limitlogfileto100MBmaxsize;whensizeexceedlimit;uponrotation,oldfilesarecompressedandarchivedon/archive/;exactlyonearchivedfileiskeptpereachsource.
Thosepolicycanbechangedintheautogeneratedfilecalledlogback.
xml,inthetomcatconffolder.
AsystemrestartisrequiredafterthechangeshavebeenmadeCMDBuild–OpenSourceConfigurationandManagementDatabasePage22TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS6.
ConfigurationtoaccessaDMSthroughCMIS6.
1.
IntroductionCMDBuildallowstheintegrationwithanydocumentmanagementsystemthatsupportsCMIS,anopenstandardtoexchangedocumentdatathroughthewebprotocol,supportedbyallthemainproductsofthesector.
Theacceptanceofsuchprotocolallowstosupportbasefeaturesto:AttachanykindoffiletoanydatacardAssignacategorytoeveryfileDisplaytheuploadedfilesThemanagementofcategoriesandmetadataatthemomentissupportedonlyfortheprotocolCMIS1.
1,butCMDBuildsupportsevenDMSbasedonCMIS1.
0.
IncaseoftheneedforcategoriesandmetadataaDMSbasedonCMIS1.
1hastobeused.
6.
2.
ConfigurationofcategoriesmanagementInthissectionyouwilllearnhowtoconfigureaDMSthatcansupporttheprotocolCMIS1.
1,inordertomanagetheclassificationofattachmentswhenupdatingandrefreshingthemonCMDBuildcards.
Here'sanexampleoftheconfigurationforAlfresco5.
0.
Notethatthenamesusedhereareunbinding.
Tosetupsomecustomcategorieswithalfresco,twofileshavetobecreatedandsavedinthealfrescofolder:${ALFRESCO_HOME}/tomcat/shared/classes/alfresco/extension1)cmdbuild-model-context.
xmlalfresco/extension/cmdbuild-model.
xmlCMDBuild–OpenSourceConfigurationandManagementDatabasePage23TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS2)cmdbuild-model.
xmlCustomModelforCMDBuildCMDBuildTeam1.
0Classficationd:textCMDBuild–OpenSourceConfigurationandManagementDatabasePage24TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMIS6.
3.
ConfigurationoftheDMSinCMDBuildViaRESTcommandstheconfigurationsoftheDMSonCMDBuildcanbechanged,eitherviaeditconfigrestcommandtoopenaguishowingalltheavailableconfigurations(ifCMDBuildisonthelocalmachine)orviasetconfig/setconfigsrestcommand,inexample:cmdbuild.
shrestwssetconfigorg.
cmdbuild.
dms.
enabledtrueAlistoftheavailableconfigurationswillnowbepresented:org.
cmdbuild.
dms.
category.
lookupThelookupdefiningthecategoriesofthedocumentsExample:org.
cmdbuild.
dms.
category.
lookupAlfrescoCategoryorg.
cmdbuild.
dms.
enabledTheconfigurationthatenablesordisablesthedmsserviceExample:org.
cmdbuild.
dms.
enabledtrueorg.
cmdbuild.
dms.
service.
cmis.
userTheusernameusedtoaccessthedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
useradminorg.
cmdbuild.
dms.
service.
cmis.
passwordThepasswordusedbythedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
passwordadminorg.
cmdbuild.
dms.
service.
cmis.
pathWheretolocatethedmsserviceExample:org.
cmdbuild.
dms.
service.
cmis.
path/UserHomes/cmdbuildorg.
cmdbuild.
dms.
service.
cmis.
urlTheurlofthedmsserviceCMDBuild–OpenSourceConfigurationandManagementDatabasePage25TechnicalManual6.
ConfigurationtoaccessaDMSthroughCMISExample:org.
cmdbuild.
dms.
service.
cmis.
urlhttp://localhost:10080/alfresco/api/-default-/public/cmis/versions/1.
1/atomorg.
cmdbuild.
dms.
service.
typeThetypeofprotocolusedbythedmsserviceExample:org.
cmdbuild.
dms.
service.
typecmisCMDBuild–OpenSourceConfigurationandManagementDatabasePage26TechnicalManual7.
BackupofCMDBuilddata7.
BackupofCMDBuilddata7.
1.
DatabasebackupInCMDBuildeveryinformationisstoredinthePostgreSQLDatabase,soinordertoperformabackupoftheinformationweneedtobackupthedatabase.
Variouswayscanperformabackupofthedatabase,programslikePgAdmincanperformthisactionwiththesupportofagraphicalinterface.
OtherwisePostgreSQLprovidesafunctiontoperformadatabasebackup.
Inexample:pg_dump--hostlocalhost--port5432--username"postgres"--formatcustom--verbose--file/backup/cmdbuild/cmdbuild.
backupcmdbuild_dbThiscommandwillcreateabackupofthedatabasewiththename"cmdbuild.
backup".
Thisfilewillbethebackupofthedatabase"cmdbuild_db"onthePostgreSQLinstalledonlocalhostatport5432,performingtheauthenticationastheuser"postgres",compressingthedatabasewithacustomformatandnotifyingtheuserwithwhattheprogramisexecuting(withtheverboseparameter).
Thelocationofwherethebackupfilewillbesavedis/backup/cmdbuild.
7.
2.
DatabaserestoreAbackupcanberestoredatanytimewithasimpleprocedure.
CMDBuildprovidesdifferentfunctionstoperformvariousactions,suchasdatabaserelatedactions.
Ifthepurposeistorestoreabackupthiscommandwillrestorethepreviouslysavedbackupbydroppingthecurrentdatabaseandcreatinganewone:bashwebapps/cmdbuild/cmdbuild.
shdbconfigrecreate/path/to/database/backup.
backupCMDBuild–OpenSourceConfigurationandManagementDatabasePage27TechnicalManual8.
BackupofAlfrescodata8.
BackupofAlfrescodataTobackupdatainAlfrescoyoujusthavetobackupthePostgreSQLdatabase(hereafterwewillassumethatitisinthedatabasePostgreSQL).
AsforCMDBuild,thecommandtobackupthedatabaseoncommandlineisasfollows:pg_dump--hostlocalhost--port5433--username"postgres"--formatcustom--verbose--file/backup/alfresco/alfresco.
backupalfresco_dbItisalsonecessarybackup-asziportar.
gzfile-alsothewholedirectorycontainingtherepositorywherefilesaresaved(e.
g.
:C:/alfresco/repositoryforWindowssystemsor/var/alfresco/repositoryfor*nixsystems).
#!
/bin/shALFRESCO_SERVICE="/etc/init.
d/alfresco"TT_PG_BACKUP="/usr/local/bin/tt_pg_backup.
sh"BACKUP_HOME="/backup"ALFRESCO_BACKUP_HOME="${BACKUP_HOME}/alfresco"BACKUP_LOG="/var/log/cmdbuild/crontab-backup.
log2>&1"ALFRESCO_DATABASE="alfresco"ALFRESCO_DATA="/var/lib/alfresco/data"TIMESTAMP=`date+%Y%m%d%H%M%S`ALFRESCO_DATA_BACKUP="alfresco-data-${TIMESTAMP}.
tar.
gz"logger"StoppingAlfrescoservice"${ALFRESCO_SERVICE}stopsleep5logger"BackuppingAlfrescodatabase"${TT_PG_BACKUP}"${ALFRESCO_BACKUP_HOME}""${ALFRESCO_DATABASE}">${BACKUP_LOG}logger"BackuppingAlfrescodata"tarczf"${ALFRESCO_BACKUP_HOME}/${ALFRESCO_DATA_BACKUP}"${ALFRESCO_DATA}logger"Alfrescodatabase/datahavebeenbackedup.
"logger"StartingAlfrescoservice"${ALFRESCO_SERVICE}startCMDBuild–OpenSourceConfigurationandManagementDatabasePage28TechnicalManual8.
BackupofAlfrescodata8.
1.
BackupscheduleToscheduleaperiodicaldatabackuponLinuxsystems,wesuggestyoutogoonasfollows:1.
createa/etc/cron.
d/backupfile2.
insertthecommandsintothebackupfile,withthepropercronsyntax.
Foramoreefficientcleaningwerecommendyoutocreatevarioussinglescripts,oneforeachsystem,andcalltheminthisfileratherthanwritethecommandsdirectlyintothecronfileitself.
Anexample:0019***root/usr/local/bin/tt_pg_backup.
sh/backup/cmdbuildcmdbuild&>>/var/log/cmdbuild/backup/backup.
log1019**7root/usr/local/bin/alfresco-backup.
sh&>>/var/log/cmdbuild/backup/backup.
logCMDBuild–OpenSourceConfigurationandManagementDatabasePage29TechnicalManual9.
Authenticationmodes9.
Authenticationmodes9.
1.
IntroductionThankstoproperconfigurationsofCMDBuild,theauthenticationcontrolcanbedelegatedtoexternalservices.
Thispossibilityconcernsthecontroloftheaccount(usernameandpassword).
ProfilesandpermissionswillstillbemanagedwithingtheCMDBuildgrouptowhichtheuserbelongs.
ViaRESTcommandstheconfigurationsoftheauthenticationcanbechanged,eitherviaeditconfigrestcommandtoopenaguishowingalltheavailableconfigurations(ifCMDBuildisonthelocalmachine)orviasetconfig/setconfigsrestcommand,inexample:cmdbuild.
shrestwssetconfigorg.
cmdbuild.
auth.
methodsLdapAuthenticator9.
2.
ConfigurationoftheauthenticationtypeBelowthevariousparametersthathavetobesetduringtheconfigurationaredescribed:org.
cmdbuild.
auth.
methodsWiththisparameteryoucandefinetheauthentication"chain"ofCMDBuild.
Itispossible,i.
e.
,todefineincascadewhichtypesofauthenticationyoucanusetoallowaccesstotheuserandsetthepriority.
Exampleorg.
cmdbuild.
auth.
methods=LdapAuthenticator,DBAuthenticatorTheconfigurationinthepreviousexampleindicatesthatwheneverauserlogsintothesystem,CMDBuildmustfirstverifythecredentialsviaLDAP,andiftheyfail,viathedatabaseinCMDBuild.
Theacceptedparametersare:HeaderAuthenticator(authenticationviaheadercontrol)LdapAuthenticator(authenticationviacredentialverificationonLDAP)CasAuthenticator(singlesignthroughCAS)DBAuthenticator(standardauthentication)9.
3.
ConfiguringLDAPauthenticationThissectiondocumentshowtoconfigureauthenticationwithinCMDBuildviaLDAP.
InordertomanagetheuserpermissionswithinCMDBuildisnecessarythatusersthathavetoaccesstoCMDBuildtheyarealsopresentwithinthewebapp.
Forexample,ifauserwithLDAPUIDj.
doeneedsaccessingCMDBuildasauserofthe"technicians"group,youhavetoperformthesesteps:usercreationinj.
doeCMDBuildwithadefaultpassword(notnecessarilythatofLDAP)creationoftheTechnicalGroupanddefinitionoftherelevantpermitsCMDBuild–OpenSourceConfigurationandManagementDatabasePage30TechnicalManual9.
Authenticationmodesaddingusertogroupj.
doeTechniciansAtthispoint,whenyouauthenticatej.
doe,hiscredentialswillbeverified(usingtheauthenticationchaindefinedinauth.
methods)againsttheLDAPtree.
Belowthereisadescriptionoftheconfigurationparameters.
org.
cmdbuild.
auth.
ldap.
server.
addressThisattributeisusedtospecifytheaddresstowhichyoucanreachtheLDAPserver.
Example:org.
cmdbuild.
auth.
ldap.
server.
address=localhostorg.
cmdbuild.
auth.
ldap.
server.
portThisattributeisusedtospecifytheporttheLDAPserver.
Thedefaultis389.
Example:org.
cmdbuild.
auth.
ldap.
server.
port=389org.
cmdbuild.
auth.
ldap.
use.
sslItspecifieswhethertouseanencryptedconnectiontotheLDAPserver.
Thedefaultisdisabled.
Example:org.
cmdbuild.
auth.
ldap.
use.
ssl=trueorg.
cmdbuild.
auth.
ldap.
use.
tlsItspecifieswhethertousetlswiththeLDAPserver.
Thedefaultisdisabled.
Example:org.
cmdbuild.
auth.
ldap.
use.
tls=trueorg.
cmdbuild.
auth.
ldap.
basednThisattributeindicatestheBaseDNthatwillbeusedtoquerytheLDAPtree.
Example:org.
cmdbuild.
auth.
ldap.
basedn=dc=example,dc=comorg.
cmdbuild.
auth.
ldap.
bind.
attributeThisattributeindicatestheattributewillberunonthebinduser.
Forexample,asanattributeforspecifyingbinddnuidandconsideringthebasisindicatedabove,theLDAPquerythatwillbegenerateduid=username,dc=example,dc=com.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage31TechnicalManual9.
AuthenticationmodesExample:org.
cmdbuild.
auth.
ldap.
bind.
attribute=cnorg.
cmdbuild.
auth.
ldap.
search.
filterYoucanspecifywiththisattribute,asearchfiltertobeusedforresearch.
Otherconfigurations:org.
cmdbuild.
auth.
ldap.
search.
auth.
method(none,simpleorstrong)org.
cmdbuild.
auth.
ldap.
search.
auth.
passwordorg.
cmdbuild.
auth.
ldap.
search.
auth.
principal9.
4.
SinglesignonconfigurationthroughCASThissectiondocumentshowtoconfigurethesinglesignon(SSO)withinCMDBuildviaCAS.
Theauthenticationrunsasfollows:theuserasksfortheCMDBuildurltheCASauthenticatorsendstherequesttotheCASserver(${cas.
server.
url}+${cas.
login.
page})specifyingtheCMDBuildaccessurl(inthe${cas.
service.
param}paramter)theCASserveranswerswithaticket(${cas.
ticket.
param}paramter)whichyoucanextracttheusernamefromiftheusernameisproperlyvalidated/extracted,thenCMDBuildgetsonwiththeloginInordertomanagetheuserpermissionswithinCMDBuildisnecessarythatusersthathavetoaccesstoCMDBuildtheyarealsopresentwithinthewebapp.
Belowthereisadescriptionoftheconfigurationparameters.
org.
cmdbuild.
auth.
cas.
server.
urlThisattributeisusedtospecifytheaddresstowhichyoucanreachtheCASserver.
Example:org.
cmdbuild.
auth.
cas.
server.
url=https://cas.
mycompany.
com/casorg.
cmdbuild.
auth.
cas.
login.
pageThisattributeisusedtospecifytheCASloginpageExample:org.
cmdbuild.
auth.
cas.
login.
page=/loginorg.
cmdbuild.
auth.
cas.
service.
paramNameoftheparameterthatCASusestospecifytheurloftheauthenticationservice.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage32TechnicalManual9.
AuthenticationmodesExample:org.
cmdbuild.
auth.
cas.
service.
param=serviceorg.
cmdbuild.
auth.
cas.
ticket.
paramNameoftheparameterthatCASusestospecifytheticketreferencethatitgeneratesuntiltheauthenticationisvalid.
Example:org.
cmdbuild.
auth.
cas.
ticket.
param=ticketCMDBuild–OpenSourceConfigurationandManagementDatabasePage33TechnicalManual10.
Mobileinterfaceactivation10.
Mobileinterfaceactivation10.
1.
IntroductionCMDBuild"mobile"isaninterfacethatcanbeusedonsmartphonesandtabletsinordertorunusefulapplicationfeaturesduringtheactivitiesonfield.
Itiscreatedwith"SenchaTouch"(aJavascriptframeworkdevelopedbySencha,thesameproductorofExtJSframeworkusedbytheCMDBuilddesktopinterface),anditisabletointeractwithCMDBuildviaRESTwebservice.
CMDBuildmobileimplementsthemainfeaturesofthedesktopinterface:multilingual,multigrouplogin,navigationmenus,classmanagement,relations,attachments,…10.
2.
ComponentsandarchitectureTheapplicationiscreatedwiththeusageofthefollowingcomponents:SenchaTouch(JavascriptframeworkcreatedbySencha)Cordova(mobilecross-platformframework)DeftJS(mobileenterpriseextensionforapplicationsdevelopedwithSenchaTouch)log4javascript(javascriptloggingframework)Crosswalk(toolfortheapplicationdeploymentonacustomwebviewindependentfromtheandroidversion)Siesta(libraryfortheusageofunit/integrationtests)Ontheserverside,theRESTwebservicelayerisdevelopedusingtheApacheCXFframework,thatisalreadyintegratedinCMDBuild,alsousedfortheSOAPwebservicelayer.
ThesystemretracesthesoftwarearchitectureoftheRESTwebservicewiththefollowingfeatures:featuresdividedinwebresourcesaddressableresources(URI)HTTPstandardmethods(GET,POST,PUT,DELETE)JSONmediatypelinkfortheresourcenavigationstateless10.
3.
CompatibilityThemobilesystemiscompatiblewith:Android4.
0.
3ormorerecentIOS6ormorerecentCMDBuild–OpenSourceConfigurationandManagementDatabasePage34TechnicalManual10.
Mobileinterfaceactivation10.
4.
LimitationofuseThemobileinterfaceisavailableonlywiththenon-opensourcelicense,whichallowsonlythosewhohavesignedwithTecnotecasrlamaintenanceservicefortheCMDBuildapplication,andonlyuntilthemaintenanceisactive,withalimitedadditionalcharge.
CMDBuild–OpenSourceConfigurationandManagementDatabasePage35TechnicalManual11.
GUIFrameworkactivation11.
GUIFrameworkactivation11.
1.
IntroductionTheGUIFrameworkmakesavailableasimplifiedinterfacetonon-technicalstaff.
TheGUIFrameworkincludesthefollowingmainfeatures:itcanbeactivatedinportalsbasedondifferenttechnologiesasitisdevelopedinjavascript/JQueryenvironmentitallowsan(almost)unlimitedfreedomwhenprojectingthegraphiclayout,definedthroughanXMLdescriptorandwiththepossibilityofinterveningontheCSSitgrantsaquickconfigurationthankstopredefinedfunctions(communication,authenticationlogics,etc.
)andtonativegraphicsolutions(forms,grids,uploadbuttonsandotherwidgets)itinteractswithCMDBuildthroughtheRESTwebserviceitisabletogatherdatafromthedatabaseofotherapplications,allowingthemanagementofmixsolutions11.
2.
ConfigurationTheframeworkdefinesHTMLpagesstartingfromtheirdefinitioninXML.
SuchpagescanbeinsertedintoaHTMLfile,allowingtheframeworktoinsertintoexistingportalsaccesspointstoCMDBuilddata.
ThesystemconfigurabilitycanbeachievedthroughthedefinitionofcustomCSSandJavascript.
Theelementthatshouldbeinsertedintotheportalhtmlisahtmlcontainer(DIV,IFRAME.
.
.
)inthefollowingformat:$(document).
ready(function(){$("#cmdbuilForm").
cmdbuildAP({apiUrl:'http://10.
0.
0.
107:8080/cmdbuild/services/rest/',appRootUrl:'http://10.
0.
0.
107:8080/cmdbuild-gui-framework/api/',appConfigUrl:'http://10.
0.
0.
107:8080/cbap/cbap/config/bologna/',cqlUrl:'http://10.
0.
0.
107:8080/cbap/cbap/cql/',customjs:['backend/GUIForm.
js','backend/Process.
js'],start:"home.
xml",theme:["jquery-ui.
theme-crt-toscana.
min.
css","custom.
css"],CMDBuild–OpenSourceConfigurationandManagementDatabasePage36TechnicalManual11.
GUIFrameworkactivation});});
- multiapachetomcat相关文档
- creationapachetomcat
- POJOsapachetomcat
- authenticaapachetomcat
- removeapachetomcat
- clearapachetomcat
- 考勤apachetomcat
HostKvm四月优惠：VPS主机全场八折,香港/美国洛杉矶机房$5.2/月起
HostKvm是一家成立于2013年的国外主机服务商，主要提供基于KVM架构的VPS主机，可选数据中心包括日本、新加坡、韩国、美国、中国香港等多个地区机房，均为国内直连或优化线路，延迟较低，适合建站或者远程办公等。本月商家针对全场VPS主机提供8折优惠码，优惠后美国洛杉矶VPS月付5.2美元起。下面列出几款不同机房VPS主机产品配置信息。套餐：美国US-Plan0CPU：1cores内存：1GB硬...
提速啦：美国多IP站群云服务器 8核8G 10M带宽 7IP 88元/月
提速啦（www.tisula.com）是赣州王成璟网络科技有限公司旗下云服务器品牌，目前拥有在籍员工40人左右，社保在籍员工30人+，是正规的国内拥有IDC ICP ISP CDN 云牌照资质商家，2018-2021年连续4年获得CTG机房顶级金牌代理商荣誉 2021年赣州市于都县创业大赛三等奖，2020年于都电子商务示范企业，2021年于都县电子商务融合推广大使。资源优势介绍：Ceranetwo...
RackNerd：特价美国服务器促销,高配低价,美国多机房可选择,双E526**+AMD3700+NVMe
racknerd怎么样？racknerd今天发布了几款美国特价独立服务器的促销，本次商家主推高配置的服务器，各个配置给的都比较高，有Intel和AMD两种，硬盘也有NVMe和SSD等多咱组合可以选择，机房目前有夏洛特、洛杉矶、犹他州可以选择，性价比很高，有需要独服的朋友可以看看。点击进入：racknerd官方网站RackNerd暑假独服促销：CPU：双E5-2680v3 (24核心，48线程)内存...
apachetomcat为你推荐
-
com域名注册com域名注册要注意哪些情况啊?我想现在注册一个com域名~免备案虚拟空间免备案的虚拟主机空间，买了以后会强制备案不？网站空间免备案哪有不用备案的网站空间？万网虚拟主机如何购买万网的虚拟主机？虚拟主机软件问虚拟主机用什么版本的软件比较好1g虚拟主机1G虚拟空间大约多少钱?长沙虚拟主机长沙哪里虚拟主机和主机托管比较关好!广西虚拟主机虚拟机如何实现桥接方式-联网四川虚拟主机四川java虚拟主机，哪里比较好免费域名有哪些免费域名