SiteVision Onlinehelp

Developer jumpstart

If you are a Java developer and would like to start developing in SiteVision you will need the following software/files:
  • A  complete SiteVision installation package (exe file or rpm files). Preferrably installed on your local workstation for easy portlet deployment and access.
  • A developer license
  • A demo website (not necessary but very convenient)
If your organization is a partner to SiteVision, your organization will have a dedicated contact person for all communication with SiteVision. He/she can provide you with the three items above. SiteVision installation files and demo web sites are available on the SiteVision partner web. Developer licenses can be ordered from SiteVision if your organization does not already have obtained such.
Note! If you do not belong to a SiteVision partner, but your organization is using SiteVision, your local SiteVision representative can order the above mentioned items from SiteVision AB.

SiteVision installation


When using Windows - use the exe file to install the SiteVision server. During the installation process you are provided with the option not to install SiteVision as a service (as a developer you seldom need SiteVision to run as a service).

When using Linux - use the rpm files to install the SiteVision server.

Disable the SiteVision service


As a developer you probably want to start/stop SiteVision multiple times easily and be able to always see the server output in a terminal/console window. Therefore you typically want to disable SiteVision from running as a service and run SiteVision in console mode instead.

If you are using Windows (if you installed SiteVision as a service) and want to disable the service, you do this in the Windows Services management panel. Stop the service named 'SiteVision' and change the startup method from 'Automatic' to 'Manual'.

If you are running the SiteVision server on Linux you can remove or disable SiteVision from running as a service. The SiteVision service is named 'sitevision' and started at init level 3 and 5. For how to remove a service, see your OS documentation (for a rpm installed sitevision service it is typically '/sbin/chkconfig --del sitevision').

Install the Developer License


Place the developer license file (xxxx.license or xxxx.zip) in the data/license folder of your SiteVision server installation.

On Windows this will typically be something like:
C:\sitevision\data\license

On Linux it will typically be:
/var/opt/sitevision/data/license.

Prepare usage of a demo website


Place the demo website (xxxx.sva) in the data/archive folder of your SiteVision server installation.

On Windows this will typically be something like:
C:\sitevision\data\archive

On Linux it will typically be:
/var/opt/sitevision/data/archive.

Start the SiteVision server


SiteVision will use port 80. If you have another web server already using this port (IIS, Apache etc) you must disable it or configure SiteVision to use another port. The port configuration is found in the server.xml file of your SiteVision installation.

On Windows: Go to the bin folder (C:\sitevision\bin) and run startup.bat (or debug.bat if you want to start SiteVision in debug mode).

On Linux: Go to the /opt/sitevision/bin folder and run the following command: sudo sitevision console (Note! SiteVision server must run as root.) If you would like to start up SiteVision in debug mode you run the following command: sudo sitevision console debug

Log on to the SiteVision server


Since your SiteVision server installation is entirely clean, it will not contain any websites or LDAP directories you can use or log on to. You have to log on directly to the SiteVision server with the SiteVision system account (the only account that are not bound to any LDAP context and the only account that can access the server).

Use your browser and go to the server URL (http://localhost/editor by default) and use the system account information (system/system by default) to log on.

This will log you on and start the SiteVision client application (Java applets), required for editing.
Note! Your browser must have Javascript enabled and a Java plugin installed in order to use the SiteVision editing/offline mode. See the browser documentation for how to install a JRE plugin and enable Javascript. It is recommended that you use a plugin from the Java 6 (1.6) family or higher.

Import a demo website


Ensure the server object (named 'SiteVision Server' in the Navigator) is selected. Press The 'New Page' button (the top left button - a document with a yellow star). Select the 'Import pages' category and select your demo website in the list.
Tip! If you check the 'Restore from backup' option, all internal id:s of the website is kept. That means that you later on can do another import to overwrite what you import now. (i.e. if you do two subsequent imports and always check the checkbox, you will still only have one website.)

If you do not check the option, a completely new website will always be created. (i.e. if you do two subsequent imports and do not tick the checkbox for the second import, you will have two completely separate websites.)

When the import is finished (the import progress bar has disappeared) you must update the Navigator to see your imported website. To do this: Right-click on the server object ('SiteVision Server') and choose Refresh.

Additional Server information

Tip! If you are logged on with the system account, you can access additional information about the SiteVision server (such as occupied threads/stacktraces and logs) if you access the URL http://localhost/editor/admin

Stop SiteVision


To stop the SiteVision server on Windows or Linux: press [Ctrl] + [c] in the SiteVision server console/terminal window (if you are running Windows you can also press the top right 'Close' button of the window).
help-cluster-2.sitevision.net