| 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 may select to have the installer generate a configuration script that allows you to do later command line installs. This option may be useful if you are a system administrator. You create the script on the last panel of the installer wizard, as you can see in the image below.
Follow these simple steps to install the MetaTeam server:
- Launch the installer with
java -jar MetaTeamInstall.jar. (On Mac OS X you can double click MetaTeamInstall.jar). - Optionally, on the last panel of the installer click the button to create an automated install script and save it as
auto.xml - When the install completes type
chmod +x [install]/eVisioner/MetaTeam/tomcat/bin/startup.sh, where [install] is the directory you installed MetaTeam. This makes the server's startup script executable. - Start the MetaTeam server by typing
[install]/eVisioner/MetaTeam/tomcat/bin/startup.sh - Open a Web browser and go to
http://localhost:8080/metateam - Login with username
admin, passwordadminjust as you would after any install of MetaTeam
Following these steps you will notice that you type the MetaTeam URL into your browser, rather than just clicking an icon on the desktop. 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:
