Agile Autovue

Posted on by



Last updated on APRIL 28, 2020

Applies to:

Oracle Agile PLM Framework - Version 9.3.6.0 and later
Oracle Autovue for Agile Product Lifecycle Management - Version 21.0.1 and later

With AutoVue for Agile Enterprise Visualization Solutions, visual decision-making can be made available across an enterprise and its product life cycles. For example, asset data from an engineering team can be used by field service staff in their onsite activities of maintenance and repair. Part Number Link Download Description F1111201: HTML: Download (16.3 MB): Oracle AutoVue Online Documentation Library Release 21.0.2: AutoVue Client/Server Deployment AutoVue Desktop Deployment AutoVue Integration SDK AutoVue Web Services. Important Note: Before beginning your upgrade to Agile PLM 9.3.5, please review the Capacity Planning Guide and release readme. If you are using any of the Agile PLM compatible products (e.g. OPLA, AutoVue, EC MCAD, EC ECAD, PLM Mobile, etc.), you MUST wait for the compatible product to also be available.


Information in this document applies to any platform.

Goal

Actual Behavior
When using OHS12.2.1.2, getting following behavior :
1. Attachment file upload / download now working. For example when trying to download attachment file, download does not finish and just stalls.
2. Getting Error: ' The AutoVue client did not start successfully. Please ensure that the server is running and the generated JNLP is launched. You can
contact the system administrator for extending the delay required before assuming AutoVue startup failure' when try to launch autovue for agile via
web client when clicking attachment file.

Below is machine configuration. Oracle HTTP Server is installed on same machine as Agile Application server.

(1) Application Server (machine 1)

Oracle DB 12.1.0.2.0
Weblogic Server (Oracle FMW 12.2.1.1.0)
Oracle Agile PLM 9.3.6.2 (Application Server)
Oracle HTTP Server (12.2.1.2.0)

(2) File Manager Server (machine 2)

Oracle Agile PLM 9.3.6.2 (File Manager)
Oracle AutoVue for Agile 21.0.1.0.0

What is working

When using OHS12.2.1.3, file upload / file download and Autovue client will launch without any issue.

Steps

  1. Install OHS12.2.1.3 on machine 1 and check attachment file upload/download and Autovue client launching without issues
  2. On the same machine 1, uninstall OHS12.2.1.3
  3. Restart server
  4. Install OHS12.2.1.2 and modify httpd.conf
  5. Now on OHS12.2.1.2 instance check attachment file upload/download. Cannot upload and download. AutoVue client does not launch.

Solution

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
Goal
Solution
References


My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.

This section details additional configurations that can be made to your installation of AutoVue for Agile PLM.

Security

During the viewing process, documents available for viewing are rendered on AutoVue for Agile PLM, and an intelligent and displayable data stream is delivered to the client. In this way, the AutoVue for Agile PLM implementation eliminates any concerns about security since the original document is not transferred to the client computer. While the viewable data is being transmitted, AutoVue for Agile PLM uses compression and streaming algorithms to achieve a quick and responsive feedback to the client side for large and multi-page documents.

The server has complete control over the functions available to clients. For example, users may be granted or denied rights to perform printing, redlining, or any other functions depending on their access permissions.

AutoVue for Agile PLM uses cookies to track the number of users. The cookie is a unique number assigned to each browser that defines a user as a single session, regardless of the number of files a user consecutively or simultaneously opens.


Note:

If you disable or refuse cookies in your browser, AutoVue for Agile PLM will continue to work. However, each new instance of the browser creates a new session in AutoVue for Agile PLM.

HTTPS can be used for secure communications if you tunnel all communications between the viewer client and the server through HTTPS, which uses SSL. The applet must communicate with the AutoVue server through the AutoVue for Agile PLM servlet and any Agile PLM communications that are tunneled are encrypted.

Starting AutoVue Server on Windows

Following is the procedure to start the AutoVue server on Windows:

  1. Start the AutoVue server in the Oracle AutoVue Program Manager group.

    By default, when the server is started, the console is displayed and the server appears in the system tray.

    When you start the server as a service, you may not see the server console. To display the console, run the following command from the <AutoVue Install Root>bin directory:


    Note:

    The AutoVue server starts up with a default ProcessPoolSize of 4. To modify the ProcessPoolSize, set the jvueserver.processPoolSize parameter in jvueserver.properties.

  2. Start the application server and then start the File Manager.


Note:

For information on starting AutoVue as a service, refer to Running the AutoVue Server as a Service.

Starting AutoVue Server on Linux

Following is the procedure to start the AutoVue server on Linux:

  1. Start the AutoVue server by entering the following:

    This starts up the server console as long as the DISPLAY environment variable is properly set.

    When you start the server as a service, or when the DISPLAY environment variable is not set properly, you will not see the server console. To display the console, run the following command from the <AutoVue Install Root>/bin directory:


    Note:

    The AutoVue server starts up with a default ProcessPoolSize of 4. To modify the ProcessPoolSize, set the jvueserver.processPoolSize parameter in jvueserver.properties. Refer to Chapter A, 'Configuring AutoVue for Agile PLM' for more information.

  2. Start the application server and then start the File Manager.

  3. The startup script for the AutoVue server on Linux OSes also starts up the Xvfb server. Xvfb is an X11 virtual framebuffer that helps the AutoVue server render files. The Xvfb server runs on port 909 by default. To modify this port and configure other Xvfb properties, open jvueserver.properties (located in the <AutoVue Install Root>/bin directory) and locate property names containing 'xvfb'.

    If you want the AutoVue server to continue running after you close the terminal window, or after you log out of the Linux machine, you must exit the shell (console window) used to start the AutoVue server before logging out of Linux. The server continues running even after you log off. To exit the shell, you must enter exit (do not exit by clicking the Close button).


    Note:

    For information on starting AutoVue as a service, refer to Running the AutoVue Server as a Service.

Shutting Down the AutoVue Server

To shut down the AutoVue server, click Shutdown on the AutoVue server console. You can also shut down the AutoVue server through the command-line interface by entering the following command:

If you are running the AutoVue server as a service, you must shut it down as you would any service.

Running the AutoVue Server as a Service

When running the AutoVue server as a service, you must run it as a named user and not as Local System Account, as the local system account has more privileges than a named account.

On Windows OSes

The AutoVue server can be run as a Windows Service. The advantage of this is that it continues to run even after you log off of Windows. Before running the AutoVue server, first verify that it runs properly in 'non-service' mode (for example, run by clicking the Start AutoVue Server button in the Start menu).

To install the service, go to the bin folder of the directory where you installed the AutoVue server and enter the following:

where <user information> is in the form 'domainusername password'. This ensures that the AutoVue server service runs as a named user instead of the local system account.

Note that the user account information entered must be registered in the Log on as a service local security policy. If the user information is not there, the Oracle AutoVue service will not start. To check or edit the security policy, perform the following steps:

  1. Open the Windows Control Panel.

  2. Double-click Administrative Tools.

  3. Double-click Local Security Policy. The Local Security Settings window appears.

  4. Expand Local Policies and then select User Rights Assignment.

  5. Double-click Log on as service. The Log on as a service Properties window opens.

  6. Verify that the user account is listed under the Local Security Setting tab. If not, click Add User or Group to add the user account information.

To remove the service, go to the <AutoVue Install Root>bin directory and enter the following: Starting and Stopping the Service

Starting and Stopping the Service

  1. In the Control Panel select Administrative Tools > Services.

  2. Select the Oracle AutoVue Server service.

  3. Click Startup.

  4. Select whether you want the service started automatically on re-boot or manually. The default is Manual.

  5. If you select Manual, you can start the service by doing one of the following:

    • Click Start in the Services dialog

      or

    • Use the sc.exe utility.

      For example: SC start 'Oracle AutoVue Server'

      or

    • Use the NET program.

      For example: NET start 'Oracle AutoVue Server'

To shutdown the service, select the Oracle AutoVue Server service in the Services dialog and click Shutdown.

On Linux OSes

Oracle provides an RC-Script to manage the AutoVue server on Linux. The AutoVue server can be configured to startup automatically when the machine is restarted by following these steps:

  1. Edit file <AutoVue Install Root>/etc/jvueserver_rc and locate the following lines:

  1. Replace $USER_INSTALL_DIR$ with the path to AutoVue installation and __JVUEUSER__ with the name of the user that will be running the AutoVue server.

  2. Rename jvueserver_rc to autovue.

  3. Login as a root and copy autovue to /etc/init.d folder.

  4. As root, go to the /etc/init.d folder and add AutoVue as a service:

  5. Configure autovue to startup automatically:

The AutoVue server now starts up automatically when the machine starts up.

To start the AutoVue service, manually, run

To stop the AutoVue service manually, run

To remove the AutoVue service, run

Testing the VueServlet


Note:

The Agile View servlet (VueServlet) is packaged and deployed as part of the File Manager installation. The VueLink Servlet is deployed on the File Manager and tunnels the requests to the Agile PLM Application Server using HTTP protocol. No additional configuration is required.

The VueServlet is used to access the AutoVue server across firewalls from external clients on standard HTTP/HTTPS ports.

You must ensure that the VueServlet has been loaded successfully and that the VueServlet communicates with the AutoVue server. Open a browser and type the following URL in the address bar:

If this page loads, it means that the File Manager was successfully started and initialized. To view the status of the VueServlet from this page, enter the following in the address bar of the browser:

  • If you specify this URL in the browser and receive the message 'Page not found,' check the following:

    • Ensure that the AutoVue server and File Manager were started successfully.

    • Check the URLs to make sure that you are specifying the correct File Manager hostname, port and path (for example, /Filemgr/Configuration and /Filemgr/VueServlet)

Agile Autovue Programming

Managing Multiple Viewers for Load Balancing

The AutoVue server is designed to provide server scalability to support increasing demand for file viewing and markup on intranets and the Internet. It can run in a process pool on a single computer that improves the responsiveness for simultaneous connections and balances the load across a multi-CPU computer.

The default process pools four concurrent services. It is specified in the jvueserver.properties file located in the AutoVue server home folder at AGILE_HOMEAVSbin:

jvueserverx.nt.processPoolSize=4

As a general rule, you should allow approximately 50 MB for each process in the pool. A process pool size of four services requires approximately 200 MB of RAM. On a computer with 256 MB of RAM, this allows the remaining RAM to run the operating system and other services. Increasing the RAM on a computer allows you to increase the number of services using the process pool.

The system allows you to add servers to support more users while the servers are online, without restarting or disconnecting existing servers. Doubling the capacity is as simple as adding another computer. When using multiple viewers, the load can be efficiently balanced across the servers by manually directing the viewer client requests to different viewers.

Autovue

Client-Server Communications

For the AutoVue server the issue of using IP addresses for client-server communication at runtime (rather than hostnames or DNS names) is resolved because the File Manager also hosts the VueServlet. The VueServlet acts as a proxy for the AutoVue server, and it is placed on the intranet with other Agile server components. In addition, since the VueServlet is running on the File Manager with an Agile Web client, the Web proxies also forward external requests to the intranet. The VueServlet comes as part of the File Manager installation.

Removing AutoVue for Agile PLM

Follow these instructions to remove AutoVue for Agile PLM.

To remove AutoVue for Agile PLM on Windows:

  1. Stop the AutoVue service.

    1. Open the Services dialog box.

    2. Select AutoVue Server and stop the service.

    3. Close the Services dialog box.

  2. Choose to Start > Settings > Control Panel.

  3. Double-click Add/Remove Programs.

    The Add/Remove Programs Properties dialog appears.

  4. Scroll down the window and select AutoVue for Agile PLM.

  5. Click Change/Remove.

  6. Click Uninstall, and click OK to confirm the deletion.

  7. Click Exit.

To remove AutoVue for Agile PLM from the Start menu:

  1. Choose Start > All Programs > AutoVue for Agile PLM > Setup > Uninstall AutoVue.

  2. Select and delete the installation folders from the location of Agile home directory.

Agile Autoview

To remove AutoVue for Agile PLM on Linux:

Agile Autovue

  1. Stop the AutoVue server by clicking Shutdown on the View Server applet or killing the jvueserver process.

  2. Go to the VIEWER_HOME/AVS/_uninst directory.

  3. Run the uninstall_linux2.bin file to uninstall AutoVue for Agile PLM.