Installation Instructions for iFMLA

These instructions explain how to install the software on your database server and client workstations. If you have any questions then call (317) 225-4415 or e-mail tsupport@iHRsoftware.com.

1. System Requirements

Table 1 lists the system requirements for the server and client components. You may install all of the server components on one computer, or you may install them separately. The client uses an auto-update function that is similar to Windows Updates. For auto-updates to work, each user needs write permissions on their local folder, c:\Program Files\Apex\iHR, and firewalls must allow SOAP messages over HTTP port 80 to/from 64.199.129.131. Apex recommends that all of the workstations, users, and server(s) are joined to the same Windows AD domain.

Table 1. System Requirements
Component Prerequisites Client/Server Permissions Additional Memory (MB) Additional Hard Drive Space (MB)
Apex Client Windows 98, 2000, XP, Vista, 7, 2003 or 2008
.NET Framework 1.0 or better
Client
  • Users require read/write on registry key, HKEY_CURRENT_USER
  • Updates require full permissions on Apex program installation folder
  • Auto-updates require SOAP messages over HTTP port 80 to/from 206.221.237.115
64 10
Database Windows 2000, XP, Vista, 7, 2003 or 2008
SQL Server: MSDE, Express 2000, 2005 or 2008
Express requires .NET Framework 2.0 or better
Server Default SQL Server installation permissions 128 500
Share for File Attachments Windows 98, 2000, XP, Vista, 7, 2003 or 2008
All clients must be able to use a UNC path to access share
Server
  • Typically, HR has full permissions over the share
  • HR assistants need read/write/create
  • Managers may need read on folders for individual employees
0 4000
Task E-mailer Service Windows 2000, XP, Vista, 7, 2003 or 2008
Relay Access to SMTP Server
.NET Framework 1.0 or better
Server Service must run under an account that can read apexTaskEmailer.xml in the program installation folder 10 10

Table 2 lists server configurations for a typical client/server installation. In the recommended configuration, performance is balanced with cost. The recommended configuration uses two IDE drives: one drive holds system files and the SQL Server transaction log. The other hard drive holds the database and the network share for the file attachments.

Table 2. Server Configurations
Component Minimum Recommended Best Performance
MicroprocessorP32x Dual Core4x Quad Core
RDMSMSDESQL Server 2000SQL Server 2008
OSWindows 2000Windows XP ProWindows 2008 Server
RAM500M1G2G
Hard DriveIDE 40GIDE 2x40GRAID SCSI/SAS 4x20G

2. Database Server Installation

The database server requires Windows 2000 or better. If you use a Windows domain then the server should be a member of the domain. The procedure for server installation depends on whether or not you are attaching the database to an existing SQL Server 200x.

2.1. Attaching the Database to an Existing SQL Server

If your server already runs SQL Server 200x then log on to your SQL Server as an administrator. Download the compressed database backup file...

http://iHRsoftware.com/FTP/iFMLADb.zip (3M)

Extract the file and use Enterprise Manager to restore it as a database named IHR. During the restore, you may want to change the locations of the mdf and ldf files.

2.2. "No SQL Server" Installation

If SQL Server 200x is unavailable then log on to the server as an administrator. Download and run the self extracting executable...

http://iHRsoftware.com/FTP/iFMLASetup.exe (73M)

The installer will open. Click Server Installation.

IMPORTANT! With the No SQL Server installation, append \IHR to the server's name when the system prompts you for the name of the database server. If your server were named MyServer then you would enter MyServer\IHR

3. Client Installation

Client installation depends on whether or not the target workstation has .NET Framework 1.0 or better installed.

3.1. .NET Framework 1.0 or Better Is Already Installed

For every workstation with .NET Framework 1.0 or better, log on with an account that has local administrative permissions. Download and execute the file...

http://iHRsoftware.com/FTP/ApexSetup.msi (8M)

The installer will open. Click Next until it finishes. After the installer finishes, the client will open. When prompted, enter the name of the database server and choose Windows Authentication. After you log in, the software may prompt you to enter the key code from your e-mailed sales receipt. Enter your key code if prompted and close the software. You can open the software later by clicking Start > Programs > Apex.

3.2. .NET Framework 1.0 or Better Is Not Installed

For every workstation without .NET Framework 1.0 or better, log on with an account that has local administrative permissions. Either use Windows Update to install the latest .NET framework and then follow the instructions from the last section, 2.1, or download and execute the file...

http://iHRsoftware.com/FTP/iFMLASetup.exe (73M)

The installer will open. Click Additional Client Installation. When prompted, click Next until the installer finishes. After the installer finishes, the client will open. When prompted, enter the name of the database server and choose Windows Authentication. After you log in, the software may prompt you to enter the key code from your e-mailed sales receipt. Enter your key code if prompted and close the software. You can open the software later by clicking Start > Programs > Apex.

3.3. Enabling Auto-Updates

For auto-updates to work, each user needs write permissions on their local folder, c:\Program Files\Apex\iHR, and firewalls must allow SOAP messages over HTTP port 80 to/from 64.199.129.131. Auto-update failures are logged to the user's Application event log. If you use Microsoft's ISA or a similar firewall then copy the pinhole for Microsoft updates and change it to 64.199.129.131.

4. File Attachments and Portraits

iFMLA can associate files like portraits, resumes, and MS Office documents with an employee. If you choose to take advantage of this feature then use Windows Explorer and/or Computer Management to create a network share that will hold the documents. Set appropriate security on the share, and enter the share's UNC path into the software.

To enter the UNC path, log on as an administrator and open the client. Click Company > Settings. Click the File Associations tab. Enter the UNC path. On that same tab, you can also edit the subfolders that will be created for each employee. Note that iFMLA does not automatically manage the security on any of those folders.

5. Security

To set security, log on as an administrator and open the client. Click Company > Security. Click Yes when prompted to remove Users from db_owner. To grant a user or group of users full control, add the user/group, and join him to the db_owner SQL Role. For additional security settings refer to the help manual at http://iHRsoftware.com/ftp/help.doc.

6. Installing the Apex Task E-mailer Service

To enable automatic e-mails, insure that your Windows Account is a member of Domain Admins and follow the steps below.
  1. Choose the server that will host the service. The server needs network access to the Apex database and an SMTP server. Apex recommends that you install the e-mailer service on an existing SMTP server that does not require SMTP authentication.
    If the SMTP server is a remote computer then it must grant relay permissions to the local server. Also, the e-mailer service cannot pass SMTP credentials. If authentication and relaying create problems then work around them by installing a new, local SMTP service from your Windows server CD-ROM.
  2. Log on to the target server. Click here to download (6M) and run the install package.
  3. After the service installs, open the apexTaskEmailer.xml file with notepad. The file is usually located at C:\Program Files\Apex\Apex Task Emailer\apexTaskEmailer.xml. Edit the file and change the database and SMTP keys to point to your database and SMTP server.
    You may choose to create an administrative SQL account and use that account in the database connection string. Otherwise, database permissions will be determined by the Windows Account in which the service runs. Two example connection strings are listed below. One uses Windows Authentication and the other uses SQL Authentication.

    Data Source=.;Database=IHR;Trusted_Connection=Yes
    Data Source=.;Database=IHR;User Id=SQLEmailAccount;Password=colts2007
  4. Open the computer's list of services. Find Apex Task E-mailer.
    If you choose to use Windows Authentication instead of SQL Authentication then right-click the service, edit its properties, and change the Windows Account to a domain account that has administrative database access (member of IHR.db_owner). Note that the domain account needs read permissions on the local apexTaskEmailer.xml file.
  5. Right-click the service and start it. Review your application event log to confirm that the service started successfully.
http://ihrsoftware.com