settings.ini.cfm Reference
Settings
- mode=production
- Description: Sets the mode per the appropriate settings in the section defined as [production], [development], [etc]. A complete set of attributes is required. Duplicate the default production set here and edit as necessary.
- Options: production, development, staging, etc.
- appname=Mura CMS
- Description: Forthcoming
- Options: Forthcoming
- appReloadKey=appreload
- Description: Name of the url variable used to reload Mura. Best practice suggests changing this for security through obscurity.
- installed=0
- Description: Forthcoming
- Options: Forthcoming
Production
- title=Mura CMS
- Description: This prepends the Site Name in the <title> tag of the Mura Admin.
- filedir
- Description: Optional. This redefines the file system path for storing site assets that are uploaded through the editor, component cacheing, files associated with a specific content node. If this is not set, it will place all assets into the local site ID directory. Defaults to the Mura webroot (not the webrootmap set here)+assetpath-the context.
- Example: "c:\\inetpub\assets"
- fileStore
- Description: Defines where you store content-node associated files such as a gallery item, or file.
- Options: database, fileDir, or s3
- fileStoreAccessInfo
- Description: This is the a caret-delimited string for Amazon S3 file storage service following the convention of "Access Key ID^Secret Access Key^Bucket"
- Example: 0EGQ0TXQW1dsfhgsdfR6C602^JtyxuImafdgfdIaV+g7edhNpmcpIQ00eokGaCGpC^files.yourdomain.com
- assetdir
- Description: Forthcoming
- Example:
- assetpath
- Description: The URL to where assets are stored. Can be a domain or root relative path.
- Example: /tasks/sites (no trailing slash), http://assets.domain.com
- plugindir
- Description: Forthcoming
- Example:
- usefilemode
- Description: Forthcoming
- Options: Forthcoming
- mapdir=mura
- Description: This is a deprecated setting specific to ColdFusion MX 7 that is not supported. Do not change.
- webrootmap=murawrm
- Description: This is a ColdFusion MX 7 specific setting to tell Mura what your mapping is in the CFMX7 administrator. Do not change.
- datasource=muradb
- Description: This the Data Source Name (DSN) created for Mura. This is usually done in the ColdFusion or Railo administrator, or in the control panel of your host if you are installing Mura in a shared environment. Please note that if you are installing Mura in a shared environment, this will likely need to be changed to something other than "savadb" to make sure it is unique to the server.
- dbType=mssql
- Description: This sets the type of database you are using. Mura currently supports MySQL 4+, MS SQL 2000+ and Oracle 10g(+?).
- Options: mssql, mysql, oracle
- dbUsername
- Description: This is the username used to log into your database.
- dbPassword
- Description: This is the password used to log into your database.
- context
- Description: If you are installing Mura into a sub-directory, you will need to set the context to that directory.
- Example: /nameofdirectory (no trailing slash)
- stub
- Description: Used to define the friendly URL servlet for application servers that do not support index.cfm/about-us, or if you just prefer taht format for URLs.
- Option: go
- admindomain
- Description: Optional. Binds the Mura admin to a specific domain especially for SSL or obscuring access to the Mura admin.
- Example: admin.yoursite.com
- indexfile=index.cfm
- Description: Deprecated.
- adminemail
- Description: Secondary email settings for emails that need to be sent that are not associated with a specific site such as the Mura admin.
- Example: user@domain.com
- mailserverip
- Description: The server used to send emails from Mura.
- Example: mail.domain.com, 267.11.98.23
- mailserversmtpport
- Description: Port of the mail server you'd like Mura to use to send emails such as review notifications, login/password resets, Email Broadcaster email, etc. Defaults to 25.
- mailserverpopport
- Description: Port of the mail server you'd like Mura to check for bounced emails from the Email Broadcaster. Defaults to 110.
- mailserverusername
- Description: This is the username used to log into or send emails from the adminemail account.
- mailserverpassword
- Description: This is the password used to log into the adminemail account.
- mailservertls
- Description: Forthcoming
- Options: 1,0
- mailserverssl
- Description: Forthcoming
- Options: 1,0
- usedefaultsmtpserver
- Description: Setting this to 1 will allow Mura to use the default SMTP server specified in your application server. Alternatively, you can use a different email server by specifying the mailserverip, mailserverusername and mailserverpassword below.
- Options: 1, 0
- adminssl
- Description: If you have an SSL certificate on your domain.
- Options: 1, 0
- logEvents
- Description: Creates log files for tracking events in Mura.
- Options:1, 0
- debuggingEnabled=true
- Description: Toggles debugging on errors between the default app server debugging output or the error.html file found in /config.
- Options: true, false
- port
- Description: This is the default http port for your webserver. If you need to use another such as 8500 (for a local ColdFusion deployment), set it here. Defaults to 80.
- sessionHistory
- Description: This sets the number of days that will be stored for session tracking stats in the Mura Dashboard and associated reports. This has the potential to impact database storage significantly so for sites with more traffic, it should be adjusted as necessary. Defaults to 1 day.
- sharableremotesessions
- Description: Forthcoming. Defaults to 1.
- dashboard
- Description: Toggles the Mura Dashboard on or off. If you 'd like to not use the Mura Dashboard and have users directed to the Mura Site Manager instead, set this to false. Defaults to True.
- locale
- Description: Renders Dates and Currency per the servers locale or clients locale. Defaults to server.
- Options: server, client
- ping
- Description: This controls the scheduled task Mura creates for publishing scheduled content, sending scheduled emails, etc. If this functionality is important to you, leave it set to 1. Defaults to 0.
- Options: 1,0
- enablemuratag
- Description: Toggles rendering of the [mura ] tag. Defaults to true.
- Options: true, false
- proxyuser
- Description: Forthcoming.
- Options:Forthcoming.
- proxypassword
- Description: Forthcoming.
- Options: Forthcoming.
- proxyserver
- Description: Forthcoming.
- Options: Forthcoming.
- proxyport
- Description: Forthcoming. Defaults to 80.
- Options: Forthcoming.
- sortpermission
- Description: Forthcoming.
- Options:Forthcoming.
- imageinterpolation
- This set the image quality when uploading images as content in Mura. For example, images associated with specific content and image galleries. Does not apply to any images uploaed via the WYSIWYG editor.
- Options (defined by ColdFusion, not Mura): highestquality, lanczos, highquality, mitchell, mediumPerformance, quadratic, mediumquality, hamming, hanning, hermite, highPerformance, blackman, bessel, highestPerformance, nearest, bicubic, bilinear.
- Note: There is a great blog post by Ray Camden that suggests the time it takes to process an image at each setting.
- productiondatasource
- Description: When mode is set to "staging", this and the following settings define where to deploy content.
- productionassetpath
- Description: Same as AssetPath above but specific to production environment
- productionWebroot
- Description: Same as WebRoot above but specific to production environment
- productionFiledir
- Description: Same as FileDir above but specific to production environment
- clusteriplist
- Description: Forthcoming.
- Options:Forthcoming.
- siteidinurls
- Description: Toggles the siteID (i.e. default, mynewsite, etc.) in URLS to give you a URL of http://www.yoursite.com/index.cfm/about/ instead of http://www.yoursite.com/default/index.cfm/about/. Important: If siteID's are toggled off, each site MUST have a unique URL assigned to it in "Site Settings". To remove the index.cfm from URLs, you must use URL rewriting on your webserver via ISAPI rewrite (IIS) or mod_rewrite (apache). Defaults to 1.
- Options: 1, 0.
- indexfileinurls
- Description: Toggles the beginning "/index.cfm" from the in URLS to give you a URL of http://www.yoursite.com/about/ instead of http://www.yoursite.com/index.cfm/about/. Important: This must be used in conjunction with setting the above siteidinurls attribute to 0. You must also use URL rewriting on your webserver via ISAPI rewrite (IIS) or mod_rewrite (apache) to write requested URLs back to http://www.yoursite.com/index.cfm/about/. Defaults to 1.
- Options: 1, 0.
Comments
- Yami Fonseca
Hi,
I tried to change the sessionHistory=7, instead 1. On this file :File Manager/Application Root/Config/settings.ini.cfm, but I'm still only seeing 1 days worth of data on my dashboard. Mura Core Version 5.2.1739
Site Version 5.2.1739
- July 28, 2010, 7:58 PM