Installing XStudio Web Package

Installing Tomcat















Installing XStudio Web Package

On a Apache Server

In your Apache installation create a repository folder XSTUDIO in the Apache htdocs folder. Unzip the XStudio Web Package in the XSTUDIO folder. You should get a tree similar to the one below:






Set a specific port (opt.)

By default, Apache is listening on port 80. If you want to set a specific port (i.e. 8080), you must edit the conf/httpd.conf file and set “Listen 8080”.

Do not forget to set the same port in the codebase property of xstudio.jnlp and to restart Apache.



Set the Mime type

The only additional step is to set the web server's mime-type associations to map jnlp to the mime-type application/x-java-jnlp-file.


To do so, add the following line to the conf/mime.types file:


application/x-java-jnlp-file jnlp

and restart Apache.

If by any mischance, you’re deploying XStudio through your personal ISP, it may be hard to convince him to change his web server configuration. However, if your provider runs Apache (as many do) and hasn't switched off support for the .htaccess feature (which is usually true) there's an easier way: Just add these two lines to the .htaccess file at the top directory of your site (or create one, if it doesn't exit):


AddType application/x-java-jnlp-file jnlp


On a Tomcat Server

In your Tomcat installation create a repository folder XSTUDIO in the Tomcat webapps folder. Unzip the XStudio Web Package in the XSTUDIO folder. You should get a tree similar to the one below:






Set a specific port (opt.)

By default, Tomcat is listening on port 8080. If you want to set a specific port (i.e. 8888), you must edit the conf/server.xml file and set “<Connector port="8888" ...”.

Do not forget to set the same port in the codebase property of xstudio.jnlp and to restart tomcat.



Configuring XStudio Web Package

.jnlp

You must first edit the XSTUDIO/bin/xstudio.jnlp file to edit the codebase attribute of the root jnlp tag. This attribute must point to the server hosting the Tomcat installation (the local host).


The xstudio.jnlp file should look like:





<server_name> can be a hostname or an IP address.



.conf

Now, you need to configure the connection to the database(s):
2 configuration files are located in XSTUDIO/bin:
  • xstudio.conf
  • bugtracking.conf


These configuration files are using the exact same syntax as for the XStudio standalone client installation.


The passwords MUST be encrypted in the conf files, so the easiest solution is to copy your xstudio.conf from a standalone installation to XSTUDIO/bin on your web server:
  • install XStudio standalone version on a PC (i.e. windows based)
  • run XStudio - at the first run it will ask you for the settings (including username/passwords) to connect to the Database
  • check that everything works fine
  • then copy xstudio.conf to your tomcat/apache install of XStudio (in XSTUDIO/bin)
  • (opt.) you can uninstall the standalone version of XStudio.



Connecting from any browser

Open you favorite browser and type the URL: http://<server_name>:<port>/XSTUDIO/bin/

At the first use, the application as well as all the necessary libraries will be downloaded and cached. In addition, if you open the Java configuration panel, you can create a shortcut on your desktop.