| Please note: |
If you are installing on Linux, we assume you are more technically savvy than average. You will need to verify that you have Java installed, and install it if you do not. |
How do I install MetaTeam on Linux or Mac OS X?
A pure Java installer for MetaTeam is available. The Java installer works on any computer that has a copy of the Java Development Kit (JDK), version 5 or greater.
Mac OS X comes with a JDK preconfigured. Please be aware that MetaTeam is tested primarily on Windows and Linux and only secondarily on Mac OS. Mac OS X is a consumer variant of UNIX and so is very similar to a Linux machine, for the purposes of running MetaTeam.
Linux users may or may not have the JDK preinstalled. If you do not have a JDK, or are not sure, try this tutorial page. If you need a copy of java, please download it from http://java.sun.com/.
The MetaTeam Java installer is available at http://www.evisioner.com/MetaTeamInstall.jar.
The MetaTeam Java installer is GUI based, just like the Windows installer. However, unlike the Windows installer, you can select to create a configuration script for later command line installs when you run the Java installer. In the steps below we're taking that option.
- Launch the installer with
java -jar MetaTeamInstall.jar - On the last panel of the installer click the option to create an automated install script -- save it to auto.xml
- When the install completes chmod +x <install>/eVisioner/MetaTeam/tomcat/bin/startup.sh
- Execute <install>/eVisioner/MetaTeam/tomcat/bin/startup.sh
- Open a Web browser and go to http://localhost:8080/metateam
- Login with username "admin", password "admin" (without the quotes) just as you would after any install of MetaTeam
From these steps you may have noticed that you type the MetaTeam URL into your browser, rather than clicking an icon. The Java installer does not actually create the same icons that the Windows installer does. When you run the Windows installer two icons appear on your desktop, one to start MetaTeam and the other to open a browser and login. Since the Java installer does not create the icons it is important for you to remember:
- Start MetaTeam by running <install>/eVisioner/MetaTeam/tomcat/bin/startup.sh
- Log in to MetaTeam by opening http://localhost:8080/metateam
Using a script or the command line to install
You can run the Java installer at the command line—i.e. without using the GUI wizard. This option is useful if you need to do automatic installs. Please review the steps above to learn how to have the installer generate an install script.
Most people don't need to script their MetaTeam installs, but, as one example, we use the command line install capability to refresh the online MetaTeam demo every hour.
When you want to run the installer from the command line you need to do two things:
- Edit auto.xml to point to the install directory for the machine you are going to install on
- Run the installer by typing
java -jar MetaTeamInstall.jar auto.xml
The auto.xml (remember, that's just the name I'm using here, you can call it whatever you like) file contains one key line you may need to edit. The line is:
<installpath>/home/djk/MetaTeam</installpath>
Of course your file will have a different path than this example. Edit the line to point to the location you need for a given install. If you did your initial install on Windows the <installpath> may point to the Program Files directory on your C drive. That is fine, just change the path to suit your Linux machine and you are ready to go.
When you run the Java installer to do a command line install on Linux you will see something like this:
