Quick Start Guide for Mac OS X
Mac OS X This guide contains VERY IMPORTANT information on how to start and stop the Marratech Manager on Mac OS X. Please read this thoroughly.

divider

What you need

1. Please take the appropriate time to verify that your server fulfills these basic requirements.

Processor G4 or better, 1.5 GHz recommended (2 GHz for H.323)
Memory 512 MB (1 GB for H.323 use)
Operating system Mac OS v10.4 (Tiger) or higher. Server edition not required.
Disk space About 20MB (The log files may grow over time)
Network A central network location with at least a T1 connection

2. You will need administrative privileges if you wish to install the Marratech Manager.

3. You will need an appropriate license key file supplied to you by your authorized Marratech reseller. If you do not have such a file, your Marratech Manager will default into a Marratech Free server.

NOTE: The Marratech Manager (and Marratech Free) are server processes. Their installation may require basic Unix and Terminal skills. If you do not understand the following instructions, you should not attempt to install.

Notes:

  1. To start and stop the Marratech Manager, please use Mac OS X's System Starter (read below).Otherwise, the server may not start.
  2. The Traditional Apple installer does not support Remote Nodes nor does it support renaming the Central Node.
  3. All logging will occur in the /Library/Logs/MarratechManager folder

divider

Graphical Installation

  1. Download the file called MarratechManager33.dmg
  2. Mount the image by double clicking the MarratechManager33.dmg file.
  3. Double click the MarratechManager33.dmg contained within the image.
  4. Follow the instructions. You may be asked to enter an administrator's password. This is required for a Startup Item to be installed in Mac OS X's SystemStarter tool.
  5. To start the Manager for the first time, simply choose the "Start" option from the Manager's Application folder. Since it is a server process, your Administrator's password will be prompted.

  6. To stop it, choose the Stop option.
  7. Click on the MarratechManager.html to lead you to the Marratech Manager's web interface.
  8. To log in as an Administrator, click on the Administration link and type username: "admin" , password: "admin".
  9. Read the "Configuration" part found below.

divider

Console Installation (For remote installation)

The console installer for Mac OS X enables installs for:

  • Nodes
  • Multiple installations of Marratech Managers on one server
  • Remote installations via SSH
  1. Download the installer MarratechManager33.dmg and mount the image by typing the following in a Terminal window.

    hdiutil mount MarratechManager33.dmg

  2. Start the installer by typing:

    sudo installer -pkg /Volumes/MarratechManagerMpkg/MarratechManager3.5.mpkg -target /
  3. You can now choose to start up the Manager.

    sudo SystemStarter start MarratechManager3.5
  4. To stop the Manager:

    sudo SystemStarter stop MarratechManager3.5
  5. Open the html file called MarratechManager.html in your install folder to find the address of your Managerm in order to access the admin interface.

    [imacg5:/Applications/MarratechManager3.5] serge% more MarratechManager.html
    <html>
    <meta http-equiv="Refresh" content="0;URL=http://192.168.1.10:8000/">
    <head>
    <title>Marratech Manager gateway</title>
    </head>

    In this case, the address is http://192.168.1.10:8000/
  6. Access the administrative inteface of the Manager using your favorite web browser, log in with username "admin" and password "admin". Change the admin password immediately.
  7. Add your license file by clicking on Upgrade. Your authorized reseller should be able to furnish it to you. If you do not have such a file, your Marratech Manager will default into a Marratech Free server.

    This file should not be copied into the file structure. Install it via the Upgrade function in the administrative interface.

divider

Configuration
The MarratechManager.html file in the MarratechManager3.5 folder will automatically bring you to your Manager. (you may need to drag and drop it in your favourite browser)

  • 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, theMarratechManager.html file will help you find it easily.

Basic Network Settings



Session Engine

After logging in the first time (username: admin, password: admin), changing the password and upgrading your license, click on the Network settings page to start configuring your Manager. From here you may:

  1. Choose the http port you wish to use for your Manager.
  2. If you want to create a self signed certificate or use a Certificate Authority signed certificate for your Manager, you can do it here.
  3. You may modify the UDP port range in order to match the requirements of your network administrator, if necessary. Be sure to have at least 12 UDP ports per meeting room created.
  4. Turn on IP Multicast, if this is supported in your network. The Marratech clients will automatically sense if multicast is present or not when connecting.

If your Marratech Manager is located behind a NAT firewall and it must be reached from an external address, you should:

  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 (TCP) and HTTPS (TCP) ports, as well as the UDP ports must be properly configured.

Here are some of the most common modifications done to the Marratech Manager:

  1. Add a self signed or official certificate for secure web and meeting 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 by Apache or IIS etc.)
  3. Enter the external IP address used to access the Manager if it is being used behind NAT.
  4. If you have many Network Interfaces (i.e. many IP addresses) you will need to bind the Manager to the proper interface.
  5. The Manager's interface is created using Cascading Style Sheets and JSP (Java Server Pages). These are found in the installation directory. This interface can be fully customized (logos, fonts, name, etc…)
  6. The Manager can use an LDAP server, e.g. Active Directory, for managing user and group accounts. This is activated in the Users section.
  7. Add a SIP and or H.323 Dial Out gateway.

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

Administration of Users

Setting up users
Setting up a user 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.

Add New 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.

Defining E-meeting Rooms

Setting up e-meeting rooms
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 using the built-in default templates.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.

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.

divider

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
Ports for SIP and H.323 call connections** UDP 5060 to 5160 and UDP 53000 to 53099

*the default http and https port may change if they are already used by another process. Look at the Marratech Meetings shortcut to know what ports you are using.

**Select a unique span of ports for each SIP and H.323 line you create.

divider

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 Apache or QT StreamingServer? (use the hint above to check)
  • 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.

divider

Where to get more information?
The reference manual is online at www.marratech.com.

If you require assistance regarding Firewall or NAT configuration, please consult our Firewall Settings Guide.

If you have a question not answered by any of the above resources, please visit our Support Forum where we regularly post information, updates and tips.


    forum    support Copyright © 1998-2006 Marratech AB