inFORM Decisions Information Portal

User Tools

Site Tools

Trace:
pub:iview8setup

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
pub:iview8setup [2018/08/30 13:02] – [Installation and Configuration] kkramerpub:iview8setup [2018/09/05 11:13] – [Enter License Keys and Set Location] kkramer
Line 4: Line 4:
  
  
-iView version 8 is significantly different than it's previous versions. +iView version 8 is significantly different than it's previous versions offering many enhancements. 
  
 ===== Installation and Configuration ===== ===== Installation and Configuration =====
  
-Iview is comprised of two parts:  The iView front end or Tomcat Server, and the back end running on the IBMi.   +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)**. 
-Apache Tomcat is used to deploy your Java Servlets and JSPs. So in your Java project you can build your WAR (short for Web ARchive) file, and just drop it in the deploy directory in Tomcat. So basically Apache is an HTTP Server, serving HTTP. Tomcat is a Servlet and JSP Server serving Java technologies.+
  
 +==== 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
 +
 +<html><pre>
 +call qp2term
 +cd /www
 +ajar -x /home/download/apache-tomcat-6.0.39.zip
 +</pre></html>
 +
 +==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:
 +<html><pre> 
 +ADDENVVAR ENVVAR(JAVA_HOME) VALUE(/qopensys/QIBM/ProdData/JavaVM/xyz) LEVEL(*SYS)
 +</pre></html>
 +With xyz is the JDK folder of the version you want to set.
 +<html><pre> 
 +ADDENVVAR ENVVAR(JAVA_OPTS) VALUE(' -Dos400.awt.native=true -Djava.awt.headless=true -server 
 +-Xms1536m -Xmx3072m -XX:NewSize=256m -XX:MaxNewSize=1024m -XX:Perm Size=256m -XX:MaxPermSize=1024m') LEVEL(*SYS)
 +</pre></html>
 +==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:
 +<html><pre> 
 +CHGAUT OBJ('/www/apache-tomcat-6.0.39') USER(*PUBLIC) DTAAUT(*RWX) OBJAUT(*ALL) SUBTREE(*ALL)
 +</pre></html>
 +==Root userID and Password:==
 +Go to /www/apache-tomcat-6.0.39/conf/tomcat-users.xml
 +And add:\\
 + <role rolename="admin"/> \\
 + <user username="<your_user_name>" password="<your_password>" roles="manager,admin"/>
 +{{: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) 
 +<html><pre> 
 +STRTOMCAT JOBQ(FMGJOBQ)
 +</pre></html>
 +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 ): 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 ):
  
 <html><pre> <html><pre>
-RSTLIB SAVLIB(IVIEW800) DEV(*SAVF) SAVF(QGPL/IVIEW800) MBROPT(*ALL) ALWOBJDIF(*ALL)+RSTLIB SAVLIB(IVIEW844) DEV(*SAVF) SAVF(QGPL/IVIEW844) MBROPT(*ALL) ALWOBJDIF(*ALL)
 </pre></html> </pre></html>
  
Line 38: Line 90:
  F1=Help   F3=Exit   F12=Cancel  F1=Help   F3=Exit   F12=Cancel
 </pre></html> </pre></html>
 +==== 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. 
  
-Take option 20, then option 8 to set the iView location and path. Set the parameters as appropriate to your installation or upgrade and press <enter> to update. These values are stored in the data areas DSIVIEWLIB (for iView Library) and DSIVIEWDIR (for iView IFS Path).+<html><pre> 
 +  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                                                
 +</pre></html> 
 +Press <Enter> and then **F6** to add the 3 iView License keys: 
 +<html><pre> 
 +  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                                            
 +</pre></html> 
 +Then use option 8 to set the iView location and path. Set the parameters as appropriate to your installation or upgrade and press <enter> to update. These values are stored in the data areas DSIVIEWLIB (for iView Library) and DSIVIEWDIR (for iView IFS Path).
  
 <html><pre> <html><pre>
Line 57: Line 153:
  
 </pre></html> </pre></html>
- +==== Migrating Any Meta Data Files ====
-==Download Tomcat distribution file== +
-Download Tomcat 6.x from FTP site at:\\ +
- [[ftp:// ftp.informdecisions.com/ftpRoot/CustomerFTP/iView/apache-tomcat-6.0.39.zip]]\\ +
-and upload Tomcat distribution file to an IFS directory, for example /home/download. \\ +
- +
-Change your current working directory to /www then decompress Tomcat distribution file using qshell command: +
-<html><pre> +
-ajar -x /home/download/apache-tomcat-6.0.39.zip +
-</pre></html> +
-==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: +
-<html><pre>  +
-ADDENVVAR ENVVAR(JAVA_HOME) VALUE(/qopensys/QIBM/ProdData/JavaVM/xyz) LEVEL(*SYS) +
-</pre></html> +
-With xyz is the JDK folder of the version you want to set. +
-<html><pre>  +
-ADDENVVAR ENVVAR(JAVA_OPTS) VALUE(' -Dos400.awt.native=true -Djava.awt.headless=true -server  +
--Xms1536m -Xmx3072m -XX:NewSize=256m -XX:MaxNewSize=1024m -XX:Perm Size=256m -XX:MaxPermSize=1024m') LEVEL(*SYS) +
-</pre></html> +
-==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. +
-<<Insert graphic 1 here>> +
-==Change security for Tomcat folder== +
-Type command: +
-<html><pre>  +
-CHGAUT OBJ('/www/apache-tomcat-6.0.39') USER(*PUBLIC) DTAAUT(*RWX) OBJAUT(*ALL) SUBTREE(*ALL) +
-</pre></html> +
-==Root userID and Password:== +
-Go to /www/apache-tomcat-6.0.39/conf/tomcat-users.xml +
-And add:\\ +
- <role rolename="admin"/> \\ +
- <user username="<your_user_name>" password="<your_password>" roles="manager,admin"/> +
-<<Insert graphic 2 here>> +
-==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)  +
-<html><pre>  +
-STRTOMCAT JOBQ +
-</pre></html> +
-And open your web browser, enter the URL [[http://your.server.name:8080]] +
-<<Insert graphic 3 here>> +
-==Stop Tomcat==  +
-Use command **ENDTOMCAT** to stop Tomcat +
- +
- +
-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 directoryl +
- +
-<html><pre> +
-call qp2term +
-cd /home/user +
-tar -xf iView8.00-FrontEnd-Php5.4.tar +
-cd /www/zendsvr6/htdocs/iview800 +
-find . -type d -print | xargs chmod 755 +
-find . -type f -print | xargs chmod 644 +
-chmod 666 i5_def.php +
-chown -R qtmhhttp +
-</pre></html> +
- +
-You should now add the following stanza to the Apache configuration file used by the Zend Server. +
-This file is /www/zendsvr6/conf/httpd.conf. You may append this to the file: +
- +
-<html><pre> +
- &lt;LocationMatch "/iview*"&gt; +
-          PasswdFile %%SYSTEM%% +
-          AuthType Basic +
-          AuthName "i5 User Profile" +
-          Satisfy All +
-          Require valid-user +
- &lt;/LocationMatch&gt; +
- </pre></html>  +
-   +
- These statements establish browser authentication against the IBM i profile. iView will not work without user authentication. You may establish user authentication through any means that Apache will allow. +
-   +
-At this point, if your machine's IP is 192.168.0.2 you should be able to point your browser at http://192.168.0.2/iview800 and get a response. +
 If this is an upgrade, you can migrate the meta data files, configuration and license keys with the command IVCOPYDATA. If this is an upgrade, you can migrate the meta data files, configuration and license keys with the command IVCOPYDATA.
  
pub/iview8setup.txt · Last modified: 2022/06/25 17:02 by 127.0.0.1