4.6.3 Considering the Management Portal execution environment

To use the Web GUI (Management Portal), you must set it up on both the manager host and agent host. For details about how to set up Web GUI (Management Portal), see the sections corresponding to the OS. For Windows, see 6.7 Settings related to the Web GUI in the JP1/Automatic Job Management System 3 Configuration Guide. For Linux, see 15.8 Settings related to the Web GUI in the JP1/Automatic Job Management System 3 Configuration Guide.

This section describes the management portal execution environment for using the Web GUI (Management Portal). You might need to change some settings.

Organization of this subsection

(1) Environment settings for JP1/AJS3 - Manager

The following conditions must be met to use the Web GUI (Management Portal).

If the system time of the JP1/AJS3 Manager host is changed by using the NTP (Network Time Protocol) or some other means, make sure that:
- The time is adjusted in milliseconds by using, for example, the slew mode, to prevent the same time from occurring twice.
- Time adjustment operations are logged so that they can be confirmed later.
When you set the system time backward, make sure you delete the performance log file.

For details about how to delete performance log files, see 7.9.3 Changing the date and time of the system in the JP1/Automatic Job Management System 3 Administration Guide.
When you set the system time backward, make sure you delete the execution agent performance log file.

For details about how to delete execution agent performance log files, see 7.9.3 Changing the date and time of the system in the JP1/Automatic Job Management System 3 Administration Guide.
When you set the system time backward, make sure you delete the aggregation results of the number of job executions.

For details, see 7.9.3 Changing the date and time of the system in the JP1/Automatic Job Management System 3 Administration Guide.
When you set the system time backward, make sure you delete the aggregation results of the execution agent performance data.

For details, see 7.9.3 Changing the date and time of the system in the JP1/Automatic Job Management System 3 Administration Guide.
An OS user with administrator privileges must be mapped to the JP1 user who logs in to the Management Portal.

If the environment setting parameter ADMACLIMIT is set to yes, set access privileges so that the JP1 user who logs in to the Management Portal can view all event jobs defined as startup conditions in the target scheduler service.

If a JP1 user who logs in to the Management Portal cannot view the event job defined as a start condition, the Event Job Retention Details dialog box cannot be viewed. For details about the ADMACLIMIT environment setting parameter, see 20.11.2(4) ADMACLIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
To view the usage state of a scheduler service or the retention states of jobnets with start conditions in a scheduler service, make sure that the logged-in JP1 user has access permission to view all units managed by the scheduler service.
The time zone of the JP1/AJS3 manager host is not a daylight saving time zone.

To obtain the status of JP1/AJS3 from the Web GUI, you might need to specify the settings described in the following sections:

6.6.1 Settings for the performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.7.1 Settings for the performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX)
6.6.2 Settings for the execution agent performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.7.2 Settings for the execution agent performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX)
21.5 Setting up the job distribution delay reduction function in the JP1/Automatic Job Management System 3 Configuration Guide
21.7 Settings for detecting factors that might stop job execution in the JP1/Automatic Job Management System 3 Configuration Guide

The Web GUI can be used even if the preceding four additional settings are not specified. However, if these additional settings are not specified, some of the JP1/AJS3 operating information will not be displayed with the Web GUI.

The following table lists the items that will not be displayed with the Web GUI (Management Portal).

Table 4‒19: Items of JP1/AJS3 operating information requiring additional settings to be displayed with the Web GUI (Management Portal)
No.	Relevant screen	Operating information item	Required setting
1	Scheduler Service Details screen	Number of jobs that are in queue or running	Settings for the performance report output function Settings for detecting factors that might stop job execution
2		Number of execution generations
3		Number of unreported information items
4	Target Host screen	Execution agent status	Setting up the job distribution delay reduction function
5	Operating status of target host dialog box	Maximum number of concurrently executed jobs, maximum number of concurrently executed event jobs, and number of executed jobs	Settings for the execution agent performance report output function

The following table lists the items that will not be displayed with the Web GUI (Job Portal).

Table 4‒20: Items of JP1/AJS3 operating information requiring additional settings to be displayed with the Web GUI (Job Portal)
No.	Relevant screen	Operating information item	Required setting
1	Operating status of execution agent dialog box	Maximum number of concurrently executed jobs, maximum number of concurrently executed event jobs, and number of executed jobs	Settings for the execution agent performance report output function

Also consider the values to be set for the environment setting parameters shown later. For details about the environment setting parameters, see 20.15 Management Portal execution environment in the JP1/Automatic Job Management System 3 Configuration Guide.

Table 4‒21: Environment setting parameters related to the Web GUI (Management Portal) (JP1/AJS3 - Manager)
No.	Definition key	Environment setting parameter	Definition
1	[JP1_DEFAULT\JP1AJS2\CONTROL]	"AUTHSYSLOG"=	For Windows Sets whether messages related to user authentication are output to the Windows event log and integrated trace log. For UNIX Sets whether messages related to user authentication are output to the syslog and integrated trace log.
2		"SYSLOGCODE"=	Sets the language of messages output to syslog.
3		"UACAdministratorsMP"=	For Windows Allows an OS user who belongs to the Administrators group to use the Web GUI (Management Portal) as the JP1 user mapped to that OS user if the UAC function is enabled.
4	[JP1_DEFAULT\JP1AJS2\CONTROL\MANAGER]	"CONRESTRICTSYSLOG"=	For Windows Sets whether messages related to connection-source restriction are output to the Windows event log. For UNIX Sets whether messages related to connection-source restriction are output to the syslog.
5		"AJSSYSCTLDLOGSIZE"=	Sets the size of the internal log file for the ajssysctlmd process.
6		"LOGSIZE"=	Sets the size of the log file for the ajssysctlmd process.
7		"MAXOPEEXEC"=	Sets the maximum number of on-screen operations.
8		"MAXAGGEXEC"=	Maximum number of threads to perform aggregation concurrently
9		"JOBAGGTIMEOUT"=	Sets the timeout of a wait for the number of job executions to be aggregated.
10	[{JP1_DEFAULT\|`logical-host-name`}\JP1AJSMANAGER\`scheduler-service-name`]^#1	"PERIODICJOBAGG"=	Whether the number of job executions is automatically aggregated^#2
11		"JOBAGGSTARTTIME"=	The time at which aggregation of the number of job executions starts
12		"JOBAGGLOGDIR"=	The name of the directory for containing job execution count aggregation log files
13		"JOBAGGRESULTSSTOREDAYPERIOD"=	The number of days for which the aggregation results of the number of job executions are stored
14		"JOBAGGJP1USERNAME"=	Sets the name of the JP1 user who aggregates the number of job executions.
15	[{JP1_DEFAULT\|`logical-host-name`}\JP1AJSMANAGER]^#1	"PERIODICAGTAGG"=	Sets whether to automatically aggregate execution agent performance data.
16		"AGTAGGJP1USERNAME"=	Sets the name of the JP1 user who aggregates execution agent performance data.
17		"AGTAGGSTARTTIME"=	Sets the time at which to start aggregation of execution agent performance data.
18		"AGTAGGLOGDIR"=	Sets the path of the directory in which to store the aggregation log files for execution agent performance data.
19		"AGTAGGRESULTSSTOREDAYPERIOD"=	Sets the retention period (in days) of the aggregation results for execution agent performance data.

#1: The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.
#2: Set yes for this parameter if you want to display the number of job executions for a scheduler service in the Number of job executions dialog box or the Number of job executions in a day dialog box of the Web GUI (Management Portal).

To Page Top

(2) Environment settings for JP1/AJS3 - Agent

Consider the values to be set for the environment setting parameters shown later. For details about the environment setting parameters, see 20.15 Management Portal execution environment in the JP1/Automatic Job Management System 3 Configuration Guide.

Table 4‒22: Environment setting parameters related to the Web GUI (Management Portal) (JP1/AJS3 - Agent)
No.	Definition key	Environment setting parameter	Definition
1	[JP1_DEFAULT\JP1AJS2\CONTROL]	"AUTHSYSLOG"=	For Windows Sets whether messages related to user authentication are output to the Windows event log and integrated trace log. For UNIX Sets whether messages related to user authentication are output to the syslog and integrated trace log.
2		"SYSLOGCODE"=	Sets the language of messages output to syslog.
3		"UACAdministratorsMP"=	For Windows Allows an OS user who belongs to the Administrators group to use the Web GUI (Management Portal) as the JP1 user mapped to that OS user if the UAC function is enabled.
4	[JP1_DEFAULT\JP1AJS2\CONTROL\AGENT]	"AJSSYSCTLDLOGSIZE"=	Sets the size of the internal log file for the ajssysctlad process.
5		"LOGSIZE"=	Sets the size of the log file for the ajssysctlad process.
6		"MAXOPEEXEC"=	Sets the maximum number of on-screen operations.

To Page Top

(3) OS user to be mapped to a JP1 user

In Windows, the privilege needed by the OS user differs depending on whether the UAC function is enabled.

In an environment in which the UAC function is enabled, any OS user who belongs to the Administrators group, including the built-in administrator account, can be mapped to the JP1 user for accessing Management Portal. This function can be enabled by setting 1 for the UACAdministratorsMP environment setting parameter. If you set 1 (permit use by any user who belongs to the Administrators group) for this parameter, note that the OS user to be mapped must have Log on as a batch job permission. Make sure that the Administrators group is added to the list of users or groups granted Log on as a batch job permission.

For details about the UACAdministratorsMP setting parameter, see 20.15.2(3) UACAdministratorsMP in the JP1/Automatic Job Management System 3 Configuration Guide.

The following table shows the conditions related to availability of the Web GUI (Management Portal) for the OS user.

Table 4‒23: Conditions related to availability of the Web GUI (Management Portal) for the OS user
UAC function	OS user type		Whether "Log on as a batch job" permission is granted	UACAdministratorsMP parameter setting	Is the Web GUI (Management Portal) available?
Enabled	Administrator group	Built-in Administrator	Granted	1(Permit use by any user belonging to the Administrators group)	Y
			Granted	0(Permit use by only built-in Administrator)	Y
			Not granted	1(Permit use by any user belonging to the Administrators group)	N
			Not granted	0(Permit use by only built-in Administrator)	Y
		Other than built-in Administrator	Granted	1(Permit use by any user belonging to the Administrators group)	Y
			Granted	0(Permit use by only built-in Administrator)	N
			Not granted	1(Permit use by any user belonging to the Administrators group)	N
			Not granted	0(Permit use by only built-in Administrator)	N
	OS users not belonging to the Administrators group		--^#	--^#	N
Disabled	Administrator group (Built-in Administrator, other than built-in Administrator)		Granted	1(Permit use by any user belonging to the Administrators group)	Y
			Granted	0(Permit use by only built-in Administrator)	Y
			Not granted	1(Permit use by any user belonging to the Administrators group)	N
			Not granted	0(Permit use by only built-in Administrator)	Y
	OS users not belonging to the Administrators group		--^#	--^#	N

Legend:

Y: The Web GUI (Management Portal) can be used.

N: The Web GUI (Management Portal) cannot be used.

#: OS users not belonging to the Administrators group cannot use the Web GUI (Management Portal) regardless of how the Log on as a batch job permission and UACAdministratorsMP parameter settings are specified.

To Page Top