This guide is a condensed version of the manual and is recommended for first time users. We recommend first reading through this page, then browse through the rest of the manual.

Linux installation is done now via RPM.

1. Before installing, please check if you have a previously installed Marratech Manager RPM package by opening a terminal and typing:
   
   rpm -qa | grep "Marratech"
   
   If you find a previous Marratech Manager, export what you need from your server, do a backup and then type the following to remove it:
   
   rpm -e MarratechManager35.i586.rpm
   
2. Copy the new Marratech Manager RPM file to your server.
   
3. As root, run "rpm -i MarratechManager35.i586.rpm" in a terminal. (Some graphical user environments (Gnome, KDE etc) allow you to double-click the file which will use a graphical RPM installer.)
   
4. Install the Autostart feature by typing
   
   [root@178640 marratech]# sh /usr/local/marratech/MarratechManager3.5/bin/InstallAutostart.sh
   
5. To start the Marratech Manager, find the start script in the /etc/init.d directory. it is named the same as your instalaltion directory. Here is an example:
   
   [root@178640 marratech]# sh /etc/init.d/MarratechManager3.5 start
   
6. A html file called MarratechManager.html will be created in the installation directory to help you find on what address and port your server is running. Please open it.
   
7. Log in with username "admin" and password "admin". Change the admin password immediately.
   
8. Add your license file by clicking on Upgrade. Your authorized reseller will furnish it to you. If you do not have such a file, your Marratech Manager will default into a Marratech Free server.
   
   Note: This file should not be copied into the file structure. Install it via the Upgrade function in the administrative interface.

Advanced installtion: running multiple Marratech Managers on Linux

1. Complete steps 1,2,3 in the previous section.
2. Move the newly installed software in a new installation directory manually.
   
   cd /usr/local/marratech/
   cp -rp MarratechManager3.5 MarratechManager3.5_port8000
   cd MarratechManager3.5_port8000
   
3. Do a listing to see all the files in this new directory:
   
   ls -Flag
   [root@178640 bin]# ls -Flag
   total 24
   drwxr-xr-x 2 root 4096 Oct 26 10:41 ./
   drwxr-xr-x 9 root 4096 Oct 26 10:41 ../
   -rwxr--r-- 1 root 1328 Oct 20 07:40 InstallAutostart.sh*
   -rwxr-xr-x 1 root 938 Oct 20 07:37 MarratechManager*
   -rw-r--r-- 1 root 1342 Oct 20 07:37 .marratech.rc
   -rwxr--r-- 1 root 807 Oct 20 07:40 UninstallAutostart.sh*
   
4. You will need to edit these four files in your favorite editor and change all occurences of MarratechManager3.5 for your new installation directory name. Here is an example:
   
   vi InstallAutostart.sh MarratechManager UninstallAutostart.sh .marratech.rc*
   
   :%s/MarratechManager3.5/MarratechManager3.5_port8000/g
   
5. Run the auto start install script.
   
   sh InstallAutostart.sh
   
6. To start your new Manager, find the start script in the /etc/init.d directory. it is named the same as your new instalaltion directory (in our example,MarratechManager3.5_port8000 )
   
   [root@178640 marratech]# sh /etc/init.d/MarratechManager3.5_port8000 start
   
7. Repeat the steps 2 through 6 for every new Manager you wish to install, taking care of assigning a new installation directory name for each of them.

• If port 8000 was available at start up time, your Manager address will be http://your.server.address:8000
• If not, the Manager will choose an available port automatically. In this case, the MarratechManager.html file will help you find it easily.

1. Under the Details section of the Network settings panel, fill in the Extra Address #1 field in the Session Engine section with the external IP address your server is accessed from.
2. In your NAT, you will need to setup the proper port forwarding for external connections to reach the internal address. HTTP and HTTPS ports, as well as the UDP ports must be properly configured.

1. Add a self signed or official certificate for secure web access.
2. Change the http port to port 80 for reaching the Manager without the need for a :8000 in the URL (be sure this port is not used for instance by Apache).
3. Give the Manager its external IP address if being used behind NAT.
4. Under Network settings and details, specify which network interface you wish to use if you have multiple.
5. The Manager's interface is created using JSP (Java Server Pages). These are found in the Marratech Manager html folder. This interface can be fully customized (logos, fonts, name, etc…) Please consult the manual.
6. The Manager can now use an LDAP server, e.g. Active Directory, for managing user accounts. This is activated in the Users section.

Once your Manager is running and you completed the previous steps, you will want to setup user groups, users and e-meeting rooms.

Setting up users Setting up a group is done from the administration pages, under the Users section. Users can be assigned a name, password, location, etc… as well as the group they belong in. Any user can be given administrator access by placing it in the Manager-admin group.

Setting up user groups Room membership can be controlled by which group a user belongs too. Setting up a group is done from the administration pages, under the Users section.

Setting up an e-meeting room Setting up a room is done from the administration pages, under the E-meetings section. Setting up a room involves a few simple steps. We recommend downloading and importing the default templates found in the support section of http://www.marratech.com/ . These will help you easily define rooms for basic DSL usage, premium (faster) DSL usage and broadband usage.

You can also define the maximum amount of seats a room may take as well as which users will have access to it. (see below for more info about groups)

An e-meeting room may also be defined as open or private. A private room requires the user to log in while an open room requires no username / password to participate.

Ports
If placed behind a firewall, port configuration in your firewall may be needed for access by external IP addresses.

The Marratech Manager uses the following ports by default:

Item	Default value
http for viewing web pages*	TCP 8000
https for viewing secure web pages*	TCP 8001
Ports for meeting traffic	UDP 52000 - 52999

*the default http and https port may change if they are already used by another process. Look at the MarratechManager.html file to know what port you are using.

Easy troubleshooting

• Double check to see if the Unix daemon is started properly. In a terminal type "sudo lsof -i :8000" (or the port you are using instead of 8000). This will answer if something is using your http port. If it does not answer anything, the Manager is probably not started.
  
• If you changed http and or https ports, are there any conflicts with for instance Apache?
  
• When your Manager is being used, you can get an approximate bandwidth value in the Status page. Please ensure that it does not go over your network limit.
  
• Never move a license.kit file manually. Always use the web interface to upgrade or add a license file.
  
• The templates provided are made for creating "seat" based rooms. If you have an auditorium license and you create an auditorium with the provided seat based template, you will get a "Room is full" error message. Simply edit the room and modify it to be an auditorium.
• If someone has a lot of packet loss and very long delays, ask that user to set their bandwidth limit in their Marratech client options to the one matching their setup.
  
  This is not a Manager issue and may be because the user's DSL / Cable modem is buffering data when the uplink capacity is overloaded.