Content of the VM

It comes with everything pre-installed and configured!


We pre-configured and optimized a server for you that includes ALL the components that you will need on your XStudio Server instance.

This server is based on a Linux LAMP server that can run with only 512 Mbytes of RAM.
This is an optimized headless server that can boot in 20 seconds and provide great performances.

You don't really need to be fully aware of all the components/packages included in the VM but the list is provided below for your information:

Components
Linux Distribution Debian 7.2 Wheezy
Kernel Linux 3.2.0-4-686-pae
Database server MySQL 5 
Web server Apache 2 
Web app server Tomcat 7 
Automatic backup tool Automysqlbackup
Web administration tool WebMin
Database administration toolPhpMyAdmin




Prerequisites

To install and run this VM, you'll need a virtualization software such as VirtualBox (free) or VMWare.

These virtualization softwares can be installed on any OS (Windows win32/win64, MacOSX, Linux or Solaris).




Import the VM

Once you have VirtualBox or VMware installed on your server, it's very easy to import and run our pre-installed and configured XStudio VM.




For the rest of the process, please click on the appropriate option below:

I have VirtualBox installed on the server

I have VMWare installed on the server





Check the install

Now that the install is completed, let's check your server is fully operational.


Start XStudio from any computer

  • Open the URL: http://<IP address>:8080/xqual/xstudio and click on the XStudio button

  • Authenticate to XStudio using the default credentials:
    Username:admin
    Password:password



  • A couple of warnings will popup to indicate that you're missing a license and that 2 major features that are enabled in the configuration have been automatically disabled:
    • The test case procedure Grid Editor
    • The ability to use rich-texts in the test case procedures




    It also summarizes the limitations of the community version:



  • XStudio's GUI appears on the screen.


Start XStudio.web from any computer

This must be done AFTER you've executed XStudio first at least once.
  • Open the URL: http://<IP address>:8080/xqual/xstudio.web/ and login

  • Authenticate to XStudio using the default credentials:
    Username:admin
    Password:password



  • XStudio's GUI appears on the screen.


Try the REST API

You can access programmatically the XStudio REST-API server using the following URL:
http://<IP address>:8080/xqual/api?<query>

For instance, you can browse the URL:
http://<IP address>:8080/xqual/api?command=getInfo

This should return a json string containing information about the server:
i.e. {"application_title":"XStudio","application_copyright":"(c) copyright XQual",
"application_version":"3.0sp7", "database_schema_version":"78"}


For more information on the types of queries you can post please refer to the REST API documentation.




Check the automatic database backup

In this VM, the XStudio database is backuped daily overnight (with weekly and monthly rotations).

Account used for local backupxstudio/xstudiopwd


All the backups can be found in /var/lib/automysqlbackup in the daily, weekly, monthly and latest folders.


In addition, the latest backup is copied and transfered once a week (on Sunday) to the FTP server of your choice.
To specify the IP address of the FTP server and the credentials to use, just edit the file /root/scripts/transfer_weekly_backup.sh and modify the variables HOST, USER and PASSWD.
On the FTP server you'll need to create a destination folder named with the IP address (or name) of your server. This way, you can have several XStudio instances backuped on the same remote FTP server.



Request a license

At this stage, you have XStudio Community Edition installed (with all its limitations).


If you wish to try one of the commercial editions, please send us an email requesting a trial license key for free and we'll be happy to send it back to you by email.

Your email needs to include:
  • The license type you wish to try (Professional, Business or Enterprise)
  • The URL of your web server

After you install your license key, all the limitations will be removed and all the additional features will be enabled automatically.




Managing the VM

SSH/SFTP

The VM can be accessed through SSH or SFTP

This means you can use very powerfull graphical tools such as WinSCP to drive your VM remotely.
You can also use putty or any other SSH/SFTP client if you wish.

SSH/SFTP (port 22)root/rootpwd


Remote SQL connection

You can connect remotely to the the VM's database using standard MySql clients (i.e. SQLYog Community edition that we recommend) using the following credentials:

Account used for remote connection (port 3306)xstudio/xstudiopwd


Samba Network File System

The VM also has a Samba service running (the server can be seen on the network) with an anonymous share.


File Manager

The VM has a web File Manager. It's a convenient way to manage the files on the server remotely from your browser, upload files, download files etc.
You may need to add https://<IP address>:12321 in the whitelist of you Java to be able to use it though (as it's not signed).


Webmin

A web-based control-panel is also available to manage the File-system, the MySQL server, the databases, the web services etc.
Homepage of all tools https://<IP address>root/rootpwd
- Webmin https://<IP address>:12321root/rootpwd
- PHPMyAdmin https://<IP address>:12322root/rootpzd
- Webshell https://<IP address>:12320root/rootpwd
Tomcat App. Manager http://<IP address>:8080/manager/htmltomcat/tomcatpwd