Some icons are used to alert you about additional informations.
"Important", showed by an exclamation mark, alerts you about important informations about the administration area of Ametys Runtime.
"Remark", showed by an i, alerts you about additional informations, for example it gives you others methods to reach your goal.
"Tips", showed by a tick, alerts you about tips to work with more efficiency.
This manual was written for persons who wants to perform an installation of an application based on CMS to test the Ametys v3.
If you need some help installing CMS V3, do not hesitate to ask mailing-lists users-fr@ametys.org or dev-fr@ametys.org, and to add your comments and informations to this documentation.
On the site ametys.org you can download the packaged version (http://releases.ametys.org/nightly/org.ametys.template/cmsweb/latest/zips/) to deploy to a server.
Take always a note where the software binaries are installed on your system, you will need them to configure some softwares.
The technical requirements are ;
We recommend you to use the standard configuration : a Linux distribution with the Sun Java 6 and Tomcat 6.0.
In order to avoid many Java installations and servlets engines, It is possible to use a more recent version.
Warning if you decide to do that, it is possible to have some incompatibilities: in this case, it is important to specify to the support of the application which version you are using.
The packaged version comes with an integrated database Derby, which allows to start working with the application, but is not recommended for production.
Ametys also natively supports MySQL, Oracle and PostgreSQL.
Since Ametys 3.1, You will find the sql scripts in the WEB-INF/script directory.
Unzip the archive. The directory cms is the backoffice application .
Check the Tomcat of the cms is stopped.
Move the directory cms to the application directory of the tomcat server (webapps).
Restart the tomcat server.
Launch your browser (Firefox 3.5+ ) and enter the url http://serveur:port/cms/ (http://localhost:8080/cms/).
You may get a special screen if the application is not fully configured, which tells you that the application can't be loaded and prompts to update the config.
Then click to configure the application.
In Database, specify : | |
In Management of contents, specify : |
To find the definition of the others parameters, go to page Administration.
Click to "Save and restart".
You can now access to the cms : http://serveur:port/cms.
You must be authenticated. Demo version is downloaded with these users in the database:
For a public application, it is recommended to set-up a static web server like Apache HTTPD (http://httpd.apache.org/) behind the end-user and the servlet engine. This one is used to redirect the requests to your servlets engine (with mod_jk or mod_proxy) and allows you to access to some others functionalities:
- Limit the access to the administrator area to some IPs,
- Load balancing,
- Deliver static files (pictures, javascript...) directly.
For overall performance improvements, it is also recommended to enable HTTP gzip compression on both the tomcat server and the apache HTTPD front-office.
To enable gzip compression on the tomcat server, edit the <tomcat directory>/conf/server.xml file, and add the following lines in the HTTP Connector configuration:
<Connector port=...
compression="on"
compressableMimeType="text/html,text/xml,text/plain,text/javascript,text/css,application/json"
compressionMinSize="2048"...
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript