Académique Documents
Professionnel Documents
Culture Documents
Contents
Contents ................................................................................................................................................................... 2
Introduction .............................................................................................................................................................. 5
Intended Audience ................................................................................................................................................. 5
Minimum System Requirements ............................................................................................................................ 5
Configuring the Signing SSL Certificate and Xero Client SSL Certificate serial numbers in the Ambit Optimist 8
web.config ............................................................................................................................................................ 65
Configuring the Xero application name and OAuth consumer key in the Ambit Optimist 8 web.config .............. 66
Appendix 3 – Configuring IIS to enable HTTP Compression for Ambit Optimist 8 ........................................ 67
Enabling HTTP Compression of Dynamic Content on Web Server ..................................................................... 67
Registering new MIME Type for dynamic compression ....................................................................................... 67
Appendix 4 – Configuring Microsoft Message Queuing for Batch Obligor Risk Ratings .............................. 70
Enabling Microsoft Message Queuing ................................................................................................................. 70
Windows Server 2008 or Windows Server 2008 R2 ..................................................................................... 70
Windows Server 2012 or Windows Server 2012 R2 ..................................................................................... 72
Creating a new Message Queue .......................................................................................................................... 73
Configure Ambit Optimist 8 with the Message Queue path ................................................................................. 77
Appendix 5 – Minimize transaction log growth during an Ambit Optimist 8 upgrade ................................... 78
Troubleshooting .................................................................................................................................................... 83
Internet Explorer displays a completely blank, white page when I navigate to
http://<servername>/Optimist8/default.aspx ........................................................................................................ 83
Internet Explorer displays an error page with Internal Server Error 500 .............................................................. 83
Internet Explorer displays an error page with Runtime Error and there is a logged error referencing “portable
reference folder Profile24” .................................................................................................................................... 83
While attempting to import the license file an error message is displayed informing you that the license file could
not be loaded ........................................................................................................................................................ 84
The User gets prompted to log in when using Windows Authentication .............................................................. 85
Performing a Third Party Import from Xero fails when connecting to the Xero API ............................................. 86
Performing a Web Service call fails with an error message ................................................................................. 86
Covenant List and My Clients information blinking on Legal Entity Profile tab .................................................... 87
On mouse over Covenant List and My Clients information starts blinking on Legal Entity Profile tab for some
machines. ............................................................................................................................................................. 87
Internet Explorer displays a completely blank, white page when I navigate to
http://<servername>/Optimist8/PortfolioAnalysis ................................................................................................. 87
Clicking “Portfolio Analysis” tab on Optimist BUI or Optimist Admin is opening a “Not Found” page.................. 87
Introduction
This document details the installation and registration process for the Ambit Optimist application components.
Intended Audience
The intended audience of this document is IT personnel and system administrators of the Ambit Optimist software
application. We strongly suggest that this document should not be made available to normal users of the
software.
Workstation:
Browser Internet Explorer 11 (to support both Silverlight and HTML5 GUIs)
Client Operating System Windows 7
Windows 8, 8.1
Windows 10
Client Screen Resolution 1280 x 1024 resolution, 32-bit color (minimum)
Dependencies MS Silverlight 5
Other Optional Applications MS Office 2003 or above, Adobe Acrobat Reader
Database Server:
Server Operating System Windows Server 2003 R2 or above
Components and Services Minimum: SQL Server 2008 R2
Web Server:
Server Operating System Windows Server 2008 R2 or above (32 and 64 bit versions)
Dependencies MS Internet Information Services 7.5
MS .NET Framework 4.6.2
Microsoft Web Deploy 3.5
Installation Overview
There are a number of activities to complete when installing your software:
Pre Installation
1. Read this Installation Guide completely.
2. Read any Release Notes specific to your software version.
3. Ensure that your workstation or server environment meet the minimum system requirements.
4. Ensure the person installing the software has Administrator rights on both the application server and the
database server where the software is being installed.
Installation
In order to successfully install the software you need to ensure all prerequisite components are installed first,
followed by system installation. The following sections provide detailed instructions.
Notes 1. FIS recommends that your operating system be maintained with the latest official Service Packs and Updates available.
2. Windows 95, 98, NT 3.5, NT 4.0, 2000 are not supported.
3. Apple and Linux operating systems are not supported on Web Servers.
4. Adobe Acrobat Reader is required to view reports exported to PDF.
Installation Prerequisites
Important! To install the software you must ensure that all of the prerequisite components are installed and
successfully working on the web server.
Note If the Internet Information Services (IIS) option is not available in the Administrative Tools, it will need
to be installed. To do this:
1. Click on the Windows Start menu.
2. Launch the Control Panel.
3. Select the Programs and Features option.
4. Select Turn Windows features on or off.
5. Select IIS features to install (see below).
Click OK to complete the installation of the IIS features. You may be requested to re-start your computer. If so, re-
start before you continue with the rest of the installation.
4. Using the Add Role Services wizard, ensure that the following six IIS Role Services are installed:
Common HTTP Features \ Static Content
Application Development \ ASP.NET
Security \ Windows Authentication
Security \ Request Filtering
Management Tools \ IIS Management Console
Management Tools \ Management Service
These are shown in the following two images:
5. If any of these six Role Services are not already installed, click Next and complete the Add Role
Services wizard.
6. Click Next.
7. Select the Features tree in the left hand panel.
8. Expand the .NET Framework 4.5 Features tree node.
9. Ensure that the following features are installed:
ASP.NET 4.5
WCF Services \ HTTP Activation
10. Accept any pop up addressing required additional roles and features that need installing.
13. If any of these Role Services and Features are not installed, select them, and complete the Add Roles
and Features Wizard.
Once downloaded, install the framework by following the instructions as provided by Microsoft.
Tip! The installation path can be changed by clicking the Options button in the installer.
Important! You need to add a trailing period character (.) when naming the “.NETPortable” folder to
avoid an error caused by the leading period character (e.g. “.NETPortable.”). Windows
Explorer will remove this trailing period.
4. Copy the three extracted folders from step 2 into the .NETPortable folder.
The process for installing Ambit Optimist 8 for the first time comprises the following steps:
Start Internet Information Services (IIS) Manager
Create a web site for SunGard applications
Adjust the automatically created SunGard Application Pool
Import the Ambit Optimist 8 web application
Configure a private Application Pool for the Optimist8 web application
Confirm that the IIS settings for the application are correct
Configure the database
Connect to the database
Import a license file
Post-Installation database security refinements (SQL server only)
Following are detailed instructions for each step.
Note If upgrading from a previous version of Ambit Optimist 8, refer to the next section – Upgrading
Software – for installation instructions.
Note If you are planning to configure a private application pool for the Ambit Optimist 8 web
application (recommended), you do not need to provide a value for the Specific Times
setting.
If you are installing Ambit Optimist 8 from a file download rather than a CD, you will need to decompress the
downloaded .zip file and then mount the .iso file so that you can access the Software folder. This will need to be
done before continuing through the following steps.
Important! If you are installing Ambit Optimist 8 from a file download and have not yet decompressed the
downloaded .zip file and mounted the .iso file to access the Software folder, you must do this
now before continuing. Refer to .iso mounting software in the Installation Prerequisites section.
Important! If the Deploy section is unavailable or missing, then Web Deploy will need to be installed
as a prerequisite – see the section Installation Prerequisites.
3. In the Import Application Package wizard, select the Optimist.Web.zip file from the Software folder on
the installation CD (or mounted drive).
4. Click Next and complete the wizard using the default options.
5. Once imported, a new web application named Optimist8 is displayed under the SunGard website on the
Connections panel of IIS.
6. On the Connections panel, select the new Optimist8 web application.
7. Double-click on the Authentication icon in the IIS section of the Features panel. As shown in the image
below:
9. Disable all other authentication types by right-clicking on them and selecting Disable. This must be done
for each authentication type.
10. Right-click on Windows Authentication then click Advanced Settings…
11. Make sure the Extended Protection drop-down is set to Off.
12. Click OK if a change was required; otherwise, click Cancel.
7. Click OK.
8. On the Connections panel, navigate to the Optimist8 web application and select it.
9. On the Actions panel, click Advanced Settings…
10. On the Advanced Settings dialog, select Application Pool and then click the ellipsis button.
11. Select the Optimist8 Application Pool as shown in the below image, then click OK.
When Web Deploy imported the Optimist8 web application, it granted write access to the Optimist8’s
App_Data folder to the Application Pool Identity, which at the time was the SunGard application pool.
Now that we have changed the application pool that Optimist8 uses, we will need to manually grant write
access to both the App_Data and the ClientBin folder.
The Select Users or Groups dialog is displayed as shown in the image below:
Confirm that the IIS settings for the application are correct
1. Return to the IIS Manager and select Optimist8 from the Connections panel on the left.
2. In the Actions panel at the right, click on Browse *:80 (http). The port number may be different
depending on how the bindings were set up for the SunGard website in earlier steps.
Internet Explorer is launched and the application’s Installation page is displayed. It should look similar to
the image below:
If the page shown in your browser looks like this, then you are ready to configure the database. Leave
Internet Explorer open on this page as we will return to it later.
3. The Login name that you enter will depend on whether the SQL server instance is installed on the same
machine as IIS instance that hosts the Ambit Optimist 8 application or not.
If on the same machine, the Login will be in the form ‘IIS APPPOOL\<ApplicationPoolName>’.
As we have created a private application pool for the Ambit Optimist 8 application (as described in
the section Configuring a private Application Pool for the Optimist8 web application), it would be ‘IIS
APPPOOL\Optimist8’.
If not on the same machine, the Login will be in the form ‘<DomainName>\<MachineName>$’.
For example, if the domain name is ‘GlobalFinance’ and the machine hosing IIS is named ‘IIS-BOX’,
then it will be ‘GlobalFinance\IIS-BOX$’. Note that the Login name must have the $ character at the
end.
Note SQL Server authentication can be used as an alternative; however the disadvantage to this
approach is that the login credentials are stored in the web application’s local storage and
are also transmitted from the application server to the database server. This can represent a
significant security vulnerability.
5. Select the Server Roles page and in the list of Server roles, select public.
Note For databases that will store volumes of data comparable to a production environment, a
database maintenance plan should be implemented. Refer to Appendix 6 – Recommended
database index maintenance for further information.
Note After the license file has been imported the page will refresh. Please contact FIS Client Services if
you think the license details are incorrect.
Important! Language packs are built to match specific versions of Ambit Optimist 8. Language Packs built
for older versions of Ambit Optimist 8 may not work on newer versions. In some cases they may
even cause Ambit Optimist 8 to malfunction. Always only use language packs that were made for
your specific version of Ambit Optimist 8.
For each language pack that you wish to install, follow these steps:
1. In the Administration module of Ambit Optimist 8, select the Languages tab.
A list of the currently installed language packs is displayed.
Note Sometimes there will be a check in the Disabled column for a given language pack. This can
happen during a multi-web server installation, or when upgrading Ambit Optimist 8 from a prior
version. There is no cause for concern in this case, it just means that you need to re-install that
language pack on this web-server in order to synchronize it with the database.
2. Click Install.
3. Browse to the location of your language pack, select it and click Open.
4. Ambit Optimist 8 will begin installing the language pack. This may take a few moments.
Note If you are re-importing a language pack Ambit Optimist 8 will prompt to confirm that you wish to
upgrade.
5. To make the language pack that you installed to be the default for all users to access Ambit Optimist 8,
select it in the Languages list and select the radio button in the Default column.
If you are performing a multi web server installation, you will need to install all of your language packs on
each webserver.
7. Click OK on the Login Properties dialog and exit SQL Server Management Studio.
5. Change the Value for the IsInstallConfigEnabled application setting to False and click OK.
Attempting to navigate to the installation configuration page will now result in a Page Not Found error
page.
The process for installing Portfolio Analysis comprises of the following steps:
Import Portfolio Analysis web application
Configure Portfolio Analysis web application
Following are detailed instructions for each of the above steps.
Important! If you are installing Portfolio Analysis from a file download and have not yet decompressed the
downloaded .zip file and mounted the .iso file to access the Software folder, you must do this
now before continuing. Refer to .iso mounting software in the Installation Prerequisites section.
Important! If the Deploy section is unavailable or missing, then Web Deploy will need to be installed
as a prerequisite – see the section Installation Prerequisites.
4. In the Import Application Package wizard, select the PortfolioAnalysis.Web.zip file from the Software
folder on the installation CD (or mounted drive).
5. Click Next and complete the wizard using the default options.
Important! Do not change the web application name while doing installation. Always keep the
default name - PortfolioAnalysis - as changing this will not install the application as
intended.
6. Once imported, a new web application named PortfolioAnalysis is displayed under the Optimist8 web
application on the Connections panel of IIS.
7. On the Connections panel, select the new PorfolioAnalysis web application.
8. Double-click on the Authentication icon in the IIS section of the Features panel. As shown in the image
below:
6. Click Locations….
7. Select the local computer then click OK.
8. Enter IIS AppPool\Optimist8 into the text box then click Check Names. When the name is resolved it
will be underlined and will not be qualified by the IIS AppPool prefix, e.g. “Optimist8”.
9. Click OK to return to the Permissions for App_Data dialog.
10. Select Optimist8 from the list of names at the top of the dialog.
11. Ensure that there is a tick in the Allow column of the Permissions for Optimist8 list box for both Read and
Write. No other permissions need to be granted. See image below:
Upgrading Software
If you currently have an earlier version of the software installed on your computer, the installation requires some
additional processes to ensure a complete and thorough update is performed.
The process for upgrading to a new version of Ambit Optimist 8 comprises the following steps:
Uninstall the previous version of Ambit Optimist 8
Import the Ambit Optimist 8 web application
Set the web application to use the Optimist8 private application pool
Confirm IIS settings for the application are correct
Ensure database login has sufficient privileges to perform an upgrade
Connect to database
Import a license file
Post-Installation database security refinements (SQL Server only)
Following are detailed instructions for each step.
Important! If you are installing Ambit Optimist 8 from a file download rather than a CD, you will need to
decompress the downloaded .zip file and mount the .iso file to access the Software folder. This
needs to be done before continuing through the following steps. Refer to .iso mounting software
in the Installation Prerequisites section.
10. In the Import Application Package wizard, select the Optimist.Web.zip file from the Software folder on
the installation CD (or mounted drive).
11. Click Next and complete the wizard using the default options.
Once imported, a new web application named Optimist8 is displayed under the SunGard web site on the
Connections panel of IIS.
12. On the Connections panel, select the new Optimist8 web application.
13. Double-click on the Authentication icon in the Features panel:
When Web Deploy imported the Optimist8 web application, it granted write access to the Optimist8’s
App_Data folder to the Application Pool Identity, which at the time was the SunGard application pool.
Now that we have changed the application pool that Optimist8 uses, we will need to manually grant write
access to both the App_Data and the ClientBin folder.
6. On the Connections panel:
7. select the Optimist8 web application
8. expand the tree using the + button
9. select the App_Data sub-folder.
10. On the Actions panel click Edit Permissions….
Confirm that the IIS settings for the application are correct
1. Return to the IIS Manager and select Optimist8 from the Connections panel on the left.
2. Under the Actions panel, click on Browse *:80 (http). The port number may be different depending on
how the bindings were set up for the SunGard website in earlier steps.
Internet Explorer is launched and the application’s Installation Configuration page is displayed. It should
look similar to the image below:
If the page shown in your browser looks like this one, you are ready to connect to the database.
3. Ensure database login has sufficient privileges to perform an upgrade.
Ambit Optimist 8 will be connecting to and upgrading an existing database. In order to do this, the
mapped database user of the Login that is used to connect to the database will need to be a member of
some specific database roles.
If you are not familiar with SQL server security it may be helpful to read Appendix 1 – Understanding SQL
server security before continuing.
For the Login used to access the database server, you can configure database roles of the mapped
database user by completing the following steps (refer to following image):
4. Select the User Mapping page on the Login properties dialog.
5. Select the Map checkbox for the Optimist8 database.
6. Select the following database roles:
7. db_datareader
8. db_datawriter
9. db_ddladmin
10. Click OK on the Login Properties dialog.
Note For databases that will store volumes of data comparable to a production environment, a
database maintenance plan should be implemented. Refer to Appendix 6 – Recommended
database index maintenance for further information.
If your installation of Ambit Optimist 8 has a large database (such as a production size database),
complete the steps outlined in Appendix 5 – Minimize transaction log growth during an Ambit Optimist 8
upgrade. Otherwise, click Yes.
Ambit Optimist 8 will require a valid license before you begin using it. Refer to the section Importing a
License file for details.
Note After the license file has been imported, the page will refresh. Contact FIS Client Services if you think
the license details are incorrect.
Important! Language packs are built to match specific versions of Ambit Optimist 8. Language Packs built
for older versions of Ambit Optimist 8 may not work on newer versions. In some cases they
may even cause Ambit Optimist 8 to malfunction. Always only use language packs that were
made for your specific version of Ambit Optimist 8.
For each language pack that you wish to install, complete the following steps:
1. From the Administration module of Ambit Optimist 8, click the Languages tab. Here you will see a list of
the currently installed language packs.
Note Sometimes there will be a check in the Disabled column for a given language pack. This
can happen during a multi-web server installation, or when upgrading Ambit Optimist 8 from
a prior version. There is no cause for concern in this case; it just means that you need to re-
install that language pack on this web-server in order to synchronize it with the database.
2. Click Install.
3. Browse to the location of the language pack, select it and click Open.
Ambit Optimist 8 begins to install the language pack. This may take a few moments.
Note If you are re-importing a language pack, Ambit Optimist 8 will prompt you to confirm that
you wish to upgrade.
4. If you would like the language pack that you installed to be the default for all users to access Ambit
Optimist 8, select it in the Languages list and check the radio button in the Default column.
If you are performing a multi web server installation, you will need to install all of your language packs on
each web server.
Note You need to ensure that the Client endpoint (Optimist 8 Covenant Maintenance WCF
Service) and log file values are correct.
1. Open SQL server Management Studio (SSMS) and connect to the SQL server instance that will host the
Ambit Optimist 8 database.
2. Use the Object Explorer to navigate to the Logins folder which is located under the Security folder.
3. Expand the Logins folder then select the login that was created earlier for Ambit Optimist 8.
4. Right-click the login and select Properties from the context menu. The Login Properties dialog is
displayed.
5. Select the User Mapping page.
6. Select the Optimist8 database and deselect the db_owner and db_ddladmin database roles. Only the
db_datareader, db_datawriter and public database roles are required (see image below):
7. Click OK on the Login Properties dialog and exit SQL Server Management Studio.
Attempting to navigate to the installation configuration page will now result in a “Page Not Found” error
page.
3. Create a new folder named Optimist8_<old version number> or the name of the application.
4. Create a new text file called default.html located in the folder created in the previous step.
Note To ensure you apply the correct alias you may want to check the URL that has been used
by the users when accessing the old version prior to the upgrade.
7. Ensure you set the Physical Path to the location of the folder created in step 3.
8. Select the newly created Web Application and open the Default Document item under the IIS heading.
9. Add the entry default.html and ensure it is at the top of the list.
Note This setting is case sensitive so please be sure you match the default document entry
exactly to the file name.
If HTTP Redirect is not available you will need to install the Role/Feature. To do this, follow the
Microsoft guide:
HTTP Redirects <httpRedirect>:
http://www.iis.net/configreference/system.webserver/httpredirect.
Note The relative path needs to represent the navigation from the old version to the new version.
When working with relative paths the symbol ‘../’ indicates to navigate back a directory.
Note This process will only remove the web site from the web server. Unless the installation of
Ambit Optimist 8 used SQL CE, the database established by Ambit Optimist 8 (containing
all client files and related data) on the database server will not be removed by this process.
Appendix 1 – Understanding
Microsoft SQL server security
When installing Ambit Optimist 8 with a SQL server database, it helps to understand a little about how SQL server
security works.
For Ambit Optimist 8 to access a database in SQL server, it requires access on 3 main levels:
Windows level
SQL server level
Database level.
During installation we create an IIS Application Pool Identity called Optimist8. This provides access at the
Windows level.
Later, we create an SQL server Login called <Domain Name>\<MachineName$> and we assign some Fixed
server roles ( db_creator, public). This provides access at the SQL Server level.
Lastly, we map the SQL server Login to a Database user (which is automatically created by SQL server) and we
assign some Fixed database roles to that Database user (db_datareader, db_datawriter, public). This provides
access at the Database level.
The IIS Application Pool Identity (which in this case is named Optimist8) uses Windows Authentication to identify
itself to SQL server at which point the connection is associated with the SQL Server Login that you created. This
in turn is associated with the database user which has access to the data.
For anyone new to these concepts, the important thing to remember is that the IIS Application Pool Identity, the
SQL server Login and the Database user are all different things that need to be connected together in order for
Ambit Optimist to connect to the database and function securely and successfully.
4. In the pop-up dialog, select the Computer account option and click Next.
5. Select the Local computer option and click Finish.
6. Click OK in the Add or Remove Snap-ins dialog.
Configuring the Signing SSL Certificate and Xero Client SSL Certificate
serial numbers in the Ambit Optimist 8 web.config
The next step is to configure the Signing SSL Certificate and Xero Client SSL Certificate serial numbers in the
Ambit Optimist 8 web.config so it can be accessed in the Ambit Optimist 8 application.
To do this, complete the following steps:
1. Double-click the Signing SSL Certificate in the Personal certificates node.
2. In the pop-up dialog, select the Details tab.
3. In the details list, select the Serial number list item.
4. Note the serial number value shown. This will be entered into the web.config in a later step.
Note The final serial number should not contain spaces and should be all capitals. For
example, if it is shown in the dialog as “Z9 c4 2X”, then the serial number will be
“Z9C42X” (without quotes).
Warning! Do not copy the value directly from the dialog. This will copy an invisible character,
causing Ambit Optimist 8 to not correctly find the certificate.
5. Perform the same previous steps for the Xero Client SSL Certificate in the Personal certificates node.
Note this serial number shown; this will be entered into the web.config in a later step.
6. Locate the web.config file in the installation directory. Typically, the installation directory will be
D:\WebSites\SunGard\Optimist8\.
7. Open the web.config file in a text editor such as Notepad. In order to edit the web.config file, you may
require Administrator privileges.
8. Navigate the file to locate the tag <appSettings>.
9. Find the sub tag with the key equalling XeroSigningCertificateSerialNumber.
10. Add the value attribute to the tag (as below), with the Signing SSL Certificate serial number noted in the
earlier step.
Configuring the Xero application name and OAuth consumer key in the
Ambit Optimist 8 web.config
The final step is to configure the Xero application name and OAuth consumer key in the Ambit Optimist 8
web.config so it can be accessed in the Ambit Optimist 8 application.
To do this, complete the following steps:
1. Log into the Xero Development Centre at http://developer.xero.com/
2. Navigate to the My Applications tab.
3. Note the Name of the application and the OAuth Key for the previously configured Xero partner
application. Note this serial number shown; this will be entered into the web.config in a later step.
4. Locate the web.config file in the installation directory. Typically the installation directory will be
D:\WebSites\SunGard\Optimist8\.
5. Open the web.config file in a text editor such as Notepad. In order to edit the web.config file, you may
require Administrator privileges.
6. Navigate the file to locate the tag <appSettings>.
7. Find the sub tag with the key XeroApplicationName
8. Add the value attribute to the tag (as below), with the Xero application name noted in the earlier step.
For example: <add key="XeroApplicationName" value="Ambit Credit Assessment 8"/>
9. Find the sub tag with the key XeroConsumerKey
10. Add the value attribute to the tag (as below), with the OAuth consumer key noted in the earlier step.
For example: <add key="XeroConsumerKey" value="IPV05QKJPPQROFCZNAGX8J12L2QTL2"/>
4. Select DynamicTypes and click the ellipsis button that appears on the right side.
5. In the Collection Editor dialog, click Add, then input the following:
6. enabled = True
7. mimeType = application/msbin1
Command Line
Using AppCmd for IIS7, the new MIME Type can be added via following command line command
appcmd.exe set config -section:system.webServer/httpCompression
/+"dynamicTypes.[mimeType='application/msbin1',enabled='True']" /commit:apphost
4. Add a new node to the <dynamicTypes> section. This node should be:
<add mimeType="application/msbin1" enabled="true" />
5. Save applicationhost.config and close Notepad.
6. Restart the web server.
5. Find and expand the Message Queuing node, then expand the child Message Queuing Services node.
6. Ensure that both Message Queuing Server and Directory Service Integration are selected.
7. Click Next.
8. Click Install.
Once MSMQ features have been installed, the server may need to be restarted. This should be performed
before the next step.
8. Click Next.
9. Click Install.
Once MSMQ features have been installed, the server may need to be restarted. This should be performed
before the next step.
3. Expand the Message Queuing node. If a public queue is desired, select the Public Queues node,
otherwise select the Private Queues node.
Note In the next section, creating a new private queue is demonstrated. The steps are the same
for a public queue.
4. In the Actions pane, click More Actions, then select New > Private Queue.
7. Click OK.
8. To ensure Ambit Optimist 8 has the correct permissions to access the queue, right-click the queue and
select Properties from the pop-up menu
OR
Select the queue, click More Actions from the right-hand panel, then select Properties.
9. Select the Security tab, then click Edit…
The Permissions for App_Data dialog is displayed.
10. Click Add…
The Select Users or Groups dialog is displayed as shown in the image below.
Public Queue
5. Add the value attribute to the tag (as below), with the public queue name noted in the earlier step.
The public queue path is made up of the server name and the queue name. The first part of the path is
the server name, then the queue name, separated by a backslash.
For example:
my-server\optimist8-batchratings-default
<add key="Activities:BatchRatingMessageQueuePath" value=" my-server\optimist8-batchratings-
default"/>
Private Queue
6. Add the value attribute to the tag (as below), with the public queue name noted in the earlier step.
The private queue path is made up of the private queue prefix and the queue name. The first part of the
path is the private queue prefix, then the queue name, separated by a backslash.
For example:
.\private$\optimist8-batchratings-default
Note The ‘.\private$’ prefix is important. The ‘.\’ represents the local computer, ‘private$’
represents a private queue.
3 Database 1. Change the Recovery Model back to its original setting (i.e.
Administrator FULL)
2. Take another Transaction Log backup.
Appendix 6 – Recommended
database index maintenance
During the installation and upgrade, the Ambit Optimist 8 application automatically creates (or re-creates) indexes
that are suitable for the database structure and the queries that the application executes against it.
From time to time these indexes will require either re-organizing or re-building in order for them to remain effective
and help Ambit Optimist 8 continue to exhibit good performance.
FIS recommends that the Database Administrator download and use the database maintenance scripts provided
at https://ola.hallengren.com. These scripts are written by Ola Hallengren and are considered a de-facto standard
in the industry.
For index maintenance of Ambit Optimist 8 the Database Administrator should run Ola Hallengren’s
MaintenanceSolution.sql script on their master database. This will set up the necessary logic routines that can be
used for ongoing maintenance of all the databases on that instance of SQL server.
Assuming that the name of your Ambit Optimist 8 database starts with the text “Optimist8”, the following call to
dbo.IndexOptimize should be used for maintaining the indexes in the Ambit Optimist 8 database:
EXECUTE dbo.IndexOptimize
@Databases = 'Optimist8%', --any database where the name starts with 'Optimist8'
@FragmentationLow = NULL,
@FragmentationMedium = 'INDEX_REORGANIZE,INDEX_REBUILD_ONLINE,INDEX_REBUILD_OFFLINE',
@FragmentationHigh = 'INDEX_REBUILD_ONLINE,INDEX_REBUILD_OFFLINE',
@FragmentationLevel1 = 5,
@FragmentationLevel2 = 30,
@SortInTempdb = 'Y' --If tempdb runs out of space, either allocate more space
(preferred) or set this param to 'N'
Note Once the web.config settings are completed, in the Administration module the system will
display a DataHub tab under the Web Services tab.
5. Now proceed to the DataHub tab under the Web Services tab in Ambit Optimist 8 Administration.
6. Select the Enable DataHub flag.
7. Enter a name for the Pool.
8. Provide the url of the location where DataHub is hosted.
Ambit Optimist 8 is now ready to be used with Ambit Data Hub.
Troubleshooting
Problem
Problem
Internet Explorer displays an error page with Internal Server Error 500
Solution
This can occur if the server had .NET framework installed prior to installing IIS.
To rectify the problem:
1. Select Windows Start menu > Control Panel.
2. Select Programs and Features.
3. In the list of installed programs, find the Microsoft .NET Framework
4. Right-click on the Microsoft .NET Framework and select Uninstall/Change.
5. On the following dialog, select Repair .NET Framework to its original state and click Next.
6. If you are asked to re-start the computer select Restart Now.
It is recommended to re-start your computer before attempting to access Ambit Optimist 8 again.
Problem
Internet Explorer displays an error page with Runtime Error and there is a
logged error referencing “portable reference folder Profile24”
Solution
This means that the .NET Portable Reference Assemblies have not been correctly installed. Please follow the
steps as described in Installation Prerequisites: Microsoft .NET Portable Library Reference Assemblies.
Problem
Before:
<add key="Password" value="" />
</appSettings>-->
<!--<system.xml.serialization>
<xmlSerializer tempFilesLocation="{FullPathToOptimistInstallation}\\App_Data"/>
</system.xml.serialization>-->
<system.webServer>
<modules runAllManagedModulesForAllRequests="true">
After:
<add key="Password" value="" />
</appSettings>-->
<system.xml.serialization>
<xmlSerializer tempFilesLocation="D:\\WebSites\\SunGard\\Optimist8\\App_Data"/>
</system.xml.serialization>
<system.webServer>
<modules runAllManagedModulesForAllRequests="true">
Problem
Problem
Performing a Third Party Import from Xero fails when connecting to the
Xero API
Performing a Web Service call fails with an error message
Solution
1. Locate the Web.Config file in the installation directory. Typically the installation directory will be
D:\WebSites\SunGard\Optimist8\.
2. Open the Web.Config file in a text editor such as Notepad. In order to edit the Web.Config file, you may
require Administrator privileges.
3. Navigate the file to locate the tag <system.net>.
4. Add a new <defaultProxy> tag, within the <system.net> tag. It should have both opening and closing
tags.
5. Add a new self-closing <proxy> tag within the <defaultProxy> tag.
6. Configure the <proxy> tag with details of a relevant internet proxy.
More information on the available options can be found at http://msdn.microsoft.com/en-
us/library/sa91de1e(v=vs.100).aspx
7. Save the changes.
Before:
<system.net>
</system.net>
After:
<system.net>
<defaultProxy>
<proxy scriptLocation="http://my.company.proxy.server/wpad.dat"/>
</defaultProxy>
</system.net>
Problem
Problem
Problem
Solution
This happens when the portfolio analysis application is not installed correctly on the server. Make sure that all the
steps in installation guide are followed correctly and the application can connect to the database using the
configuration provided.