This is the beginner's guide to installing your Tornado server. It's as easy as 1-2-3...
Since version 3, Puakma Enterprise Server now ships with an embedded database server and a very simple install program. You should be able to complete the install in under two minutes.
1. Verify that Java 1.4+ is installed
Go to the Sun website and download the latest JDK (Java Development Kit). The JDK is for developers and includes the JRE (You can install just the JRE, but the full SDK is recommended). Please follow Sun's install instructions. When the install has completed, type java -version at the command prompt. You should see something like the following:
C:>java -version
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)
2. Get the installer
From this website download the Puakma Enterprise Server install package (PuakmaInstall.jar). This is a single jar file of approximately 5MB. Click the Download link on the left to download it now.
3. Run the installer
On most GUI platforms you should be able to just double-click on the PuakmaInstall.jar file and the install process should start. If this does not happen, it is most likely that .jar files have not been associated correctly in your operating systems configuration. You can manually start the installer by typing: java -jar PuakmaInstall.jar from a command prompt.
4. Start the server
The server can be started by executing pmastart.sh (for *nixes) or pmastart.bat (Windows). On Windows platforms there will be a shortcut in your "Program Files" menu to start the server. Start the server and observe the console for any messages. First time startup should be a little slower than normal as Puakma will create its system tables, system applications and SysAdmin user account.
5. Connect
Start your web browser and type in http://localhost/ You should see a list of application available on the server. Next click on http://localhost/system/admin.pma (for server administration). Log in using the SysAdmin account and the password you supplied during installation. If you cannot remember the password, take a look in the puakma.config file (look for the line SysAdminPWSetup=).
If you wish to set up the server with an alternate database server, such as mySQL or PostgreSQL, this will be covered in another technote.
