To Install Bentley i-model Composition Server for PDF (standard installation)
file and select
Run as administrator.
The ProjectWise Server installer opens.
Accept the license agreement, change the installation location if
needed (if possible) and click
The option to change the installation location is hidden if another application from this release is already installed.
- On the Select server type page, select Additional Software and click Next.
Select feature to install page, turn on
Bentley i-model Composition Server for PDF and
the subfeatures you want and click
The following items can be installed:
- IIS Web Service for Bentley i-model Composition Server for PDF (required for ProjectWise Explorer jobs)
- Bentley i-model Composition Server Administrator (installs Orchestration Framework Administrator with the Bentley i-model Composition Server for PDF extension; required to configure batch rendition jobs)
Orchestration Framework Configuration page,
enter the credentials of the user account that
ProjectWise Orchestration Framework Service
will run under, then click
This should be the same user account you set up in the procedure, Configuration Checklist for Bentley i-model Composition Server for PDF. If the user is a Windows account, enter the name of the domain to which the user belongs in the Domain Name field. If the user is a local account, enter the user’s computer name in the Domain Name field.
Bentley i-model Composition Server for PDF
Configuration page (which opens if you selected to install the
IIS Web Service for Bentley i-model Server for
PDF feature), select the IIS website (for example,
Default Web Site) on this computer that you
want to deploy the service to and click
If, for testing purposes, you have already deployed another Bentley application to IIS, then make sure you select a different website to deploy this web service to.
If the list of websites is blank, it is possible that you did not use Run as administrator to launch this installer.
- On the Pre-installation summary page, review your selections, make any last minute changes if necessary, then click Install.
Orchestration Framework Database
Setup dialog opens, select which SQL Server database you want to use
Orchestration Framework database and click
You can connect to the selected database using either an ODBC data source or a direct database connection. Using an ODBC connection assumes that you have already created an empty database in SQL Server, and that you have already created a 64-bit ODBC data source on this computer that connects to the empty database in SQL Server. If you are going to use a direct database connection, either you can create the empty database in SQL Server before installing this server, or you can use the Orchestration Framework Database Setup dialog to create a new database in SQL Server.
To connect using an ODBC data source:
- Set Connection Type to ODBC.
- Select the ODBC data source you created for this purpose from the ODBC Connection list.
Database Security section, select the same
authentication method that you configured the selected ODBC data source to use.
If you select Use Windows authentication, you must already be logged in with a Windows account that is able to log in to the database that the ODBC data source points to.
If you select Use SQL Server authentication, enter the User name and Password of the SQL Server account that the ODBC data source is configured to log in to the database with.
- Click Test Data Source to make sure the specified Windows or SQL Server account can connect to the selected ODBC data source, and ultimately, the SQL Server database.
- Click OK to install the latest Orchestration Framework database schema into the database.
To use a direct database connection:
- Set Connection Type to Direct Database Connection.
Database Server field, enter name of the
computer where SQL Server is installed.
This field defaults to the local computer name. If your SQL Server installation has named instances, enter the name of the computer, followed by a backslash, followed by the SQL Server instance name you want to connect to. For example: computername\SQLServerinstancename
Database Security section, select the
authentication method and account that you want to use to connect to the
The account you specify here must be the same account you specified on the Orchestration Framework Configuration page of this server installer.
If you select Use Windows authentication, you must already be logged in with a Windows account that is able to log in to the specified SQL Server instance.
If you select Use SQL Server authentication, enter the User name and Password of a SQL Server account that is able to log in to the specified SQL Server instance.Tip: To quickly verify that the specified account can connect to SQL Server, try to select the Database list. If connection is successful, the list will be populated with databases. If connection is not successful, you will get an error and the list will be empty. If that is the case, one of the following may be true:
- The service for the specified SQL Server instance may not be running. Make sure that it is running, then try again.
- The SQL Server computer name specified, or instance name, or both, may be incorrect. Make sure you typed the names correctly, then try again.
- The account you are trying to use does not exist in SQL Server. Make sure this account (whether local or Windows) exists in SQL Server with appropriate database permissions, then try again.
Once you have established a connection to SQL Server, the next
step is to either create a new database in it, or select an existing empty
- Click OK to install the Orchestration Framework database schema into the selected database.
Bentley i-model Composition Server for PDF
Configuration Wizard opens, click
(The Configuration Wizard automatically finds the Orchestration Framework database you selected in the previous step.)
Working Directory Type page opens, select
whether you want to use a shared or non-shared folder for the working directory
Bentley i-model Composition Server for PDF
jobs and click
working directory - Select this option if you want to use a local,
non-shared folder for the working directory.
This option requires that Bentley i-model Composition Server for PDF and Bentley i-model Composition Server Administrator are both be installed on the same computer.
working directory - Select this option if you want to use a shared
folder for the working directory located on this or another computer in the
Use this option if you need to install Bentley i-model Composition Server for PDF on multiple computers, or if you need to install Bentley i-model Composition Server for PDF and Bentley i-model Composition Server Administrator on separate computers.
- Local working directory - Select this option if you want to use a local, non-shared folder for the working directory.
page, specify the location of the working directory and
(If you have not yet created and shared the folder you want to use for the working directory, do so now before continuing.)
You can either type the location of the working directory in the field provided, or click the Browse button to locate and select the working directory folder. When typing the path to a local, non-shared folder, use the local file system path (C:\ics_localworkdir).
When typing the path to a shared folder, use the UNC path (\\computername\ics_sharedworkdir).
ProjectWise User Credentials page, enter user
name and password of the
ProjectWise user account whose working directory
will be used by
ProjectWise InterPlot Organizer to copy out any
managed workspace files and click
Whenever a user runs a rendition job from ProjectWise Explorer, ProjectWise InterPlot Organizer will use the ProjectWise working directory of the user specified here, for the purpose of downloading managed configuration / workspace files. The user you specify here does not need to exist now, but it must exist by the time your users begin running jobs in ProjectWise Explorer.
Email Server page, specify information about
the email server that will be used to send automatic email notifications when
rendition jobs are complete, and click
Tip: If you do not plan to use email notifications, or if you want to configure this information later, you can skip this page.
Advanced Configuration Properties page, review
the default settings, change any settings as needed, and click
Setting Description Cache Orchestration Routing Table If True (default), the graph that displays how the dispatchers and processors in the Bentley i-model Composition Server for PDF orchestration instance are linked together is cached when each process starts and any changes made thereafter inside Orchestration Framework Administrator are not made effective until the process is restarted. Caching the routing table improves performance. Preventing caching may be appropriate on multi-server clusters when the orchestration needs to be changed often and high job volume makes restarting the ProjectWise Orchestration Framework Service(s) problematic. Delete Job Folder on Completion If True, the job folder under the Bentley i-model Composition Server for PDF working directory is always deleted after the job completes. This reduces the storage space requirements on the server but forces all references to be re-extracted during incremental job runs. Deleting the job working folder also prevents ProjectWise delta file transfer optimization.
The job working folder is always deleted for jobs submitted from ProjectWise Explorer. This property only affects the behavior of stored jobs.
Saving the contents of the job working folder between stored job runs may significantly improve performance depending on the number and size of the extracted documents. Setting this property to True may be desired if storage space on the server is limited, if security of the Bentley i-model Composition Server for PDF working directory is a concern, or if the job input set changes frequently or does not contain many large shared references.
The default is False.
Enable Progressive Input Processing If True (default), processing of documents may begin before the input scan is complete. This improves performance especially in incremental job situations where the number of documents requiring processing is small compared to the total size of the input set. The downside is that the job monitor in Orchestration Framework Administrator cannot display accurate progress bars until the input set scan is complete, a period which may encompass almost the entire duration of the job run. Enable Rendition Failure Retry If True (default), in the event of an error during rendition creation, Bentley i-model Composition Server for PDF silently re-attempts the operation once without reporting an error. If this property is set to False , jobs with renditions failing due to legitimate, reproducible errors will end quicker improving throughput. Enable Shortest Queue Detection If True (default), and the orchestration instance has more than one of a particular processor installed, the dispatcher will send messages to the processor that has the fewest messages in its queue. When set to False, the system uses a simple algorithm to determine which processor to send the message to. Enable Datasource Config via Web If True (default), a subset of the Configuration tree in iCS for PDF Administrator is available when using a web connection. Specifically, the ProjectWise datasource credentials and iCS for PDF advanced configuration dialogs. Otherwise, no items under the Configuration tree are visible to a web-connected administrator. Input Set Limit Sets the maximum number of documents in an input set that will be processed. If set to 0 (default), then there is no limit on the number of documents that will be processed. Max Renditions Before Restart Sets the maximum number of renditions in a job that an InterPlot processor will create using a single ProjectWise InterPlot Organizer process. If set to 0 (default), then there is no limit on the number of renditions that the InterPlot processor will create.
Setting a value for this property forces the InterPlot processor to stop and restart its ProjectWise InterPlot Organizer worker process whenever the job rendition limit is exceeded. While this may reduce performance, it may also reduce the chance of failure when creating large numbers of renditions within a single job.
Save Email XML Logs If True, an XML file is saved on the server containing all the information used to build the job email notification message body. Bentley i-model Composition Server for PDF never deletes these XML files, so you must manually delete them if you no longer need them.
The default is False.
Email Log Folder If saving of email notification XML files is enabled, this setting specifies the folder on the server where the XML files are written. If this folder is undefined and XML files are created, the location is C:\ProgramData\Bentley\Bentley iCS for PDF\EmailLogs.
The default is undefined.
InterPlot Printer Name If defined, this setting overrides the name of the Windows printer on the server used by ProjectWise InterPlot Organizer when creating renditions. The printer name is normally specified by the IP_DCS_RENDITION_PRINTER configuration variable in IP.CFG to be "ProjectWise Dynamic Composition Server".
The default is undefined.
- On the Crash Report Consent page, select whether or not you want crash reports to be automatically sent to Bentley, then click Next.
- On the Configuration Type page, select Standard and click Next.
DMS Connectors page, select the
ProjectWise Connector and click
As delivered, Bentley i-model Composition Server for PDF only delivers one connector — the ProjectWise Connector. This connector is selected by default, and is required to store the newly created rendition documents in the same or other datasource.
- When the Configuration In Progress page says "Configuration is complete" (over the progress bar), click Close.
- Click Finish on the ProjectWise Server installer.