DocuBin Enterprise Edition

From 360Works Product Documentation Wiki
Revision as of 17:47, 14 August 2014 by Michael (Talk | contribs)

Jump to: navigation, search

DocuBin - Enterprise Edition

Contents

Minimum System Requirements

  • You must be running FileMaker 12 Server, FileMaker 12 Server Advanced, or FileMaker Server 13
  • 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
https://fmhelp.filemaker.com/docs/13/en/fms13_getting_started.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.fmp12, DocuBinUtility.fmp12, and DocuBinWSM.fmp12 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. Users with FileMaker Server 13 will find it in FileMaker Server/HTTPServer/htdocs/ for FileMaker 13
  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

DocuBin Enterprise Edition assumes a default, single-machine deployment of FileMaker Server. The steps below should help with any other deployments.

Web Publishing Engine on a different port

By default, 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

Web Server on a different port or machine

If you are running a three-machine deployment, or if your web server is running on any port other that 80:

Open the file:

 FileMaker Server 11
 /FileMaker Server/Web Publishing/publishing-engine/cwpe-tomcat/conf/Catalina/localhost/DocuBin.xml
 FileMaker Server 12
 /FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/conf/Catalina/localhost/DocuBin.xml

And modify the address 'localhost' to the address/port of your Web Server. Be careful because there may be a commented line, and modifying localhost on that line won't do anything:

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/">
   <Parameter name="wsmAddress" value="http://localhost/websvcmgr_docubin.php"/>
   <Parameter name="filesRoot" value=""/>
   <Parameter name="authenticationRealm" value="DocuBin" />
</Context>

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

Action was denied by the server (IIS)

Check to see if WebDAV publishing is enabled in IIS

Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox