pub:installation
Differences
This shows you the differences between two versions of the page.
Previous revision | |||
— | pub:installation [2022/06/25 17:02] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Installation ====== | ||
+ | < | ||
+ | [[softwareoverview | Prior Topic - Software Overview ]]< | ||
+ | |||
+ | ===== Media ===== | ||
+ | |||
+ | iDocs is available via **web download** from inFORM Decisions’ web site | ||
+ | [[http:// | ||
+ | The [[http:// | ||
+ | and update procedure is recommended as the most efficient method to receive the latest and greatest version from inFORM. | ||
+ | |||
+ | |||
+ | ===== Environment ===== | ||
+ | |||
+ | iDocs 4.02 requires **V5R2**. < | ||
+ | iDocs 5.00 requires **V5R4**. | ||
+ | |||
+ | Access to the iSeries IFS shared folders will be necessary. | ||
+ | |||
+ | inFORM software products may be used with virtually any laser printer with HP compatibility. Specifically, | ||
+ | |||
+ | ===== Installation Instructions ===== | ||
+ | |||
+ | ==== Upgrading From Older Releases ==== | ||
+ | |||
+ | If you are upgrading from a release of iDocs prior to version 4.0 you will need to obtain | ||
+ | |||
+ | **DSPSYSVAL QSRLNBR** | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Installation From The Web ==== | ||
+ | |||
+ | Connect to our web site at http:// | ||
+ | Select the link Software Downloads and Updates, and on the proceeding page select iDocs (iCHECKS included). Lastly, select the ‘Download Software’ button associated with the iDocs Suite. | ||
+ | |||
+ | Save the file to your Windows Desktop. | ||
+ | |||
+ | Create the library on your i5/iSeries called IDOCSSETUP: **CRTLIB IDOCSSETUP** | ||
+ | |||
+ | Unpack the downloaded archive IDOCSSAVF.ZIP (**the name varies**) to a directory on your C: drive called C:\IDOCS. From the window’s screen select start, run and type ‘COMMAND’ in the run window. Change to the IDOCS subdirectory: | ||
+ | The archive contains a .SAVF file, the i5 savlib file. **This file may be named variously depending on the release.** It is referred to in this article as idocssavf.savf or the savefile IDOCSSAVF. | ||
+ | |||
+ | Upload this file to your System i server. | ||
+ | |||
+ | Issue the following command to ensure that the IBM i FTP server is currently running: | ||
+ | |||
+ | PC file name: c: | ||
+ | i5/OS savefile name: idocssetup/ | ||
+ | |||
+ | First - create the savefile on the IBM i: **CRTSAVF IDOCSSETUP/ | ||
+ | |||
+ | Second - upload the pc file into the i5 savefile: | ||
+ | |||
+ | < | ||
+ | C: | ||
+ | ftp> open system name or ip address | ||
+ | ftp> (user) qsecofr | ||
+ | ftp> (password) password | ||
+ | ftp> binary | ||
+ | ftp> quote site namefmt 1 | ||
+ | ftp> cd / | ||
+ | ftp> put c: | ||
+ | ftp> quit | ||
+ | </ | ||
+ | |||
+ | |||
+ | Log on your System i server as QSECOFR. | ||
+ | |||
+ | If upgrading: | ||
+ | |||
+ | * End all engines. | ||
+ | |||
+ | * Use **WRKOBJLCK OBJ(FMG) OBJTYPE(*LIB)** to view object locks on FMG. End all jobs and remove FMG from all user library lists. | ||
+ | |||
+ | If you have an existing library FMGOLD, you must rename or delete it. The iDocs file upgrade routine (COPYDATA) presumes that the prior iDocs version be in a library named FMGOLD: | ||
+ | |||
+ | * **WRKLIB FMG*** | ||
+ | * Use **RNMOBJ OBJ(FMGOLD) OBJTYPE(*LIB) NEWOBJ(FMGOLD1)** | ||
+ | * Use **DLTLIB LIB(FMGOLD)** to delete FMGOLD. | ||
+ | |||
+ | |||
+ | Rename your __current__ production version of iDocs: **RNMOBJ OBJ(FMG) OBJTYPE(*LIB) NEWOBJ(FMGOLD)** | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Restore Instructions for Specific Releases ==== | ||
+ | |||
+ | === iDocs Release 5.00 (Obsolete, see 5.02/ | ||
+ | |||
+ | Restore the new version:\\ | ||
+ | | ||
+ | |||
+ | Two objects will not restore from the save file. This is normal and is no concern. | ||
+ | < | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | |||
+ | Restored 2063 objects from FMG to FMG, 2 not restored, 0 excluded | ||
+ | </ | ||
+ | |||
+ | |||
+ | **Installing Fix Packs** - Starting with iDocs 5.0, inFORM Decisions releases cumulative fix packages. These may be found on the ftp server ftp.informdecisions.com, | ||
+ | |||
+ | **iDocs5.00-CumulativePatches-2009.03.11-1501.zip** | ||
+ | |||
+ | The above example being the cumulative patch file built on March 11th, 2009 at 3:01pm. | ||
+ | * Unpack the downloaded PTF500.ZIP (the name varies) to a directory on your C: drive called C:\IDOCS. | ||
+ | * To install do the following: | ||
+ | < | ||
+ | CRTSAVF QGPL/ | ||
+ | </ | ||
+ | * Upload to library QGPL using binary FTP | ||
+ | < | ||
+ | C: | ||
+ | ftp> open system name or ip address | ||
+ | ftp> (user) qsecofr | ||
+ | ftp> (password) password | ||
+ | ftp> binary | ||
+ | ftp> quote site namefmt 1 | ||
+ | ftp> cd / | ||
+ | ftp> put c: | ||
+ | ftp> quit | ||
+ | </ | ||
+ | * then follow the insructions in the readme.txt file included with the ptf file download. The restore instructions differ per version. | ||
+ | |||
+ | Make certain that the iDocs library (FMG) is the first library in the library list that contains copies of the iDocs files, i.e. make certain that there are not older versions or copies of iDocs above the main iDocs library in the library list. Use **DSPLIBL** to confirm. | ||
+ | |||
+ | * The iDocs ptf installer, UPDATE, uses QShell, an IBM licensed program product. If this product is not installed on your iSeries, the "// | ||
+ | |||
+ | 1. Locate the operating system installation CD's from IBM.\\ | ||
+ | 2. Put the first possible CD that contains QShell in the CD drive -- that's not the first CD but one of the later ones. | ||
+ | There is no way to determine which CD contains QShell other than to call IBM support.\\ | ||
+ | 3. Log on as QSECOFR and install licensed program product 5722SS1 option 30 QShell.\\ | ||
+ | 4. Re-apply the latest cumulative PTF package so that PTF's for QShell are installed. A re-IPL should not be required.\\ | ||
+ | \\ | ||
+ | Alternately, | ||
+ | |||
+ | The UPDATE program checks an object about to be updated and if it exists moves it to the archive library, deleting any object of the same name and type existing in the archive library. It then moves the new object from the installation library to the production library. At the end of the procedure the installation library (PTF500 in the above example) is empty save for the UPDATE command and program objects. | ||
+ | |||
+ | === iDocs Release 5.02/ | ||
+ | |||
+ | Restore the new version:\\ | ||
+ | | ||
+ | |||
+ | There are no service packs to install at this time. See the specific release notes below: | ||
+ | |||
+ | |||
+ | ===== Completing the Install Process ===== | ||
+ | |||
+ | If upgrading from older release: | ||
+ | * Please refer to the information above regarding the FMGOLD library. | ||
+ | * Put the new library in the library list: **ADDLIBLE LIB(FMG) POSITION(*FIRST)** | ||
+ | * Copy user definitions from the old library to the new if an upgrade: | ||
+ | Note: If COPYDATA command is not promptable enter CALL FMG/ | ||
+ | **If you have created any user output queues or files in your iDocs library you will have to save them and manually restore to the new iDocs library. The COPYDATA procedure will NOT copy user created objects.** \\ | ||
+ | |||
+ | If this is a new installation: | ||
+ | * Create the folder " | ||
+ | * Check the system directory using the **WRKDIRE** command and give all user profiles that will work with iDocs or run the engines a directory entry. | ||
+ | **ADDDIRE USRID(USERPROFILE LCLSYSTM) USRD(' | ||
+ | |||
+ | You may now delete the IDOCSSETUP library and the savefile it contains. | ||
+ | |||
+ | You should now run the [[start# | ||
+ | |||
+ | Note that IPDFSETUP will delete and recreate the /ipdf directory including the iPDF configuration file ipdf.cfg. | ||
+ | |||
+ | You can then edit the new iPDF configuration file (/ | ||
+ | |||
+ | If you purchased [[start# | ||
+ | |||
+ | iMail note: Prior to using *XLS to send a database in Excel format, the command IMAILIFS needs to first be issued to install the Java dependencies used to create the Excel file form the DB2 database. The syntax for the command is: | ||
+ | \\ | ||
+ | \\ | ||
+ | | ||
+ | \\ | ||
+ | \\ | ||
+ | The basic installation / upgrade is complete. If you run other products of inFORM Decisions please consult the documentation for those products. | ||
+ | |||
+ | |||
+ | The installation library (PTF500 in this example) may be deleted at the completion of the procedure. | ||
+ | |||
+ | |||
+ | ===== Notes & Issues with Specific Releases ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== 5.02 ==== | ||
+ | |||
+ | This release changed the way overlay names are stored in the tables. The filenames are now stored with an extension, matching the actual extension in the filesystem. If the overlays fail to convert during COPYDATA you can use these two sql commands through the STRSQL command interpreter to fix the issue: | ||
+ | |||
+ | '' | ||
+ | UPDATE FMG/ | ||
+ | UPDATE FMG/ | ||
+ | '' | ||
+ | ==== 5.02/ | ||
+ | |||
+ | There are no ptf's required for these releases. | ||
+ | |||
+ | One of the ' | ||
+ | |||
+ | Do an F15 on the form or check application screen to determine if there is a global adjustment value specified. | ||
+ | |||
+ | |||
+ | |||
+ | ==== 6.00 ==== | ||
+ | |||
+ | For iDocs 6 and later, set the data area **DSLIB** to the name of the library as installed on your disk. If iDocs is installed in library IDOCS600: | ||
+ | **CHGDTAARA DTAARA(IDOCS600/ | ||
+ | |||
+ | If Smart Routing is being used, run these commands to copy data from an older release: | ||
+ | < | ||
+ | CLRPFM IDOCS6/ | ||
+ | CALL FMR1207 PARM(' | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | ---- | ||
+ | |||
+ | < |