Managed ZIEWIN and Interoperablity

Interoperability 2.1.0.0 Configuration Introduction:

ZIEWeb v2.1.0.0 introduced interoperability between ZIEWin and ZIEWeb. This allowed ZIEWin sessions to be accessed through ZIEWeb and ZIEWeb Client after the session definitions were uploaded to the ZIE server .

Password provided during the user creation will be encrypted using AES 128-bit algorithm and will be sent to the server through the HTTP/HTTPS protocol as Json object. UID is added to the WS and BCH profile files for unique identification. Only Connection parameters are considered for the interoperability between ZIEWin and ZIEWeb Clients and vice-versa.

After the ZIEWin sessions are converted and stored in the ZIE server , any changes made to the common parameters from any of the clients will be saved on the ZIE server . These parameter changes will be available to ZIEWin users after the next login.

Steps to install:

1. Install the ZIEWeb v2.1.0.0.
2. Install the ZIEWin v2.1.0.0.

WAR File Configuration:

The interoperability executable (ZIEWeb_Interoperability.war) is available under the lib directory of the product.

For Embedded Web Server:

If the Embedded Web Server is used, by default Interoperability application is running on context root "interop”. If the user needs to change the context root, add the following parameter to the configuration file (config.properties), located in the ZIE server publish directory.

Example: InterOpContextPath=interop

The user can utilize ZIEWeb_Interoperability.war file (available under the lib directory of the product) to deploy to different application servers such as WAS/Tomcat.

For WebSphere Application Server (WAS):

1. Log in to WebSphere Application Server.
2. Go to Applications.
3. Click WebSphere enterprise applications under Application Type.
4. Select ZIEWeb_Interoperability.war file.
5. Click on Initialize parameters for servlets link under Web Module Properties section.
6. Enter the required values.

Supported Application Servers: Apache Tomcat and WAS.

Limitations

1. Only connection parameters are considered for interoperability between ZIEWin and ZIEWeb and vice-versa.
2. Session creation from ZIEWeb / ZIEWeb Client will not be converted to a ZIEWin session.

Known Issues

1. For stored ZIEWin sessions, changes to any session parameters (not only the listed parameters) from ZIEWeb / ZIEWeb Client will be overridden or set to default when there is an update from “Session Manager Online” (ZIEWin Client).
2. If there are simultaneous profile updates from any of the two clients, the most recent update will be saved as the final copy in the ZIE server .
3. Modifications done in multiple sessions (add, delete sessions, or rename) from the ZIEWeb Clients do not reflect in the ZIEWin Client.
4. Saving/renaming profiles with special characters (Ex: \ / : * ? " < > |.) in ZIEWeb/ ZIEWeb Clients will result in unexpected behavior in the ZIEWin Client.

   How to setup Managed HCL Z and I Emulator for Windows (ZIEWIN)

   HCL Z and I Emulator for Windows uses Session Manager Online dialog to provide easy access to workstation profiles and batch files on the ZIE Server. With Session Manager Online users can create or start a single or multiple sessions and or batch files. Users can create their own profile to the ZIE server and migrate existing files such as the workstation profiles (*.WS) and batch files (*.BCH) that were stored on the ZIE Server.

   This "How To" document aims to supplement additional detailed information in setting up Managed HCL Z and I Emulator for Windows (ZIEWIN) as referenced below.

   Steps to Install Using Managed: Refer to Planning to Install Z and I Emulator for Windows

   The steps provided in this document are applicable to all Windows 10 versions which are 64-bit OS level.

   Prerequisites :
   1. Download a copy of HCL Z and I Emulator for Windows 64-bit base package and HCL Z and I Emulator for Windows RP1.zip
   1. A HCL Z and I Emulator for Web server is required for the Session Manager Online to work.
   2. Create a folder (e.g. MPZiewin) in the ZIEWEB published directory.
   3. Unzip and dump the HCL Z and I Emulator for Windows RP1 contents in MPZiewin folder.
   4. Right click the MPZiewin folder > Properties > Sharing > Advance Sharing > Put a check on Share this Folder.
   5. Click OK then Close.
   6. Repeat steps 5-6 with ZIEWEB folder.
   7. Obtain the IP address of the ZIEWEB server and use it at step 2 below.
   Follow the steps below in setting up Managed HCL Z and I Emulator for Windows (ZIEWIN):

   There are two ways to input the ZIE Server configuration details. Choosing to go either way will have the same results.

   • During the ZIEWIN installation a new panel has been added.
     
     
     
   • Preferences Manager - Click on Start > HCL Z and I Emulator for Windows > Preferences > Advanced
     
     
     
     
   1. Enter the configuration parameters based on the information below:
      • Web Server URL : The URL of the Web Server from where HCL Z and I Emulator for Windows fix pack file will be downloaded for installation. Installer or fix pack will be installed on the system by "Start or Configure Sessions - Online" program.>
      • Config Server : URL of the Application Server/Embedded Server, on which interoperability module (.war file) is deployed. It can be deployed on the HOD Embedded Server or on any configured Application Server.

        Example: http://< Application Server IP >/<Configured context root of the application>

        For more details on WAR file deployment, refer to the technote <hyper-link>.

      • Config Server Port : Port number of Application Server where interoperability module (.war file) is deployed.

        Example: 9080

   2. Click OK.
   3. Open File Explorer > This PC > Map network drive. Use the IP address of the Web Server along with the folder where the HCL Z and I Emulator for Windows RP1.msi is located. E.g. \\192.168.56.102\MPZiewin
   4. Click Save.
   5. Repeat steps 4-5 with ZIEWEB folder. E.g. \\192.168.56.102\ZIEWEB
      Note: This completes configuring Managed HCL Z and I Emulator for Windows (ZIEWIN).
   6. To validate that the configuration is correct, create a new Username or use an Existing User in the Session Manager Online. Click on Start > HCL Z and I Emulator for Windows > Start or Configure sessions - Online
      
      
      
      
   Points to consider:
   • When mapping the network drive ensure that client machine and ZIEWEB server is within the same network.
   • The Session Manager Online checks for updates at startup. It is essential that HCL Z and I Emulator for Windows RP1 is in the ZIEWEB published directory.