Installing on Windows

Before starting liquid-os make sure you have Java installed. Preferably JDK 8 from Oracle (http://www.oracle.com/technetwork/java/javase/downloads/index.html). The reason for the JDK is you need it for keystore generation. If you configure your own keystore, you can do without. Also set a JAVA_HOME environment variable, liquid-os will not run otherwise.

Before installing liquid-os as a Windows service, you must first run setup.bat. The setup.bat will ask for a keystore password. This keystore password will be used to secure the keystore that the setup process will generate. There are no restrictions on the length or format of the password, but a lengthy one is always a good idea. You will need to remember the password, because you need to add it to the properties in a later faze. So store it somewhere! If you forget, you can always generate it again, but it’s a hassle so just remember. The setup process will have generated several files in the config folder. You can just leave them there the configuration is fine as is. The only thing you need to do now is change the keystore password in the application.properties file. The file is located in the config directory and the property you are looking for is at the bottom. It is called ‘liquid.keystore.password’. Once this is done, you can test the installation.

Testing the installation is relatively easy. You can just start the run.bat command file and liquid-os should start. I would advise starting it from command line, that way you can see any errors that occur on startup without the command window closing. If liquid-os is running correctly, a log file should be created in the logs directory. You can monitor the startup sequence from there. Once you see the following line, liquid-os is started:

INFO com.pte.liquid.Liquid - Started Liquid in xx.xxx seconds

You can shut down liquid-os now you know it works. Use the CTRL + C command in the command box and it should shut down. If it doesn’t shut down fast enough, just hit CTRL+C several times in a row, it always gives me the feeling things go faster that way :P. You can now proceed to install the Windows service.

If you still have the command line open, you can run the service installation script right away. You can use installServiceAmd64.bat script for 64 bit systems and installServicex86.bat for 32 bit systems. The few people who need the itanium version can use the installServiceIa64.bat script (if they actually still exist). The Windows service will be automatically created and be set to auto start. It is called LiquidService. If you want to change it, just edit the creation script, it’s pretty straight foreward.