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
webhosting24：€28/年，日本NVMe3900X+Webvps
webhosting24决定从7月1日开始对日本机房的VPS进行NVMe和流量大升级，几乎是翻倍了硬盘和流量，当然前提是价格依旧不变。目前来看，国内过去走的是NTT直连，服务器托管机房应该是CDN77*（也就是datapacket.com），加上高性能平台（AMD Ryzen 9 3900X+NVMe），这样的日本VPS还是有相当大的性价比的。官方网站：https://www.webhosting...
Virmach：1核/512M1核M1核512M/夏季美国vps促销,年付$7.2,9月更换AMD平台
virmach怎么样？virmach家这几年非常火，从商家的黑五闪购开始，以超低的价格吸引了大批的国人客户，而且商家的机器还是非常稳定的，站长手里的4.75刀年付已经用了两年了，非常稳定，不过商家到国内的线路一般，目前商家新上了夏季优惠促销，价格低到发指，年付7.2美元起，商家反馈将在9月开始更换AMD+NVMe平台，这个消息从年初就有了，不过一直没有更换，目前这个时间也不确定是否准确。点击进入：...
华纳云不限流量￥324/年，香港双向CN2（GIA）云服务器/1核1G/50G存储/2Mbps
华纳云（HNCloud Limited）是一家专业的全球数据中心基础服务提供商，总部在香港，隶属于香港联合通讯国际有限公司，拥有香港政府颁发的商业登记证明，保证用户的安全性和合规性。 华纳云是APNIC 和 ARIN 会员单位。主要提供香港和美国机房的VPS云服务器和独立服务器。商家支持支付宝、网银、Paypal付款。华纳云主要面向国内用户群，所以线路质量还是不错的，客户使用体验总体反响还是比较好...
apachetomcat为你推荐
-
云主机租用云主机到底是什么？租用以后该如何使用？国外域名注册如何注册国外域名？域名备案查询怎么查看域名在什么空间备案的？免备案虚拟空间免备案的虚拟主机空间，买了以后会强制备案不？美国网站空间我想买个国外的网站空间，那家好，懂的用过的来说说虚拟主机评测网怎么选一台好的虚拟主机虚拟主机管理系统虚拟主机管理系统那一家好?万网虚拟主机万网虚拟、专享、独享主机有什么区别?虚拟主机服务商哪个虚拟主机的服务商比较好？下载虚拟主机虚拟机下载完之后如何安装