Table of Contents

[ Up To Index ]

Installing and Upgrading iView

System Requirements

iView 6 requires V5R4 and the Php interpreter. The Php interpreter is bundled with i/OS shipped from IBM starting with version 6.1. Otherwise, it may be downloaded for free from Zend .

IBM prerequisites to install Zend are shown here: http://www-03.ibm.com/systems/i/software/php/gettingstarted.html

Installing the current ptf's for the Apache Web Server is strongly recommended.

Installation of iView 6

The installation and upgrade of iView is normally done with a support representative on the phone or webex session.

The current recommended installation consists of the iView front end version 6, and the back end version 5.

iView 6 Front End Installation

Pre-requisite: the latest Zend engine from Zend.com

Check which version of Php you are running by executing this QShell command:
/usr/local/zendsvr6/bin/php -v | grep PHP

Download the latest .phar file from the ftp server directory /iview/fullInstalls.
Choose the version built for the version of Php that you are running.
Use binary FTP for the download.

Using binary FTP again, upload the .phar file to the IBM i, to the document root of the Zend Server,
the default of which is /www/zendsvr6/htdocs.

Start QShell by typing: strqsh<enter>
Change directory to the phar file location: cd /www/zendsvr6/htdocs<enter>

Start the installation script: /usr/local/zendsvr6/bin/php <phar file name> install <enter>

Then follow the prompts. The iView installer will attempt to install both the front and back ends
of iView.

If this is a first installation, provide for greenscreen profile authorization by adding this paragraph to the Zend Server's Apache configuration file /www/zendsvr6/conf/httpd.conf 

<LocationMatch "/iview*">

  ### green screen authentication required
   PasswdFile %%SYSTEM%%
   AuthType Basic
   AuthName "i5 User Profile"
   Satisfy All
   Require valid-user

  ### establish access control
   Order deny,allow
  ### default access none
   Deny from all
  ### allow from within your lan or VPN access
  ### adjust network for your site
   Allow from 10.0.0.0/8
  ###

</LocationMatch>

Then restart the Zend Server Apache instance and access iView as: http://<your machine's IP>/iview999/
Note that the above paragraph should not be considered adequate security by itself; you should consult with your network consultants or administrator.

To set values in the iView configuration, take the link “iView Setup”. Set these global values correctly and click the “Update” button. Also upload a license file using the dialog at the top. When a server id is licensed it will show in green with the text “(licensed)” following.

Next, take the link “Manage Groups and Users” ( lower left ). At this page, you may add or update any users. Please note that this function replaces the greenscreen authorization scheme from prior releases, and that the administrator does not by default have access to an archive – he must grant himself access using this function.

When the iView Setup page and User/Group page are complete, the front end setup is complete.

To complete the back end installation, perform the following steps:

=⇒ IVIEWNEW is the name of the just installed iView library, /iview is the archive root location.

CHGDTAARA DTAARA(IVIEWNEW/DSIVIEWLIB *ALL) VALUE(IVIEWNEW) ( to set the library data area to the current library name )
CHGDTAARA DTAARA(IVIEWNEW/DSIVIEWDIR *ALL) VALUE('/iview') ( to set the archive root data area to the correct name )
MKDIR DIR('/iview') DTAAUT(*RWX) OBJAUT(*ALL) ( to create the archive root directory if it does not exist )

You may want to change the security on the archive root directory, depending on your security policy.

Migrating Data From Prior Releases

End all iView engines.

IVIEWOLD is the prior release library.
IVIEWNEW is the new release library.

Execute the following to migrate the archive and engine configuration: 

CPYF FROMFILE(IVIEWOLD/IVPAPPH) TOFILE(IVIEWNEW/IVPAPPH) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPAPPD) TOFILE(IVIEWNEW/IVPAPPD) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPSRVH) TOFILE(IVIEWNEW/IVPSRVH) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPSRVD) TOFILE(IVIEWNEW/IVPSRVD) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPFTPH) TOFILE(IVIEWNEW/IVPFTPH) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPNOTES) TOFILE(IVIEWNEW/IVPNOTES) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPPASSWD) TOFILE(IVIEWNEW/IVPPASSWD) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPGROUP) TOFILE(IVIEWNEW/IVPGROUP) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

CPYF FROMFILE(IVIEWOLD/IVPAUTH) TOFILE(IVIEWNEW/IVPAUTH) FROMMBR(*FIRST)
      TOMBR(*FIRST) MBROPT(*REPLACE) CRTFILE(*NO) FMTOPT(*MAP *DROP)

After copying the files above, use the greenscreen gui to press <enter> through all the archive definitions ( option 1 ) and the
engine defintions ( option 10 ) to initialize any missing defaults.

If you are migrating from version 4 or earlier, check the keywords in the engine used to identify the external spool file attributes.
These were changed, so prompt and reselect them.

You will then need to move the archive meta data tables from the old library to the new library.
Each archive will have a *FILE object of the same name in the iview library. These files contain the scraped metadata of the stored documents.
For each archive in the old library, perform the following:

MOVOBJ OBJ(IVIEWOLD/FILE) OBJTYPE(*FILE) TOLIB(IVIEWNEW)



[ Up To Index ]