Installing AutoVue Client/Server

Installing AutoVue Client/Server includes installing the AutoVue Client/Server software on a Java application server and installing the components that integrate AutoVue Client/Server with Meridian Enterprise on the Meridian web server and on the Java application server (if separate). The AutoVue Client/Server software and documentation are available on the BlueCielo FTP server. Installation also includes configuring Meridian to connect to those components when a document should be viewed.

Note

• BlueCielo product licenses include the use of AutoVue Client/Server for viewing 2D documents. Viewing 3D documents requires the installation of optional licenses (M--AV3) that are available at additional cost.
• When the Meridian Enterprise server is upgraded to a new release, also upgrade the AutoVue server at the same time. The AutoVue server software must be the same version as the JVue applet that is included in the Meridian Enterprise release.
• By default, client computers download documents to the Local Workspace when files are viewed. When configured to use AutoVue Client/Server, this does not occur unless documents are printed from the viewer in PowerUser or if the viewer window is separate from the primary client window (undocked in PowerUser or the View documents in a separate browser window option is enabled in Web Access).

The AutoVue Client/Server software includes a copy of the open source Java application server software Jetty. This is convenient if you will be deploying AutoVue Client/Server and do not have an existing Java application server on which to host AutoVue. It is also useful if you want a lightweight Java application server for desktop deployment. For convenience, the AutoVue Client/Server installation packages install Jetty support by default.

Before you begin

• Microsoft .NET Framework 3.5 SP1 is required on the web server where the BlueCielo web service is installed in this task.

To install AutoVue Client/Server:

1. Ensure that the server and client computers meet the hardware and software requirements described in the Oracle AutoVue Client/Server Deployment Installation and Configuration Guide and in the BlueCielo Meridian Enterprise Administratorʹs Guide.

2. On the computer that will be the AutoVue server, install the AutoVue 2D or AutoVue 3D server software using its respective setup program. Use the instructions for non-integrated installation in the Oracle AutoVue Client/Server Deployment Installation and Configuration Guide. The default installation options are adequate for integration with Meridian Enterprise. By default, the software is installed at C:\Oracle\AutoVue.

   Tip    These settings configure the AutoVue server as a stand-alone application that can be used outside of Meridian by opening the page at http://<ServerName>/jVue/jVue.html.

3. On the same computer, run the Meridian Enterprise setup program that contains the same AutoVue Client/Server version as the installed version of Meridian and install the Server-Based Viewing component. This will add the BlueCielo Connector to AutoVue and install a BlueCielo web service in the IIS default website. If the Meridian web server is a separate computer, run the setup program there also.

4. In Meridian Enterprise Administrator on the Meridian application server, select Web Access in the left pane. The existing web locations appear in the right pane.
5. On the Action menu, select Properties. The Web Access Properties dialog box appears.

6. Configure the options using the descriptions in the following table.

   Server-based viewing options

   Option	Description
   AutoVue Server URL	URL of the AutoVue servlet that you installed in step 2. The default is http://<ServerName>: 5098/servlet/VueServlet. You should only need to configure the server name.
   BlueCielo Connector URL	URL of the BlueCielo Connector that you installed in step 3. The default is http://<ServerName>:8900/wsclient/servlet/DMS. You should only need to configure the server name.

7. On the Meridian web server, test the web service by opening it in a browser with the following URL.

   http://<ServerName>/BCWebService/BCWebService.BluePrintService.svc

   A page titled BluePrintService Service appears if installation is correct to this point.

8. On the AutoVue server, open the file StartServers.bat in any text editor and verify that the paths are correct for your installation. By default, it is located in C:\Oracle\AutoVue\bin.

9. Start the Jetty application server, the AutoVue servlet, and the BlueCielo connector servlet by running StartServers.bat. Two Command Prompt windows and the AutoVue Server console window appear. The windows must stay open but can be minimized.

   Tip

   • To start the servers automatically when Windows boots and a user account logs on, create a shortcut to StartServers.bat in the computerʹs Startup group of the Windows Start menu. Enable the Run as administrator option in the Advanced Properties dialog box of the shortcut.
   • To start the servers automatically when Windows boots without a user account logged on, in the Local Group Policy Editor of the computer, under Computer Configuration, in Windows Settings, add StartServers.bat to the Startup script list.

10. NEW  On the desktop client (not Web Access) computers, set the registry values that are described in the following tables.

    HKEY_LOCAL_MACHINE\SOFTWARE\Cyco\AutoManager View Control2

    Value Name	Data Type	Value Data
    BluePrintWSDL	String	URL of the BlueCielo web service that you installed in step 3. For example: http://<ServerName>/BCWebService/BCWebService.BluePrintService.svc?wsdl
    DMSInfo	String	URL of the BlueCielo Connector that you installed in step 3. For example: http://<ServerName>:8900/wsclient/servlet/DMS.

    HKEY_CURRENT_USER\SOFTWARE\Cyco\AutoManager Meridian\CurrentVersion\Client\Settings

    Value Name	Data Type	Value Data
    ClientServerWebView	DWORD	If this value is 1, the client applications use the AutoVue Client/Server viewer. If this value is 0, the client applications use the locally installed viewers.

11. Users must enable the AutoVue Client/Server viewer before it will become their default viewer.

    • Web client users must enable the Use Oracle AutoVue for viewing documents option on the Preferences page in Web Access as described in theBlueCielo Meridian Enterprise Userʹs Guide.
    • Desktop client users must set the AutoVueWebViewer option first in viewer priority in the viewer options of PowerUser as described in theBlueCielo Meridian Enterprise Userʹs Guide.
12. Test AutoVue Client/Server by opening a document in Meridian Enterprise. The AutoVue applet downloads from the web server and opens the selected document.

For more information about configuring and administering AutoVue Client/Server, see the Oracle AutoVue Client/Server Deployment Installation and Configuration Guide or Oracle AutoVue Desktop Deployment Installation and Configuration Guide, accordingly.