MDRest4i 14.0 Installation Instructions
This installation guide will take you through the installation of the V14 MDRest4i MDRFRAME framework component, and the MDRest4i SDK web application on the IBM i.
Please Note
Please get license keys from Midrange Dynamics before continuing!
Brief Description of Installation
The installation consists of installing the MDRST library using command from the MDRST.savf save file on the IBM i.
Apply the license key using command MDRST/MRLICKEY.
The MDRST library contains the MDRDK save file, which contains the MDRest4i SDK web UI web application.
If the SDK is required on that LPAR, the next step is to run the MDRST/MDRSDKINS command. This restores, configures, and adds an HTTP server instance for the MDRest4i SDK web UI, creates a default Provider and Consumer program library, and creates a default HTTP server instance to expose Providers(API's)
If additional REST API servers are required on this LPAR or to setup an LPAR for running REST Providers and Consumers only(not developing), create an API server instance using command MDRHTTPAPI
Please Note
This installation is for V14 upwards, and cannot be used to automatically upgrade from V12 and earlier.
Which Product to Install?
MDRest4i MDRFRAME is required on all LPAR's where any MDRest4i API or consumer runs, including the development LPAR where the SDK will be installed.
MDRest4i SDK is only required on the LPAR where API or Consumer development takes place.
Updating Products
Command MDRST/MDREST4INS is used for both installing AND updating MDRest4i. Command MDRST/MDRSDKUPD is used for updating the SDK (after MDRST/MDREST4INS has completed)
Simplified Installation Steps
The following is a simplified version of the installation steps, assumes you have already installed the MDREST4iNS command, and you have your MDRest4i License keys.
| Step | Comments |
|---|---|
| Login to your IBM i with a user that has QSECOFR Authority | |
| Download zip and upload MDRST.SAVF onto IBM i | MDREST4INS command should still be in QGPL so you can skip that |
| Stop the MDRST SDK HTTP server and any HTTP API server you have created : | ENDTCPSVR SERVER(*HTTP) HTTPSVR(MDRST) ENDTCPSVR ENDTCPSVR SERVER(*HTTP) HTTPSVR(MDRSTAPI) ENDTCPSVR |
| Make sure lib MDRST not locked and in use | WRKOBJLCK OBJ(MDRST) OBJTYPE(*LIB) |
Prompt Command MDREST4INS | Prompt command MDREST4INS to specify a different backup lib or different instance name. MDREST4INS is also used to update the server applications. |
ADDLIBLE MDRST | This lib will now be at the lasted build |
Enter command MRLICKEY | Use command MRLICKEYReview the license status and the correct build and version number at the bottom. Press enter when complete |
Prompt command MDRSDKINS | MDRSDKINS is only required if SDK is being installed. This will install the SDK web application server MDRSDKUPD is only required if SDK is being updated. This will update the SDK web application server code and copy back the existing settings. |
| Restart your SDK and API servers | STRTCPSVR SERVER(*HTTP) HTTPSVR(MDRST) |
| Test the server is running | http://[your serverip or host]:[yourport]/mdrapi/mdrhello?firstName=Mike&lastName=Smith&Title=Mr |
Detailed Step-by-Step Installation
For first time installations, kindly select the following installation pages in sequence: