[[[start#iview | Up To Index ]]] ====== iView 8 Setup ====== iView version 8 is significantly different than it's previous versions offering many enhancements. ===== Installation and Configuration ===== iView is comprised of two parts: The **iView front end running on Tomcat Server (version 5.x or above)**, and the **back end running on the IBMi (V6R1 or above)**. ==== Front end - Apache Tomcat ==== ==Download iView WAR file== The iView front end is typically provided in a war file. Download this file to your home directory in the IFS using **binary** file transfer, and then execute these commands ( populating the names with those used in your installation ). The directory /home/user is meant to refer to your user profile's home directory ==Download Tomcat distribution file== Download Tomcat 6.x from FTP site at:\\ [[ftp://ftp.informdecisions.com/iView/apache-tomcat-6.0.39.zip]]\\ and upload this file to /home/user directory

call qp2term
cd /www
ajar -x /home/download/apache-tomcat-6.0.39.zip

==Add environment variable JAVA_HOME at system level== Set JAVA_HOME environment variable: go to directory /qibm/ProdData/Java400 and choose a JDK version that you want to set for JAVA_HOME, then type command:

 
ADDENVVAR ENVVAR(JAVA_HOME) VALUE(/qopensys/QIBM/ProdData/JavaVM/xyz) LEVEL(*SYS)

With xyz is the JDK folder of the version you want to set.

 
ADDENVVAR ENVVAR(JAVA_OPTS) VALUE('-Dos400.awt.native=true -Djava.awt.headless=true -Dserver 
-Xms1536m -Xmx3072m -XX:NewSize=256m -XX:MaxNewSize=1024m -XX:PermSize=256m -XX:MaxPermSize=1024m') LEVEL(*SYS)

==Verify the availability of the ports used by Tomcat== Tomcat uses 8005, 8080, and 8009 by default among which 8080 is the default HTTP port. Enter the command NETSTATOPTION(*CNN) to verify whether the ports are in use. If port 8009 and 8080 are occupied, edit the configuration file /www/apache-tomcat-6.0.39/conf/server.xml to change default ports 8005, 8009, and 8080 to other ports which are not in used. If you have multiple Tomcat servers running on this IBM i, you will need to use different ports for these values.\\ {{:pub:iview:tomcat01.jpg?600|}} ==Change security for Tomcat folder== Type command:

 
CHGAUT OBJ('/www/apache-tomcat-6.0.39') USER(*PUBLIC) DTAAUT(*RWX) OBJAUT(*ALL) SUBTREE(*ALL)

==Root userID and Password:== Go to /www/apache-tomcat-6.0.39/conf/tomcat-users.xml And add:\\ \\ {{:pub:iview:tomcat02.jpg?600|}} ==Start Tomcat== Tomcat is installed and configured successfully. Now you can start Tomcat by using command: (Where the job queue is where you want to run Tomcat)

 
STRTOMCAT JOBQ(FMGJOBQ)

To open your web browser, enter the URL [[http://your.server.name:8080]] {{:pub:iview:tomcat03.jpg?600|}} ==Stop Tomcat== Use command **ENDTOMCAT** to stop Tomcat ==== Back end - IBMi ==== The iView back end is typically provided in a savefile. To install, upload the savefile to the IBM i and restore it with a command like this ( you will need to populate this command with the names you are using on your system ):

RSTLIB SAVLIB(IVIEW844) DEV(*SAVF) SAVF(QGPL/IVIEW844) MBROPT(*ALL) ALWOBJDIF(*ALL)

Add the iView library to the top of the library list and execute **GO IVIEW**.

 IVIEW                    iView Version 8.44 02.20.18                           
                                                             System:   DEVV6CLT 
   iView Archive Applications                                                   
      1. Work with iView Applications                        WRKIVWAPP          
      2. Work with iView Processing Log                      CALL IVRELOG       
                                                                                
   iView Server                                                                 
     10. Work with iView Servers                             WRKIVWSRV          
                                                                                
   Administrative Options                                                       
     20. Work with Administrative Menu                       GO IVIEWADM        
                                                                                
                                                                         Bottom 
 Selection                                                                      
                                                                                
                                                                                
 F1=Help   F3=Exit   F12=Cancel

==== Enter License Keys and Set Location ==== Take option 20, then press Enter to enter the permanent or temporary license provided by your account manager. iView should have 3 key components: IVIEWWEB, IVIEW1, IVIEW2. Once entered, iView is now ready to use.

  8/30/18                      inFORM Decisions                       FM0070R1  
 14:02:21                   iDocs Installation Library Set            KKRAMER   
                                                                                
 System Information                                                             
    Serial Number:  102A36R       LPAR: 2     OS/400 Release: V6R1M0            
                                                                                
 iDocs Production Information                                                   
    Product version . . . . . :                                                 
    iDocs Installation Library: FMG       Name, F4 for list                    
                                                                                
 Location settings                                                              
    Country Code . . . . . . .: US                                              
    Code Page. . . . . . . . .:    37  1-65535                                  

                                                                                
                                                                                
                                                                                
                                                                                
 Press enter to continue                                                        
 F3=Exit   F4=Prompt   F12=Cancel

Press and then **F6** to add the 3 iView License keys:

  8/30/18                       inFORM Decisions                      IMREGPS2  
 14:06:42                  Module Registration Screen                 KKRAMER   
                                                                                
                                                                                
                                                                                
                                                                                
 Module Name. . .                                                               
                                                                                
 Registration Code                                                              
                                                                                
 Status . . . . .  No license found for                                         

                                                                                
                                                                                
                                                                                
                                                                                
  F3=Exit   F10=Update   F12=Previous

Then use option 8 to set the iView location and path. Set the parameters as appropriate to your installation or upgrade and press to update. These values are stored in the data areas DSIVIEWLIB (for iView Library) and DSIVIEWDIR (for iView IFS Path).

                   Change iView Library & IFS Dir (CHGIVWLIB)                   
                                                                                
 Type choices, press Enter.                                                     
                                                                                
 iView Library  . . . . . . . . .   *SAME         Character value               
 iView IFS path . . . . . . . . .   *SAME                                       
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display 
 F24=More keys

==== Migrating Any Meta Data Files ==== If this is an upgrade, you can migrate the meta data files, configuration and license keys with the command IVCOPYDATA.

                          iView Copy Data (IVCOPYDATA)                          
                                                                                
 Type choices, press Enter.                                                     
                                                                                
 Current iView Library  . . . . .   iviewold      Character value               
 New iView Library  . . . . . . .   iview         Character value               
 Action on Metadata Files . . . .   *copy         *MOVE, *COPY, *NONE           
                                                                                
                                                                                
                                                                         Bottom 
 F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    
 F24=More keys

The use of ***MOVE** rather than ***COPY** for the meta data files may be appropriate if the meta data files are large. Note that the archived documents themselves, in the IFS, are not normally moved. You can copy them to a new location if you wished with the shell command **cp -R**. See system documentation regarding the use of that command. \\ ---- [[[start#iview | Up To Index ]]]