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
bgpto：BGP促销,日本日本服务器6.5折$93/月低至6.5折、$93/月
bgpto怎么样?bgp.to日本机房、新加坡机房的独立服务器在搞特价促销，日本独立服务器低至6.5折优惠，新加坡独立服务器低至7.5折优惠，所有优惠都是循环的，终身不涨价。服务器不限制流量，支持升级带宽，免费支持Linux和Windows server中文版(还包括Windows 10). 特色：自动部署，无需人工干预，用户可以在后台自己重装系统、重启、关机等操作!bgpto主打日本(东京、大阪...
IMIDC(rainbow cloud)：香港/台湾/日本/莫斯科独立服务器特价,闪购大促销,最低30usd/月起
imidc怎么样?imidc彩虹网路，rainbow cloud知名服务器提供商。自营多地区数据中心，是 Apnic RIPE Afrinic Arin 认证服务商。拥有丰富的网路资源。 在2021年 6.18 开启了输血大促销，促销区域包括 香港 台湾 日本 莫斯科 等地促销机型为 E3係，参与促销地区有 香港 日本 台湾 莫斯科 等地， 限量50台,售罄为止,先到先得。所有服务器配置 CPU ...
HostKvm（4.25美）香港和俄罗斯高防机房云服务器
HostKvm 商家我们算是比较熟悉的国内商家，商家主要还是提供以亚洲数据中心，以及直连海外线路的服务商。这次商家有新增香港和俄罗斯两个机房的高防服务器方案。默认提供30GB防御，且目前半价优惠至4.25美元起步，其他方案的VPS主机还是正常的八折优惠。我们看看优惠活动。香港和俄罗斯半价优惠：2021fall，限购100台。通用优惠码：2021 ，八折优惠全部VPS。我们看看具体的套餐。1、香港高...
apachetomcat为你推荐
-
主机租用电脑租赁多少钱一天呢？有人租过吗？查询ip怎么查看IP地址便宜的虚拟主机低价虚拟主机那种类型的好呢？手机网站空间我想建一手机网站，那位推荐一个域名便宜点的手机建站网址，空间小也没关系。虚拟主机评测网怎么选一台好的虚拟主机东莞虚拟主机在东莞服务器租用怎么选择青岛虚拟主机阿里云主机青岛好还是杭州好买域名买域名要多少钱？顶级域名什么是顶级域名域名服务器在网上买个域名和买个服务器有什么区别吗？