I2Rest quick config - Revision history

Alexei.baranov at 13:21, 22 July 2020

2020-07-22T13:21:38Z

Alexei.baranov at 18:29, 14 July 2020

2020-07-14T18:29:31Z

Pavel.lobko at 09:49, 16 June 2020

2020-06-16T09:49:28Z

Pavel.lobko at 09:48, 16 June 2020

2020-06-16T09:48:19Z

Pavel.lobko at 13:46, 15 June 2020

2020-06-15T13:46:13Z

Alexei.baranov at 08:10, 15 June 2020

2020-06-15T08:10:42Z

Alexei.baranov at 08:10, 15 June 2020

2020-06-15T08:10:13Z

Alexei.baranov at 08:07, 15 June 2020

2020-06-15T08:07:52Z

Alexei.baranov at 13:23, 11 June 2020

2020-06-11T13:23:30Z

Alexei.baranov at 13:12, 11 June 2020

2020-06-11T13:12:58Z

@@ Line 1: / Line 1: @@
 {{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|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>
 In this configuration, none of the user authentication models are used, that is, the API call is performed in anonymous mode.

← Older revision		Revision as of 18:29, 14 July 2020
Line 50:		Line 50:
	Now you are ready to [[I2Rest_Start\|start your i2Rest Server instance]].<br>		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\|advanced details]] how to configure your i2Rest ~~server~~.	+	If you would like to go deeper, please explore [[I2Rest_Advanced_Setup\|advanced details]] how to configure different features of your i2Rest Server.<br/>
		+	Complete reference of i2Rest Server configuration options is provided [[I2Rest_Config\|here]]

@@ Line 26: / Line 26: @@
      "session_systems":
+     [
-        {  "submit" : "SBMJOB JOB(I2RESTA)  USER(${user})  CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
+        {  "name"   : "*ANONYMOUS",
            "submit" : "SBMJOB JOB(I2RESTA)                \
                               USER(${user})               \

@@ Line 26: / Line 26: @@
      "session_systems":
+     [
+        {  "submit" : "SBMJOB JOB(I2RESTA)  USER(${user})  CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
            "name"   : "*ANONYMOUS",
            "submit" : "SBMJOB JOB(I2RESTA)                \

@@ Line 4: / Line 4: @@
 ;Step 1
-:Create text file named I2RESTECHO.PCML somewhere on IFS, for example "/tmp/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:
+:Create text file named I2RESTECHO.PCML anywhere on IFS, for example "/tmp/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">

@@ Line 28: / Line 28: @@
+        {
            "name"   : "*ANONYMOUS",
-           "submit" : "SBMJOB JOB(I2RESTA) \
+           "submit" : "SBMJOB JOB(I2RESTA)                \
-                              USER(${user}) \
+                              USER(${user})               \
-                              CMD(CALL I2REST \
+                              CMD(CALL I2REST             \
-                                 PARM('-session' \
+                                 PARM('-session'          \
-                                      '-url' '${surl}' \
+                                      '-url' '${surl}'    \
-                                      '-uid' '${uid}' \
+                                      '-uid' '${uid}'     \
                                       '-user' '${user}')) \
                               INLLIBL(I2REST)"

← Older revision		Revision as of 13:23, 11 June 2020
Line 3:		Line 3:

	;Step 1		;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:	+	:Create text file named I2RESTECHO.PCML somewhere on IFS, for example "/tmp/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>		<pre>
	<pcml version="1.0">		<pcml version="1.0">
Line 15:		Line 15:

	;Step 2		;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. We will start with simplest non-encrypted connections, so please leave http as a protocol:	+	:Contact your system administrator for your IBM i server host name (or IP) and ''two'' available ports 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, ports and pcml_file with appropriate values. We will start with simplest non-encrypted connections, so please leave http as a protocol:

	{		{
−	"gates":	+	"gates":
−	{	+	{
−	"main" : {"url":"http://<span style="color:red;"><host_name>[:port]</span>"},	+	"main" : {"url":"http://<span style="color:red;"><host_name>[:port] (for example api.i2rest.com:1234)</span>"},
−	"management" : {"url":"http://<span style="color:red;"><host_name>[:port]</span>"}	+	"management" : {"url":"http://<span style="color:red;"><host_name>[:port] (for example api.i2rest.com:4321)</span>"}
−	},	+	},
−	"session_systems":	+	"session_systems":
−	[	+	[
−	{	+	{
−	"name" : "*LOCAL",	+	"name" : "*LOCAL",
−	"submit" : "SBMJOB JOB(I2RESTS) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"	+	"submit" : "SBMJOB JOB(I2RESTS) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
−	},	+	},
−	{	+	{
−	"name" : "*ANONYMOUS",	+	"name" : "*ANONYMOUS",
−	"submit" : "SBMJOB JOB(I2RESTA) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"	+	"submit" : "SBMJOB JOB(I2RESTA) USER(${user}) CMD(CALL I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' '-user' '${user}')) INLLIBL(I2REST)"
−	}	+	}
−	],	+	],
−	"pcmls":	+	"pcmls":
−	[	+	[
−	{	+	{
−	"pcml_mount" : "echo",	+	"pcml_mount" : "echo",
−	"pcml_file" : "<span style="color:red;"><complete ~~path~~ of i2restecho.pcml on IFS (for example /tmp/~~i2rest~~/i2restecho.pcml)></span>",	+	"pcml_file" : "<span style="color:red;"><complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)></span>",
−	"valid_in_anonymous" : true	+	"valid_in_anonymous" : true
−	}	+	}
−	]	+	]
−	}	+	}


	Now you are ready to [[I2Rest_Start\|start your i2Rest Server instance]].<br>		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.	+	If you would like to go deeper, please explore [[I2Rest_Advanced_Setup\|advanced details]] how to configure your i2Rest server.

@@ Line 34: / Line 34: @@
+       }
     ],
     "pcmls":
+    [