To install the Viewer (to use with PrizmDoc Cloud), follow these steps:
- From the PrizmDoc Cloud portal, go to the API Documentation and scroll down to the HTML5 Document Viewing section.
- Under Integrating the Viewer, click on Download Client.
- The Pick Your Platform dialog box is displayed; select Windows and the installer downloads.
- Double-click on the PrizmDocClient-xx application file to launch the installer (where xx represents the version). Click Install PrizmDoc Client.
- Carefully read the information contained in the License Agreement form before making a decision to accept the terms of the agreement. Choose I accept the terms in the License Agreement to accept the conditions outlined in the License Agreement and then click Next to continue the installation (or click Cancel to exit the installation process).
- The Hosting Options dialog is displayed. You have two PrizmDoc Server hosting options when installing the Viewer; they are PrizmDoc Cloud and PrizmDoc Self-Hosted. For this tutorial, we are installing using a PrizmDoc Cloud server. This option is highly recommended for evaluators of PrizmDoc Viewer as it does not require running the PrizmDoc Server software on your server. The PrizmDoc Cloud option is selected by default. Click Next to continue the installation.
- The Select Features dialog is displayed. The Select Features dialog allows you to define what components of PrizmDoc Viewer you want to install:
- Sample Documents and Code – Installs the different client viewers that can be used with the PrizmDoc Viewer services and sample documents.
- Application Services - Installs the service that provides application-level logic for the Viewer, such as enabling document viewing through the PrizmDoc Server, saving and loading of markup, and handling opening of documents and creating viewing sessions.
- Configure ASP.NET Samples with IIS - This option is only available if both IIS and ASP.NET 4.0+ are present.
- Re-register ASP.net 4.0 with IIS - This option is only available if both IIS and ASP.NET 4.0+ are present.
Once you have made your selections, click Next to continue.
- If you are installing PAS, you will need to enter your PrizmDoc API key to connect to the PrizmDoc Cloud server. This key is available on the Account page (in the Accusoft Portal) and can be copied from there and pasted into API Key field below.
You will need an active internet connection on the machine you are installing the Viewer in order to validate your API key.
You will not see this screen if you are not installing PAS at this time. Additional installation and configuration may be required:
- You may need to configure one of the Viewer samples to use an existing installation of PAS.
- You may need to install and configure PAS with your API key to connect to the PrizmDoc Cloud server. See the PAS Configuration topic for more information.
Enter your API key into the text field provided. Click Next to verify your API key and continue the installation.
- The Installation Path dialog is displayed. Specify the destination directory where the Viewer should be installed, or choose the default installation destination directory, then click Next.
- The Account Information dialog is displayed. Here you define the account that will be used to run PAS that is installed on the system. The Account Information dialog will default to the user running the installation, but you can enter a user name or use the Browse button to select a user from the local system or domain. Once a user has been selected, enter the password for the user account into the dialog.
During installation, when specifying a login account for PAS, you MUST choose a user which has administrative privileges. Otherwise, the installation will fail.
- Once you have entered in all of the appropriate information, click Install to continue. (If the password is not correct an error dialog will be displayed noting that the password is not correct.) The Installation dialog is displayed with a progress bar.
The Installer will unpack the product, and lay out and configure the product as defined in the configuration dialogs. While PrizmDoc Viewer is installing, you can look at the Release Notes, Online Demos, or Code Examples from the links provided.
- Once the installation is complete, the Installation Complete dialog is displayed.
There are links to the Documentation, product Release Notes, as well as a How to Migrate topic if you wish to view them directly after the installation. There will also be an option to launch the locally installed demo in your default browser.
The option to launch the local demo is only available if all of the following occurred:
- Sample Documents and Code were installed.
- The Samples were configured and re-registered with IIS.
- PAS was installed.
- Click Finish to exit the Installer.
- Go to Check the Connection to PrizmDoc Cloud for instructions on verifying that your installation of the Viewer is able to contact the back-end services.