Upgrading or Updating Password Self Help
These instructions guide you through the process of upgrading to Password Self Help version 3.003 on your IBM i, or updating from a prior modification level of version 3.
Before You Upgrade or Update
- Please ensure that the system value QALWOBJRST has a value of *ALL, i.e. CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(‘*ALL’)
- We recommend that you ensure that the system value QFRCCVNRST is set to 2 i.e. CHGSYSVAL SYSVAL(QFRCCVNRST) VALUE(‘2’). This ensures that any program conversion is performed when the objects are restored. If you do not change this system value, the system will convert these programs as and when they are used. This may lead to users experiencing longer response times.
- The QSECOFR security profile will be used during the upgrade process so make sure that you have access to the QSECOFR security officer profile. No other profile will allow you to load the software.
- Please ensure that your current Self Help system is properly backed up. The library to back up is @MSSH. Complete this backup first before proceeding further.
- The upgrade must be in dedicated mode. To ensure that you are in a dedicated mode, use the command WRKOBJLCK QSYS/@MSSH *LIB. No one should be signed on to this library.
- The upgrade time may vary between 0.25 hours to 1 hour depending on the size and usage of Self Help.
- Please clear all reports (if any) in the @MSSH/SHOUTQ output queue. The output queue should be empty. If the queue is not empty, the upgrade installation may terminate abnormally.
System Requirements
Password Self Help requires the following:
- IBM i (i5/OS, OS/400) version V7R1M0 or higher
- 30 MB of disk space
- Current IBM-supported PTF level
Compatibility with HelpSystems Insite
To use HelpSystems Insite to access your products through a web browser, you must meet the following browser and/or operating system requirements.
| Hardware Type | Minimum Browser and/or OS Requirements |
|---|---|
| Desktop/Laptop | Firefox 11 or higher Chrome 21 or higher Internet Explorer 11 Safari 6.1 or higher Microsoft Edge |
| Mobile Device | iOS: Browsers on iOS 8 or higher Android: OS 4.4 or higher using Chrome Windows: OS 10 using Edge |
| IBM i | V7R1 or higher operating system |
For more details, see Insite System Requirements.
Compatibility Requirement with DetectIT:
If you are using DetectIT's User Profile Manager module, before you upgrade to version 3.003 of Password Self Help, you will need to be on a compatible version of DetectIT.
- The minimum is DetectIT version 14.4.2, with the addition of the following PTFs:
- R881090823 Reduce number of file opens and close for Pre-Filter
- R881090826 Convert Remote Command Requests
- If you are on DetectIT 14.4.3, you need the addition of the following PTF:
- R881090826 Convert Remote Command Requests
DetectIT version 14.4.4 and higher is compatible without special PTFs.
Upgrade/Update Procedure
On the IBM i
- Sign on with QSECOFR
- CRTSAVF QGPL/SELFHELP
On the PC
- Go to the HelpSystems Password Self Help download page and download "Password Self Help for IBM i" zip file (SHPSAVF).
- Unzip SHPSAVF and save to PC
- Open command window
- FTP <IBM i>
- Sign on with QSECOFR
- Change to binary mode using the BIN command
- PUT <pathname>\SHPSAVF QGPL/SELFHELP
- Wait until the transfer has finished
On the IBM i:
- Sign on with QSECOFR
- LODRUN DEV(*savf) SAVF(< Save_File_Library >/< Save_File > )
Where:
< Save_File > is name of save file that contains Self Help shipping library SHPSAVF
< Save_File_Library > is name of library containing < Save_File >
- This will prompt the APYDTISHP command:
Transfer data: Enter a ‘Y’, if you wish to transfer data. The system will automatically transfer the data from the old version after the installation of the new release. Typically, this process will only take a few minutes to complete. If you enter a ‘N’, the system will overlay the data from Self Help and thereby delete all the users and the control records that you have previously set up. Please note that the base IBM i user profiles (ALERTSH and SELFHELP) will not be deleted by this process.
Submit to batch: Type ‘N’ to run interactively. Type ‘Y’ to run the command in batch. The system will automatically prompt the SBMJOB command.
Device: *SAVF
Save file library: SHPSAVF
Library: Type the library to contain the installation objects. It will be created if it does not exist. The default is APYSHP. For a batch job the value cannot be QTEMP.
- Once all necessary parameters have been input press Enter.
NOTE: If you entered ‘Y’ at the "Submit to batch" prompt the SBMJOB prompt screen will appear. Input the appropriate values and press Enter. For further details of the SBMJOB parameters please refer to the appropriate IBM manual.
- The upgrade routine will submit a job in QBATCH to delete the old version of Self Help that will be renamed to @MSSHOLD. This job will be held. Once you are ready to delete the older version, then please back up the library before releasing the deletion job.
