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
10gbiz：香港/洛杉矶CN2直连线路VPS四折优惠,直连香港/香港/洛杉矶CN2四折
10gbiz怎么样?10gbiz在本站也多次分享过，是一家成立于2020的国人主机商家，主要销售VPS和独立服务器，机房目前有中国香港和美国洛杉矶、硅谷等地，线路都非常不错，香港为三网直连，电信走CN2，洛杉矶线路为三网回程CN2 GIA，10gbiz商家七月连续推出各种优惠活动，除了延续之前的VPS产品4折优惠，目前增加了美国硅谷独立服务器首月半价的活动，有需要的朋友可以看看。10gbiz优惠码...
云如故枣庄高防（49元）大内存2H2G49元8H8G109元
云如故是一家成立于2018年的国内企业IDC服务商，由山东云如故网络科技有限公司运营，IDC ICP ISP CDN VPN IRCS等证件齐全！合法运营销售，主要从事自营高防独立服务器、物理机、VPS、云服务器，虚拟主机等产品销售，适合高防稳定等需求的用户，可用于建站、游戏、商城、steam、APP、小程序、软件、资料存储等等各种个人及企业级用途。机房可封UDP 海外 支持策略定制 双层硬件（傲...
百纵科技云主机首月9元，站群1-8C同价,美国E52670*1,32G内存 50M 899元一月
百纵科技:美国高防服务器,洛杉矶C3机房 独家接入zenlayer清洗 带金盾硬防,CPU全系列E52670、E52680v3 DDR4内存 三星固态盘阵列！带宽接入了cn2/bgp线路，速度快，无需备案，非常适合国内外用户群体的外贸、搭建网站等用途。官方网站：https://www.baizon.cnC3机房，双程CN2线路，默认200G高防，3+1（高防IP），不限流量，季付送带宽美国洛杉矶C...
apachetomcat为你推荐
-
域名空间代理哪里的域名空间商比较好?网站空间域名什么是网站域名和网站空间郑州虚拟主机虚拟主机哪个好点，用过的推荐下北京虚拟主机虚拟主机 那个好用又实惠虚拟主机mysql虚拟主机支持mysql数据库，还需要额外购买mysql吗？成都虚拟主机成都唯度科技有限公司怎么样？虚拟主机测评虚拟主机哪个最好虚拟主机管理软件虚拟主机用什么管理软件，我准备购买一个vps 先咨询下。华众虚拟主机管理系统华众虚拟主机管理系统请问。华众 虚拟主机管理系统 这个问题 怎么解决 。就是后台可以开通虚拟主机 没有问题，但是 删除虚拟主机 后台显示删除成功的，但是实际在服务器上 文件夹 ftp iis站点 都没有被删除 是什么问题备案域名哪些域名可以在国内备案？