6.4.2 Setup procedure for version upgrade installation

This section describes how to set up JP1/Service Support after a version upgrade installation. Follow the procedure that matches the version of JP1/Service Support from which you upgraded. If you want to upgrade JP1/Service Support from JP1/Service Support Starter Edition to JP1/Service Support (Standard), see 6.5 Performing a product upgrade of JP1/Service Support.

Notes:

• Before performing a version upgrade installation, back up the Item management database so that you can recover it if something goes wrong. For details, see 6.2.3 Backing up the environment.

• The system creates temporary files when setting up JP1/Service Support after a version upgrade installation. Make sure that approximately 400 MB of additional free space is available in the installation folder of JP1/Service Support.

• When you set up JP1/Service Support after a version upgrade installation, you cannot change the size of the Item management database after it has been populated with data from the previous version. If you want to change the size of the Item management database, you can do so by following the procedure in 11.2.4 Expanding the size of the Item management database. For details on how to determine the appropriate size for the Item management database, see 5.12.5 Criteria for determining the Item management database size.

• If you have configured the system to display an HTML manual when you click the Help button, you need to overwrite the existing manual with the new version. For details on how to do so, see 6.8 Procedure for incorporating a manual.

• For details on the keys you need to add to definition files when performing a version upgrade installation, see the Release Notes.

• If the version of JP1/Service Support is 10-50 or earlier and registration of Items by email is used, the jsssetup.bat command with the -vup option specified automatically executes the jssauthusersetup (authentication user setting) command. Then, the jssauthusersetup command re-sets the password (hptl_jp1_imss_mail_pop3_password) specified in the email definition file for the mail server that is the destination of Item registration emails.

• Note that, if the version is updated, the size of the Item management database and the amount of free disk space required for the reorganization command increase.

• The following changes have been made to version 11-00 from version 10-50 or earlier:

  - The product name has been changed from JP1/Integrated Management - Service Support to JP1/Service Support. Accordingly, some of the product names that appear not only in the header rows in output CSV files but also in message text have been corrected.

  - An improved authentication method is used to confirm the identity of users who obtain email information from the mail server by using the jssitementrybymail command. By using the jssauthusersetup command, specify the user ID and password for user authentication. You do not need to edit the email definition file (jp1imss_mail_setting.conf). Note that the authenticated user's password, which was stored into the email definition file (jp1imss_mail_setting.conf) before the version upgrade process, is updated automatically when the jsssetup command is executed.

  - The disclosed log for the main service is output. When the service starts, the values specified for the properties are output. A warning message related to commented-out properties is output.

  - The event ID displayed on the JP1/Service Support screen consists of six characters instead of five. Note that if you upgrade to version 11-00 by using JP1/IM - Service Support Advanced Edition, the number of characters for the displayed event ID is not changed. It consists of six characters, as before.

• If JP1/Service Support is installed as an overwrite installation, the property key added in the new version is not added to the existing definition file.

  The following table shows the property key that is added in each version.

  Table 6‒6: The property key that is added in each version

  Version	Definition file name	Property key
  10-10	System property file (hptl_jp1_imss_main_setting.properties)	hptl_jp1_imss_np_item_info_$n hptl_jp1_imss_ao_item_info_$n hptl_jp1_imss_jp1base_virtual_hostname
  10-50	System property file (hptl_jp1_imss_main_setting.properties)	hptl_jp1_imss_item_warning_threshold=5000 hptl_jp1_imss_itemwindow_enable=Y hptl_jp1_imss_itemwindow_size=3 hptl_jp1_imss_batch_item_edit_max=100 hptl_jp1_imss_item_batch_ope_approval=false hptl_jp1_imss_item_batch_ope_approval_all_user_flag=false hptl_jp1_imss_item_batch_ope_approval_userlist= hptl_jp1_imss_item_batch_ope_approval_rolelist= hptl_jp1_imss_item_batch_ope_close=false hptl_jp1_imss_item_batch_ope_close_all_user_flag=false hptl_jp1_imss_item_batch_ope_close_userlist= hptl_jp1_imss_item_batch_ope_close_rolelist=
  11-00	System property file (hptl_jp1_imss_main_setting.properties)	hptl_jp1_imss_research_display_number_list hptl_jp1_imss_process_name_display_characters
  	Email definition file (jp1imss_mail_setting.conf)	hptl_jp1_imss_mail_auth_method hptl_jp1_imss_mail_smtp_auth_port hptl_jp1_imss_mail_smtp_user hptl_jp1_imss_mail_smtp_password hptl_jp1_imss_mail_connect_timeout hptl_jp1_imss_mail_socket_timeout hptl_jp1_imss_mail_item_recall_flag hptl_jp1_imss_mail_item_recall_title hptl_jp1_imss_mail_item_recall_text hptl_jp1_imss_mail_item_sendback_flag hptl_jp1_imss_mail_item_sendback_title hptl_jp1_imss_mail_item_sendback_text hptl_jp1_imss_mail_operation_mode hptl_jp1_imss_mail_source_address hptl_jp1_imss_mail_itemdata_set_form hptl_jp1_imss_mail_format_error_string
  11-10	System property file (hptl_jp1_imss_main_setting.properties)	hptl_jp1_imss_add_item_info_$n hptl_jp1_imss_add_item_info_product_$n hptl_jp1_imss_add_item_info_key_list_$p hptl_jp1_imss_itemwindow_start_month

• If JP1/Service Support is installed as an overwrite installation, the XML tags added to new Item form definition files are not added to the existing Item form definition files.

Organization of this subsection

• (1) Version upgrade from JP1/Service Support version 9, version 10 or version 11 to JP1/Service Support version 12