
HIVE 3.0 FROM beezwax datatools (www.beezwax.net)

FOR FILEMAKER 7 & 8

Nov 2005

1. FIRST STEPS...
2. ABOUT THE PLUG-IN
3. INSTALLING THE PLUG-IN
4. OPENING THE HIVE DEMO
5. CHECKING NETWORK SETTINGS



1 FIRST STEPS
----------------------

If you are reading this document, you have already un-compressed The Hive demo file you downloaded from our website. The folder should contain a number of FileMaker files, this ReadMe, and a folder named "Plug-in". You can store The Hive folder anywhere on your hard-drive. If for any reason you need to re-download, go to: http://www.beezwax.net/hive/

If you do not own FileMaker Pro 7 or 8, we encourage you to download a 30-day trial at this website: www.filemaker.com

The latest version of FileMaker Pro 7 or 8 is required. For FileMaker Pro 7, upgrade to 7.0v3. For FileMaker Pro 8, the latest patch is recommended. 

This demo will not work with previous versions of FileMaker (like 6 or 5.5...), although we have a version (Hive 2.0) that will work on those version of FileMaker. It is available on our website.

We recommend that you do not keep multiple copies (demo or previous versions, for example) of the Hive files on your hard drive. To backup and archive old versions you can compress the entire folder into an archive (ZIP or Stuffit file) and save the archive with the backup date. Then trash the old files (this prevents FileMaker from loading the wrong file set). 

2. ABOUT THE PLUG-IN
-----------------

The Events plug-in is used throughout the Hive to enhance functionality and improve the user experience. Much of the Hive will work without it, but certain critical areas will not. See below for installation instructions.

3. INSTALLING THE EVENT PLUG-IN
----------------------
For both Windows and Mac OS X, the WAV Event plug-in must be installed on each workstation to work properly. This is true for single-user, FM local networking, and Server-Client environments. The plug-in will not work with FileMaker Server if installed on the server directly (instead, install it on each workstation using the instructions below). The plug-in has a known issue of failing to recognize its own registration code if your launch the Hive and have had your copy of FileMaker open for longer then 60 minutes. If you do, you may see a warning message that the plug-in is not properly installed when in fact it is. 

* FOR MAC USERS
First quit FileMaker if it is open. 

To install the plug-in, simply move the file WavEvEvent.fmplugin from inside “Mac OS X” inside the "Plug-in" folder into the Extensions folder of the FileMaker application folder. For example, move this file into:

/Applications/FileMaker Pro 7/Extensions/

or

/Applications/FileMaker Developer 7/Extensions/



* FOR WINDOWS USERS
First quit FileMaker if it is open. 

Windows users must install the .NET Framework, available FREE from Microsoft, to utilize the Windows version of the Events 4.0 plug-in. If the .NET Framework is not installed, the plug-in will fail to appear in FileMaker's list of available plug-ins.  

To resolve this issue, download the Microsoft .NET Framework Redistributable 1.0 from Microsoft's website at: 

http://www.microsoft.com/downloads/details.aspx?FamilyID=d7158dee-a83f-4e21-b05a-009d06457787&DisplayLang=en  

You can also run Windows Update to do the download and install the Microsoft .NET Framework 

To install the Plug-in, be sure to use the file named WaEvEvent.fmx inside the “Windows” folder in the “Plug-In” folder of the Hive. Find your Program Files by opening your local hard disk. Look for the FileMaker folder, open it, and then open the Extensions folder. Drag the WaEvEvent.fmx inside the Extensions folder (you may see other plug-ins or language folders already in this folder). 


VERIFYING THE PLUG-IN IS INSTALLED (MAC/WIN): If you are experiencing difficulty with the Hive seeing the plug-in or are experiencing an error message, close the Hive and make sure FileMaker is recognizing the plug-in. This is done by opening FileMaker without opening the Hive (you do not need to open a file). Choose “Preferences...” (Windows: this is under the Edit menu; Mac OS X: this is under the “FileMaker Pro”, etc menu, also known as the Application menu). Click the fourth tab marked Plug-Ins. If you see “Waves In Motion - Events” in the list of available plug-ins, then you have the plug-in correctly installed. If not, check to make sure you have put the plug-in file into the correct location and installed in the Extensions folder for the version of the FileMaker you have open.  Remember to quit and relaunch each time you move plug-ins in or out of the Extensions folder.



4. OPENING THE HIVE DEMO
----------------------

Double-Click on the file called: "Hive_Organizer.fp7". This will open FileMaker and the required files, and take you to the introduction screen.

5. CHECKING NETWORK SETTINGS
----------------------

SINGLE- AND MULTI-USER SETTINGS:
By default, the Hive Organizer is set with Network access to file disabled. This means the database can only be used locally, on one machine. To run Hive on FileMaker Server 7, this options must be changed. In Mac OS X, this setting can be changed by going to the "FileMaker Pro" or "FileMaker Developer" menu, choose "Preferences...", then "FileMaker Network..." (In Windows, choose the "Edit" menu, then "Sharing", then "FileMaker Network..."). In "Network access to file", change settings from "No users" for all 16 Hive files. All files must be open, and you must be logged in with a Privilege Set that has Full Access.

FILE PERMISSIONS AND OWNERSHIP
Errors may be generated if the .fp7 files do not have correct read/write access. Typically error messages include not being able to modify the database. It may be necessary to modify ownership if the files were not downloaded directly to the host computer. To change ownership: Locate the files on the desktop (it must exist locally on the same machine). Select all files, right-click and choose "Get Info" ("Properties" on Windows). Depending on your OS and its version, the settings can be under in "Ownership & Permissions" (OS X 10.3) or "Attributes" (Windows 2000 Pro). It is important to note that frequently when transfering files from a cd to a PC the filemaker files will "lock" themselves by default.

For FileMaker Server 7 on Mac OS X Server and Windows, the account that is the login for normal operation of the server must have sufficient privaleges in order to host the files. In FileMaker Server for Mac OS X, this is done by setting the files to be Grouped with “fmsadmin” and setting the group to have Read/Write permissions. Please see the FileMaker Server read me for more information about this issue.



ADDRESS BOOK PUSH

Address Book Push is an optional upgrade which provides connectivity to OS X Address Book. To purchase, contact beezwax or see http://www.beezwax.net.

Address Book connectivity is limited to a one-direction pushing of all or selected records in HiveContacts into Address Book. The records created will be remembered by Hive Contacts (using Address Book’s hidden unique identifier). The next time the push is run, the records in Address Book will be deleted and recreated. Therefore, you cannot add information to those records in Address Book. You will not be able to run the push subsequent to creating groups with those records or else you group affiliations will be lost. Records you create Address Book will be ignored by HiveContacts, and will not be imported automatically (”one-direction”). 



