DocuBin Enterprise Edition

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with "DocuBin - Enterprise Edition ==System Requirements== * You must be running FileMaker Server or Server Advanced 11 * The FileMaker Web Publishing Engine must be enabled *...")
 
(added default web directory for Mac OS X 10.7 and newer)
Line 15: Line 15:
  
 
: '''IMPORTANT''' -  If you are attempting to map a WebDAV share to a drive letter on Windows, WebDAV will not work by default unless WebDAV is used over SSL. '''360Works recommends that you configure you FileMaker Server to operate over SSL if you wish to map shares on Windows.''' However, if you choose not to configure your FileMaker Server to operate over SSL, you can follow the instructions at the following link to use WebDAV without SSL encryption: http://code.google.com/p/sabredav/wiki/Windows#Authentication
 
: '''IMPORTANT''' -  If you are attempting to map a WebDAV share to a drive letter on Windows, WebDAV will not work by default unless WebDAV is used over SSL. '''360Works recommends that you configure you FileMaker Server to operate over SSL if you wish to map shares on Windows.''' However, if you choose not to configure your FileMaker Server to operate over SSL, you can follow the instructions at the following link to use WebDAV without SSL encryption: http://code.google.com/p/sabredav/wiki/Windows#Authentication
 +
  
 
==Installation==
 
==Installation==
  
 
# Deploy DocuBin.fp7, DocuBinUtility.fp7, and DocuBinWSM.fp7 to your FileMaker Server.
 
# Deploy DocuBin.fp7, DocuBinUtility.fp7, and DocuBinWSM.fp7 to your FileMaker Server.
# Copy the '''''websvcmgr_docubin.php''''' file into your Web Server document root. This is where you would normally put PHP files for use with Web Publishing. On OS X, this defaults to ''/Library/WebServer/Documents''. On Windows, this defaults to ''C:\Inetpub\wwwroot''.
+
# Copy the '''''websvcmgr_docubin.php''''' file into your Web Server document root. This is where you would normally put PHP files for use with Web Publishing. On Mac OS X 10.6 and earlier, this defaults to ''/Library/WebServer/Documents''. For Mac OS X 10.7 and later, this defaults to "/Library/Server/Web/Data/Sites/Default". On Windows, this defaults to ''C:\Inetpub\wwwroot''.
 
# Stop the FileMaker Web Publishing engine.  
 
# Stop the FileMaker Web Publishing engine.  
 
# Run the Enterprise Edition installer for your operating system on the machine running Web Publishing.
 
# Run the Enterprise Edition installer for your operating system on the machine running Web Publishing.
 
# Restart the FileMaker Web Publishing engine.
 
# Restart the FileMaker Web Publishing engine.
 +
  
 
==Basic Setup==
 
==Basic Setup==
Line 30: Line 32:
 
# Select Enterprise Edition
 
# Select Enterprise Edition
 
# Set the 'Web Services URL' to point to the computer running the FileMaker Web Publishing Engine. For example, if your server's DNS name is ''fmserver.xyz.com'', you would enter ''http://fmserver.xyz.com''.
 
# Set the 'Web Services URL' to point to the computer running the FileMaker Web Publishing Engine. For example, if your server's DNS name is ''fmserver.xyz.com'', you would enter ''http://fmserver.xyz.com''.
 +
  
 
==Advanced Setup==
 
==Advanced Setup==
Line 52: Line 55:
  
 
If you have purchased or upgraded to an Enterprise Edition License, you should see 'Congratulations' in a white box on the Enterprise Edition layout. If not, Enterprise Edition will run for 2 hours in demo mode. Demo mode is fully functional, with no limitations. You can start a new 2 hour demo mode by clicking the 'Start Demo Mode' button.
 
If you have purchased or upgraded to an Enterprise Edition License, you should see 'Congratulations' in a white box on the Enterprise Edition layout. If not, Enterprise Edition will run for 2 hours in demo mode. Demo mode is fully functional, with no limitations. You can start a new 2 hour demo mode by clicking the 'Start Demo Mode' button.
 +
  
 
==Enterprise Edition==
 
==Enterprise Edition==
  
 
The url to access your DocuBin files through WebDAV or the Web Client is ''http://fmserver.xyz.com/DocuBin/webdav/''
 
The url to access your DocuBin files through WebDAV or the Web Client is ''http://fmserver.xyz.com/DocuBin/webdav/''
 +
  
 
===WebDav===
 
===WebDav===
Line 78: Line 83:
 
# Click Finish.
 
# Click Finish.
 
# Enter a DocuBin account name and password
 
# Enter a DocuBin account name and password
 +
  
 
===Web Client===
 
===Web Client===

Revision as of 17:24, 1 October 2012

DocuBin - Enterprise Edition

Contents

System Requirements

  • You must be running FileMaker Server or Server Advanced 11
  • The FileMaker Web Publishing Engine must be enabled
  • PHP publishing must be enabled
  • XML publishing must be enabled
  • The FileMaker PHP API must be installed
http://www.filemaker.com/support/product/docs/fms/fms11_getting_started_en.pdf
  • The Web Client will work in any modern browser.
  • WebDAV has been tested on Mac OS X 10.6 and Windows 7. It may work on earlier versions as well.
IMPORTANT - If you are attempting to map a WebDAV share to a drive letter on Windows, WebDAV will not work by default unless WebDAV is used over SSL. 360Works recommends that you configure you FileMaker Server to operate over SSL if you wish to map shares on Windows. However, if you choose not to configure your FileMaker Server to operate over SSL, you can follow the instructions at the following link to use WebDAV without SSL encryption: http://code.google.com/p/sabredav/wiki/Windows#Authentication


Installation

  1. Deploy DocuBin.fp7, DocuBinUtility.fp7, and DocuBinWSM.fp7 to your FileMaker Server.
  2. Copy the websvcmgr_docubin.php file into your Web Server document root. This is where you would normally put PHP files for use with Web Publishing. On Mac OS X 10.6 and earlier, this defaults to /Library/WebServer/Documents. For Mac OS X 10.7 and later, this defaults to "/Library/Server/Web/Data/Sites/Default". On Windows, this defaults to C:\Inetpub\wwwroot.
  3. Stop the FileMaker Web Publishing engine.
  4. Run the Enterprise Edition installer for your operating system on the machine running Web Publishing.
  5. Restart the FileMaker Web Publishing engine.


Basic Setup

  1. Login to DocuBin with an admin account
  2. Open DocuBin Settings...
  3. Select Enterprise Edition
  4. Set the 'Web Services URL' to point to the computer running the FileMaker Web Publishing Engine. For example, if your server's DNS name is fmserver.xyz.com, you would enter http://fmserver.xyz.com.


Advanced Setup

By default, DocuBin Enterprise Edition assumes that the FileMaker Server Web Publishing Engine is set to run on port 80. If you wish to use another port, follow these directions:

  1. Login to DocuBin with an admin account
  2. Open DocuBin Settings...
  3. Select Enterprise Edition
  4. Set the 'Web Services URL' to point to the computer running the FileMaker Web Publishing Engine. For example, if your server's DNS name is fmserver.xyz.com and the Web Publishing Engine is set to run on port 8080, you would enter http://fmserver.xyz.com:8080.

You will also need to make the following modification to the websvcmgr_docubin.php file:

//Before
define( 'HOST', '127.0.0.1' ); //Do not edit this without first consulting the support staff at 360Works

//After
define( 'HOST', '127.0.0.1:8080' ); //Do not edit this without first consulting the support staff at 360Works


Demo mode and registration

If you have purchased or upgraded to an Enterprise Edition License, you should see 'Congratulations' in a white box on the Enterprise Edition layout. If not, Enterprise Edition will run for 2 hours in demo mode. Demo mode is fully functional, with no limitations. You can start a new 2 hour demo mode by clicking the 'Start Demo Mode' button.


Enterprise Edition

The url to access your DocuBin files through WebDAV or the Web Client is http://fmserver.xyz.com/DocuBin/webdav/


WebDav

Mac OS X

http://docs.info.apple.com/article.html?path=Mac/10.6/en/8304.html

  1. In the Finder, choose Go > "Connect to Server,"
  2. Enter http://fmserver.xyz.com/DocuBin/webdav/ into the address field and click Connect
  3. Enter a DocuBin account name and password and click Connect


Windows:

http://windows.microsoft.com/en-US/windows7/Create-a-shortcut-to-map-a-network-drive

  1. Open Computer by clicking the Start button, and then clicking Computer.
  2. Click Map network drive.
  3. In the Drive list, click a drive letter. You can choose any available letter.
  4. In the Folder box, type http://fmserver.xyz.com/DocuBin/webdav/. To connect every time you log on to your computer, select the Reconnect at logon check box.
  5. Click Finish.
  6. Enter a DocuBin account name and password


Web Client

DocuBin Enterprise Edition supports all modern web browsers. Pick your favorite and go to http://fmserver.xyz.com/DocuBin/files/. Enter a DocuBin account name and password when prompted.


Troubleshooting

Log files

If you contact 360Works for support, we may request a copy of your log files to help with troubleshooting problems.

If you are on a Mac, switch to the Finder and select 'Go->Go To Folder...' from the menubar. Type in '/tmp' and hit the 'go' button. You should see a folder open up showing everything in your /tmp folder; the log file is called websvcmgr.log

If you are on Mac OS X, the file will be at /tmp/websvcmgr.log If you are on Windows XP, the file will be at C:\WINDOWS\TEMP\websvcmgr.log

Connection Failed

If you get a 'Connection Failed' message, check the server name or IP address you entered, and then try again. Also, make sure the demo period for Enterprise Edition has not expired.

HTTP Status 500

If you get an 'HTTP Status 500' message while trying to access the Web Client, make sure that the demo period for Enterprise Edition has not expired.

Bad Request (Invalid Hostname) Error

If end users are receiving errors, one cause might be that your server is not configured to allow internal access via localhost. If you cannot or do not want to resolve this issue via the server, you can change a line in the 'websvcmgr_docubin.php' file. The following example assumes your server's DNS name is 'http://fmserver.xyz.com'.

//Before
define( 'HOST', '127.0.0.1' ); //Do not edit this without first consulting the support staff at 360Works

//After
define( 'HOST', 'fmserver.xyz.com' ); //Do not edit this without first consulting the support staff at 360Works
Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox