Deltek Ajera 9 Installation Guide
Deltek Ajera 9 Installation Guide
Installation Guide
Multi-tier Setup 11
Machine 1 11
Machine 2 11
Update Ajera 13
Before you begin 13
To update Ajera 13
To update to SQL 2019 14
Uninstall Ajera 15
Before you begin 15
To uninstall Ajera from your server 15
Ajera Cloud 27
Ajera Cloud: Migrate from Ajera server 27
Ajera Cloud: Set up a new Ajera database 28
Access and reload sample data 28
Index 31
Install Ajera
Without the correct hardware and software (such as supported web browsers or
Microsoft Windows), you cannot access Ajera’s full functionality.
l Confirm that Microsoft .NET Framework 4.6is installed on the Ajera server. Refer to the Microsoft
.NET Framework 4.6 website for installation information.
If you use Firefox as your browser you must manually install the Microsoft .NET Framework
Assistant add-on for Firefox.
1. Download and install Firefox 20 or later on your Ajera workstations.
2. Download and install the Microsoft .NET Framework Assistant add-on for Firefox.
3. Open Firefox and click Ctrl+Shift+A to open the add-on screen.
4. Click the Extension tab and select Microsoft .NET Framework Assistant.
5. Click the Enable button to enable the update.
6. Click Restart Now to restart Firefox.
l Determine what version of Microsoft SQL Server your firm requires. The Ajera installation
automatically installs Microsoft SQL Server 2019 Express as its database on your server. Your
database size and the number of Ajera users may require that you upgrade to a full version of
Microsoft SQL Server 2019. Refer to the Microsoft SQL Server website for installation information.
l If your firm determines that one of the following scenarios applies, contact Ajera Support for
instructions on how to install SQL manually:
l Your firm requires a version of Microsoft SQL Server other than SQL Server 2019 Express.
l You need to install SQL Server 2019 Express to a different directory than the default location.
l Before beginning the installation, disable your anti-virus software.
l When your firm purchased Ajera, your billing contact received a Welcome to Ajera email, containing
your firm’s Ajera Registration Code and company name. Locate that email, as you will need that
information for the installation.
l Identify your Ajera Administrator. Your Ajera Administrator is responsible for the health of your project
and financial information in Ajera. After you install Ajera, your Administrator sets up Ajera to align with
your accounting and project management workflow. Refer to the Ajera Getting Started Guide for setup
information.
Ajera stores your project and financial information in a Structured Query Language (SQL) database. Ajera
automatically pulls data from the SQL database tables to create client invoices, generate reports, and perform
other tasks for you. After installing Ajera on your server, your employees access Ajera on the server by using
supported browsers.
The Ajera installation automatically installs Microsoft SQL Server 2019 Express as its database on your
server. Your database size and the number of Ajera users may require that you upgrade to a full version of
Microsoft SQL Server 2019.
If your firm determines that you need to install a full version of Microsoft SQL Server or if you install SQL on a
drive other than the C: drive on your Ajera server, you must specify an instance name of Axium during the
SQL installation. Refer to the Microsoft SQL Server website for installation information.
During the Ajera installation, the system looks for the SQL instance named
Axium.
If the Ajera installation does not find that name, Ajera installs Microsoft SQL
Server 2019 Express.
Without the correct hardware and software (such as supported web browsers or
Microsoft Windows), you cannot access Ajera’s full functionality.
l If you did not install SQL for Ajera, the system may prompt you to allow access to your
computer, depending on your User Account Control settings in the Control Panel. Click
Allow.
2. To start the Ajera installation, click Next on the screen below.
3. Enter your company name spelled exactly as it appears in the Welcome to Ajera email, along with
your Registration Code and click Next.
4. Specify the local server location where you want to install the Ajera program files and backup folder
(C:\Ajera, by default). Click Install.
The drive letter must be local to the server, not on network-attached storage or a
mapped drive letter. Do not enter the location of the database.
5. Specify the program file and backup folder installation directory, and click Install.
This is not the location of the database; it is the location for the program files and
backups. The drive letter must be local to the server, not on network-attached
storage or a mapped drive letter.
The installation creates and shares a folder within this location for you. By
default, it is C:\Ajera\Program, and the Program folder is shared as Ajera with the
appropriate permissions.
For more information on how to set up an SSL certificate, contact your company
network administrator.
For public Internet use and for Ajera Mobile Timesheets, you must use a static public IP address. You
also need additional network configuration to set up external web access to your server or a virtual
private network (VPN) or other technology, such as a public domain name system (DNS), to connect
to your server from over the Internet.
You can create a public DNS through your Internet service provider. If you do, you must configure a
port forward on your firewall or gateway device.
Due to the variations in firewalls and network access, Deltek cannot provide
support or troubleshoot any problems you might experience while setting up
external web access.
ClickOnce does not support non-standard ports. You must use either port 80 or
443.
The following scenario describes what happens when an employee logs into Ajera over the web.
1. Using a supported web browser, an employee logs into Ajera: http://<server name>/Ajera or
https://<server name>/Ajera.
The Ajera login page displays, via anonymous authentication.
2. When the employee clicks the Login button, Ajera verifies the user name and password against the
database using protections against common attacks, such as SQL injection and buffer overrun.
l If Ajera cannot validate the credentials, an error message appears on the login page.
l If Ajera accepts the login credentials, the system creates a forms authentication token on the
server with an expiration of 30 days.
3. Communication between the Ajera web application and server uses secure HTML5.
4. Using the token passed on the Ajera ClickOnce URL, a forms authentication cookie is manually set in
all HTTP requests.
5. All communication from the Ajera program back to the server for data entry tasks is done via .NET
remoting, with custom client and server sinks.
Server calls are in the form of a binary HTTP POST. The address for all server calls is
http://servername/Ajera/Secure/SAService.rem, where .rem is a default ISAPI extension that points
to ASP.NET, used for remoting purposes.
This cookie allows the request to access the /Ajera/Secure path to process the .NET remoting call.
Note that the cookie is not set in Microsoft Internet Explorer (IE) and is not stored anywhere on the
client workstation.
Without the correct hardware and software (such as supported web browsers or
Microsoft Windows), you cannot access Ajera’s full functionality.
Setting up the Ajera server for web access installs IIS and required modules if they are not already present. It
also creates an Ajera ASP.NET application and application pool on the Ajera server. Ajera requires IIS 7 or
greater.
Ajera: http://<servername>/Ajera
If problems occur with web access, delete the following folder from the client
workstation. You may need to display hidden folders before you can find the right
folder.
Windows 10 C:\Users\%username%\AppData\Local\Apps\2.0\
5. From the > Setup menu, click Employees. The Employee List screen appears with only the first
employee listed.
6. Click Edit.
7. On the General tab, enter or verify the following information:
l Employee name
l Employee type = Administration
l Login information = employee email (required by Ajera Cloud), Login ID, password
l Role = Administrator
Record this setup information and store in a safe location, as the Ajera
Administrator will need it to manage this Ajera database.
8. On the Pay Information tab, select a pay period and enter a pay period salary amount for the
administrator.
9. Click Save and then click Close.
The administrator can now set up your Ajera company information as described in the Ajera Getting
Started Guide.
Store this information in a safe location, as the administrator will need to manage
this Ajera database.
Without the correct hardware and software (such as supported web browsers or
Microsoft Windows), you cannot access Ajera's full functionality.
If your domain name is different from your server name, use this URL instead:
http://<domain name>/Ajera/M
Ajera Cloud clients: To log into Ajera using the Ajera Cloud, employees must
be set up in Ajera with email addresses, which is used as their login ID.
From the > Setup menu, click Utility >Reload Sample Data.
If you are logged into the sample data, Ajera restores the sample data and returns you to the login web page.
Otherwise, Ajera restores the sample data and returns you to your normal processing.
Multi-tier Setup
Use these installation instructions if you are installing Ajera and SQL on different machines.
Technical Having a dedicated gigabit connection between the two machines is recommended
Recommendation as all communication between SQL and Ajera will done through this connection.
Machine 1
Machine 2
Note l Use mixed mode and setup the instance with an sa password.
: l Install SQL using the default instance. Installing SQL with a different name will
cause SQL to use dynamic ports and forwarding those ports can be more difficult.
Update Ajera
Ajera Cloud clients: You do not need to complete this task; Deltek completes it for
you.
Do not install an Ajera update while employees are connected over the web. If
you install the update when an employee is entering data, work entered since the
last save will be lost.
To update Ajera
1. Direct all users, including those using Ajera Mobile Timesheets, to exit Ajera.
If anyone is logged in during the update, all changes since the last save are
discarded.
2. If the Release Notes describe changes to Inquiry, export your custom inquiries.
3. From the Ajera server, go to the Windows Start menu, and select All Programs > Ajera > Ajera
Server Administration.
4. On the Tasks menu, select Update Ajera.
The Ajera installation displays status messages as it proceeds. Do not close any of these windows
until the update is complete. If you have multiple Ajera databases, the update process updates all
databases automatically.
If using Windows Server 2008 with the User Account Control enabled, you
must answer any security messages within two minutes. Otherwise, the update
aborts, and you must restart the process again.
Ajera automatically creates a backup of your data in Ajera > Backups >
PreviousVersion.bak.
6. After the update is complete, import your custom inquiries if you had exported them earlier.
Uninstall Ajera
Ajera Cloud clients: You do not need to complete this task; Deltek completes it for
you.
If you have multiple companies that do not share employees, projects, or financial information, you can set up
a unique Ajera database on your server for each company. Each database contains only that company
information and functions as a completely separate version of Ajera.
2. From the > Setup > Utility menu, click Multiple Databases.
This option only appears on the Utility menu if you are set up with the
Administrator role in your original Ajera database.
When you create an additional database, Ajera creates it with the same firm type selected for the
original Ajera database (Architectural, Engineering, or Neither).
5. Click Close.
After setting up multiple databases, you must set up the first employee as the administrator for each
database. Choose an employee who can maintain each database, has full rights to the system, and has
access to all options, tasks, reports, and employee user IDs and passwords.
5. From the > Setup menu, click Employees. Complete the steps described in the Set up Ajera
Administrators section.
To rename databases
1. On the Ajera Login window, select the database you want to rename.
2. Enter the administrator login credentials for this database and click Login.
4. On the General tab, the words New Company appear in the Company name field. Replace those
words with your actual company name.
5. Enter a beginning balance date and click Save.
6. Repeat the above steps to rename each database.
7. To see all of your renamed databases, log into the original Ajera database.
8. From the > Setup > Utility menu, click Multiple Databases.
This option only appears on the Utility menu if you are set up with the
Administrator role in your original Ajera database.
All Ajera databases appear with their corresponding company names, as illustrated below:
9. Share the company database name with employees so that they can log into the right database.
There are many reasons to move your Ajera databases to a new server. For example, when you purchase a
new server, reorganize your network structure, or move SQL to a different drive on the same server. Moving
Ajera is a simple process of creating, copying, and restoring database backups.
Write down the number is assigned to each new database in the Database
column.
To turn on Upload Attachments using SQL FileStream when Ajera and SQL are on the same server
1. From the Ajera server, go to the Windows Start menu and select All Programs > Ajera > Ajera
Server Administration.
2. From the Tasks menu, select Setup Upload Attachments.
You will get the message "FileStream databases have been created."
This creates a new FileStream database for each Ajera database you use. The naming convention for
files uploaded will be AjeraFiles followed by the name of the database.
3. Click OK.
4. To verify FileStream is enabled, from > Setup menu, select Company > Preferences > General
tab and verify that the check box in the lower right is checked. This check will have to be done for
each Ajera database.
4. Check to ensure that the Running Values are displaying that the FileStream Access level is set to Full
access enabled.
5. Click OK, and restart the SQL Server service.
6. Continue on to manually creating FileStream databases.
9. To verify FileStream is enabled, from > Setup menu, select Company > Preferences > General
tab and verify that the check box in the lower right is checked. This check will have to be done for
each Ajera database.
Ajera Cloud only: The upload file size is set to 120MB by default and cannot be
changed.
Back up Ajera
Back up a database
Ajera Cloud clients: You do not complete this task. Deltek backs up your databases
daily. Contact Ajera Support for backup assistance.
To secure your data, create a formal backup schedule, document the schedule, and incorporate it into your
workflow. How often you create a backup depends on your firm’s situation.
If using the upload attachment feature, Ajera automatically backs up your Ajera
database and Filestream attachments together. If manually backing up your files be
sure that you back Ajera and the corresponding FileStream data together.
l Back up your Ajera server daily, at month-end, at year-end, and before installing updates.
l Retain at least two weeks of backups on the \Ajera\Backups folder on your Ajera server.
l Archive your \Ajera\Backups folder to an external location regularly.
To back up a database
1. Log into Ajera, using your administrator user name and password.
2. From the > Setup > Utility menu, click Database Backups.
This option only appears on the Utility menu if you are set up with the
Administrator role in your original Ajera database.
3. Click New Backup and type a description for the backup, such as January backup. Do not use the
following characters: \ / : * ? " < > | or exceed 100 characters.
4. Click Create. Ajera saves a copy of your data to the \Ajera\Backups folder on your Ajera server.
5. If you have multiple databases, you must log into and back up each database separately. When you
back up data, the Database Backup window lists only the data for the database you are logged into.
5. On your Ajera server, navigate to and select the backup file that you want to restore. Click Restore.
After Ajera restores the database, Ajera prompts you to log in. Keep previous
administrator passwords in a secure location so that you can use them to log into
the restored databases.
6. Click Yes to confirm that you want to restore the database. Ajera notifies you when it has
successfully restored and updated your database.
If a FileStream database was backed up, this also restores the backed up FileStream database.
7. To restore multiple databases, repeat the above steps for each database separately.
This option only appears on the Utility menu if you are set up with the
Administrator role in your original Ajera database.
If using the upload attachment (FileStream) feature, this also deletes the
FileStream data.
4. Click Delete.
5. Click Yes to confirm that you want to delete the database.
6. If you have multiple databases, you must log into each database separately to delete it.
Ajera Cloud
If using the upload attachment (FileStream) feature, this will also back up the
FileStream database.
When you are ready to send your databases to Deltek, be sure to restrict any further
use of your Ajera databases by your employees. Any updates you make after you send
your databases will be unavailable in the Ajera Cloud.
1. The Ajera IT team will contact you and walk you through the steps you’ll need to send your data to
Deltek.
2. The Ajera IT team will notify you when your data is accessible in the Ajera Cloud.
The administrator can now set up your Ajera company information as described in the Ajera Getting
Started Guide.
From the > Setup menu, click Utility >Reload Sample Data.
If you are logged into the sample data, Ajera restores the sample data and returns you to the login web page.
Otherwise, Ajera restores the sample data and returns you to your normal processing.
www.deltek.com
F
Index
FileStream 21
A
H
administrator setup 8
hosted Ajera (Ajera Cloud)
for multiple databases 17
logging in 27
Ajera Cloud (hosted Ajera)
migrating to 27
logging in 27
setting up 28
migrating to 27
hosted Ajera (Axium Cloud)
setting up 28
sample data 9, 28
Axium Cloud (hosted Ajera)
sample data 9, 28 I
installing
B
Ajera 2
backups
Ajera on workstations 9
backing up 24
sample data 9, 28
deleting 25
restoring 25 L
logging in 9
C
Ajera Cloud (hosted) 27
ClickOnce 6
M
D
Mobile Timesheets
databases
accessing from workstations 9
backing up 24
installing 2
creating multiple 16
setting up 9
deleting backups 25
moving
moving to new server 18
databases 18
renaming 17
multiple databases
restoring backups 25
creating 16
setting up administrators 17
moving 18
renaming 17 W
setting up administrators 17 web access 1
R
renaming databases 17
S
sample data
Ajera 9, 28
server
installing Ajera 2
setting up
Ajera administrator 8
Ajera Cloud 28
web access 7
T
timesheets 9
U
uninstalling
Ajera 15
updating Ajera 13
Upload Attachments 20