Installing XStudio Standalone Client

Installation

Windows

Installing XStudio is quite straight froward. Execute the setup.exe program and follow the instructions provided:






WARNING: if you're a Vista or Windows7 user, change the default path to C:/Users/<your account>
(the reason is detailed in the FAQ).






Once XStudio installation is completed, copy the appropriate JDBC driver to the <Install_folder>binjdbc folder.


You can also install silently XStudio using /S and /D=<install path>.
For instance, if you want to install silently XStudio in C:XStudio you can just run the following command line:
setup_xstudio_vx_y_win32.exe /S /D=C:XStudio


Linux

You just need to unzip the package.



MacOSX

You need to unzip the package then:
  • cd xstudio.app; chmod -R +x *
  • open Info.plist and change $JAVAROOT/bin\xstudio.jar in $JAVAROOT/bin/xstudio.jar



Configuration

When running XStudio for the first time, and if the computer does not have a JRE 1.6+ installed (as detailed in a previous chapter), you will be prompted with an error message and an invitation to download the JRE 1.6 at http://java.com






On the first run, you will be asked to set all the configuration parameters:





This is normal.
The system does not know where is located the database and how to access it. You have now to configure these settings:





This screenshot shows what needs to be filled in in our example.


NB: you should set username/password to ‘xstudio’/‘xstudiopwd’ instead of using the regular root/rootpwd account.


All the fields value are case-sensitive:


Field Description
driver jar path This indicates where XStudio can find the JDBC driver to connect to the database. This field must indicates the relative path from <Install_folder>\bin\jdbc folder to the jar file. Leave it as is except if you’re NOT using MySQL
driver class path Classpath to instanciate the driver from the JAR file.
database server This indicates the IP address or the name of the database server.
database name The name of the database
connection template Connection template to use the JDBC driver.

WARNING: do not replace ‘database_server‘ and ‘database_name‘ fields in the connection template.
They will be automatically replaced by the system with what you specified in ‘database server‘ and ‘database name‘ fields. Leave it as is except if you’re NOT using MySQL
username Username to connect to the database
password Password corresponding to the user account
smtp host SMTP host that XStudio will use to send emails. Use the same as you’re using usually.
smtp port SMTP port that XStudio will use to send emails
smtp username Optional, if your SMTP server requires authentication.
Username to authenticate to the server.
smtp password Optional, if your SMTP server requires authentication.
Password to authenticate to the server.
smtp from address Email address that XStudio will use to send emails.
testplan autocompletion If checked, the autocompletion is enabled when writing testplan.
This feature requires a lot of resources so some users prefer to disable it.
company logo Used for customization of the test plan, reports etc.


After validating the Application Settings screen, you should get the login screen:





By default, XStudio is configured with one admin account: admin/password. Type these credentials and the XStudio Workbench should appear…





As admin, you can now change your password and/or add some new users to the system.


Congratulations, you are now ready to use XStudio !