I2Rest Start - Revision history

Alexei.baranov: /* Required authority */

2023-12-06T06:37:11Z

‎Required authority

Alexei.baranov at 18:42, 22 July 2021

2021-07-22T18:42:28Z

Alexei.baranov: /* Troubleshooting */

2020-09-01T19:23:51Z

‎Troubleshooting

Alexei.baranov at 19:22, 1 September 2020

2020-09-01T19:22:02Z

Pavel.lobko at 13:49, 15 June 2020

2020-06-15T13:49:09Z

Pavel.lobko at 13:48, 15 June 2020

2020-06-15T13:48:55Z

Alexei.baranov at 12:13, 12 June 2020

2020-06-12T12:13:11Z

Alexei.baranov at 09:04, 12 June 2020

2020-06-12T09:04:19Z

Pavel.lobko at 11:27, 9 June 2020

2020-06-09T11:27:16Z

Pavel.lobko at 09:17, 8 June 2020

2020-06-08T09:17:50Z

@@ Line 15: / Line 15: @@
 =Required authority=
 If your server is used to process only anonymous services, then the authorization of the user who starts the server must be sufficient to execute programs registered as services.<br/>
-If the server is supposed to handle any kind of the OAuth2 flows, then the following special authorities are required to start the server:
+If the server is supposed to handle any kind of the OAuth2 flows, then the user who will run the server must have *USE authority to user profiles of i2Rest Server Users and Clients.
-* *ALLOBJ
 =Troubleshooting=
 If something went wrong and you don't know what is going on, here is a sequence of places to look out for:

@@ Line 13: / Line 13: @@
 Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.<br>
 Now, with your own i2Rest Server instance running, you can proceed to [[I2Rest_Basic_Test|test API call]].
 =Troubleshooting=
 If something went wrong and you don't know what is going on, here is a sequence of places to look out for:

@@ Line 18: / Line 18: @@
 * WRKUSRJOB <user who submitted i2Rest> *ACTIVE - to view the list of active jobs of the user who started the i2Rest Server. Find the i2Rest Server job here, open it with "5" and look at its job log ("10"), spool files ("4"), call stack ("11") and threads ("20")
 * WRKSPLF SELECT(<user who submitted i2Rest>) - to view spooled files for completed jobs
-* If you configured logging of server events in syslog file, use the command WRKLNK '<the name of syslog file>' to look at its content
+* If you configured [[I2Rest_with_syslog|logging of server events in syslog file]], use the command WRKLNK '<the name of syslog file>' to look at its content
 * If you are stuck and cannot move on - [mailto:contacts@i2rest.com contact us], we will certainly help. Attach a description of the problem, config file, screens of the above commands, we'll figure something out!

← Older revision		Revision as of 19:22, 1 September 2020
Line 13:		Line 13:
	Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.<br>		Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.<br>
	Now, with your own i2Rest Server instance running, you can proceed to [[I2Rest_Basic_Test\|test API call]].		Now, with your own i2Rest Server instance running, you can proceed to [[I2Rest_Basic_Test\|test API call]].
		+	=Troubleshooting=
		+	If something went wrong and you don't know what is going on, here is a sequence of places to look out for:
		+	* NETSTAT *CNN - use this command to ensure that your server is running and listening for client connections on the port(s) specified in the config file
		+	* WRKUSRJOB <user who submitted i2Rest> *ACTIVE - to view the list of active jobs of the user who started the i2Rest Server. Find the i2Rest Server job here, open it with "5" and look at its job log ("10"), spool files ("4"), call stack ("11") and threads ("20")
		+	* WRKSPLF SELECT(<user who submitted i2Rest>) - to view spooled files for completed jobs
		+	* If you configured logging of server events in syslog file, use the command WRKLNK '<the name of syslog file>' to look at its content
		+	* If you are stuck and cannot move on - [mailto:contacts@i2rest.com contact us], we will certainly help. Attach a description of the problem, config file, screens of the above commands, we'll figure something out!

@@ Line 11: / Line 11: @@
 #:<code>/QSYS.LIB/I2REST.LIB/I2REST.PGM -start -config <path to *.json config file></code>
 With first option, you can define any additional options for submitting job. Only two things are required - ALWMLTTHD(*YES) and I2REST library in library list of submitted job.<br/>
-Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.
+Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.<br>
 Now, with your own i2Rest Server instance running, you can proceed to [[I2Rest_Basic_Test|test API call]].

← Older revision		Revision as of 13:48, 15 June 2020
Line 12:		Line 12:
	With first option, you can define any additional options for submitting job. Only two things are required - ALWMLTTHD(*YES) and I2REST library in library list of submitted job.<br/>		With first option, you can define any additional options for submitting job. Only two things are required - ALWMLTTHD(*YES) and I2REST library in library list of submitted job.<br/>
	Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.		Second option is useful when there is no "syslog" parameter defined in json config file. In this case, all output messages will be printed in qshell console. Note that if qshell console will be closed, server instance will be stopped automatically. To leave qshell console without closing it, use F12 and execute STRQSH again to return back. Job that serving this i2Rest Server instance under QShell will have name <code>nnnnnn/<your_user_id>/QP0ZSPWT</code>.
		+	Now, with your own i2Rest Server instance running, you can proceed to [[I2Rest_Basic_Test\|test API call]].

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:Starting i2Rest Server instance}}
-To start i2Rest Server instance, you need [[I2Rest_Config| JSON configuration file ]]. See instructions how to prepare [[I2Rest_Server_quickstart|I2Rest_quick_config]].<br/>
+To start i2Rest Server instance, you need [[I2Rest_Config| JSON configuration file ]]. See instructions how to prepare [[I2Rest_quick_config|simplest config]].<br/>
 There are two ways to start i2Rest Server instance:
 #Using SBMJOB