Most parameters are stored as keys in the section <appSettings>. They are briefly described below. You will find more information at the respective places in the Axinom Developer Guide.
| Key |
Description |
Sample Value |
| MaintenanceBegin |
Server maintenance start time
|
23.12.2003 20:50:59 |
| MaintenanceEnd |
Server maintenance end time
|
23.12.2003 20:00:00 |
| SmtpServer |
SMTP Server will send mails |
smtp.yourcompany.com |
| SystemEmail |
Specifies the sender address for the emails sent by the system (e.g. after saving the tasks) |
cms@yourcompany.com |
| IsAxCMS |
If you are in Management System or Live System. Is only relevant for templates. |
Always 1 in MS Always 0 in LS |
| DBCONNSTRING |
Connection String to CMS-Data base |
SERVER=(local); DATABASE=AxCMS_Sample; UID=db_user; PWD=topsecret |
| CMSSystemRootDir |
Root directory of CMS-files |
C:\projects\AxCMS_Sample |
| CMSApplicationHostName |
Root URL of the CMS web -server |
http://localhost |
| CMSApplicationVirtualPath |
Virtual directory of the CMS webserver |
/AxCMSweb_Sample |
| LiveSystemHostName 1) |
Root URL of the LIVE webserver |
http://localhost |
| LiveSystemVirtualPath 1) |
Virtual directory of the LIVE webserver |
/AxCMSwebLive_Sample |
| MediaServerHostName |
Obsolete; available for compatibility reasons |
CMSApplicationHostName + CMSApplicationVirtualPath |
| MediaServerRootDir |
Obsolete, available for compatibility reasons |
CMSSystemRootDir + CMSApplicationVirtualPath |
| cmsExtension |
Extension of the CMS-pages. Has to be the same the HttpHandler is registered for and entered into the IIS. |
.Sample |
| TemplateRootDir |
Path to Templates-Project |
C:\Projects\AxCMS\AxCMSwebTemplates_Sample\ |
| TemplateDirectory |
Virtual directory for the templates |
/Templates/ |
| PublishDirectory |
Clipboard, pages are generated in before publication. |
/publish |
| Homepage |
Name of homepage. This page is linked in the CMS as „Editor (WYSIWYG)“ |
/Homepage.Sample |
| cmsCssFile |
This is the relative path to the style sheet file used to display the style in the Text-Editor. It starts at the top level of the domain.
|
/AxCMSweb/templates/CSS/style.css |
| GlobalLicenseFile |
Path to License-file |
C:\Projects\AxCMS_Sample\Sample.lic |
| SupportService |
If the SupportService is accessible online. |
on/off |
| CMSInstanceName |
Is used to identify the CMS-System. For example for MailCenter (should be the same like in the PublishService web.config |
Sample-CMS |
| ActiveDirectory |
ActiveDirectory used or not
|
1 - used 0 - not |
| ADCategories |
Assign users default roles and rights |
1 - true 0 - false |
| ADProfile |
Get profile information for users |
1 - true 0 - false |
| ActiveDirectoryUserName |
Windows-Accountname for retrieving AD-Info |
DOMAIN\user |
| ActiveDirectoryUserPassword |
Password for the Windows-Accountname used to retrieve AD-Info |
password |
| DescriptionLengthLimit |
Maximum allowed Description-field length at an AxPage object (at dynamic property filling) |
100 |
| EncryptPasswordsMS |
Encrypt user passwords on Management System |
1 - true 0 - false |
| EncryptPasswordsLive |
Encrypt user passwords on Live System
|
1 - true 0 - false |
1) The CMS has to know the URL of the Live System only to generate links to the Live System.
Additionally you have to add the following section:
<location path="publish/preliminary">
<system.web>
<authorization>
<allow users="*"/>
</authorization>
</system.web>
</location>
If you use Windows-Authentication, change IIS settings to allow everybody to access the folder publish/preliminary.
Configuring Web-Services
AxCMS.net consumes some Web-wervices. All of them are to be configured the same way. Most of the services are hosted in the AxCMSPublishService-application. The others are MailService, SupportService and WssService. You can also access additional services from your Extras-application and reuse the same configuration pattern.
Here is a description of a service configuration, using WebQueryService as an example. Just replace the name and other information to configure other service.
First, add section-description under configSections:
<section name="WebQueryService" type="Axinom.AECMS.Gateway.GatewayConfiguration, AxCMS.BL" /> |
|
The section itself looks like this:
<WebQueryService type="WebService">
<Url>http: <Timeout>30</Timeout>
<UseWSE>true</UseWSE>
<Username>wseUsername</Username>
<Password>wsePassword</Password>
<Proxy>address_of_your_proxy</Proxy>
<ProxyUsername>proxyUsername</ProxyUsername>
<ProxyPassword>proxyPassword</ProxyPassword>
</WebQueryService> |
|
Url - points to the asmx-file of the web-serivce
Timeout - web-service timeout in seconds
UseWSE - true/false - if WSE should be used to access the service. If set to true, Username and Password have to be specified as well - credentials for WSE. Web-service must also support WSE and WSE3 must be installed on both - client and server. Read more under Securing AxCMS.
Proxy - address of your web-proxy, if one is used. Optional. If the proxy requires username and password, they can be specified under ProxyUsername and ProxyPassword.
There are the following CMS clients in the MS application:
- WebQueryService (WebQueryService.asmx) allows to execute any queries on the live system from anywhere. You can use ExecuteDataTable and ExecuteNonQuery methods.
The service of this proxy is hosted in the AxCMSPublishService application. - PublishWebService (PublishWebService.asmx) is responsible for publishing of objects of all kinds.
This client will be configured as part of a PublishAgent.
The service of this proxy is hosted in the AxCMSPublishService application. - ReIndexWebService (IndexWebService.asmx) is responsible for indexing on the LS.
This client will be configured as part of a PublishAgent. The service of this proxy is hosted in the AxCMSPublishService application. - IpRuleService (IpRuleWebService.asmx) is provided to be able to manage IP authentication data stored in the LS
from the management system. It was developed before the generic WebQueryService and
could be recycled if the management logic will be reimplemented using WebQueryService.
The service of this proxy is hosted in the AxCMSPublishService application. - UserService (UserWebService.asmx) is responsible for classification and right management of live users. The service of this proxy is hosted in the AxCMSPublishService application.
- MailService (MailCenterWebService.asmx) provides means to send and manage bulk emails using the AxCMS.net MailCenter application.
The service of this proxy is NOT normally hosted in the AxCMSPublishService application,
but somewhere else as a standalone web application. - SupportService (http://support.axinom.de/WebSuiteService.asmx) is responsible for a context sensitive help of CMS user interface. You are not
supposed to call this service from the customer specific code.
The service of this proxy is hosted by the Axinom GmbH. - WssService (http://wss.yoursharepoint.com/wss/_vti_bin/AxinomWSS.asmx) is used to integrate AxCMS.net with Microsoft Sharepoint.
The IWssService interface is subject to changes in the future, don't use it unless you absolutely have to. The service if this proxy is hosted together with the sharepoint web application.
Support Service
The SupportService of Axinom delivers dynamic help for any CMS page and informs you about news in the AxCMS.net. To get this service working, your CMS application must have direct internet access. If this is not the case you can disable the service (see the key "SupportService" above). If the service is not available, the local help is displayed, which may no longer be complete and possibly also not up to date anymore.
IPRuleSerivce
AxCMS.net offers functionality for setting up IP-address based authentication to live system's users. One should configure IP-rules for that. GUI in MS communicates with the Live System through IpRuleWebService. More details under IP-address Based Live Authentication.
UserService
AxCMS.net users can manage live users (members). As user information is placed in the Live-System, communication has to be done via a web service.
Publishing
How the Management System publishes its content to the Live System is configured using PublishAgents.
It is possible to define multiple agents in the same time
and publish simultenously to multiple Live Systems. Publishing configuration looks like this:
<Publisher>
<PublishAgent mode="off" type="InProcess" />
<PublishAgent mode="on" type="WebService">
<PublishWebService type="WebService">
<Url>http: </PublishWebService>
<ReIndexWebService type="WebService">
<Url>http: </ReIndexWebService>
</PublishAgent>
</Publisher>
|
|
Mode (on/off) lets temporary turn off one or many publish agents. Only the agents with mode=on are taken into account during publishing.
Type of a publish agent can be InProcess or WebService. InProcess is to be used, if the Live System runs on the same server like Management System.
WebService - if Live System is installed remotely and Web-Services are used to access it.
If you use InProcess-publish-agent, you don't need any additional configuration for the agent itself, but you have to define
PublishService-section in the same web.config, because the PublishService is hosted in this case in the ManagementSystem and not in the AxCMSPublishService-application.
See also Configuring Publish Service.
If you use WebService, you have to specify 2 standard Web-Service sections in your publish agent: for PublishWebService and ReIndexWebService.