ProjectWise Administrator Help

To Install Bentley i-model Composition Server for PDF (standard installation)

  1. Right-click the Setup_ProjectWise_Serverx64_10.00.03.2xx.exe file and select Run as administrator.

    The ProjectWise Server installer opens.

  2. Accept the license agreement, change the installation location if needed (if possible) and click Next.

    The default installation location is C:\Program Files\Bentley\ProjectWise.

    The option to change the installation location is hidden if another application from this release is already installed.

  3. On the Select server type page, select Additional Software and click Next.
  4. On the Select feature to install page, turn on Bentley i-model Composition Server for PDF and the subfeatures you want and click Next.

    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)


  5. On the Orchestration Framework Configuration page, enter the credentials of the user account that ProjectWise Orchestration Framework Service will run under, then click Next.

    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.

  6. On the 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 Next.

    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.



  7. On the Pre-installation summary page, review your selections, make any last minute changes if necessary, then click Install.


  8. When the Orchestration Framework Database Setup dialog opens, select which SQL Server database you want to use as your Orchestration Framework database and click OK.

    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.

    Left: connecting to SQL Server using an ODBC data source; Right: connecting to SQL Server using a direct database connection

    To connect using an ODBC data source:

    1. Set Connection Type to ODBC.
    2. Select the ODBC data source you created for this purpose from the ODBC Connection list.
    3. In the 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.

    4. 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.

      If the specified account is able to connect, a dialog opens with the message, TEST COMPLETED SUCCESSFULLY!!

      Once connected, the Database Status field informs you that the database pointed to by the ODBC data source needs the latest Orchestration Framework database schema.

    5. Click OK to install the latest Orchestration Framework database schema into the database.

    To use a direct database connection:

    1. Set Connection Type to Direct Database Connection.
    2. In the 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

    3. In the Database Security section, select the authentication method and account that you want to use to connect to the database.

      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.
    4. 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 database:

      Click the New button next to the Database list, then in the Create Database dialog, enter a name for the database and click OK. The database is added to SQL Server and selected in the Database list.

      or

      If you already have an empty database in SQL Server, select that database from the Database list.

      The Database Status field informs you that the selected database needs the latest Orchestration Framework database schema.

    5. Click OK to install the Orchestration Framework database schema into the selected database.
  9. When the Bentley i-model Composition Server for PDF Configuration Wizard opens, click Next.

    (The Configuration Wizard automatically finds the Orchestration Framework database you selected in the previous step.)



  10. On the Working Directory Type page opens, select whether you want to use a shared or non-shared folder for the working directory for Bentley i-model Composition Server for PDF jobs and click Next.
    • Local 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.

    • Shared 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 network.

      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.

  11. On the Working Directory page, specify the location of the working directory and click Next.

    (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).

  12. On the 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 Next.
    Tip: If you do not plan to use email notifications, or if you want to configure this information later, you can skip this page.


  13. On the Advanced Configuration Properties page, review the default settings, change any settings as needed, and click Next.
    SettingDescription
    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.

  14. On the Crash Report Consent page, select whether or not you want crash reports to be automatically sent to Bentley, then click Next.
  15. On the Configuration Type page, select Standard and click Next.


  16. On the DMS Connectors page, select the ProjectWise Connector and click Next.

    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.



  17. When the Configuration In Progress page says "Configuration is complete" (over the progress bar), click Close.


  18. Click Finish on the ProjectWise Server installer.

Note: You can rerun the Configuration Wizard any time after installation by doing the following:

  • Go to the Start page and type Bentley i-model Composition Server Configuration, or go to Start > Apps > Bentley and click Bentley i-model Composition Server Configuration.
Parent topic: Installing Bentley i-model Composition Server for PDF