|
STEP 1 : Install and start MyConnection Server
Download the myconnectionsvr.tar file,
then untar the myconnectionsvr.tar file in a fresh directory.
(If you are familiar with 'rpm' you could download myconnectionsvr.rpm instead.
If you have chosen the rpm file, you can install with 'rpm -i <file>')
With either the tar file or the rpm file, the configure script should be run.
Run the mcs_configure.sh script on Linux with:-
sh mcs_configure.sh
and on Solaris or FreeBSD
ksh mcs_configure.sh
The script will ask what directory you want to install MyConnection Server
into. The script will then look for and test each installed Java JVM. The first
JVM that passes the test will be used. If one is not found in the /usr and /opt
directory structure, you will be advised on how to obtain one.
The script will then test if there is only one ip-address the availability of
port 80. If it is free that ipaddress port combination is used. If there is more
than one ipaddress the script will present a list. Port 80 of the chosen address
is tested, and if free it is used otherwise the user is asked to provide a port
number to use, which is then again tested for availability. If that port is found
to be used, the loop of question of ip-address and port is asked again until
the ipaddress port is free.
For those hosts that have 'chkconfig' the script will ask if you want to install
MyConnection Server as a system service, so that it is started at machine boot.
Finally the script will start MyConnection Server from the chosen install directory,
and after a short delay of post installation configuration, the running process
will tell you that you can browse to the chosen ipaddress:port.
STEP 2. Start the MyConnection Server Engine
The starting and stopping of the MyConnection Server engine
is with the 'start_mcs.sh' script created in step 1.
The syntax for starting is
sh <install directory>/start_mcs.sh
or if you are in that directory
start_mcs.sh
and for stopping
sh <install directory>/stop_mcs.sh
or if you are in that directory
stop_mcs.sh
When the server starts you will see some confirmation messages including the
IP address and port number allocated. You can now use a browser to request the
main control panel by using the URL http://<ip address:port>.
STEP 3. Configure IPChains
Some Linux distributions, for example Fedora Core 9, include by default firewall rules to block all incoming traffic.
These rules will need to be cleared for MyConnection Server to function.
The exact commands required to configure the firewall varies depending on which firewall is installed.
If you need assistance on a particular product please contact us we'd be pleased to help. Common firewalls are iptables and IPFiliter.
Running/Running
for the First Time 
The GUI that this section describes is only for Windows users.
Fig 1.0: MyConnection Server main window
The image above is the main GUI when you first install MyConnection server. The numbers shown on the image above are explained below:
1. In the server user interface panel MyConnection Server reports a number of important operational statistics. If this is a new install the product will not show any meaningful statistics other than the server is running successfully. Statistics reported are:
Uptime, this metric shows how long the server has been running since the application started.
Speed tests since boot, this metric shows the number of tests done since the application started
Number of pages since boot, this metric shows the number of web pages served since the application started.
Trial, if you are running a trial then MyConnection Server will show you how many days of the trial period you have left. 2. This section is used to enter a license key if you have purchased the product. Clicking the 'enter key' link will display the ‘enter key’ dialog box. Simply copy and paste the license key from the Visualware confirmation email into this dialog box and click 'ok'. If the license key validates correctly then your product will show as registered and the panel color will change to blue. If the license key fails make a note of the exact error message and contact support.
3. This section show the MyConnection Server toolbar. The toolbar provides the ability to 'start' or 'stop' the server, set preferences using server options, visit the Visualware home page and validate the MyConnection Server versions using the 'about' dialog.
4. This section of the application server panel provides list of links that may help when using MyConnection Server for the first time.
Server Options
To open the server options dialog click the 'Server Options' link as shown in fig1.0 above. This will launch a dialog box, see example below.
Fig 2.0: Server Preferences
There are two sections to this dialog box.
The first (top part) is used to assign an IP address and port number for the MyConnection Server to use for its browser interface. The drop down menu provides a list of all the IP's found on the install platform. Select the IP to be assigned and enter a port number default 80.
The check box just below, if checked, allows MyConnection Server to allocate a different port number if the one chosen is not available.
The second section (bottom part) provides a convenient method for automatically installing MyConnection Server as a Windows service. Note clicking the service 'Install ' button will initially install MyConnection Server as a service but not start the service because MyConnection Server is currently already running. MyConnection Server will start as a service on the next reboot.
If you would like to start MyConnection Server service you will need to close the existing running application and do the following
1. Right click on the My Computer desktop icon
2. Choose 'Manage'
3. In the left hand tree diagram expand the 'Services and Applications' section and choose 'Services'.
4. Scroll down the 'Visualware's MyConnection Server' in the right hand pane
5. Right click on it and choose 'Start'
6. The MyConnection Server main panel display unless you are running under Windows Terminal Services. To see the main application server panel under Windows Terminal Services (WTS) you must start using the ‘-console' switch from the DOS command line. Example: 'mstsc –console' MyConnection Web Server
When a remote browser is used to access the MyConnection Server application the 'main menu' will be served. See example below.
Fig 3.0: Main Web Server GUI
There are three main sections to MyConnection Server 'main menu' page; Testing , Reporting and Administration .
The testing section lists the licensed MyConnection Server protocol tests that are available for user online testing.
The reporting section provides a list of report shortcuts for the different test reports, Also listed are any user custom reports and alerts.
The administration section provides access to MyConnection Server administrative functions such as creating or modifying remote agents.
For more detailed information on using the MyConnection Server protocol test options please select from the list below. Testing
There are currently 5 default protocol tests that can be performed using MyConnection Server:
| MyCapacity |
Measures the maximum download and upload speed of your connection. |
| MyIPTV |
Measures the packet loss and jitter for your connection to determine the potential quality of watching broadcast TV over IP. |
| MyRoute |
Performs a route test from either your server or a remote user’s computer to validate the connection quality such as packet loss, latency, round trip, ISP peering points etc. |
| MyVideo |
Measures video and audio jitter for your connection to determine the potential quality of watching streaming video through an internet connection |
| MySpeed |
Measures the upload and download speed, quality of data, TCP efficiency etc. |
| MyVoIP |
Measures the VoIP packet loss and jitter over an IP connection to determine the quality of using VoIP digital phone technology |
| Custom Tests |
User defined test that combines one or more of the test types listed above |
Installing Linux Satellite Server
Satellite Servers can be run on Linux platforms but the install process is a little more involved. Follow the steps listed below:
1. Download the satellite.tar file from the server
2. Extract the .tar into an install directory of choice:
tar -xf satellite.tar
3. From the install directory run the configuration script:
sh sat_configure.sh
4. Download the satellite.ini file from the server and place it in the directory chosen in (3)
5, Finally start the satellite server on the Linux platform by running the sat.sh script:
sh sat.sh start
|
Introduction
