Server installation instructions for Streamtime Add-ons: Client Web App, iPad app, iphone App & Streamtimer
OVERVIEW
This article is aimed at advanced users with experience managing FileMaker Server, the Apache webserver, and Mac OS X computers. We insist that the setup procedure be performed by your company’s IT department or outside IT contractor.
Support for the setup of these add-on applications is not covered under either the Pipeline or Subscription support plans. Streamtime technical support does not provide direct technical support for these processes. We can provide you with details of 3rd party IT professionals that do support this setup however please be aware that their time will be chargeable.
This article describes how to install all four Streamtime Add-on applications onto your Mac-based FileMaker Server.
This server addon pack for Streamtime contains four applications:
- Client Web Application is a web-based module for Streamtime that allows your clients to login with their browser and monitor the progress of their jobs.
- iPhone App contains the server components you need to allow users to login to Streamtime from their iPhone or iPod Touch.
- Streamtimer contains the server components you need to allow your users to use the Streamtimer widget on their desktops.
- iPad App contains the server components you need to allow users to login to Streamtime from their iPad.
REQUIREMENTS
Before you begin, please ensure you meet all the following requirements. Configuration changes will be made to your server during the setup process, and this is the necessary starting point.
Single Machine Setup, FileMaker Server and Apache
- The Streamtime FileMaker Server must also be the webserver. Whilst it is possible to split the database and web serving onto two machines, this is beyond the scope of these instructions.
Mac OS X or Mac OS X Server version 10.6 (Snow Leopard)
- Any copy of Mac OS X or Mac OS X Server of at least version 10.5 should work, but the exact setup steps may differ, and these instructions assume you are running Snow Leopard Server.
Apache 2 web server
- Depending on your OS configuration it may be possible to run Apache 1.3, but these instructions assume you have Apache 2. You can confirm this by typing ‘httpd -v’ into Terminal and looking at the version it says.
FileMaker Server 10v2, installed and running.
- FileMaker Server 9 will also work, but the v3 Updater must have been applied otherwise it won’t work. These instructions assume you are running FileMaker Server 10.
FileMaker Pro 10 installed and running.
- Installed on all client machines at your site.
Streamtime 10.0v5 [8CB] or greater, installed and running
- Your network and DNS must be set up to allow access to the server. Generally you want users outside your local network to be able to access these services over the internet. This may mean making changes to your router, firewall and DNS. These topics are beyond the scope of this document.
The latest version of the Smarty Templating Engine for PHP
-These instructions were tested with version 2.6.26. This is required for Client Web Application. You can get this from Smarty Template Engine. Download the .tar.gz version for now and we will install it later.
Lastly, you will need the addon pack containing all the PHP and web pages required to make these applications work on yoru server: – Download it here: addons.zip (file updated 16/07/2010)
INSTALLATION & SETUP
Remember, this procedure is typically carried out by your company’s IT department or an outside IT contractor with FileMaker and Web server experience. It is not recommended to install the server addons unless you have experience in Unix server configuration, and find yourself comfortable with these instructions.
You can watch a video demonstrating the setup process here:
Apple Quicktime video showing full setup of web server for client web application, iphone and Streamtimer This video is 80mb in size so be patient and allow it to fully load before it plays.
We have also posted a version of this video on Vzaar:
1. Turn on Apache Webserver
The steps for starting Apache differ depending on whether you have Mac OS X Server or just plain Mac OS X
- Snow Leopard: Turn on “Web Sharing” under the Sharing pane of System Preferences
- Snow Leopard Server: Configure and enable the Web module in Server Admin
2. Decompress the addons.zip file
Move its contents either directly into the DocumentRoot of your webserver (eg, /Library/WebServer/Documents)
Note the following pieces of information:
- The filesystem location you moved the contents to (eg, /Library/WebServer/Documents). We’ll call this your “installation directory”.
- The web URL that this maps to (eg, http://streamtime.example.com/). We’ll call this your “base URL”.
We will refer to these details later in the setup.
3. Ensure permissions are correctly set
Update permissions on the following folders and all their contents to read & write for all users:
- clients
- FX
- iPad
- iphone
- streamtimer
This can be done using Get Info.
4. Customise config files
Edit config files using one of the built-in commandline text editors (such as nano or vi) or using a Mac OS X text editor that supports opening custom paths and saving privileged files (such as TextWrangler or BBEdit).
Client Web App config files:
Inside the ‘configs’ directory of the ‘clients’ folder:
- edit the file called global.conf.
In this file set your company name details.
Set both ‘root’ and ‘http_root’ to the same value: your home URL determined above, do not include a trailing slash. eg: http_root = “http://streamtime.example.com/clients”
root = “http://streamtime.example.com/clients”
Save and close
- Edit the file called conf.php. Change “localhost” to the FileMaker Server IP address.
Define ROOT to be your installation directory, and HTTP_ROOT to be your home URL. Save and close.
Streamtimer config files:
- Open the FX folder in your installation directory, edit the file called server_data.php. Change “localhost” to the FileMaker Server IP address. Save and close.
- Inside the configs directory of the streamtimer folder, edit the file called conf.php. Again change “localhost” to the FileMaker Server IP address. Save and close.
No configuration steps are required for the iPhone App.
No configuration steps are required for the iPad App.
5. Configure FileMaker Server
You next need to ensure Web Publishing and PHP are both enabled in FileMaker Server. Launch FileMaker Server Admin Console and login to it.
In Server Overview, click the Edit Server Deployment button. Ensure Web Publishing is enabled when asked, then click Next.
Under the Technologies choices, ensure PHP is enabled and is set to use the operating system’s included version of PHP, and not the version included with FileMaker. Also ensure XML is enabled.
If this assistant has already been run in the past, and FileMaker’s copy of PHP was chosen, you should change to the OS copy of PHP (second choice) in order to continue this setup. This may have effects on other FileMaker or PHP solutions you have running on the same server, so you should check this first.
If you made any changes, such as enabling Web Publishing or PHP or changing the selected copy of PHP, continue to the end of the Deployment Assistant and finish it. Otherwise, if you merely looked at the settings but did not change them, you can cancel out of the Assistant.
Your FileMaker Server should now have Web Publishing enabled, PHP enabled, and the OS-included version of PHP selected.
6. Install Smarty Templating Engine
The Client Web App uses the Smarty Templating Engine to display Streamtime data on the web. Having downloaded the latest version above, we need to install it. You can skip this step if you are certain that your server already has Smarty installed and the OS copy of PHP can use it successfully.
To install Smarty we just copy its files into the appopriate location, which is: /usr/lib/php/Smarty
Check that the destination directory exists, and create it if it doesn’t:
- sudo mkdir -p /usr/lib/php/Smarty
Extract the contents of the Smarty.tar.gz file, and open its folder up. Inside this you will find a folder called libs. Open the libs folder, and copy its entire contents to your Smarty destination directory determined above. Do not move the libs directory itself into the destination directory; place the *files* it contains into the destination.
- tar -zxf Smarty-(version).tar.gz
- sudo mv Smarty-(version)/libs/* /usr/lib/php/Smarty/
The folder: /usr/lib/php/ can also be accessed via a Finder window by going to:
Go > Go to Folder…
in the popup window type “/usr/lib/php/” and click Go.
Update permissions on the Smarty folder and all their contents to read & write for all users.
7. Configure Apache Webserver
As mentioned above, the Client Web App makes use of a file named “.htaccess” that contains URL mappings for the app. We need Apache to look at this file, but by default it will ignore it. Therefore we must enable this.
a) By default, the AllowOverride directive in Apache’s configuration is set to None. This should be changed to AllowOverride All for it to honor the mappings in our htaccess file.
- Snow Leopard Server – In Server Admin by going to Web > Sites > (the site) > Options and ticking Allow All Overrides. Save your changes.
- Standard Snow Leopard – Edit the apache configuration file manually.
Open /etc/apache2/httpd.conf using one of the built-in commandline text editors (such as nano or vi) or using a Mac OS X text editor that supports opening custom paths and saving privileged files (such as TextWrangler or BBEdit).
Scroll down to the part of the file that configures the folder your installation directory is inside of, eg: “/Library/WebServer/Documents” (Approx line 167)
There are two instances where ‘AllowOverride’ must be changed from ‘None’ to ‘All’:
- Approx line 179 – should read – ‘AllowOverride All’
- Approx line 214 – should read – ‘AllowOverride All’
b) Next, you need to ensure the Mac OS X supplied PHP is enabled.
- Snow Leopard Server – In Server Admin by going to Web > Settings > Modules and ticking php5_module. (Approx line 115)
- Standard Snow Leopard – Edit the apache configuration file, /etc/apache2/httpd.conf. Find the line in the file that says LoadModule php5_module (Approx line 115) and make sure it doesn’t have the comment (#) character at the start of it. Save and close this file.
Lastly, to ensure all our changes so far have taken effect, restart your Apache webserver as described earlier (using System Preferences on Mac OS X, or Server Admin on Mac OS X Server)
NOTE: The following ports need to be open on your Firewall 5003, 16000, 16001 and 80.
8. Test Client Web Application and configure Streamtime users
From a nearby computer on the local network, or from the server itself, open a web browser and visit your app’s home URL.
Eg http://Server Machines IP address/clients
Login email addresses and passwords for users are configured in the Contacts > People screen of Streamtime. Any People Contact in Streamtime that has a password and email address will be able to access the Client Web Application.
9. Install and Test iPhone app
Go to Apple Apps Store on your iphone and download the Streamtime Application. Search for keyword “Streamtime”
Once downloaded and installed, go to the Settings Icon on your iPhone. Scroll to the bottom of the settings screen to find the Streamtime settings Row. This is where you enter your IP address and login details.
The IP address is your Internet connections static IP address
The login details are your regular Streamtime username and password – they will be different for each staff member that has a license to use Streamtime in your company.
You can also test the iphone app using a web browser from a machine on the local network.
Go to the web address: http://Server Machines IP address/iphone/processing/home.php?login=tim&password=demo
Replace the red text in the address line with your regular Streamtime username and password.
A full video showing how to use the iphone application can be found here.
10. Install and Test iPad app
Go to Apple Apps Store on your iPad and download the Streamtime Application. Search for keyword “Streamtime”
Once downloaded and installed, Click on the app to open it and this is where you enter your IP address and login details. If you need to change the user go to the Settings Icon on your iPad. Scroll to the bottom of the settings screen to find the Streamtime settings Row and change the user.
The IP address is your Internet connections static IP address
The login details are your regular Streamtime username and password – they will be different for each staff member that has a license to use Streamtime in your company.
A full video showing how to use the iPad application can be found here.
11. Install Widget on client machines and test Streamtimer
Please make sure your client computer meets the minimum system specifications to install Adobe Air/Streamtimer.
See the list of minimum system specifications
Download and install from here:
Once downloaded and installed, click on the LOGIN button in the top right of the Streamtimer window. This will reveal where you need to enter your login information.
In the Username and Password fields enter your own Streamtime login details.
In the URL field enter http:://FILEMAKER SERVER IP ADDRESS/streamtimer/
Eg.
The first time you log in to Streamtimer will be slow, but after the initial login Streamtimer will run at regular speeds.
Our knowledge base article Using Streamtimer will show you how to use the Streamtime Widget.
Advanced Setup and Troubleshooting
Install iPad
If you have previously installed the addons.zip you will need to add the iPad folder. You can download the current addons.zip file, take the iPad folder and add it to your Library/WebServer/Documents