Installing Valamis

This is a simple installation guide for users, who would like to try out the Valamis learning environment. You should have the deployable .war packages at the beginning.

1. Install Java runtime environment

First of all, you should have a JRE installed. Oracle's 1.7 version is recommended, but it should work with newer versions as well as with OpenJDK, although OpenJDK has some known issues with Liferay itself.

2. Set up a database management system and create a database for Liferay

Liferay needs to have a database, and the default one is not suitable, so you have to set up your own. PostgreSQL is recommended, but any kind of database management system should work. Once you've installed the system, set up a database and username there.

3. Download Liferay

There are two versions of Liferay that you can use with Valamis: Liferay 6 and Liferay 7. 

Current requirements:

Liferay Portal 6.2 CE GA1+

Liferay Portal 6.2 EE GA1+

Liferay DXP 7.0 SP2 or SP3

Download the needed version bundled with Tomcat from the Liferay's home page and unzip it to an appropriate folder. Install Liferay in the usual way, described here.

4. Configure Tomcat's memory usage

Before you start up your Liferay, you will need to modify Tomcat's memory settings. 
- Go to your /liferay-xx/tomcat-xx/bin folder.
- Open your (or setenv.bat if you are using Windows) with a text editor.
- Find the part Xmx1024m -XX:MaxPermSize=256m
- Modify it to Xmx2048m -XX:MaxPermSize=512m
- Save the file

5. Start up your Liferay

- Tomcat starts with /liferay-xx/tomcat-xx/bin/ (startup.bat on windows).
- You can monitor its server log in /liferay-xx/tomcat-xx/logs/catalina.out
- When your Tomcat is up, it will open a browser with the Liferay's startup page. Alternatively, you can access it under the port 8080, like http://localhost:8080
- On the Liferay's startup page, you have to finish your configurations. Don't forget to set the database type, name, username and password according to the database created in step 2.

6. Download and deploy Valamis

- Download Valamis here.
- Once your Liferay is up and running, you can deploy Valamis on top. (Liferay runs on Tomcat, Valamis runs on Liferay).
- Copy the downloaded .lpkg file into the /liferay-xx/deploy folder.
- Liferay will now deploy Valamis application.
- Note: you should have an LRS (learning record store), theme, portlets and a hook.

7. Get licensed

- Log into you portal and find the Valamis Administration portlet in the Site Administration's Content tab.
- You can see your hardware ID there, that is needed for the license. Get your trial license here.
- You can find information about licensing here.

8. Valamis is now ready to use

9. Configure the mail

- Go to Control Panel -> Server Administration -> Mail tab

- Fill the Outgoing SMTP Server and Outgoing Port fields according to your needs. 

10. Configure your own LRS (optional step)

- If you use your own LRS, you can configure it in the Valamis Administration's Tincan settings tab. Read about it here.

11. Configure the Google API (optional step)

- In order to use the Google drive and Youtube connectivity in the Lesson Studio, you have to do this.
- You can find further information here.

12. Configure PowerPoint import (optional step)

- If you're planning to import PowerPoints to your environment, please check this PowerPoint import configuration guide.

13. Configure Liferay Search portlet (optional step)

- If you want to get Valamis search results in Liferay Search portlet, you need to configure it manually, as described here