eViewer HTML5

IBM Deployment of Viewer Component

This section details the creation and deployment of the eViewer WAR file on the IBM WebSphere. Make sure the file name of eViewer 7 is in the following format:

eViewer7.0.xx

Step 1: Use the following command to generate the war file:

jar –cvf “.war” *

For example: Open the command prompt and input the path of the location of eViewer7.0.xx file. Then the command to make it a war file.

Step 2: Access the IBM WebSphere console and log into WebSphere.

Step 3: Go to Applications and select “New Application”. Next, select the “New Enterprise Application” in order to deploy eViewer in WebSphere.

Step 4: Select the location of the eViewer7.0.01.war file and then select “Next”.

Step 5: Select the “Fast Path – Prompt only when additional information is required” option and the click “Next”.

Step 6: Add and verify the installation details for the “Application Name” and “Application Build ID” fields, then click “Next” to go to the Step 2.

Step 7: For Step 2: Map modules with server, it will show all the modules which needs to be mapped with the IBM application services. Select the eViewer7.0.01.war module and then select Next.

Step 8: Select the desired “Virtual host” from the dropdown menu and then select Next.

Step 9: Configure values for the context roots in web modules and select Next.

Step 10: Select the checkbox to enable metadata if needed and select Next.

Step 11: Confirm the details in the Summary. If the details are correct, select Finish.

Step 12: Select Save for saving the final changes and finalize the deployment.

Step 13: To confirm the deployment of the WAR file, go to Applications>Application types>WebSphere enterprise applications, eViewer7_0_01_war application should be displayed.

Step 14: You can start the application by clicking the “Start” button.

IBM Deployment of server component

This section details the creation and deployment of the eViewer Server WAR file on the IBM WebSphere.

Step 1:

jar –cvf “eViewerServer-0.0.1.war” *

Open the command prompt and navigate to the path of the eViewer7 folder. The enter in the command to generate a war file. For example:

Step 2: Access the IBM WebSphere console and log into WebSphere.

Step 3: Go to Applications and select “New Application”. Next, select the “New Enterprise Application” in order to deploy eViewer in WebSphere.

Step 4: Select the eViewerServer-0.0.1.war file from the folder and select Next.

Step 5: Add and verify the installation details for the “Application Name” and “Application Build ID” fields, then click “Next” to go to the Step 2.

Step 6: For Step 2: Map modules with server, it will show all the modules which needs to be mapped with the IBM application services. Select the eViewerServer-0.0.1.war module and then select Next.

Step 7: Select the desired “Virtual host” from the dropdown menu and then select Next.

Step 8: Configure values for the context roots in web modules and select Next.

Step 9: Select the checkbox to enable metadata if needed and select Next.

Step 10: Confirm the details in the Summary. If the details are correct, select Finish.

Step 11: Select Save for saving the final changes and finalize the deployment.
Step 12: To confirm the deployment of the WAR file, go to Applications>Application types>WebSphere enterprise applications, eViewerServer_0_0_1_war application should be displayed.

Step 13: You can start the application by clicking the “Start” button.

Apache Tomcat Deployment on Windows Server

This section describes the installation of the eViewer 7 viewer as well as server component on the Apache Tomcat application server.

Step 1: For deploying eViewer 7 on Apache Tomcat server, place the complete eViewer folders, eViewer7.0.01 and eViewerServer-0.0.1, and the corresponding WAR files in the Tomcat webapps folder.

Step 2: Navigate to the bin folder of the Apache Tomcat service and then click on the Tomcat(xx).exe file to launch.

Step 3: A dialogue box will appear through which the service can be started by clicking the Start button.

Step 4: Service manager is attempting to start the following service and automatically deploy the WAR files.

Configuring IBM CM8 Connector

eViewer server connector using IBM Java CM8 beans would search for “cmbicmsrvs.ini” and other supporting “.INI” files which are deployed with the IBM Content Manager 8 pClient/eClient or ICN installation.
Step 1: The path to the connectors folder needs to be pointed within eViewer server component deployment.

Step 2: The “Connectors” folder consists of multiple files for configuration settings of IBM CM8 with eViewer 7. IBM CM8 reads the file “cmbicmsrvs.ini” at runtime.

Step 3: Go to the eViewer 7 application server folder, and locate the property file named cmbcmenv.properties. Open the file in an editor application.

Step 4: The cmbcmenv.properties file contains the concrete path of the “connectors” folder for making the connection between the CM8 application with eViewer 7.

Step 5: Set the values in the application property file for making connection with IBM CM8 and save.

IBM Content Navigator

Deployment Steps

This guide provides the comprehensive information on how to manually deploy MST ICN Viewer Plugin in IBM Content Navigator. This guide is designed to assist you with the installation process and provide you the information on the procedure involved. Before installing, we recommend you to thoroughly read the guide.

This guide provides the comprehensive information on how to manually deploy MST ICN Viewer Plugin in IBM Content Navigator. This guide is designed to assist you with the installation process and provide you the information on the procedure involved. Before installing, we recommend you to thoroughly read the guide.

Perform the following Steps to deploy the plugin:

1. Unzip the jar file.
2. The jar will contain the eViewer folder with eViewer7icn.jar file.
3. Copy and paste the eViewer folder in the installed folder of IBM WebSphere.
   For example, …navigator.earnavigator.warplugins

Loading Plug-in

Perform the following Steps to load the eViewer plug-in into IBM Content Navigator.

• Log into IBM Content Navigator
• Click Plug-ins from the left menu
  
• Select New Plug-in.
  
• Enter the path of the plug-in jar in the JAR file path and select “Load”.
  i.e.: http://192.168.10.176:9080/navigator/plugins/eViewer7/bin/eViewer7icn.jar
  
• Provide the required details.
  

Required details:

• serverContext: The context root name of eViewer application deployed over the application server. If installed using Auto Installer, the default name is “MSTServer”.
• viewerURL: URL to the eViewer 7. The format of the URL will be:
  <protocol>://<IPaddress>:<port number>
  For ex: http://mstsp2010:156
• viewerScriptURL: URL to the viewer.
• For .NET, the URL must be in the format:
  http://<ip_address>:<port_no>/eViewer/7/Viewer/Integration/App/Scripts.
• For Java, provide the URL same as provided in the viewerURL.
• cacheFolderPath: It must be eViewerCache for both .NET and Java installations.
• serverSocket: It must be 9090.
• overlayPath: Path where overlays are cached.
  For example, C:Overlays.
• userPreferencesasPath: It must be empty.
• Click Save and Close.
• The plug-in has been installed successfully.

Mapping the ICN plug-in

The following Steps are to map the plug-in correctly between eViewer and IBM Content Navigator.

• Select “Viewer Maps” from the left menu.
• Select “New Viewer Map”.
  
• Provide a unique name in the “Name” text box and select “New Mapping”
  
• Select the correct Repository type and Viewer options:
• Repository type: It must be Content Manager
• Viewer: Plug-in that was created earlier
  
• Select the desired MIME Types from the available list and select to move them to the selected list to be associated with eViewer and then select “OK”.
  
• Click Save and Close and the newly created mapping will get listed in the list of existing viewer maps.
  

Creating Desktops

Perform the following Steps to create the desktops:

• Select “Desktops” from the left menu.
  
• Select New Desktop.
  
• On the General tab, enter in the following details:
• Name of the new desktop.
• Select the name of the repository from the Authentication Repository drop down list.
• For Desktop Configuration, select the viewer map in the Viewer Map drop down list.
  
• Click Save and Close.
• The newly created desktop will get listed in the list of existing desktops. Note the ID of the newly created desktop for future references.

View Desktop

Open the browser and enter the URL in the below format:
<protocol_name>://<ipaddress:port_number>/navigator/?desktop=ID_of_the_newly_created_ desktop
For example: http://192.168.10.176:9080/navigator/?desktop=eViewer.
where eViewer is the ID of the newly created desktop.

Select the document to open in eViewer.

Microsoft SharePoint Add-in Deployment

Following are the Steps to configure add-in for using the Sharepoint application.

Register Add-in in Microsoft SharePoint Portal

Following are the Steps to register eViewer 7 as an add-in with SharePoint. Access the link with the specific site collection URL to register an Add-in within SharePoint.
Syntax: <site collection url>/_layouts/15/AppRegNew.aspx
Example: https://myspis.sharepoint.com/sites/imaging/_layouts/15/AppRegNew.aspx

The information needs to be provided by the admin for the registration process:

• Client Id: 54:6eba60-7951-4:f39-915a-c9673668d2b2
• Client Secret Key: pz/xyCUY/O8EywiH0o+Kwz0e4:cMXiK4:ZTxb7hE03SJc=
• Title: eViewer7SPAddInWeb
• App Domain:
  • Syntax: .azurewebsites.net
  • Example: eviewerspaddinweb.azurewebsites.net
• Redirect URL:
  • Syntax: https://.azurewebsites.net/Pages/eViewer.aspx
  • Example: https://eviewerspaddinweb.azurewebsites.net/Pages/eViewer.aspx
• Click “Create” to complete the add-in process.

Microsoft SharePoint Provider Hosted Add-in

Following are the Steps to install add-in for using SharePoint application.

• Login into the Microsoft Office 365 portal using valid credentials.
  
• Navigate to SharePoint’s dashboard and open the App Launcher.
  
• Select the “Admin” option.
  
• The “Microsoft 365 admin center’ will open in another tab of the browser. Select the “SharePoint” option under the “Admin centers” section.
  
• The “SharePoint admin center” will open in another tab, go to the “More features” option and select the “Apps” option by clicking on “Open”.
  
• Click on “App Catalog”.
  
• Go to “Apps for SharePoint” and then click on “Upload”.
  
• Select “eViewerSPAddIn.app” from the app folder and select “OK” to publish it.
  
  
• Now go to the SharePoint dashboard again. It can have multiple sites.
  
• Open the desired site and select “Site contents” from the menu list. Then click on “New” and choose “App” for adding it.
  
• Go to “From Your Organization” and select the “eViewer7SPAddIn.app” and select “Install”.
  

View Documents in SharePoint

Open SharePoint portal, go to the document library and select the required document, select “Launch Document with eViewer 7” from the document menu options to view a file with eViewer.