28.04.

2017 BitnamiOpenfireVirtualMachine

Content BitnamiDocumentationPages(/) > VirtualMachines(/virtualmachine/) >

ApplicationStacks(/virtualmachine/apps/) > Openfire(/virtualmachine/apps/openfire/)
Description

FirststepswiththeBitnamiOpenfire BitnamiOpenfireVirtualMachine
Stack

HowtoimportaBitnamiVirtual
Machine? Description
ImportingaBitnamiVirtual OpenfireisarealtimecollaborationserverbasedontheXMPP(Jabber)protocol.Openfireiseasytoadminister
MachineinVirtualBox andisoptimizedforsecurityandperformance.
ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
FirstStepsWithTheBitnamiOpenfireStack
setformetologintotheapplication WelcometoyournewBitnamiapplication!Thisguideincludessomebasicinformationyouwillneedtoget
forthefirsttime?
startedwithyourapplication.
Whatistheadministratorpassword?
HowToImportABitnamiVirtualMachine?
WhatSSHusernameshouldIusefor
secureshellaccesstomy CheckthefollowinginstructionstoimportaBitnamiVirtualMachine:
application?
ImportingaBitnamiVirtualMachineinVirtualBox
Howtoaccessyourapplication?
Selectthe"File>ImportAppliance"menuoptionandselectthe.ovffiledownloadedfromtheBitnami
Whatisthedefaultconfigurationof website.Thenclick"Continue".
Openfire? Onceitisimported,clickthe"Start"buttonintheVirtualBoxtoolbar.

HowtoconnecttotheOpenfire
AdministrationPanel? Foradetailedwalkthrough,checkourVirtualboxtutorial(/virtualmachine/getstartedvirtualbox#step1launcha
bitnamiwordpressvirtualmachine).
HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase? ImportingaBitnamiVirtualMachineinVMware

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 1/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Selectthe"File>Import"menuoptionandselectthe.ovffiledownloadedfromtheBitnamiwebsite.Then
click"Continue".
UpdatingtheIPaddressorhostname
Oncetheimportiscomplete,click"Finish"tostartthevirtualmachine.

Foradetailedwalkthrough,checkourVMwaretutorial(/virtualmachine/getstartedvmware#step1launcha
Content bitnamiwordpressvirtualmachine).

Description
WhatIsTheAdministratorUsernameSetForMeToLogInToTheApplicationForThe
FirststepswiththeBitnamiOpenfire FirstTime?
Stack
Username:admin
HowtoimportaBitnamiVirtual
Machine? WhatIsTheAdministratorPassword?
ImportingaBitnamiVirtual Password:bitnami
MachineinVirtualBox

ImportingaBitnamiVirtual NOTE:Youcanalsoobtainthecredentialsfromtheserverconsole.Learnmoreabouttheapplication
MachineinVMware credentialsinourFAQpage(/virtualmachine/faq#howtofindapplicationcredentials).
Whatistheadministratorusername
setformetologintotheapplication WhatSSHUsernameShouldIUseForSecureShellAccessToMyApplication?
forthefirsttime?
SSHusername:bitnami
Whatistheadministratorpassword?
HowToAccessYourApplication?
WhatSSHusernameshouldIusefor
secureshellaccesstomy OnceyouhaveimportedyourBitnamiVirtualMachine,theIPaddressforyourapplicationisdisplayedonthe
application? virtualmachine'sloginscreen.AccesstheapplicationviayourbrowserbyenteringthisIPaddress.

Howtoaccessyourapplication?
ChecktheseinstructionsabouthowtoremotelyaccesstheBitnamiapplication(/virtualmachine/faq#howto

Whatisthedefaultconfigurationof
remotelyaccessthebitnamiapplication).
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?
WhatIsTheDefaultConfigurationOfOpenfire?
Openfireinstallationfolderislocatedin/opt/bitnami/apps/openfire/,whichhasthefollowingcontents:
HowtoconnecttotheMySQLdatabase?
bin/:Openfire'sbinariesfiles.
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 2/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? bnconfig:BitnamitoolforOpenfire.
changelog.html:Openfire'schangelogfile.
UpdatingtheIPaddressorhostname
conf/:Openfire'sconfigurationfiles.
documentation/:Openfire'sdocumentation.
lib/:LibrariesforOpenfire.
Content LICENSE.html:Openfire'slicensefile.
logs/:Openfire'slogs.
Description
pluigns/:PluginsforOpenfire.
FirststepswiththeBitnamiOpenfire resources/:Openfire'sresources.
Stack
scripts/:Openfire'sinitializationscripts.
HowtoimportaBitnamiVirtual
Machine? Apartfromthis,youcanfind:

ImportingaBitnamiVirtual MySQLlocatedin/opt/bitnami/mysql.
MachineinVirtualBox Apachelocatedin/opt/bitnami/apache2.
ImportingaBitnamiVirtual Javalocatedin/opt/bitnami/java.
MachineinVMware
Openfireusedifferentportstoofferdifferentservices.Thedefaultportslistis:
Whatistheadministratorusername
setformetologintotheapplication 5222ClienttoServerThestandardportforclientstoconnecttotheserver.
forthefirsttime? 5223ClienttoServerTheportusedforclientstoconnecttotheserverusingtheSSL/TLSmethod.
Whatistheadministratorpassword? 7070HTTPBindingTheportusedforunsecuredHTTPclientconnections.
7443HTTPBindingTheportusedforsecuredHTTPclientconnections.
WhatSSHusernameshouldIusefor
5269ServertoServerTheportusedforremoteserverstoconnecttothisserver.
secureshellaccesstomy
application? 5275ExternalComponentsTheportusedforexternalcomponentstoconnecttotheserver.
5276ExternalComponentsTheportusedforexternalcomponentstotheserverusingtheSSL/TLS
Howtoaccessyourapplication?
method.
5262ConnectionManagerTheportusedforconnectionmanagerstoconnecttotheserver.
Whatisthedefaultconfigurationof
5263ConnectionManagerTheportusedforconnectionmanagerstotheserverusingtheSSL/TLS
Openfire?
method.
HowtoconnecttotheOpenfire
9090AdminConsoleTheportusedforunsecuredAdminConsoleaccess.
AdministrationPanel?
9091AdminConsoleTheportusedforsecuredAdminConsoleaccess.
HowtoconnecttotheMySQLdatabase? 7777FileTransferProxyTheportusedfortheproxyservice(FTP)thatallowsfiletransferstooccur

Howtodebugerrorsinyourdatabase? betweentwoentitiesontheXMPPnetwork.

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 3/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? 5229FlashCrossDomainServicethatallowsFlashclientsconnecttootherhostnamesandports.

UpdatingtheIPaddressorhostname
XMPPClientsuse5222and5223toconnecttotheserverdependingontheuseofsecureorunsecured
connections.Bothportsmustbeopenedinyourservertobeabletoconnectaclienttotheserver.Youcan
connecttoyourAdministrationPanelusingthedefaultwebserverports80or443(forsecuredconnections)
Content sinceApachewillactasaproxyredirectingthoserequeststothecorrespondingOpenfireport.

Description
YoucaneasilychangetheportsconfigurationusingtheAdministrationPanel.Followthenextsteps:
FirststepswiththeBitnamiOpenfire
LogintotheOpenfireAdministrationPanel.
Stack
Browsetothe"Server>ServerManager>ServerInformation"menuitem,andclickon"editproperties"
HowtoimportaBitnamiVirtual
button.
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase? (/images/img/apps/openfire/openfireunderstanddefaultconfig1788ff0b6.png)
Howtodebugerrorsinyourdatabase? Edittheconfigurationasyoudesireandclickon"SaveProperties"button.
https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 4/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware
(/images/img/apps/openfire/openfireunderstanddefaultconfig2d537e54c.png)
Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime? YoucanfindmoreinformationaboutOpenfireatOpenfire'sofficialdocumentation
(http://www.igniterealtime.org/projects/openfire/documentation.jsp).
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?
HowToConnectToTheOpenfireAdministrationPanel?
YoucanconnecttotheOpenfireAdministrationPanelbybrowsingtohttp://SERVERIP:/.Thedefaultusername
Howtoaccessyourapplication?
isadminandthedefaultpasswordisbitnami

Whatisthedefaultconfigurationof
Openfire?
HowToConnectToTheMySQLDatabase?
HowtoconnecttotheOpenfire
AdministrationPanel? YoucanconnecttotheMySQLdatabasefromthesamecomputerwhereitisinstalledwiththemysqlclienttool.

HowtoconnecttotheMySQLdatabase?
$mysqlurootp
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 5/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Youwillbepromptedtoentertherootuserpassword.Thisisthesameastheapplicationpassword.

UpdatingtheIPaddressorhostname
Findouthowtoobtainapplicationcredentials(/virtualmachine/faq#howtofindapplicationcredentials).

Content HowToDebugErrorsInYourDatabase?
Description Themainlogfileiscreatedat/opt/bitnami/mysql/data/mysqld.logontheMySQLdatabaseserverhost.

FirststepswiththeBitnamiOpenfire
Stack
HowToStartOrStopTheServices?
HowtoimportaBitnamiVirtual
Machine? EachBitnamistackincludesacontrolscriptthatletsyoueasilystop,startandrestartservices.Thescriptis
locatedat/opt/bitnami/ctlscript.sh.Callitwithoutanyservicenameargumentstostartallservices:
ImportingaBitnamiVirtual
MachineinVirtualBox
$sudo/opt/bitnami/ctlscript.shstart
ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername Oruseittorestartasingleservice,suchasApacheonly,bypassingtheservicenameasargument:
setformetologintotheapplication
forthefirsttime?
$sudo/opt/bitnami/ctlscript.shrestartapache
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor Usethisscripttostopallservices:
secureshellaccesstomy
application?
$sudo/opt/bitnami/ctlscript.shstop
Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Restarttheservicesbyrunningthescriptwithoutanyarguments:
Openfire?

HowtoconnecttotheOpenfire $sudo/opt/bitnami/ctlscript.shrestart
AdministrationPanel?

HowtoconnecttotheMySQLdatabase? Obtainalistofavailableservicesandoperationsbyrunningthescriptwithoutanyarguments:

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 6/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
$sudo/opt/bitnami/ctlscript.sh
UpdatingtheIPaddressorhostname

UpdatingTheIPAddressOrHostname
Content OpenfirerequiresupdatingtheIPaddress/domainnameifthemachineIPaddress/domainnamechanges.The
bnconfigtoolalsohasanoptionwhichupdatestheIPaddress,calledmachine_hostname(usehelptocheckif
Description
thatoptionisavailableforyourapplication).NotethatthistoolchangestheURLto
FirststepswiththeBitnamiOpenfire
http://NEW_DOMAIN/openfire.
Stack

HowtoimportaBitnamiVirtual
$sudo/opt/bitnami/apps/openfire/bnconfigmachine_hostnameNEW_DOMAIN
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox IfyouhaveconfiguredyourmachinetouseastaticdomainnameorIPaddress,youshouldrenameorremove
the/opt/bitnami/apps/openfire/bnconfigfile.
ImportingaBitnamiVirtual
MachineinVMware
$sudomv/opt/bitnami/apps/openfire/bnconfig/opt/bitnami/apps/openfire/bnconfig.disabled
Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?
NOTE:Besurethatyourdomainispropagated.Otherwise,thiswillnotwork.YoucanverifythenewDNS
Whatistheadministratorpassword? recordbyusingtheGlobalDNSPropagationChecker(https://www.whatsmydns.net/)andenteringyour

WhatSSHusernameshouldIusefor domainnameintothesearchfield.
secureshellaccesstomy
application? Youcanalsochangeyourhostnamebymodifyingitinyourhostsfile.Enterthenewhostnameusingyour
preferrededitor.
Howtoaccessyourapplication?

Whatisthedefaultconfigurationof $sudonano/etc/hosts
Openfire?

HowtoconnecttotheOpenfire AddanewlinewiththeIPaddressandthenewhostname.Here'sanexample.Remembertoreplacethe
AdministrationPanel?
IPADDRESSandDOMAINplaceholderswiththecorrectIPaddressanddomainname.
HowtoconnecttotheMySQLdatabase? IPADDRESSDOMAIN
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 7/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
HowToCreateAFullBackupOfOpenfire?
UpdatingtheIPaddressorhostname
Backup
TheBitnamiOpenfireStackisselfcontainedandthesimplestoptionforperformingabackupistocopyor
compresstheBitnamistackinstallationdirectory.Todosoinasafemanner,youwillneedtostopallservers,so
Content thismethodmaynotbeappropriateifyouhavepeopleaccessingtheapplicationcontinuously.

Description
Followthesesteps:
FirststepswiththeBitnamiOpenfire
Stack
Changetothedirectoryinwhichyouwishtosaveyourbackup:

HowtoimportaBitnamiVirtual $cd/your/directory
Machine?

ImportingaBitnamiVirtual Stopallservers:
MachineinVirtualBox
$sudo/opt/bitnami/ctlscript.shstop
ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername Createacompressedfilewiththestackcontents:
setformetologintotheapplication
forthefirsttime? $sudotarpczvfapplicationbackup.tar.gz/opt/bitnami

Whatistheadministratorpassword?
Restartallservers:
WhatSSHusernameshouldIusefor
secureshellaccesstomy
$sudo/opt/bitnami/ctlscript.shstart
application?

Howtoaccessyourapplication?
Youshouldnowdownloadortransfertheapplicationbackup.tar.gzfiletoasafelocation.

Whatisthedefaultconfigurationof
Openfire?
Restore
Followthesesteps:
HowtoconnecttotheOpenfire
AdministrationPanel? Changetothedirectorycontainingyourbackup:

HowtoconnecttotheMySQLdatabase?
$cd/your/directory
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 8/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Stopallservers:

UpdatingtheIPaddressorhostname
$sudo/opt/bitnami/ctlscript.shstop

Movethecurrentstacktoadifferentlocation:
Content
$sudomv/opt/bitnami/tmp/bitnamibackup
Description

FirststepswiththeBitnamiOpenfire Uncompressthebackupfiletotheoriginaldirectoryv
Stack

HowtoimportaBitnamiVirtual $sudotarpxzvfapplicationbackup.tar.gzC/
Machine?

ImportingaBitnamiVirtual Startallservers:
MachineinVirtualBox
$sudo/opt/bitnami/ctlscript.shstart
ImportingaBitnamiVirtual
MachineinVMware
Ifyouwanttocreateonlyadatabasebackup,refertotheseinstructionsforMySQL(/virtual
Whatistheadministratorusername
setformetologintotheapplication machine/components/mysql)andPostgreSQL(/virtualmachine/components/postgresql).
forthefirsttime?

Whatistheadministratorpassword?
HowToEnableHTTPSSupportWithSSLCertificates?
WhatSSHusernameshouldIusefor
secureshellaccesstomy NOTE:Thestepsbelowassumethatyouareusingacustomdomainnameandthatyouhavealready
application?
configuredthecustomdomainnametopointtoyourcloudserver.
Howtoaccessyourapplication?
BitnamiimagescomewithSSLsupportalreadypreconfiguredandwithadummycertificateinplace.Although
Whatisthedefaultconfigurationof thisdummycertificateisfinefortestinganddevelopmentpurposes,youwillusuallywanttouseavalidSSL
Openfire? certificateforproductionuse.Youcaneithergeneratethisonyourown(explainedhere)oryoucanpurchaseone
HowtoconnecttotheOpenfire fromacommercialcertificateauthority.
AdministrationPanel?
Onceyouobtainthecertificateandcertificatekeyfiles,youwillneedtoupdateyourservertousethem.Follow
HowtoconnecttotheMySQLdatabase?
thesestepstoactivateSSLsupport:
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 9/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Usethetablebelowtoidentifythecorrectlocationsforyourcertificateandconfigurationfiles.

UpdatingtheIPaddressorhostname
Variable Value

CurrentapplicationURL https://[customdomain]/

Content Example:https://mydomain.com/orhttps://my

domain.com/appname
Description

FirststepswiththeBitnamiOpenfire Apacheconfigurationfile /opt/bitnami/apache2/conf/bitnami/bitnami.conf

Stack
Certificatefile /opt/bitnami/apache2/conf/server.crt
HowtoimportaBitnamiVirtual
Machine? Certificatekeyfile /opt/bitnami/apache2/conf/server.key

ImportingaBitnamiVirtual CAcertificatebundlefile(if
MachineinVirtualBox /opt/bitnami/apache2/conf/serverca.crt
present)
ImportingaBitnamiVirtual
MachineinVMware CopyyourSSLcertificateandcertificatekeyfiletothespecifiedlocations.

Whatistheadministratorusername
setformetologintotheapplication NOTE:Ifyouusedifferentnamesforyourcertificateandkeyfiles,youshouldreconfigurethe
forthefirsttime? SSLCertificateFileandSSLCertificateKeyFiledirectivesinthecorrespondingApacheconfigurationfileto
Whatistheadministratorpassword? reflectthecorrectfilenames.

WhatSSHusernameshouldIusefor
IfyourcertificateauthorityhasalsoprovidedyouwithaPEMencodedCertificateAuthority(CA)bundle,
secureshellaccesstomy
application? youmustcopyittothecorrectlocationintheprevioustable.Then,modifytheApacheconfigurationfileto
includethefollowinglinebelowtheSSLCertificateKeyFiledirective.Choosethecorrectdirectivebasedon
Howtoaccessyourapplication?
yourscenarioandApacheversion:

Whatisthedefaultconfigurationof Variable Value

Openfire?
Apacheconfigurationfile /opt/bitnami/apache2/conf/bitnami/bitnami.conf
HowtoconnecttotheOpenfire
AdministrationPanel?
Directivetoinclude(Apachev2.4.8+) SSLCACertificateFile"/opt/bitnami/apache2/conf/serverca.crt"
HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 10/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
Variable Value
UpdatingtheIPaddressorhostname
Directivetoinclude(Apache< SSLCertificateChainFile"/opt/bitnami/apache2/conf/server
v2.4.8) ca.crt"

Content NOTE:IfyouuseadifferentnameforyourCAcertificatebundle,youshouldreconfigurethe
Description SSLCertificateChainFileorSSLCACertificateFiledirectivesinthecorrespondingApacheconfigurationfileto
reflectthecorrectfilename.
FirststepswiththeBitnamiOpenfire
Stack
Onceyouhavecopiedalltheservercertificatefiles,youmaymakethemreadablebytherootuseronly
HowtoimportaBitnamiVirtual withthefollowingcommands:
Machine?

ImportingaBitnamiVirtual $sudochownroot:root/opt/bitnami/apache2/conf/server*
MachineinVirtualBox $sudochmod600/opt/bitnami/apache2/conf/server*

ImportingaBitnamiVirtual
MachineinVMware Openport443intheserverfirewall.RefertotheFAQ(/virtualmachine/faq)formoreinformation.

Whatistheadministratorusername RestarttheApacheserver.
setformetologintotheapplication
forthefirsttime?
YoushouldnowbeabletoaccessyourapplicationusinganHTTPSURL.
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy HowToCreateAnSSLCertificate?
application?
YoucancreateyourownSSLcertificatewiththeOpenSSLbinary.Acertificaterequestcanthenbesenttoa
Howtoaccessyourapplication? certificateauthority(CA)togetitsignedintoacertificate,orifyouhaveyourowncertificateauthority,youmay
signityourself,oryoucanuseaselfsignedcertificate(becauseyoujustwantatestcertificateorbecauseyou
Whatisthedefaultconfigurationof aresettingupyourownCA).
Openfire?
Createyourprivatekey(ifyouhaven'tcreateditalready):
HowtoconnecttotheOpenfire
AdministrationPanel? $sudoopensslgenrsaout/opt/bitnami/apache2/conf/server.key2048

HowtoconnecttotheMySQLdatabase?
Createacertificate:
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 11/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
$sudoopensslreqnewkey/opt/bitnami/apache2/conf/server.keyout/opt/bitnami/apache2/c
UpdatingtheIPaddressorhostname onf/cert.csr

IMPORTANT:Entertheserverdomainnamewhentheabovecommandasksforthe"CommonName".
Content
Sendcert.csrtothecertificateauthority.Whenthecertificateauthoritycompletestheirchecks(and
Description
probablyreceivedpaymentfromyou),theywillhandoveryournewcertificatetoyou.
FirststepswiththeBitnamiOpenfire
Untilthecertificateisreceived,createatemporaryselfsignedcertificate:
Stack

HowtoimportaBitnamiVirtual $sudoopensslx509in/opt/bitnami/apache2/conf/cert.csrout/opt/bitnami/apache2/conf/ser
Machine? ver.crtreqsignkey/opt/bitnami/apache2/conf/server.keydays365

ImportingaBitnamiVirtual
MachineinVirtualBox Backupyourprivatekeyinasafelocationaftergeneratingapasswordprotectedversionasfollows:
ImportingaBitnamiVirtual
MachineinVMware $sudoopensslrsades3in/opt/bitnami/apache2/conf/server.keyoutprivkey.pem

Whatistheadministratorusername
setformetologintotheapplication NotethatifyouusethisencryptedkeyintheApacheconfigurationfile,itwillbenecessarytoenterthe
forthefirsttime? passwordmanuallyeverytimeApachestarts.Regeneratethekeywithoutpasswordprotectionfromthisfile

Whatistheadministratorpassword?
asfollows:

WhatSSHusernameshouldIusefor $sudoopensslrsainprivkey.pemout/opt/bitnami/apache2/conf/server.key
secureshellaccesstomy
application?
Findmoreinformationaboutcertificatesathttp://www.openssl.org(http://www.openssl.org).
Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?
HowToForceHTTPSRedirection?
Addthefollowingtothetopofthe/opt/bitnami/apps/openfire/conf/httpdprefix.conffile:
HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 12/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
RewriteEngineOn
UpdatingtheIPaddressorhostname RewriteCond%{HTTPS}!=on
RewriteRule^/(.*)https://%{SERVER_NAME}/$1[R,L]

Content AftermodifyingtheApacheconfigurationfiles,restartApachetoapplythechanges.

Description

FirststepswiththeBitnamiOpenfire HowToDebugApacheErrors?
Stack
OnceApachestarts,itwillcreatetwologfilesat/opt/bitnami/apache2/logs/access_logand
HowtoimportaBitnamiVirtual /opt/bitnami/apache2/logs/error_logrespectively.
Machine?
Theaccess_logfileisusedtotrackclientrequests.Whenaclientrequestsadocumentfromtheserver,
ImportingaBitnamiVirtual Apacherecordsseveralparametersassociatedwiththerequestinthisfile,suchas:theIPaddressofthe
MachineinVirtualBox
client,thedocumentrequested,theHTTPstatuscode,andthecurrenttime.
ImportingaBitnamiVirtual
Theerror_logfileisusedtorecordimportantevents.Thisfileincludeserrormessages,startupmessages,
MachineinVMware
andanyothersignificanteventsinthelifecycleoftheserver.Thisisthefirstplacetolookwhenyourun
Whatistheadministratorusername intoaproblemwhenusingApache.
setformetologintotheapplication
forthefirsttime?
Ifnoerrorisfound,youwillseeamessagesimilarto:
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor SyntaxOK
secureshellaccesstomy
application?

Howtoaccessyourapplication?
HowToModifyPHPSettings?
Whatisthedefaultconfigurationof ThePHPconfigurationfileallowsyoutoconfigurethemodulesenabled,theemailsettingsorthesizeofthe
Openfire? uploadfiles.Itislocatedat/opt/bitnami/php/etc/php.ini.

HowtoconnecttotheOpenfire
AdministrationPanel? AftermodifyingthePHPconfigurationfile,restartbothApacheandPHPFPMforthechangestotakeeffect:

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 13/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
$sudo/opt/bitnami/ctlscript.shrestartapache
UpdatingtheIPaddressorhostname $sudo/opt/bitnami/ctlscript.shrestartphpfpm

Forexample,tomodifythedefaultuploadlimitforPHP,updatethePHPconfigurationfilefollowingthese
Content instructions.

Description

FirststepswiththeBitnamiOpenfire HowToModifyTheAllowedLimitForUploadedFiles?
Stack
Modifythefollowingoptionsinthe/opt/bitnami/php/etc/php.inifiletoincreasetheallowedsizeforuploads:
HowtoimportaBitnamiVirtual
Machine?
;MaximumsizeofPOSTdatathatPHPwillaccept.
ImportingaBitnamiVirtual post_max_size=16M
MachineinVirtualBox

ImportingaBitnamiVirtual ;Maximumallowedsizeforuploadedfiles.
MachineinVMware upload_max_filesize=16M

Whatistheadministratorusername
setformetologintotheapplication
RestartPHPFPMandApacheforthechangestotakeeffect.
forthefirsttime?

Whatistheadministratorpassword?
$sudo/opt/bitnami/ctlscript.shrestartapache
WhatSSHusernameshouldIusefor $sudo/opt/bitnami/ctlscript.shrestartphpfpm
secureshellaccesstomy
application?

Howtoaccessyourapplication?
HowToAccessPhpMyAdmin?
Whatisthedefaultconfigurationof Forsecurityreasons,phpMyAdminisaccessibleonlywhenusing127.0.0.1asthehostname.Toaccessitfroma
Openfire? remotesystem,youmustcreateanSSHtunnelthatroutesrequeststotheApacheWebserverfrom127.0.0.1.
ThisimpliesthatyoumustbeabletoconnecttoyourvirtualmachineoverSSHinordertoaccessthese
HowtoconnecttotheOpenfire
AdministrationPanel? applicationsremotely.

HowtoconnecttotheMySQLdatabase?
IMPORTANT:Beforefollowingthestepsbelow,ensurethatyourApacheandMySQLserversarerunning.
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 14/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
NOTE:Thestepsbelowsuggestusingport8888fortheSSHtunnel.Ifthisportisalreadyinusebyanother
UpdatingtheIPaddressorhostname applicationonyourlocalmachine,replaceitwithanyotherportnumbergreaterthan1024andmodifythe
stepsbelowaccordingly.Similarly,ifyouhaveenabledVarnish,yourstack'sApacheWebservermightbe
runningonport81.Inthiscase,modifythestepsbelowtouseport81insteadofport80forthetunnel
endpoint.
Content
Description Windows
ToaccesstheapplicationusingyourWebbrowser,createanSSHtunnel,asdescribedbelow.
FirststepswiththeBitnamiOpenfire
Stack DownloadPuTTYandmakesureyoucanlogintothevirtualmachineconsolewithitfollowingthe

HowtoimportaBitnamiVirtual instructionsintheFAQ(/virtualmachine/faq#howtoconnecttotheserverthroughssh).Onceyouhave
Machine? confirmedyouareabletologinsuccessfully,logbackout.

ImportingaBitnamiVirtual ReconnecttothevirtualmachineusingPuTTY,thistimeadaptingthestepstoincludeanadditionalSSH
MachineinVirtualBox tunnel.WhenconfiguringthenewSSHsessioninPuTTY,additionallynavigatetothe"Connection>SSH
>Tunnels"sectionandcreateasecuretunnelbyforwardingport80onthevirtualmachinetoport8888on
ImportingaBitnamiVirtual
MachineinVMware thelocalhost(127.0.0.1orlocalhost).

Whatistheadministratorusername Clickthe"Add"buttontoaddthesecuretunnelconfigurationtothesession.Hereisanexample:
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 15/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword? (/images/img/infrastructure/common/createsshtunnel88881822d77b.png)

WhatSSHusernameshouldIusefor Gobacktothe"Session"sectionandsaveyourchangesbyclickingthe"Save"button.
secureshellaccesstomy
Clickthe"Open"buttontoopenanSSHsessiontothevirtualmachine.TheSSHsessionwillnowincludea
application?
secureSSHtunnelbetweenthetwospecifiedports.
Howtoaccessyourapplication?
Whilethetunnelisactive,youshouldbeabletoaccessthephpMyAdminconsolethroughthesecureSSHtunnel
Whatisthedefaultconfigurationof youcreated,bybrowsingtohttp://127.0.0.1:8888/phpmyadmin.
Openfire?

HowtoconnecttotheOpenfire Tologin,useusernamerootforMySQL.Thedefaultpasswordisbitnami.
AdministrationPanel?
IfyouareunabletoaccessphpMyAdmin,verifythattheSSHtunnelwascreatedbycheckingthePuTTYevent
HowtoconnecttotheMySQLdatabase?
log(accessibleviathe"EventLog"menu):
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 16/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?
(/images/img/infrastructure/common/createsshtunnellog409dee64.png)
ImportingaBitnamiVirtual
MachineinVirtualBox LinuxAndMacOSX
ImportingaBitnamiVirtual ToaccesstheapplicationusingyourWebbrowser,createanSSHtunnel,asdescribedbelow.
MachineinVMware
Openanewterminalwindowonyourlocalsystem(forexample,using"Finder>Applications>Utilities>
Whatistheadministratorusername Terminal"inMacOSXortheDashinUbuntu).
setformetologintotheapplication
forthefirsttime? MakesureyoucanlogintothevirtualmachineconsolefollowingtheinstructionsintheFAQ(/virtual
machine/faq#howtoconnecttotheserverthroughssh).Onceyouhaveconfirmedyouareabletologin
Whatistheadministratorpassword?
successfully,logbackout.
WhatSSHusernameshouldIusefor RunthefollowingcommandtoconfiguretheSSHtunnel.RemembertoreplaceSERVERIPwiththeIP
secureshellaccesstomy
addressofyourvirtualmachine.EnteryourSSHpasswordwhenprompted.
application?

Howtoaccessyourapplication? $sshNL8888:127.0.0.1:80bitnami@SERVERIP

Whatisthedefaultconfigurationof
Ifyouareusingaprivatekeytoconnecttothevirtualmachine,usethefollowingcommandinstead,
Openfire?
rememberingtoreplaceKEYFILEwiththepathtoyourprivatekeyandSERVERIPwiththeIPaddressof
HowtoconnecttotheOpenfire yourvirtualmachine:
AdministrationPanel?
$sshNL8888:127.0.0.1:80iKEYFILEbitnami@SERVERIP
HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 17/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
NOTE:Ifsuccessful,theabovecommandswillcreateanSSHtunnelbutwillnotdisplayanyoutputon
UpdatingtheIPaddressorhostname theserverconsole.

Whilethetunnelisactive,youshouldbeabletoaccessthephpMyAdminconsolethroughthesecureSSHtunnel

Content youcreated,bybrowsingtohttp://127.0.0.1:8888/phpmyadmin.

Description Tologin,useusernamerootforMySQL.Thedefaultpasswordisbitnami.

FirststepswiththeBitnamiOpenfire
Stack Alternatively,ifyouarerunningthevirtualmachineinasecureenvironment,youcanenableaccessto
phpMyAdminfromhostsotherthan127.0.0.1byeditingthe/opt/bitnami/apps/phpmyadmin/conf/httpdapp.conf
HowtoimportaBitnamiVirtual
fileandmodifyingtheAllowandRequiredirectivesasbelow:
Machine?

ImportingaBitnamiVirtual
Defaultdirective Modifieddirective
MachineinVirtualBox

ImportingaBitnamiVirtual Apache2.2 Allowfrom127.0.0.1 Allowfromall

MachineinVMware
Apache2.4+ Requirelocal Requireallgranted
Whatistheadministratorusername
setformetologintotheapplication Youcanalsousetheexampleconfigurationfilebelowifyouwish:
forthefirsttime?

Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 18/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?
<IfDefineUSE_PHP_FPM>
UpdatingtheIPaddressorhostname <Proxy"unix:/opt/bitnami/php/var/run/phpmyadmin.sock|fcgi://phpmyadminfpm"timeout=300>
</Proxy>
</IfDefine>

Content <Directory"/opt/bitnami/apps/phpmyadmin/htdocs">
Description #AuthTypeBasic
#AuthNamephpMyAdmin
FirststepswiththeBitnamiOpenfire
Stack #AuthUserFile"/opt/bitnami/apache2/users"
#Requirevaliduser
HowtoimportaBitnamiVirtual
AllowOverrideNone
Machine?

ImportingaBitnamiVirtual <IfModulephp5_module>
MachineinVirtualBox
php_valueupload_max_filesize80M
ImportingaBitnamiVirtual php_valuepost_max_size80M
MachineinVMware </IfModule>

Whatistheadministratorusername
setformetologintotheapplication <IfVersion<2.3>
forthefirsttime? Orderallow,deny

Whatistheadministratorpassword? Allowfromall
Satisfyall
WhatSSHusernameshouldIusefor
</IfVersion>
secureshellaccesstomy
application? <IfVersion>=2.3>
Requireallgranted
Howtoaccessyourapplication?
</IfVersion>

Whatisthedefaultconfigurationof
ErrorDocument403"Forsecurityreasons,thisURLisonlyaccessibleusinglocalhost(127.0.0.1)
Openfire?
asthehostname"
HowtoconnecttotheOpenfire
AdministrationPanel?
<IfDefineUSE_PHP_FPM>
HowtoconnecttotheMySQLdatabase? <FilesMatch\.php$>
SetHandler"proxy:fcgi://phpmyadminfpm/"
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 19/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? </FilesMatch>
</IfDefine>
UpdatingtheIPaddressorhostname

</Directory>

Content RestartApachetohavethechangestakeeffect:
Description

FirststepswiththeBitnamiOpenfire $cd/opt/bitnami
Stack $sudo./ctlscript.shrestartapache

HowtoimportaBitnamiVirtual
Machine? YoushouldnowbeabletoaccessphpMyAdminbybrowsingtohttp://SERVERIP/phpmyadmin.
ImportingaBitnamiVirtual
MachineinVirtualBox Tologin,useusernamerootforMySQL.Thedefaultpasswordisbitnami.

ImportingaBitnamiVirtual
MachineinVMware
HowToChangeTheOpenfireAdminPassword?
Whatistheadministratorusername
setformetologintotheapplication ChangeitusingtheOpenfireAdministrationPanel.Followthenextsteps:
forthefirsttime?
LogintotheOpenfireAdministrationPanel.
Whatistheadministratorpassword? Browsetothe"User/Groups"menuitemandclicktheuser"admin"button.
WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?
(/images/img/apps/openfire/openfirechangepassword17cadfed5.png)
HowtoconnecttotheMySQLdatabase?
Browsetothe"UserOptions>Password"menuitem,fillwiththenewpasswordandclickthe"Update
Howtodebugerrorsinyourdatabase? Password"button.
https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 20/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack
(/images/img/apps/openfire/openfirechangepassword2446af744.png)
HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual HowToConnectAClientToTheOpenfireServer?
MachineinVirtualBox
ToconnecttoOpenfirefromanXMPPClient,pleasecheckthatports5222and5223areopenedforremote
ImportingaBitnamiVirtual access.RefertotheFAQ(/virtualmachine/faq)formoreinformationonthis.
MachineinVMware

Whatistheadministratorusername YoucanuseanyXMPPclientbutthissectiondocumentsSpark.SparkisanOpenSource,crossplatformIM
setformetologintotheapplication clientoptimizedforbusinessesandorganizationswhichistheeasiestandbestalternativetouseincombination
forthefirsttime? wihtOpenfire.
Whatistheadministratorpassword?
ConnectyourSparkclientfollowingthenextsteps:
WhatSSHusernameshouldIusefor
secureshellaccesstomy LogintotheOpenfireAdministrationPanelandcreateanewuser.
application?
OpenyourSparkclient,filltherequiredinformationandclickthe"login"button.Youmustindicateyour
Howtoaccessyourapplication? user,passwordandtheIPaddressorhostnameofyourOpenfireserver.

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 21/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword? (/images/img/apps/openfire/openfireconnectclient1760ccebb.png)

WhatSSHusernameshouldIusefor
secureshellaccesstomy YoucanfindmoreinformationaboutSparkattheofficialSparkWebsite
application? (http://www.igniterealtime.org/projects/spark/index.jsp)

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
HowToCreateANewGroupChatRoom?
Openfire? CreateanewgroupchatroomusingtheOpenfireAdministrationPanel.Youhavetofollowthenextsteps:

HowtoconnecttotheOpenfire LogintotheOpenfireAdministrationPanel.
AdministrationPanel?
Browsetothe"GroupChat>RoomAdministration>CreateNewRoom"menuitem,filltherequired
HowtoconnecttotheMySQLdatabase? information,selectthedesiredoptionsandclickonthe"SaveChanges"button.

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 22/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?
(/images/img/apps/openfire/openfirecreateroom1a0873436.png)
ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual HowToCreateANewUser?
MachineinVMware
YoucaneasilycreateanewuserusingtheOpenfireAdministrationPanel.Youhavetofollowthenextsteps:
Whatistheadministratorusername LogintotheOpenfireAdministrationPanel.
setformetologintotheapplication
forthefirsttime? Browsetothe"User/Groups>Users>CreateNewUser"menuitem,filltherequiredinformationandclick
onthe"createuser"button.
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 23/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? (/images/img/apps/openfire/openfirecreateuser1e01f8c14.png)

UpdatingtheIPaddressorhostname

HowToDebugOpenfireErrors?
TodebugOpenfire'serrors,checkthelogfilesofOpenfireat/opt/bitnami/openfire/logs/.
Content
Description

FirststepswiththeBitnamiOpenfire
HowToEnableAPluginOnOpenfire?
Stack ToenableaplugininOpenfirefollowthestepsbelow:

HowtoimportaBitnamiVirtual LogintotheOpenfireAdministrationPanel.
Machine?
Browsetothe"Plugins>AvailablePlugins"menuitem.
ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?
(/images/img/apps/openfire/openfireinstallplugins17f225bb0.png)
Howtoaccessyourapplication?
Onceyoufindthepluginyouarelookingforinthelist,clickthe"Install"buttontodownloadandinstallit.

Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 24/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack (/images/img/apps/openfire/openfireinstallplugins2556f0c43.png)
HowtoimportaBitnamiVirtual Oncethepluginisinstalled,youwillabletouseitunlessthepluginrequiresfurtherstepstoconfigureit.
Machine?

ImportingaBitnamiVirtual Youcanlaterondeletethepluginyouinstalledifyouwish.Youjusthavetobrowseto"Plugins>Plugins",find
MachineinVirtualBox yourplugininthelistandclickthe"delete"button.

ImportingaBitnamiVirtual
MachineinVMware [![Openfireplugininstallation](/images/img/apps/openfire/openfireinstallplugins3bf277885.pn

Whatistheadministratorusername g){:.imgmedium}](/images/img/apps/openfire/openfireinstallplugins3bf277885.png)
setformetologintotheapplication
forthefirsttime?
Youcanalsoinstallapluginbyuploadingthe.jarpluginfiledirectly.Youjusthavetobrowseto"Plugins>
Whatistheadministratorpassword? Plugins",chooseyour.jarfileanduploadit.

WhatSSHusernameshouldIusefor
secureshellaccesstomy [![Openfireplugininstallation](/images/img/apps/openfire/openfireinstallplugins44712d7da.pn
application?
g){:.imgmedium}](/images/img/apps/openfire/openfireinstallplugins44712d7da.png)
Howtoaccessyourapplication?

FindoutmoreaboutOpenfire'splugins(http://www.igniterealtime.org/projects/openfire/plugins.jsp).
Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire HowToUseTheRESTAPIPluginOnOpenfire?
AdministrationPanel?
ToenableRESTAPIpluginonOpenfirefollowthenextsteps:
HowtoconnecttotheMySQLdatabase?
LogintotheOpenfireAdministrationPanel.
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 25/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? InstalltheRESTAPIpluginasexplainedintheinstructions.

UpdatingtheIPaddressorhostname Browsetothe"Server>ServerSettings>RESTAPI"menuitem.Mark"EnabledRESTAPIrequests
willbeprocessed"andclickthe"SaveSettings"button.

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?
(/images/img/apps/openfire/openfirerestapiplugin137581732.png)
Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor OnceyouhaveinstalledandenabledtheAPIRESTpluginyouwillbeabletosendAPIrequeststotheOpenfire
secureshellaccesstomy
Server.
application?

Howtoaccessyourapplication? FindoutmoreabouthowtosendAPIrequeststoOpenfireusingAPIRESTplugin
(http://www.igniterealtime.org/projects/openfire/plugins/restapi/readme.html).
Whatisthedefaultconfigurationof
Openfire?

HowtoconnecttotheOpenfire HowToSetTheServerXMPPDomain?
AdministrationPanel?
SettheserverXMPPdomainusingtheAdministrationPanel.Followthestepsbelow:
HowtoconnecttotheMySQLdatabase?
LogintotheOpenfireAdministrationPanel.
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 26/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Browsetothe"Server>SystemProperties"section,scrolltothebottomofthepage,clickthe"Edit"button
andset"PropertyValue"tothedesireddomainname.Afterthat,click"SaveProperty".
UpdatingtheIPaddressorhostname

Content
Description

FirststepswiththeBitnamiOpenfire
Stack

HowtoimportaBitnamiVirtual
Machine?

ImportingaBitnamiVirtual
MachineinVirtualBox

ImportingaBitnamiVirtual
MachineinVMware

Whatistheadministratorusername
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword?

WhatSSHusernameshouldIusefor
secureshellaccesstomy
application?

Howtoaccessyourapplication?
(/images/img/apps/openfire/openfiresetdomain1ff4fdb22.png)
Whatisthedefaultconfigurationof ConnecttoyourserverthroughSSHandexecutethecommandbelow:
Openfire?
$sudo/opt/bitnami/ctlscript.shrestartopenfire
HowtoconnecttotheOpenfire
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?
HowToUpgradeOpenfire?
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 27/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Itisstronglyrecommendedtocreateabackupbeforestartingtheupdateprocess.Ifyouhaveimportantdata,
createandtrytorestoreabackuptoensurethateverythingworksproperly.
UpdatingtheIPaddressorhostname

Youcanupgradetheapplicationonlywithoutmodifyinganyotherstackcomponents.Followthesesteps:

Stopyourserver:
Content
$sudo/opt/bitnami/ctlscript.shstop
Description

FirststepswiththeBitnamiOpenfire
Copytheetc/,var/andopenfire_home/foldersintheopenfire/folder:
Stack

HowtoimportaBitnamiVirtual $mkdir~/openfire_backup
Machine? $sudocpr/opt/bitnami/openfire/conf~/openfire_backup/

ImportingaBitnamiVirtual $sudocpr/opt/bitnami/openfire/scripts~/openfire_backup/
MachineinVirtualBox

ImportingaBitnamiVirtual Downloadthelatestversion(http://www.igniterealtime.org/downloads/index.jsp)ofOpenfireand
MachineinVMware uncompressit:

Whatistheadministratorusername
$tarxvfopenfire_4_0_2.tar.gz
setformetologintotheapplication
forthefirsttime?

Whatistheadministratorpassword? Copytheuncompressedfolderto/opt/bitnami/openfire:

WhatSSHusernameshouldIusefor $cpropenfire_4_0_2.tar/*/opt/bitnami/openfire/
secureshellaccesstomy
application?
Recoveryourbackupfiles:
Howtoaccessyourapplication?
$sudocpr~/openfire_backup/*/opt/bitnami/openfire/
Whatisthedefaultconfigurationof
Openfire?
Restartyourserver:
HowtoconnecttotheOpenfire
AdministrationPanel? $sudo/opt/bitnami/ctlscript.shrestart

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 28/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices?

UpdatingtheIPaddressorhostname

BitnamiDocumentation
Content FAQs
Description Howtofindapplicationcredentials?(/general/faq#find_credentials)
HowtoconnecttotheserverthroughSSH?(/general/faq#connect_ssh)
FirststepswiththeBitnamiOpenfire
HowtouploadfilestotheserverwithSFTP?(/general/faq#upload_files)
Stack
Howtoopentheserverportsforremoteaccess?(/general/faq#open_firewall)
HowtoimportaBitnamiVirtual HowtoconfigureyourapplicationtouseathirdpartySMTPserviceforoutgoingemail?
Machine? (/general/faq#use_external_smtp_title)
HowtoblockasuspiciousIPaddress?(/general/faq#block_suspicious_ip)
ImportingaBitnamiVirtual
MachineinVirtualBox
PlatformDocumentation
ImportingaBitnamiVirtual GoogleCloudPlatform(/google)
MachineinVMware AWSCloud(/aws)
Whatistheadministratorusername
OracleCloudPlatform(/oracle)
MicrosoftAzure(/azure)
setformetologintotheapplication
forthefirsttime? BitnamiCloudHosting(/bch)
CenturyLinkCloud(/centurylink)
Whatistheadministratorpassword? 1&1CloudPlatform(/1and1)
GoDaddyCloud(/godaddy)
WhatSSHusernameshouldIusefor
OpenTelekomCloud(/opentelekomcloud)
secureshellaccesstomy
Installers(/installer)
application?
VirtualMachines(/virtualmachine)
Howtoaccessyourapplication? Containers(/containers)
Kubernetes(/kubernetes)
Whatisthedefaultconfigurationof
Openfire? GeneralDocumentation
BitnamiApplicationStacks(/general/apps)
HowtoconnecttotheOpenfire
BitnamiInfrstructureStacks(/general/infrastructure)
AdministrationPanel?
HowToGuides(/general/howto)
BitnamiComponents(/general/components)
HowtoconnecttotheMySQLdatabase?
SecurityNotices(/general/security)
Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 29/30
28.04.2017 BitnamiOpenfireVirtualMachine

Howtostartorstoptheservices? Bitnami2017

UpdatingtheIPaddressorhostname

Apps
Content Applications(https://bitnami.com/stacks)
Addons(https://bitnami.com/addons)
Description
Vote!(https://bitnami.com/contest)
FirststepswiththeBitnamiOpenfire
Stack Whatwedo
CloudHosting(https://bitnami.com/cloud)
HowtoimportaBitnamiVirtual
Pricing(https://bitnami.com/cloud/pricing)
Machine?
Enterprise(https://bitnami.com/enterprise)
ImportingaBitnamiVirtual CloudPartners(https://bitnami.com/partners/cloud)
MachineinVirtualBox SoftwarePartners(https://bitnami.com/partners/software)
Customers(https://bitnami.com/cloud/customerstestimonials)
ImportingaBitnamiVirtual
FAQs(https://bitnami.com/cloud/pricing#faqs)
MachineinVMware

Whatistheadministratorusername Whoweare
setformetologintotheapplication
About(https://bitnami.com/aboutus)
forthefirsttime? Contact(https://bitnami.com/contact)
Careers(https://bitnami.com/careers)
Whatistheadministratorpassword?
What'sNew?(https://bitnami.com/news)
Press(https://bitnami.com/news/press)
WhatSSHusernameshouldIusefor
secureshellaccesstomy Blog(http://blog.bitnami.com)
application? Legal(https://bitnami.com/legal)

Howtoaccessyourapplication?Support

Documentation(https://bitnami.com/support)
Whatisthedefaultconfigurationof Forums(https://community.bitnami.com)
Openfire?
Helpdesk(http://helpdesk.bitnami.com)
HowtoconnecttotheOpenfire Webinars(https://bitnami.com/webinars)
AdministrationPanel?

HowtoconnecttotheMySQLdatabase?

Howtodebugerrorsinyourdatabase?

https://docs.bitnami.com/virtualmachine/apps/openfire/#howtoconnectaclienttotheopenfireserver 30/30