INSTALL XL TESTVIEW

-------------------
Server requirements
-------------------

The XL TestView server requires:

* Microsoft Windows or Unix-family operating system
* Java Runtime Environment (JRE) 1.8 (Oracle or IBM)
* At least 1 GB of RAM available for XL TestView
* At least 1 GB of hard disk space available for XL TestView and the database (the exact amount of space required depends on your usage of XL TestView)

-------------------
Client requirements
-------------------

The XL TestView user interface requires one of the following browsers:

* Internet Explorer 10.0 or later
* Firefox
* Chrome
* Safari

----------------------
Installation procedure
----------------------

To install XL TestView:

1. Download the XL TestView ZIP file from https://dist.xebialabs.com.
2. Extract the ZIP file to the directory where you want to install XL TestView; for example, /opt/xebialabs/xl-testview or C:\Program Files\XL TestView. This is referred to as <XLTESTVIEW_HOME>.
3. Open a command prompt and navigate to <XLTESTVIEW_HOME>/bin.
4. If you already have a license file, copy it to <XLTESTVIEW_HOME>/conf/xl-testview-license.lic. If you do not have a license file XL TestView will ask you to enter one.
5. To install XL TestView as a service:
   * On Windows:
     * Run <XLTESTVIEW_HOME>/bin/install-service.cmd
     * For production use reconfigure the service to run as a dedicated user with minimal rights.
   * On Unix (only upstart and systemd init systems are supported):
     * Run <XLTESTVIEW_HOME>/bin/install-service.sh
     * The script will create a service user and tighten the permissions on the XL TestView directory tree.
6. Start the service and navigate to http://<server-ip>:6516/

Alternatively you can run run XL TestView as a normal application by executing:
* On Unix: <XLTESTVIEW_HOME>/bin/server.sh
* On Windows: <XLTESTVIEW_HOME>/bin/server.cmd

Note: When starting the server from the same directory as a service ensure you run the script as the correct user. XL TestView will not function properly if it cannot access files.

If you do not have a license you can obtain a trial license at http://xebialabs.com, or download your full license from https://dist.xebialabs.com/ using your customer credentials.

Note: Because XL TestView can perform file system operations such as scanning the file system, it is strongly advised that you execute XL TestView as a specialized user with limited permissions and minimal access rights.

The default username is admin and default password is admin. You can change this in <XLTESTVIEW_HOME>/conf/users.conf.

-------------
Release notes
-------------

For release notes and upgrade information, refer to releasemanual.html.

-------------
Documentation
-------------

For more information about XL TestView, visit https://docs.xebialabs.com.
