1.0 OBJECTIVE
This document outlines maintenance and installation of the client and
server application software for the ManufactPro database system.
MMC provides this document as guide to help understand the operation of
client/server relational database software. Specific procedures are the
responsibility of the end users of MMC products.
2.0 SCOPE
This document is specific to the ManufactPro relational database system,
a product of MMC, running on FileMaker Pro platform. The document cover
systems running versions of the MFP 9x using the platform FileMaker 5.0-6.0
/ FileMaker Server 5.0-5.5 and referred to throughout this document as
“FM5-6” and versions of the MFP 10x using the platform FileMaker
8.0-x.x / FileMaker Server 8.0 and referred to throughout this document
as “FM7-8”
3.0 MAINTENANCE PROCEDURE
By using the platform of FileMaker Pro to host your database solution,
many of the traditional maintenance routines of big databases can be avoided
and minimized. Re-indexing for example, in accomplished on the fly or
as needed on the FileMaker platform.
Some maintenance still needs to be done to keep your system running smoothly.
Some of these tasks can be automated using the Server Console and backup
software, some can be done manually by IT or the MFP administrator or
MMC Software, LLC. It is up to you to decide who does the maintenance
and when.
The “Wait till it crashes” option is not very professional
and can result in downtime for your operations, data loss and very expensive
emergency service bills. Almost every crash we have seen could have been
avoided by a couple of the routines below.
Basic computer OS skills are needed to perform these tasks: running applications,
starting and stopping services, copying and renaming files, writing backup
media, and restoring from backup media. If you are unable to perform or
contract out maintenance, do not use our software. Maintenance requires
a workstation with the full version of FileMaker Pro and full version
of the MMC software installed If you choose to limit user functionality
via the package definition format file or by doing network installation
in a managed MS environment, at least one machine is required on site
to be configure to our specifications. If your IT department cannot provide
this, do not use our software.
Suggested Schedule:
Daily:
Backup a closed daily copy of databases to backup media. Use the FM server
console to write backups at a specific time and to a specific location
(can be to another server on the LAN). Reason: restore data due to user/admin
errors; restore data in event of hard disk crash.
Weekly:
FM5-6-Reboot the server. Clears any memory leaks and instabilities. Do
a cold reboot, which is a shutdown, wait 2 minutes and then restart. Reason:
improves speed and performance. Unstable machines can do very weird things.
Interval can be lengthened as one gains experience with their server setup,
network traffic loads and user usage loads.
Monthly:
FM7-8-Reboot the server. Clears any memory leaks and instabilities. Do
a cold reboot, which is a shutdown, wait 2 minutes and then restart. Reason:
improves speed and performance. Unstable machines can do very weird things.
Interval can be lengthened as one gains experience with their server setup,
network traffic loads and user usage loads.
MFP internal Maintenance Scripts are set to run every 30 days, unless
changed by the administrator in the preferences. One may run MFP specific
maintenance scripts manually in each file (button on report or admin screens),
Doc Log, Parts, and Part Lots are examples. A master Maintenance button
is located in the Preference section of the MFP (9x) or on the Admin screen
(MFP 10x). Reason: performs error check and writes calculated data to
local indexed fields. Very important if the administrator is working unlocked
and not using the user interface for data entry. Corrects many synchronization
issues caused by admins who “trick” the system.
Quarterly:
FM5-6 Compress and swap large log files. Reason: improves performance
and reduces disk fragmentation.
Annually:
FM7-8. Compress and swap large log files. Reason: improves performance
and reduces disk fragmentation
Migrate data into a clean structure/schema. Reason: prevents data corruption
due to file damage
As needed:
Document any design changes to the files. This is extremely important
to prove the change control trail if you have a validated system and to
allow MMC to move your customization to a new structure during annual
maintenance or upgrade.
Apply updates or bug fixes from MMC.
Apply updates or bug fixes from FileMaker Inc.
4.0 BASICS
Use the Remote Admin plug in (FM5-6) or the FM Console (FM7-8)
FM5-6
Use the remote admin plug-in to selectively close files for maintenance
or changes.
Launch the FileMaker Pro application on the local machine. Do not open
any network files.
Select File>Open>Host .
Select the server name at the top of the list.
Click Open.
Enter the server password.
The server remote control panel will now appear and you can close or open
the desired databases using the buttons. It is nice to send a message
to other users if you are booting them off. To close the entire database,
select the folder and click Close.
Click Done.
The file(s) are now closed and can be opened on the server from your machine.
Open the server control panel again and open the file(s) on the server.
Close the server dialog and test your changes.FM7-8
Use the FM Console application to configure and manage the server. This
can be accessed on the server, from the button on the MFP admin screen,
or thru a web browser (url: IP of server:16000)
Launch the FileMaker Pro Server Console application on the local machine.
Do not open any network files. Enter the password if any.
Select the database icon .
Select the server name at the top of the list.
Click Open.
Enter the server password.
One can now open, or close files, and configure the server settings. See
the FileMaker Server documentation.
Start/Stop FileMaker Pro Server
FM5-6
Log on to the server
Select Programs>Administrative Tools>Services
Select FileMaker Server from the list
Click start/stop.
It can take a few minutes to disconnect all the users and close the files.
FM7-8
Launch the FM Console application.
Login
Navigate to the database directory
Select open/close all databases from the menu bar
Or to stop the service: Select My Computer>>>Manage>>>Services>>>Services>>>FileMakerPro
Server>>>Stop
Rename files
Find or navigate to the file using Windows Explorer. Launch Explorer by
typing Windows key + E.
Click on the file once or type the F2 key
Right click and select rename
Type the new name and type the Enter key to save
Open the ManufactPro
Use the launcher file on the desktop (OpenMFP) or the open remote command
in the application.
5.0 MAINTENANCE HOW TO’S
Note: These procedure involve make copies of your MFP system and you need
to take care to make sure there is only one copy of the system available
for user access, this includes local drives. FileMaker is a little too
smart and will open local copies (via peer to peer sharing) and networked
copies at the same time—a big mess. Prevent this by renaming all
files or compressing and deleting originals.
Compress and swap FM 5-6 & 7-8
Stop FileMaker Server
Copy the entire system to a client
Open like normal, but use full control and point to the local copy of
a_Home.fp5
Open the file to compress using a_Home.fp5
Select File>Save as>Choose compressed from the menu. Click OK.
Do this for all large log files.
Exit FileMaker
Remove the original uncompressed files from the directory, save in case
of problems.
Copy the new compressed files into the directory
Rename the new compressed files to the exact name as the original.
Open the entire system once in single user mode, and exit
Copy the entire system back to the server
Start FileMaker Server.
Review the Event Log
Optimize and Compact FM7-8
Install and launch a copy of FileMaker Advanced
Open the MFP using the super user password
Navigate to each file and select optimize and compact from the menu bar
This can be done live on hosted open databases
Exit
Restore from a backup
Stop FileMaker Server
Copy the entire system to an unshared directory and compress.
Find the most recent copy on your tape and restore to a hard drive.
Copy this to the FileMaker Server directory on the server
Start FileMaker Server
Restore from a ghost
Reinstall the ghost image
Stop the FileMaker service(s)
Copy the last known good files from tape and overwrite the files in the
FileMaker server directory.
(Note: the databases on the ghost are almost always obsolete, current
data files need to be copied)
Update a file
This is if MMC sends you an update or critical bug fix.
Stop FileMaker Server
Read the instructions with the update, this will tell you what to rename
files and where to put them
Run the update per the instructions
Copy the updated files back to the server
Start FileMaker Server.
Do a design change
Minor design changes can be accomplished live online. Document the change.
Major changes must be done off line
It is MMC’s policy to always keep an unused development copy of
a system we maintain for design changes and backup purposes. The reason
is complex, but lies in the fact that FileMaker databases contain the
data, the structure, the user interface and the reports all in one place.
The structure can be damaged or degraded in the normal production environment
use to thousands of opens and closes, server crashes and disk errors.
This is the basic software design routine we use
Write the specification
Make the change
Test the change
Document the test
Stop FileMaker Server
Copy the affected files to your offline copy
Import data
Reset counters
Run conversion routines or update scripts
Copy the updated files back to the server
Start FileMaker Server.
Test again live
Recover a file
FileMaker has a routine to recover damaged files. This must be done offline
in single user mode.
Symptoms:
Buttons and scripts behave strangely
Unexpected crashes
Counter do not work
Some records display as blank
It is the policy of MMC to move data that has been recovered into the
original unused files rather than reuse the recovered files. While this
can work for a while, repeated crashes and data loss may occur.
Stop FileMaker Server
Copy the entire system to a client
Open like normal, but use full control and point to the local copy of
a_Home.fp5
Open the file to recover using a_Home.fp5
Select File>Recover. Click OK.
Do this for all damaged files.
Exit FileMaker
Rename the current files and move out of the hosted directory.
Rename the new recovered files to the exact name as the original.
Remove the original uncompressed files from the directory, save in case
of problems.
Copy the entire system back to the server
Start FileMaker Server.
6.0 WHEN THINGS GO WRONG / TROUBLESHOOTING
1. Use the remote control administration plug-in (FM 5-6) or fm console
application (FM7-8) from any client machine to see the statistics and
if any or all of the files are closed. This feature works via a plug-in
that is installed on every machine when using the MMC client installer.
The plug-in is installed with the MMC client installer. It can also be
installed from the Server CD-ROM on to a client as well. Do not try to
install it on to the server, it will not work unless there is a copy of
FileMakerPro client on the server. To use the remote control admin, launch
FileMakerPro on the client. Select file>open>host>server name.
Double click on the server icon at the top of the list. Enter the password.
Select open file and see if any databases are not open. Attempt to open
them by clicking once on them ,then click open.
2. If the files do not open, try starting and stopping services on the
server. Select Start>Control Panels>Services>FileMaker Server>Stop.
Wait 2-5 minutes before restarting.
3. If this does not work. Shut down and restart the server. The databases
should open automatically. Shut down and wait 2 minutes and then start
up. Do not do a restart.
4. If this does not happen. Read the error messages and event logs and
try to recover the problem databases. Use the Event Viewer application.
Launch FileMakerPro on a client and select File>Recover. You must rename
the files exactly as they were originally. Go to step one and try to open
them on the server again. Move the data into your original files or design
copies as soon as possible
5. If this does not work. Try restoring from backup.
6. If this does not work. Try reinstalling the server software.
7. If this does not work. Call MMC Software, LLC.
7.0 INSTALLATION—SERVER/CLIENT/MFP
For best performance, ManufactPro should be run on its own server using
FileMakerPro Server. However, we have had success in using a server that
acts as a file server, print server, gateway, domain controller, or backup
domain controller. FileMaker Server will not run on a server with Microsoft
Exchange installed and running. The reason is Exchange will take 100%
of the CPU for long periods of time—hours and prevent users access
to the hosted databases.
We suggest the following hardware setup for a dedicated server:
Application Server (running FileMaker Server): Raid 1 drives, 1GB Ram,
Tape drive, CD-ROM drive.
Installing the Server-Step 1
Login as Admin. Turn virus protection off. Insert the CD. Click Install
or Setup.exe. Choose custom to change installation location from the default
install: C:programs\filemaker. Do not drag or copy and paste this application,
the application will not run and the Registry keys will become disconnected.
Uninstall and reinstall if you want to move the directory. Install only
one copy.
On some servers, the application may need an admin level password to do
things like write backup to the hard disk or to a share. To configure
this, find the application (FileMaker Server), right click, open the properties
sheet and enter a password or assign the app to an admin level group.
Install on hardware certified by Microsoft. FM5-6--No AMD processors.
FM7-8 AMD works fine.
FM5-6--Problems can arise with multiple network cards. Removing/disabling
all but one card solves the problem. Have only one adapter per protocol(tcp/ip)
installed. FileMaker cannot be told which adapter to use. It is possible
to install other adapters after the server is up and running and one client
is connected.
Configuring the Server Software-Step 2
Select Start>Programs>FileMaker>FileMaker Console.
For FM7-8, log in to each server you manage on the network one at a time
to configure.
Click on each wizard to setup. Set the values below or the custom values
for your network. Click “apply” then “OK”.
Set users to 10 or the number on the license
Set files to 100 (FM5-6) or 50 (FM7-8).
(FM5-6)Remote admin to yes. Password company initials.
Allow hosting single user files=yes
Ram to 40Mb 100 (FM5-6) or 400Mb (FM7-8).
Network Protocol: TCP
Service starts automatic
Create a backup schedule.
Note: If IE5.5 is installed, the wizards will not work. Install IE 6.0
or higher or use the buttons on the toolbar to get to the properties sheet.
Or right click in the window to get to the properties sheet.
Install the MFP Databases-Step 3
Copy the databases into the FileMakerPro Server Folder (FM7-8 install
in the “database” directory). The server will open all files
in this directory and one level down. Install only one copy. Do not change
the names of the files. If installing from a CD, select all files and
set the read only bit (properties: right click) to “not read only”.
Install and share the FM_Support directory.
Select Start>Control Panels>Services and start the FileMaker Server
Service and open the FM Console and select “Open from the drop down”.
Create Backup Schedule, Configure Backup and Virus Apps.-Step 4
(FM5-6)
Create an unshared directory on the server called fm_bu.
Create directories in fm_bu called daily and weekly.
Use the server console to create a daily and weekly backup. Test by right
clicking the schedule and select “Run Now”.
(FM7-8)
Accept the default backup location within the FMserver directory.
Create directories in called daily and weekly in the default directory.
Use the server console to create a daily and weekly backup. Test by right
clicking the schedule and select “Run Now”.
Configure the Backup software or agent and Virus scanners
Configure the backup software (Verities/Symantec) to copy the closed backup
copies.
Make sure your backup software skips open files. Backup only the closed,
not the open database files. If you do not do this, the databases can
be corrupted, damaged and you can loose data and cause your system to
be non-functional. Most backup software should skip open files. Test after
the first backup to make sure the files are on the tape and usable.
Configure the virus software (Symantec) to skip the FileMaker Server directory
at c:\\Programs\FileMaker\FileMaker Server x\. Pattern matching virus
scanning software is known to alter/rewrite the data and schema of the
database files. Do not let this happen.
Set Permissions for the Server Directory-Step 5
Share the FileMaker Server directory. Allow full control to sys admins
and ManufactPro/FileMaker admins. Do not give anyone else read or any
other kind of access. Apply the permissions to the directories only, not
the files. FileMaker uses its own permission scheme, not the operating
systems. You must not allow the users to navigate to the database files
and double click on them. This is the wrong way to open networked databases
and file damage and data corrupting will occur. Users must open the system
by double clicking the “launcher” file on their desktop, via
a custom url or using the Hosts button.
Installing FileMaker on a Client machine
There are three steps: install the application and install MFP software.
Step 1-FileMaker app: Turn virus protection off. Insert the FileMaker
application CD. Click Install. Enter the registration key. The application
will install, answer no to the registration dialogs. MMC usually copies
the application files and registration key to this location for easy network
installs. Command line and script installs are possible, read the directions
in the FileMaker documentation.
Step 2-MFP app: Locate the FM_Support directory on your network to find
the MMC installer or download the latest version from our website: www.mmcpro.com.
Double click MFP_Setup.exe. to run the Vise installer. You must install
the MFP software to use MMC products. This installer installs plug-ins,
fonts and an opener file.
Step 3-Open Firewall Ports. FM5-6 UDP/TCP 5003 or FM7-8 UDP/TCP 50003
Note: When upgrading, it is OK to leave older versions of FileMaker Pro
on the machine, however, the MFP setup application must be rerun. Older
versions are treated as separate applications.
Moving Servers-FileMaker Server
Moving servers is no big deal. Install and configure FM Server on the
new box. Stop services on the old box, copy the databases to the new box,
start service on the new box. All clients on the network should find the
new box. OK to change share name and IP address. In some cases, the first
user to open the system must “locate” the new box the very
first time using Open>Hosts. After this first locate, everything works
fine. Make sure you configure backups and remove the old databases from
the old box and disable the service. Running two FileMaker servers on
the same network is OK, but they must host different databases. If they
host the same dbases, there is no way to correctly point, connect to the
new vs. the old system. Do not do this. You will have some data entry
in one system and some in another. It is almost impossible to correct.
Do not host 2 identical systems at the same time.
Moving Servers-Doc Control
Open the MFP and login as usual. Click Preferences>Preferences>Document
Locations. Type to change the server name. The MFP uses a UNC path to
find the documents. The path is built from the server name in these fields
and a complex calculation to determine the file/directory names. The UNC
path is rebuilt each time the open document feature is used. You can run
the maintenance script to re-write all paths at once.
Custom Files
Some companies have custom databases that have been developed outside
the scope of the MMS/MFP system. These file are hosted on the same server
and may have a button in the MFP home/main file. They are very specialized
to the owner who designed them, so please check with them first as to
function, changes and access..
Passwords
Every file MMC develops has a master password used for design purposes.
Using this password puts one at risk of data deletion and design changes.
Please check with the MFP admin for the master password or use the “Full
Control” opener file to open the database (FM5-6) or the super user
account and password (FM7-8). The master password cannot be changed.
MMC Network Access
MMC requires a current and valid network logon to your domain. If we are
installing software, we require permissions that will let us do that.
When we install or maintaining the server software, we require the admin
password and physical access to the server. If you want use to make customizations
or do troubleshooting, we require remote access. We use PC Anywhere and
Windows Remote Desktop with or without VPN clients—we have the most
widely used ones.
Known Issues:
FileMaker Server FM5-6
1. Internet Explorer 5.5 has a bug that will prevent the server wizards
from running. Solution: Use property pane, downgrade, upgrade.
2. The MMC-Microsoft Management Console is required to configure the server.
Solutions: Install the MMC so snap-ins can be used.
3. The server app runs as a service, if it does not have the proper permissions,
it cannot run. Solutions: Give it system or admin permissions. Test by
manually running backups and examine the event log.
4. Multiple network cards—NIC cards. FileMaker Server expects one
network connection. Solutions: disable the extra cards during install
and active after FM Server is running.
5. Install on hardware certified by Microsoft. No AMD processors for the
server. Solutions: use another box.
6. MS Exchange on the same server can cause long (hours) delays in access
to the MFP system. Reason: Exchange will not share the processor. Solution:
run Exchange on an dedicated server.
FileMaker Server FM7-8
None at this time.
FileMaker Client
1. The memory cache on the client can drastically affect performance.
Set to 9999k FM5-6 or 20MB FM7-8 or use the MMC installer.
2. Window XP Service Pack 2 and the Personal Firewall blocks the UDP and
TCP port FileMaker uses to find Server. Solution: Open port 5003 for UDP
and TCP.
8.0 RESOURCES
FileMaker documentation (in FM_Support directory and on CD-ROM)
MMC documentation (in FM_Support directory and on CD-ROM)
FileMaker website http://www.filemaker.com
MMC website http://www.mmcpro.com