You are here: Chapter 5: Installing and Upgrading FootPrints > Installing FootPrints
Installing FootPrints
Information Needed for Installation
Your email address
SMTP email server
name for email notification (DNS name or IP address)
If installing the
version for Microsoft SQL database, please have the following information:
Name of Microsoft SQL Server
machine
Microsoft SQL Server Administrator
account password (blank password by default)
The FootPrints Installation
Wizard automatically installs the software, creates the necessary aliases
in IIS, and creates the database, tables and permissions.
After installation, the software can be auto-licensed for 30 days with
all functionality.
NOTE FOR Microsoft SQL Server USERS
Microsoft SQL Server can be installed such that column names are case
sensitive; this causes FootPrints
to fail. If
you have installed Microsoft SQL Server with case sensitive column names, you will
need to reinstall it without case sensitive column names before installing
FootPrints.
NOTE FOR Microsoft SQL Express 2005 USERS
Microsoft SQL Express 2005 requires Windows Installer 3.1 or later, MDAC 2.8 SP1 or later, and .Net Framework 2.0 or later.
NOTE FOR BASE STARTER PACK USERS
The Extended Starter Pack is required to purchase the SQL Link. Please contact your salesperson for details on obtaining the Extended Starter Pack.
NOTE
FootPrints must be installed from the server and not through
a terminal services session. Installing
FootPrints through a terminal server session will result in a "Page
Not Found" error when attempting to access FootPrints.
FootPrints Version 11.6 for Unix and Linux Functions Under FastCGI
FastCGI is now the preferred method enabling Fast CGI in FootPrints. Directions can be found in this Knowledge Base article: FastCGI implementation instructions. Please contact BMC Support if you need help with this installation.
Installation Instructions
Note on MICROSOFT XP
Because neither Microsoft XP nor Vista are designed to be used as servers,
we do not recommend them as platforms for the FootPrints
server. Microsoft XP and Vista are supported, however, as a client platforms for connecting
to FootPrints for all users via
the browser.
The FootPrints software contains installation files for many different platforms. Select the appropriate file to install FootPrints from the following list, then double click the file to begin setup:
fpsc64ORACLE1160.exe
fpsc64SQL1160.exe
fpsc64SQLExpress1160.exe
fpsc64up1160ORACLE.exe
fpsc64up1160SQL.exe
fpscORACLE1160.exe
fpscSQL1160.exe
fpscSQLExpress1160.exe
fpscup1160ORACLE.exe
fpscup1160SQL.exe
Note
For UNIX/Linux versions, please read the README
for installation instructions.
Follow the prompts
and enter the information required:
Name—Your name.
Company—Your company.
Email
server—Enter
the full DNS name or IP address for your SMTP mail server.
User
ID—Enter
a User ID. You
will be given a password.
Note
Make sure to keep a written copy of your FootPrints
user ID and password. You need these to log
in to FootPrints the first time.
Email
address—Your
email address.
Workspace
name—The
name of your first FootPrintsWorkspace
Address
Book name—The
name of your first FootPrints Address Book.
By
default, FootPrints is installed to c:\FootprintsServiceCore. You can optionally
browse for a different directory.
NOTE
The install path cannot contain any spaces.
When
you are asked if you would like FootPrints to setup the web server, answer
Yes.
This creates
5 virtual directories in IIS for FootPrints.
If
installing the Microsoft SQL Server database version:
What is the name
of the Microsoft SQL Server you are using?—Specify the machine name of the Microsoft SQL Server machine.
Microsoft SQL
Server Administrator ID—This
is “sa” by default (please consult your Microsoft SQL Server administrator).
Microsoft SQL
Server Administrator Password—This
is blank by default (please consult your Microsoft SQL Server administrator).
The Installation
Wizard now tests the connection to Microsoft SQL Server. If
the connection fails, you will be prompted to enter the information again.
Program
Folder—This
defaults to FootPrints.
NOTE
If you are updating an existing installation of FootPrints that has Asset Management enabled using BMC FootPrints Asset Core, you may be warned during the install that the integration will be disabled as part of the update. Depending on your version of BMC FootPrints Asset Core you will either need to update to a more recent version of BMC FootPrints Asset Core or reconfigure the integration under Administration > System > Asset Management. Refer to BMC FootPrints Asset CoreSystem Administration Setup for details on configuring the most recent release of BMC FootPrints Asset Core.
When setup is complete,
you must reboot the server.
If you decide to not have FootPrints automatically configure IIS for you, you will have to configure IIS on your own. Complete the FootPrints installation before doing so. The next steps provide instructions for adding the Perl extension to IIS are below.
To add the Perl extension
to IIS:
Based on the platform you are running:
On
Windows 2003/2008 Server, go to Start
| Programs | Administrative Tools | Internet Services Manager.
In the Management
Console, highlight your Default Web Site. In
the right pane, there should be five FootPrints
virtual directories listed: FootPrints,
help,
MRcgi,
tmp,
and MRimg. In order to run properly, FootPrints
requires the following directory aliases to be made in your web server.
different IIS versions have different interfaces for entering this information.
Directory
Alias
IIS 6 Permissions
c:\FootprintsServiceCore\cgi
MRcgi
scripts and executables
c:\FootprintsServiceCore\html
footprints
scripts and executables
c:\FootprintsServiceCore\html\help
help
read
c:\FootprintsServiceCore\html\tmp
tmp
read
c:\FootprintsServiceCore\html\MRimg
MRimg
read
Highlight MRcgi,
right-click the mouse, and select Properties.
On the Virtual Directory
tab, click the Configuration
button. If you don't have this button, click the Create
button first.
In the App Mappings
tab, click the Add
button.
For Executable,
enter: c:\FootprintsServiceCore\bin\perl\bin\perl.exe
"%s" "%s". where c:\FootprintsServiceCore is the FootPrints installation
path. For
example, if FootPrints is installed to D:\FootPrintsServiceCore, the Perl executable
path should be: D:\FootPrintsServiceCore\bin\perl\bin\perl.exe
"%s" "%s".
For Extension,
enter: .pl
Click OK,
then click Apply,
and then OK
on the App Mappings tab.
Click OK
on the MRcgi Properties.
Close IIS and save
any changes.
To access FootPrints,
point your web browser to: http://mywebservername/footprints/
where myservername
is the URL for the server on which FootPrints
is installed. To
run it locally, the machine name can be used, e.g., http://mymachine/FootPrints/.
Login to FootPrints
with the user ID and password created during installation, then click Login or press Enter.
To start using FootPrints, you must obtain a license. The first
time you log in, a 9-character license code is displayed on the screen.
Click the
link to connect to the licensing page. This
opens a second window that brings you to the BMC automatic
licensing page.
Note: If you have purchased FootPrints, you should obtain
a permanent license and input it on this screen, instead of following
the evaluation license process above. Email Support for your permanent license.
Fill in the short
form on this screen, and click Get License. You will immediately receive a 54-character license string via email.
You
must enter a valid email address to receive the license.
Enter the 54-character
license string in the License
String field on the FootPrints screen and click GO. Pasting the license string directly from the email (rather than typing
it) ensures accuracy. This provides you with a 30-day evaluation
license for 5 internal users, Unlimited Customer (end user) access and
the Dynamic Address Book link feature.
The Workspace
Setup Wizard is displayed. The
Workspace Setup Wizard guides you through setting up the most popular features
of FootPrints. You can exit the
Wizard at any time, which takes you to the FootPrints Homepage.
To configure
options at a later time, visit the Workspace and System Administration pages
by selecting Administration from the FootPrints
Toolbar.
Once the Wizard is
complete, you are on the FootPrints
Homepage. The FootPrintsHelp appears in a second
window. Follow
this guide to learn about how to use FootPrints
and to configure itwith additional
fields, users, and settings.
Application Pools
If questions arise regarding Application Pools when configuring
Virtual Directories, email Support for assistance.