4.5 Setup procedure

This section describes the Navigation Platform setup procedure.

1. To set up Navigation Platform with changes to the default settings, copy the sample user setup property file (ucnp_setup_user.properties) to the directory shown below and then edit it.

   Source file (sample file)

   Navigation-Platform-installation-directory\sample\conf\ucnp_setup_user.properties

   Destination directory

   Navigation-Platform-installation-directory\conf

   To set up Navigation Platform with the default settings, this step is not necessary. Start from step 2.

   Tip

   If you are setting up a development environment, you need to change the values of the following properties:

   • Set to true the value of the property ucnp.setup.server.cosminexus.debug.enable.

   • Set the property ucnp.setup.server.cosminexus.debug.jdwp.port to a port number that is not being used on the machine where Navigation Platform is being set up and that you will be able to use for debugging User Plugins.

   Note

   • If you are not using user authentication, leave the properties related to the directory server as they are in the sample file.

   • If you specify Japanese text for a user setup property, use UTF-8 encoding for editing and do not include a Byte Order Mark.

2. Start JP1/Base. (This step is applicable only when you use JP1/Base for user authentication.)

   If JP1/Base is not up and running, start it. For details about how to start JP1/Base, see the JP1/Base User's Guide.

   Note:

   Skip step 2 if you do not use JP1/Base for user authentication.

3. Create files necessary to establish an HTTPS connection, or place existing files. (This only applies for communications using the HTTPS protocol.)

   For details about how to create or place the files necessary to establish an HTTPS connection, see 4.10 Configuration procedure when using HTTPS.

   Note:

   Step 3 is not required when not using communications based on the HTTPS protocol.

4. Execute the npsetup command (perform setup of Navigation Platform).

   Command path

   Navigation-Platform-installation-directory\bin\npsetup

   If an error occurs, take corrective action in accordance with the message that is displayed, perform the unsetup procedure, and then perform setup again. For details about the messages, see the manual JP1/Navigation Platform Messages. For details about the unsetup procedure, see 4.7 Unsetup procedure.

   If Windows Firewall displays a warning message, click the Permit access button to cancel the block.

5. Display the login window.

   Enter the following URL into your web browser and verify that the Navigation Platform login window is displayed.

   http://host-name:port-number/ucnpBase/

   Note

   For an https connection, specify the following URL:

   https:// host-name:port-number /ucnpBase/

   host-name

   The host name or IP address of the J2EE server machine.

   port-number

   The port number of the web server.

   This is the value specified in the property ucnp.setup.server.cosminexus.hws.http.port in the user setup property file (ucnp_setup_user.properties).

   Login ID

   Enter the value specified for the property ucnp.setup.server.system.admin.userids in the user setup property file. The default value is user1.

   Login password

   If you are using Active Directory for user authentication, enter a user password that was set in Active Directory. If you are using JP1/Base for user authentication, enter a JP1 user ID and password registered in JP1/Base. If you set up Navigation Platform without configuring user authentication, no password is required at login time.

6. Edit the user property file (ucnp_user.properties) as necessary, and then restart the system.

   For details about what settings can be configured in the user property file (ucnp_user.properties) and the user message properties file (ucnp_message_user.properties), see 8.1 Property files whose settings need to be specified.

   Note that changes to the property files do not take effect until you restart the system. For details about how to restart the system, see 5.1 Starting and stopping the system.

Important

After setup, take note of the points below. For the flow of tasks after setup, see 4.8 General procedure after setup.

• Do not make any changes to the user setup property file (ucnp_setup_user.properties) that was edited during setup unless you first perform the unsetup procedure in the environment that was set up. If you change the environment before performing unsetup, Navigation Platform might not work correctly.

• After you perform setup using the npsetup command (perform setup of Navigation Platform), do not make any changes to the environment other than to perform the tasks shown in the table below. Otherwise, Navigation Platform might not work correctly.

  Table 4‒2: Tasks that can be performed after the environment has been set up

  No.	Task that can be performed	Remarks
  1	Add plugins	For details about how to develop plugins, see the manual JP1/Navigation Platform Development Guide. For details about how to add plugins that you have developed, see 6.6 Applying the files created in the development environment.
  2	Customize windows	For details about how to customize windows, see Chapter 7. Customizing Navigation Platform windows.

To Page Top