Difference between revisions of "I2Rest quick config"
Pavel.lobko (talk | contribs) |
|||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:i2Rest configuration in two steps}} | {{DISPLAYTITLE:i2Rest configuration in two steps}} | ||
Our i2Rest Server configuration template will help you to set up you server in a minutes. With this minimal configuration your server instance will be able to process request to test I2RESTECHO program.<br> | Our i2Rest Server configuration template will help you to set up you server in a minutes. With this minimal configuration your server instance will be able to process request to test I2RESTECHO program.<br> | ||
| − | Create | + | |
| + | ;Step 1 | ||
| + | :Create text file named I2RESTECHO.PCML somewhere on IFS, for example "/temp/PCML/i2restecho.pcml". Copy and paste following code. It represents a description for the sample program I2RESTECHO, that is included into i2Rest server installation for demonstration purposes: | ||
| + | <pre> | ||
| + | <pcml version="1.0"> | ||
| + | |||
| + | <program name="echo" path="/QSYS.LIB/%LIBL%.LIB/I2RESTECHO.PGM"> | ||
| + | <data name="echo" usage="inputoutput" type="char" length="10" trim="both"/> | ||
| + | </program> | ||
| + | |||
| + | </pcml> | ||
| + | </pre> | ||
| + | |||
| + | ;Step 2 | ||
| + | :Contact your system administrator for available host and port on your IBM i for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder). Enter following text, replace host_name, port and pcml_file with appropriate values: | ||
<pre> | <pre> | ||
| Line 32: | Line 46: | ||
} | } | ||
</pre> | </pre> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | Now you are ready to [[I2Rest_Start|start your i2Rest Server instance]].<br> | |
| − | |||
| − | |||
| − | + | If you would like to go deeper, please explore [[I2Rest_Advanced_Setup|more details]] how to configure your i2Rest server. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Revision as of 16:04, 11 June 2020
Our i2Rest Server configuration template will help you to set up you server in a minutes. With this minimal configuration your server instance will be able to process request to test I2RESTECHO program.
- Step 1
- Create text file named I2RESTECHO.PCML somewhere on IFS, for example "/temp/PCML/i2restecho.pcml". Copy and paste following code. It represents a description for the sample program I2RESTECHO, that is included into i2Rest server installation for demonstration purposes:
<pcml version="1.0">
<program name="echo" path="/QSYS.LIB/%LIBL%.LIB/I2RESTECHO.PGM">
<data name="echo" usage="inputoutput" type="char" length="10" trim="both"/>
</program>
</pcml>
- Step 2
- Contact your system administrator for available host and port on your IBM i for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder). Enter following text, replace host_name, port and pcml_file with appropriate values:
{
"gates":
{
"main" : {"url":"http://<host_name>[:port]"},
"management" : {"url":"http://<host_name>[:port]"}
},
"session_systems":
[
{
"name" : "*LOCAL",
"submit" : "SBMJOB JOB(I2RESTS) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
},
{
"name" : "*ANONYMOUS",
"submit" : "SBMJOB JOB(I2RESTA) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
}
],
"pcmls":
[
{
"pcml_mount" : "echo",
"pcml_file" : "<path to i2restecho.pcml on IFS>/i2restecho.pcml",
"valid_in_anonymous" : true
}
]
}
Now you are ready to start your i2Rest Server instance.
If you would like to go deeper, please explore more details how to configure your i2Rest server.
