After you download the IBM Intelligent City Planning and Operations installation package, run the installation program.

1. Copy the IBM Intelligent City Planning and Operations installation bundle to a server outside the IBM Intelligent Operations Center environment, either the installation server or a Red Hat Linux server with network access to the IBM Intelligent Operations Center servers. Extract the installation bundle to a temporary folder, for example /tmp/ICPO_Install.
2. Log in to the server on which you extracted the installation bundle as a root user, and access the folder where the installation bundle was extracted.
3. Open the iop_lite_topo.properties file in the /tmp/ICPO_Install/Linux/Disk1/InstData/VM folder and specify the host names and passwords for the servers in your environment. If you plan to use the Licensing and Tax Investigation application for business license fraud investigation, install the Licensing and Tax Investigation application by setting the ICPO.DEPLOY property to DeployAll. You can choose to install the Licensing and Tax Investigation application later by setting the ICPO.DEPLOY property to DeployAnalysis.
4. Open the install.props file in the /tmp/ICPO_Install/Linux/Disk1/InstData/VM folder and specify the location of the JRE. For example, JAVAHOME=/opt/ibm/java-x86_64-60/jre.
5. From the /tmp/ICPO_Install/Linux/Disk1/InstData/VM folder, run the install_icpo.bin file.
6. When prompted, accept or decline the license agreement. If you decline the license agreement the installation will stop.
7. When prompted, enter the IBM Intelligent Operations Center topology password.
8. When prompted, press Enter to start the installation.

You can load sample data to view IBM Intelligent City Planning and Operations functionality before loading live data.

To load sample data:

1. Log in to the IBM Intelligent Operations Center database server as db2inst1.
2. Navigate to the /opt/IBM/COOP/asset_coop_import folder.
3. Run the following commands:

   	./updateImportDatabase.sh create layers_samples.json 
   		http://application_server/wpsv70/wps/portal wpsadmin wpsadmin_password
   	./updateImportDatabase.sh updatelayer "Events on IBM Campus" 
   		jdbc:db2://localhost:50000/IOCDB db2inst1 db2inst1_password
   	./updateImportDatabase.sh updatelayer "Animal Sightings on IBM Campus" 
   		jdbc:db2://localhost:50000/IOCDB db2inst1 db2inst1_password

4. Select users and groups to have access to view the sample data layers in maps.

If Tivoli® Access Manager WebSEAL is installed on a different node from IBM Intelligent Operations Center, you must perform additional installation steps.

To install in alternate topologies:

1. Add the following lines to the /opt/pdweb/www-default/lib/jmt.conf file:

   /wpsv70 /.asset_coop_ui_portlet/*
   /wpsv70 /asset_coop_ui_portlet/*
   /wpsv70 /asset_coop_rest/*
   /wpsv70 /.COOP/*
   /wpsv70 /asset_permitting_ui_portlet/*
   /wpsv70 /asset_permitting_rest/*
   /wpsv70 /STATWS/*
   /wpsv70 /asset_stat_rest/*
   /wpsv70 /STATJS/*
   /wpsv70 /MayorOperationsWeb/*
   /asset_permitting_rest  
   	/wps/myportal/asset_permitting_rest/application_categories/*

2. Create a new junction called /asset_permitting_rest and load the junction mapping table to the default Tivoli Access Manager WebSEAL by running the following commands:

   pdadmin -a sec_master -p password
   server list (displays list of servers) 
   server task default-webseald-WebSEAL_FQDN create -t tcp -x -b 
   	ignore -h Port_Application_FQDN -p 10039 -A -F /opt/pdweb/etc/portal.ltpa 
   	-Z LTPA Token Password /asset_permitting_rest 
   acl attach /asset_permitting_rest wpsv70_ACL 
   server task default-webseald- WebSEAL_FQDN jmt load 
   server replicate 
   exit

   For example:

   pdadmin sec_master> server task default-webseald-access.ibmsclive.com create 
   	-t tcp -x -b ignore -h app.ibmsclive.com -p 10039 -A 
   	-F /opt/pdweb/etc/portal.ltpa -Z passw0rd /asset_permitting_rest 
   Created junction at /asset_permitting_rest
   
   pdadmin sec_master> acl attach /asset_permitting_rest wpsv70_ACL
   
   pdadmin sec_master> server task default-webseald-access.ibmsclive.com jmt load
   	DPWWM1462I JMT Table successfully loaded
   
   pdadmin sec_master> server replicate
   
   pdadmin sec_master> exit

3. Restart Tivoli Access Manager WebSEAL by running the following commands:

   [root@access lib]# pdweb restart

   If successful, the console will report:

   Stopping the: webseald-default
   Starting the: webseald-default

When you experience problems during installation, you might need to perform troubleshooting tasks to determine the corrective action to take.

To enable search and view data from all of your data sources, you must import data into the IBM Intelligent City Planning and Operations database and enable the data for search.

To import data:

1. Import shape file data into the staging database.
   Work with your GIS administrator to determine the shape files to import.
2. Import non shape-file data into the staging database.
   
3. Define layer and data source structure into which data will be imported.
   
4. Import block data.
   
5. Optional: Update data from one or all sources.
   
6. Optional: Delete data, a data source, or a data layer.
   

Manage user and group access to viewing data layers and to managing resources.

To manage user roles and security:

1. Click Configuration > Resource Access.
2. Select:
   • By user to select one user and grant access to one or more resources to that user.
   • By group to select one group and grant access to one or more resources to that group.
   • By resource to select one resource and grant access to one or more users or groups to that resource.
3. Click Save.
4. Optional: To revert to default values and lose all changes, click Reset.

Create analysis views to reveal relations and correlations among data.

1. Click Configuration > Analysis Views.
2. Specify a name and description.
3. Specify a display order and time frame.
4. Select one or more categories as dimensions for the analysis.
5. Select parameters for the analysis view cluster:
   • Cluster by distance to compare and collect facts about
     • any of the specified categories
     • within the specified time period
     • within the specified distance
   • Cluster by distance and correlate dimensions in different categories to compare and collect facts
     • in different categories
     • within the specified time period
     • within the specified distance
   • Cluster by distance and correlate dimensions with time to compare and collect facts
     • in different categories
     • within the specified time period
     • within the specified distance between facts
     • within the specified time interval between facts
6. Select maximum distance and time interval.
7. Select a named area to apply the analysis to.
8. Click Add.

To connect to permitting software you must create an adapter.

To configure a permitting system adapter:

1. Extract SamplePermittingAdapter.zip.
2. Import the Eclipse project from SamplePermittingAdapter.zip.
3. Modify the build path of the imported Eclipse project to include the Java libraries from installation_directory/topology/ioc_topo/icpo/Samples/lib. Remove all other projects and libraries from the build path except the projects and libraries in the specified directory.
4. Create a new Java project that includes a class that implements the IPermittingService interface.
5. Export the project as a Java JAR file to the /opt/IBM/iss/common/lib folder on the IBM Intelligent Operations Center APP node.
6. Modify the row in the PO.APPLICATION_CATEGORY table in the IOCDB database so that the IMPL_CLASS_NAME field contains the fully qualified class name of the new adapter.

You can add or delete named area types or categories.

To add or delete a named area type:

INSERT INTO  CITY_HUB.NAMED_AREA_TYPE (NAME, DESCRIPTION) VALUES ('Retail Center' ,  
	'Area with shopping and restaurants');

DELETE FROM CITY_HUB.NAMED_AREA_TYPE WHERE NAME='Retail Center';

To enable the Licensing and Tax Investigation application you must install and configure the connector, configure messaging, and import data from theIBM i2 Intelligence Analysis Platform.

1. Install the IBM i2 Intelligence Analysis Platform connector.
2. Configure messaging for the Licensing and Tax Fraud application.
3. Send fraud alerts from IBM i2 Analyst's Notebook.
4. Import data from the IBM i2 Intelligence Analysis Platform staging table.
   
5. View fraud alerts.

You can select, search, and filter data, which is viewed as layers and displayed on the map.

1. Click Layers.
2. Select a layer category, such as Events or Incidents.
3. Select one or more layers. You must select at least one layer to run a query. You can choose to filter data from a layer based on attributes that are configured for the layer. Filters apply only to the selected layer.
4. Optional: Click When and specify a date or time range. The selected parameters apply to all selected layers.
5. Optional: Click Where and specify parameters, such as region, address, or proximity, or an area that you draw on the map. The selected parameters apply to all selected layers.
6. Click Submit.
7. Optional: To save a query, click Save. You must specify a name for the saved query, and choose to make it private or public.

You can reveal relations and correlations by using analysis views.

To reveal relations and correlations:

1. Click Analysis Views.
2. Select a predetermined analysis view.
3. Review the details of facts included in the analysis view. You can show or hide layers listed in the map legend, and view details in the timeline and detail panel at the bottom of the page.

You can save and retrieve information about a fact, including comments and locations, in a bookmark.

1. Select a fact on the map. A fact details page is displayed.
2. Click Add Bookmark. The Bookmark window opens.
3. Enter a name for the bookmark, and click Create Bookmark.. The new bookmark is added at the bottom of the bookmark list.
4. Optional: Add a comment, and click Add Comment. If the bookmark is not private, other users can add comments.

Review and evaluate permit applications for various activities in your city to reveal conflicts over time and space.

To analyze and monitor permits:

1. Open and log in to IBM Intelligent City Planning and Operations.
2. Click Permit Optimization.
3. From the Search Criteria panel, select an Application Module, Application Type, Review Type, and Review Result, then click Submit. If any of these fields is blank, ask your system administrator to verify your database connection.
4. Select a permit application to review from the search results, then click Select.
5. To specify an area associated with the selected permit application, click Define Area. You can draw an area on the map, name the area, and specify start and end dates. Or you can display the coordinates of a selected area. You can reuse previously defined areas.
6. To view the layers displayed on the map for the selected permit, expand the map legend panel. If defined areas are associated with the selected permit application, they will be listed in the legend. You can toggle the defined areas that are displayed on the map.
7. To associate a bookmark with the selected permit application, click Bookmarks and select an existing bookmark, or create a new bookmark. Use bookmarks to save related data between data layers and permits
8. To add comments, click Notes..
9. To view dates and times associated with the permit application, open the timeline panel at the bottom of the page.
10. When you have finished editing the permit application properties, click Save, or to revert to the previous properties, click Reset.
11. If you are ready to accept or deny the permit application, select an action from the Review Result menu, then click Save.

Examine fraud alerts from IBM i2 Intelligence Analysis Platform to reveal unlicensed businesses and lost revenue opportunities.

To view fraud alerts:

1. Open and log in to IBM Intelligent City Planning and Operations.
2. Click Layers.
3. Select the data layer that includes alerts from the IBM i2 Intelligence Analysis Platform database.
4. Click Submit to submit a query that will display the imported fraud alert data. To view the alerts in the context of other data, include additional layers in your query.