Download - intra-mart Accel Platformaccel-archives.intra-mart.jp/2014-winter/document/iap/...Editing Configuration File Apache Cassandra Startup Apache Cassandra Setup Note In this setup, Apache

Transcript

Table of Contents

1. Revision History2. Introduction

2.1. Document Purpose2.2. Prerequisites2.3. Target Readers2.4. Terminology Description

3. Setup Overview4. Setup Flow5. Middleware Setup

5.1. Database5.2. Web Application Server5.3. Apache Cassandra5.4. Apache Solr

6. WAR File Creation6.1. Project Creation and Module Creation6.2. Editing Configuration File6.3. WAR File Output

7. Web Application Server Startup8. WAR File Deployment9. Tenant Environment Setup

9.1. System Administrator Information9.2. Tenant Information9.3. Tenant Environment Information9.4. Tenant Administrator Information9.5. LDAP Linkage/Setting9.6. Apache Cassandra Connection Information9.7. Apache Solr Connection Information9.8. Registration

10. Uninstallation10.1. WAR File Undeployment10.2. Application Deletion10.3. Storage Area Deletion10.4. Middleware Product Deletion

Please proceed to [ Introduction ].

Quick Setup GuideVERSION 3 2014-08-01

intra-mart Accel Platform

1

Revision History

RevisionDate Updated Contents

2014-01-01

Initial Version

2014-04-01

Version 2 Following additions/changes have been made.

Table of contents structure has been improved.

2014-08-01

Version 3 Following additions/changes have been made.

Added descriptions to each wizard page [Tenant Environment Setup ].Added the link to [Solr Administrator Guide] to [Apache Solr ].

intra-mart Accel Platform

2

Introduction

Document Purpose

In this document, easy way to set up intra-mart Accel Platform is described.Setup contents are for the users who set up intra-mart Accel Platform for the first time.

Note

[*] intra-mart Accel Platform to be set up is stand alone (minimum configuration).[*] Apache Cassandra and Apache Solr can be optionally set up.

Prerequisites

System requirements described in the release note should be met.Please refer to [Release Note ]-[System Requirements ] for details.

Note

If you use TRY version, setup can be made even when you are using the OS that is not listed in the serverrequirments in the release note above.intra-mart Accel Platform will operate on any OS which supports JDK.For example, setup can be performed in Windows 7 environment.

Every environment such as the environment set up in this document and the environment accessed by Web browser mustreside in the same enclosure (local environment).

Target Readers

Following users are the target readers.

Users who set up intra-mart Accel Platform for the first time

Note

Please refer to [Setup Guide ] for the setup contents in detail.

Terminology Description

Directory which Resin is installed is abbreviated as %RESIN_HOME%.Directory to be used as Storage is abbreviated as %STORAGE_PATH%.Directory to be used as PublicStorage is abbreviated as %PUBLIC_STORAGE_PATH%.

Go to [ Setup Overview ].

Setup Overview

intra-mart Accel Platform

3

Setup overview is as follows.

1. Set up middleware.Subjects for setup are JDK, Database, Resin, Apache Cassandra, and Apache Solr.

Warning

If you do not use IMBox, you do not have to set up Apache Cassandra,but you must remove IMBox module. Details are described in [ How to remove IMBox Module ].If IMBox module is included, connection error to Apache Cassandra would occur during setup.

Warning

If you do not use IM-ContentsSearch for Accel Platform, Apache Solr setup is not necessary.

2. Create WAR file using IM-Juggling.

Note

What is WAR file?

It is a Web Application Archive file defined in JavaEE,and various types of files necessary for the operations of intra-mart Accel Platform are stored.WAR file for intra-mart Accel Platform is created by IM-Juggling.Various files necessary for the operations of intra-mart Accel Platform are stored, andby deploying the WAR file created by IM-Juggling to Web Application Server such as Resin,and by starting Web Application Server,intra-mart Accel Platform itself or various applications that support intra-mart Accel Platform stored in theWAR filewill be started and be made available.

3. Deploy(expand) the created WAR file on Web Application Server ( Resin ).

4. Access from the browser and execute tenant environment setup (such as data input to the database).

Go to [ Setup Flow ].

Setup Flow

Following flowchart shows the setup procedures.Please refer to the link destination of the list for the setup procedures for each step.

Legend

Mandatory・・・Items which require the setup.Optional・・・Items for which setup process may be skipped.

intra-mart Accel Platform

4

Name Description

start

JDK JDK

Database Database Server

JDBC Driver JDBC Driver

ApplicationServer Web Application Server

Apache Cassandra Apache Cassandra

Apache Solr Apache Solr

Module Selection WAR File Creation - Project Creation and ModuleCreation

Configuration File WAR File Creation - Editing Configuration File

WAR File Output WAR File Creation - WAR File Output

Startup Web Application Server Startup

Deployment WAR File Deployment

Tenant Build Tenant Environment Setup

License Registration License Registration

end

Middleware Setup

Following should be installed and set for the setup of intra-mart Accel Platform.

Database

Following installations and settings which are required for Database setup should be performed.

Database Server

Topics

intra-mart Accel Platform

5

PostgreSQL Build Example

PostgreSQL Build Example

PostgreSQL is used in this document.

PostgreSQL Installation

PostgreSQL can be downloaded from the URL below.After you download the one appropriate to the environment, please proceed on the installation.

http://www.enterprisedb.com/products-services-training/pgdownload (English)In case of PostgreSQL 9.3 (32bit), click <Win x86-32>.In case of PostgreSQL 9.3 (64bit), click <Win x86-64>.

Database and Log-in Role Creation

1. Start up pgAdmin tool.

2. Log-in rule creation

Right click [Log-in Role] from [Object Browser] and click [New Log-in Role].

Sub-window is displayed.

Enter following items and click [OK].

Property Tab [Role Name] (optional)

Definition Tab [Password] (optional)

Note

Following contents are specified as an example in this document.

Role name [imart]

Password [imart]

3. Database Creation

Right click [Database] from [Object Browser] and click [New Database].

Sub-window is displayed.

intra-mart Accel Platform

6

Enter following items, select them, and click [OK].

Property Tab [Name](optional) [Owner](log-in role which was created in [2. Log-in Rule Creation] described above)

Note

Following contents are specified as an example in thisdocument.

Name [iap_db]

Owner [imart]

Go to [ JDBC Driver ].

JDBC Driver

Warning

JDBC driver to be used by intra-mart Accel Platform is JDBC 4. JDBC 4.1 has notbeen verified yet.

1. JDBC driver of PostgreSQL can be downloaded from the URL below.

In case of PostgreSQL 9.3, please obtain <postgresql-9.3-1100.jdbc4.jar> file.http://jdbc.postgresql.org/download/postgresql-9.3-1100.jdbc4.jar

Go to [ Web Application Server ].

Web Application Server

Topics

Obtaining ResinInstallationResin SettingJDBC Driver Placement

intra-mart Accel Platform

7

Obtaining Resin

Note

If you use TRY version, Resin can be downloaded from [TRY version Downloading Site] shownbelow.

http://www.intra-mart.jp/support/try_j.html

[*] Please fill in the questionnaire, and download the one listed below from the page aftertransition.-> Caucho Resin (Application Server)

Resin 4.0.37.zip (Windows)

Note

In case of Product Version DVD, it is included in the directory below.

%Product Version media image (DVD)%/Products/tools/iap/Resin Directory-> resin-pro-4.0.37.zip

Installation

Expand <Resin> archive file which is included in the media to arbitrary path.

Note

In this document, following directory is specified as an example.[C:/Resin4.0.40]

Warning

[.NET Framework 3.5] is necessary to start Resin.In Windows Server 2012 environment, only [.NET Framework 4.5] is installed,so please do the setup of [.NET Framework 3.5].Please refer to [ .NET Framework Setup ] for details.

Resin Setting

1. Open <C:/Resin4.0.40/conf/resin.properties> file.

2. Set memory value and maximum heap size suitable for the installation environment to [jvm_args] property.

In this ducument, following value is set as an example.

# Arg passed directly to the JVMjvm_args : -Xmx1024m -XX:MaxPermSize=256m

Warning

Setting value should be [1024m] or larger.If you set the value less than [1024m], it may not work properly.

Note

If the error which indicates the duplication of port at Resin startup time occurs,please change the setting of port number after Resin is stopped.

intra-mart Accel Platform

8

java.lang.RuntimeException: java.net.BindException: Address already in use: JVM_Bind Can't bind to *:8080. Check for another server listening to that port.

Please change [8080] which is set to [app.http] property to the unused port numbersuch as [8081].

# Set HTTP and HTTPS ports.# Use overrides for individual server control, for example: app-0.http : 8081app.http : 8081

Please restart Resin after the change is completed.

JDBC Driver Placement

1. Copy the downloaded JDBC driver to the following directory.

C:/Resin4.0.40/lib

Go to [ Apache Cassandra ].

Apache Cassandra

Apache Cassandra Setting

Topics

Apache Cassandra SetupEditing Configuration FileApache Cassandra Startup

Apache Cassandra Setup

Note

In this setup, Apache Cassandra is set up on the same machine with intra-mart Accel Platform.

Obtain Apache Cassandra.

Apache Cassandra can be downloaded from the URL below.

http://archive.apache.org/dist/cassandra/1.1.12/apache-cassandra-1.1.12-bin.tar.gz

After downloading, <apache-cassandra-1.1.12-bin.tar.gz> file is expanded to the arbitrary path.

[*] Please use unzip tool that can expand zip file in TAR-GZ format for file expansion.

Note

Following directory is specified as an example in this document.

[C:/apache-cassandra-1.1.12]

Open <C:/apache-cassandra-1.1.12/bin/cassandra.bat> file by the editor.

Memory value suitable for the installation environment is specified.

Specify the minimum heap size to [Xms] property and the maximum heap sizefor [Xmx] property.

Note

set JAVA_OPTS=-ea^-javaagent:”%CASSANDRA_HOME%libjamm-0.2.5.jar”^

intra-mart Accel Platform

9

-Xms512M^-Xmx512M^

Warning

The value to be set should be [512M] or larger.As Cassandra, it is recommended to set it to 1GB or above.If you set the value which is smaller than [512M], it may notwork properly.

Add the home directory where JDK7 is installed to the Windows environment variable.

Please set as follows according to the Windows OS manual.

Variable JAVA_HOMEValue Home directory where JDK is installed.

Editing Configuration File

Environment setting is to be made.

*Open <C:/apache-cassandra-1.1.12/conf/cassandra.yaml> file by editor.

Warning

This file has read-only attribute immediately after file expansion, soplease remove it in advance.

Specify save location of the data.If there is no specified directory, it would be automatically created at startuptime.

Specify the arbitrary path to [data_file_directories] property.

Note

Following contents should be specified as anexample in this document.

data_file_directories:- C:/apache-cassandra-1.1.12/data_file

Specify save location of CommitLog.If there is no specified directory, it would be automatically created at startuptime.

Specify arbitrary path to [commitlog_directory] property.

Note

Following contents are specified as an example inthis document.

# commit logcommitlog_directory: C:/apache-cassandra-1.1.12/commit_log

Specify save location of cache data.If there is no specified directory, it would be automatically created at startuptime.

Specify arbitrary path to [saved_caches_directory] property.

Note

Following contents are specified as an example inthis document.

# saved cachessaved_caches_directory: C:/apache-

intra-mart Accel Platform

10

cassandra-1.1.12/saved_caches

Open <C:/apache-cassandra-1.1.12/conf/log4j-server.properties> file by editor.

Warning

This file has read-only attribute immediately after fileexpansion, so please remove it in advance.

Specify save location of system log.

Specify arbitrary path to [log4j.appender.R.File] property.

Note

Following contens are specified as anexample in this document.

log4j.appender.R.File=C:/apache-cassandra-1.1.12/system.log

Apache Cassandra Startup

Start up Apache Cassandra.

Double click <C:/apache-cassandra-1.1.12/bin/cassandra.bat>.

Startup would be completed if the message below is displayed on the command prompt.

INFO 12:55:11,319 Using synchronous/threadpool thrift server on localhost/127.0.0.1 : 9160INFO 12:55:11,320 Listening for thrift clients...

Note

When you start up Apache Cassandra, please change the port number setting ifthe following error occurs.

Error : Agent throws the exception : java.rmi.server.ExportException: Port already in use: 7199;nested exception is: java.net.BindException: Address already in use: JVM_Bind

Open <C:/apache-cassandra-1.1.12/bin/cassandra.bat> file by the editor.

Please change [7199] that is set toDcom.sun.management.jmxremote.port propertyto the port number which has not been used such as [7198].

-Dcom.sun.management.jmxremote.port=7198^

If the change was successful, please start up Apache Cassandra again.

Note

If the startup from the second and subsequent time does not work properly,

Delete <C:/apache-cassandra-1.1.12/commit_log> directory andstart up Apache Cassandra.

Note

How to stop Apache Cassandra

Execute [Ctrl] + [C] command on the command prompt thatappeared at startup time, and stop the process.

Please refer to [Cassandra Administrator Guide ] for more detailed settings.

Then, please proceed to [ Apache Solr ].

intra-mart Accel Platform

11

Apache Solr

Topics

PrerequisitesApache Solr Setup[Apache Solr] Startup, Connection to Admin Screen, and Stoppage

Prerequisites

When you set up [Apache Solr] on [Resin], [Resin] should be already installed.

If you select [Standard Application]-[IM-ContentsSearch for Accel Platform] module on IM-Juggling anduse [IM-ContentsSearch for Accel Platform], [Apache Solr] server should be built.

Apache Solr Setup

1. Expand <solr_setup.zip> file which is included in the media to the arbitrary path.

[Apache Solr] setup tool can also be downloaded from the URL below.

http://www.intra-mart.jp/download/product/iap/im_contents_search/solr_setup.zip

Note

The directory below is specified as an example in this document.

[C:/solr]

2. Open command prompt and move to the next path.

C:/solr/solr_setup

3. Enter the following command.

If you press <Enter> key, setup tool would be executed and setup tool command list and its description wouldbe displayed.

C:/solr/solr_setup> setup.bat

C:\solr\solr_setup>C:\solr\solr_setup> setup.batBuildfile: C:\solr\solr_setup\build\build.xml

usage: [echo] Welcome to the Apache Solr Installation! [echo] Use '' to display usage [echo] Use 'usage' to display usage [echo] Use 'jetty' to download the jetty zip file, solr zip file and the solr.war and unzip the zip files and config the jetty port [echo] Use 'jetty.start' to download the jetty zip file, solr zip file and the solr.war and unzip the zip files and config the jetty port and start the jetty [echo] Use 'resin' to download the solr zip file and the solr.war for resin and unzip the zip file [echo] Use 'tomcat' to download the solr zip file and the solr.war for tomcat and unzip the zip file

BUILD SUCCESSFULTotal time: 1 second

C:\solr\solr_setup>

4. Set up to Resin.

If you execute C:/solr/solr_setup> setup.bat resin, resin directory will be created in ./dist directory.

Note

Shown below is a part of screen which is displayed after setup. bat resin is executed.

intra-mart Accel Platform

12

[get] .................................................... [get] .................................................... [get] .................................................... [get] .................................................... [get] .................................................... [get] .................................................... [get] .................................................... [get] .................................................... [get] ........... [get] last modified = Thu Sep 27 01:25:24 JST 2012

md.resin.webapps: [echo] make resin webapps dir(../dist/resin/resin/webapps)... [mkdir] Created dir: C:\solr\solr_setup\dist\resin\resin\webapps

copy.resin.solr.war: [echo] copy the solr.war from ./download/solr.war to ../dist/resin/resin/webapps... [copy] Copying 1 file to C:\solr\solr_setup\dist\resin\resin\webapps

common.display.readme: [echo] ========================================================================================================== [echo] [*] Definition [echo] Directory which <%resin_home%>:Application Server Resin is installed [echo] [echo] [*] Placement and setting of Solr [echo] Copy /dist/resin_solr/resin/*.* to <%resin_home%>. [echo] [echo] [*] Solr home location setting [echo] Add the contents of /dist/resin_solr/env-entry.txt to <%resin_home%>/conf/resin.xml. [echo] [echo] Copy env-entry.txt contents before </resin> of resin.xml. [echo] [echo] ========================================================================================================== [echo] C:\solr\solr_setup\dist\resin\readme.txt

BUILD SUCCESSFULTotal time: 11 seconds

C:\solr\solr_setup>

5. When setup tool execution is completed, file group which is necessary for the setup will be output to ./distdirectory.

Then, please execute the steps stated in readme.txt in the file (same with the contents displayed at commandcompletion).

Note

Resin which should be set up by Apache Solralso operates in the same environment with Resin which sets up intra-mart Accel Platform.

6. This completes the setup.

If you need to know more details about the settings, please refer to [ Solr Administrator Guide ].

[Apache Solr] Startup, Connection to Admin Screen, and Stoppage

1. Start up Resin which sets up [Apache Solr].

2. Connect to Admin screen of [Apache Solr] and check if the [search] button operates normally.

http://localhost:8080/solr/default/admin/

[*] Screen below is just an example.

intra-mart Accel Platform

13

Go to [ WAR File Creation ].

WAR File Creation

Following procedures are required for the WAR file creation.

Project Creation and Module Creation

What is IM-Juggling?

IM-Juggling is the environment build tool that can manage modules and execute remote deployment of WAR files.This tool can be used to install new functions and apply corrections to the defects.

IM-Juggling Installation

Expand IM-Juggling for the environment to the arbitrary path.

Note

If you use TRY version, IM-Juggling can be downloaded from [TRY VersionDownload Site] below.

http://www.intra-mart.jp/support/try_j.html

[*] Please fill in the questionnaire, and then download the one listed below fromthe page after transition.–> IM-Juggling (tool that creates WAR files)

IM-Juggling (Windows 32Bit)IM-Juggling (Windows 64Bit)

Warning

Repository data to be used in IM-Juggling is also included in the product copy.

%Product copy media image (DVD)%/Products/repository Directory

If IM-Juggling is copied from product copy media image and started,this setting path may not be the appropriate setting.Please check if the reference destination of local depository is the correct settingpathby clicking [Setting]-[IM_Juggling]-[Module Repository] on the right edge of tool barinside the IM-Juggling window.In case of internet connection, if the location starting with “ http://” is enabled(checked),external repository is to be accessed.

intra-mart Accel Platform

14

Warning

If proxy setting is required in the environment to be used, please open [Setting]-[General]-[Network Connection].If [Native] is selected as active provider, proxy server setting information of InternetExplorer will be inherited.(It is the proxy server setting displayed when you display menu by pressing [Alt] keyin Internet Explorer and clicking [Tool]–>[Internet Option]–>[Connection] tab–>[LANSetting].

Please select [Manual Operation] as the active provider,and click [Edit] of [HTTP] of proxy entry.And set [Host], [Port], and [Authentication Information] on [Proxy Entry Edit] screenand click [OK].

Warning

If the error such as repository information obtaining occurs when you create project orWAR file using IM-Juggling,please delete the data in the following directory and start IM-Juggling again.

%OS user directory%/juggling/workspace/.repository Directory

Old information may be the cause of the error.By deleting this old file, the latest data would be obtained again and you can avoidthe issue.

Project New Creation

1. Start juggling.exe which is immediately under the expanded directory.

2. In case of first startup time, [License Contract Agreement] is displayed.Select [I agree] and click [OK].

3. Dashboard is displayed.Select [Create Project newly].

4. Enter arbitrary project name in single-byte alpha-numeric characters to the [Project Name] inside the wizardscreen which is pop-up displayed.After you enter, click [Next(N)].

intra-mart Accel Platform

15

5. Select product and version to be used.After you select, click [Next(N)].

Note

If multiple versions are displayed in the same product, it is recommended to selectthe latest one.

6. Select the application to be used.After you select, click [Next(N)].

intra-mart Accel Platform

16

Warning

[Migration Tool] and [Compatibility Function] are selected for the migration fromversion7.2.Please do not select it since you do not need it in the setup in this document.

7. Screen to select additional source (configuration file etc.) for the platform to be used is displayed,but just click [Next(N)] without any change.

8. Click [Finish(F)] at last.

intra-mart Accel Platform

17

9. Project creation process would be performed and the following screen will be displayed if it is completed.

Module Selection

1. Select the module to be used.[*] In case IMBox is used, nothing needs to be changed.

Warning

If IMBox is not included in the configuration, IMBox module needs to be removed.Please refer to [ How to remove IMBox Module ] for detail.

Application Addition

After the project creation, the application can be added.

1. Click the [Application] tab and click [+].

intra-mart Accel Platform

18

2. Click the application that you want to add, and click [OK].

Warning

[Migration Tool] and [Compatibility Function] are selected for the migration fromversion7.2.Please do not select it since you do not need it in the setup in this document.

Note

In case the error message is displayed on the upper part of the screen

There is a dependency by each module and each application.

intra-mart Accel Platform

19

Necessary setting can be added by the following procedures.

1. Click the message.2. Click [OK] on [Resolve Dependency] screen.

Go to [ Editing Configuration File ].

Editing Configuration File

Following files should be edited to operate intra-mart Accel Platform.

DataSource

Setting of Database( PostgreSQL ) used on intra-mart Accel Platform is made.

1. Open <(project name)/resin_web.xml> file inside the [ProjectNavigator] by doubleclicking and select [Source] tab.

2. Database connection information of connection destination is set to <web-app>/<database>/<driver>.

<driver> <type>org.postgresql.Driver</type> <url>jdbc:postgresql://localhost:5432/iap_db</url> <user>imart</user> <password>imart</password></driver>

Go to [ Storage ].

Storage

Path to be used as Storage area is specified.

1. Open <(project name)/conf/storage-config.xml> inside the[ProjectNavigator] by double clickingand select [Source] tab.

2. Storage area path is set to <storage-config>/<storage-info>/<root-path-name>.

<root-path-name>/tmp/storage</root-path-name>

Warning

In case of default setting ([/tmp/storage]), Storage folderwill be created on the drive that starts Resin.

Example: In case Resin is started on [C Drive],Storage folder will be created in [C:/tmp/storage] folder.

intra-mart Accel Platform

20

Go to [ WAR File Output ].

Note

If there is no configuration file on the tree inside the [ProjectNavigator],

1. Double click <(project name)/juggling.im> file.2. Click [Configuration File] tab.3. Select the subject configuration file and click [Output] on the right.4. Double click on the file displayed on the tree in [ProjectNavigator] to edit it.

Go to [ DataSource ].

WAR File Output

1. Open <juggling.im> file and click [Build Wizard] icon on the upper-right.

2. Select the subject server on [Select Server Product] and click [Next].

Note

Resin 4.0.x should be selected in this document.

intra-mart Accel Platform

21

3. Do the setting on [Basic Setting] screen and click [Next].

Note

In this document,select [Product Version] as usage type.Select [C:\] as war file output folder.Enter [imart] as file name (no extension).Put a check mark on Including Sample.Select [Operations Environment] as execution environment.

Warning

As [WAR File Output Folder], please specify the folder with execution user authority.

4. Check the contents on [License Review] screen, select [I agree to terms of usage conditions] if you agree, andclick [Next].

5. Check the contents on [Confirm Setting Items] screen and click [Finish].

Juggling build wizard screen will show up and downloading will be started.It may take some time for downloading, and so please refrain from operations until its completion.

intra-mart Accel Platform

22

6. When WAR file is output to the specified location, the build wizard screen is closed.WAR file will be output to the specified directory.

Go to [ Web Application Server Startup ].

Go to [ Project Creation and Module Creation ].

Web Application Server Startup

Warning

If you use IMBox, Apache Cassandra should be started before you start Resin.Double click <C:/apache-cassandra-1.1.12/bin/cassandra.bat> to start it.

Warning

In order to start up Resin, [.NET Framework 3.5] is necessary.Since only the [.NET Framework 4.5] is installed in Windows Server 2012 environment,please set up [.NET Framework 3.5].Please refer to [ .NET Framework Setup] for detail.

1. Double click <C:\ Resin4.0.40\resin.exe> file.Start/Stop screen and the console will be displayed.

intra-mart Accel Platform

23

2. Startup would be completed if the following messages are displayed on the console.

[12-07-02 18:30:00.000] {main} http listening to *:8080[12-07-02 18:30:00.000] {main}[12-07-02 18:30:00.000] {main} Resin[id=app-0] started in 55480ms

Note

Resin Stoppage

1. Click [Stop] on the Start/Stop screen which was displayed at startup time.

2. It has been stopped when the following message is displayed on the console.

{resin-shutdown} Shutdown Resin reason: OK

Go to [ WAR File Deployment ].

WAR File Deployment

1. Place the war file which was created in IM-Juggling to the arbitrary directory.

2. Start the command prompt and execute following commands.

> cd C:\ Resin4.0.40\> resin deploy ..\imart.war

Warning

Resin needs to be started for WAR file deployment.

Note

In case you need to stop Resin

1. Click [Stop] on the start/stop screen which was displayed at startup time.

It has been stopped when the following message is displayed on console.

{resin-shutdown} Shutdown Resin reason: OK

Go to [ Tenant Environment Setup ].

Tenant Environment Setup

Do Tenant Environment Setup using the Web browser.

intra-mart Accel Platform

24

Access the URL below from Web browser.

System Administrator Log-in Screen: http://<HOST>:<PORT>/<CONTEXT_PATH>/system/login

[*] In case you set up Web Application Server in local environment according to the example in this document,you can establish connection with the address below.

System Administrator Log-in Screen: http://localhost:8080/imart/system/login

Note

As a context path, please specify the one you set at the time of deployment.In case of Resin, it will be the WAR file name at the time of deployment.Please refer to resin_war_deploy.For Web Application Server other than Resin, it will be the [Context Root] which is specified at the time ofdeployment.

Tenant Environment Setup procedures of intra-mart Accel Platform are shown as below.

Please refer to the followings for the detail of each wizard.

System Administrator Information

1. System Total Administrator is set.

intra-mart Accel Platform

25

Item Mandatory/Optional DescriptionUser Code Mandatory Enter user code of system administrator.Password Optional Enter password of system administrator.Password(confirmation)

Optional Enter password of system administrator.

Locale Mandatory Select the locale of system administrator.

Tenant Information

1. Tenant Basic Information is set.

Item Mandatory/Optional DescriptionTenant ID Mandatory Enter the Tenant ID.DefaultLocale

Mandatory Select the default locale of tenant.

Time Zone Mandatory Select the time zone of tenant.Number ofAccountLicenses

Optional Enter the number of account licenses oftenant.

Tenant Environment Information

1. Tenant Environment Information is set.

Warning

In the case of Web Application Server other than Resin,setting for Resource Reference Name, Storage Path, and BaseURL are not displayed.

intra-mart Accel Platform

26

Item Mandatory/Optional DescriptionResourceReferenceName

Optional Resource Reference Name is selected.

Storage Path Optional Enter the path to Public Storage.Base URL Optional Enter the Base URL.

Note

If it is not specified, contents of each setting file will be in effect.

Tenant Administrator Information

1. Tenant Administrator is set.

Item Mandatory/Optional DescriptionUser Code Mandatory Enter user code of tenant administrator.Pssword Optional Enter password of tenant administrator.

intra-mart Accel Platform

27

Password(confirmation)

Optional Enter password of tenant administrator.Item Mandatory/Optional Description

Note

If the setup is interrupted because of the error that has occurredduring tenant environment setup, tenant administrator will not beregistered even if you do the setup again.In case the normal registration of tenant administrator could not bedone, you need to start from the Tenant Management Screen toregister tenant administrator.For the deails, please refer to the [Newly Create TenantAdministrator] section of [System Administrator OperationsGuide]- [Tenant Management].

LDAP Linkage/Setting

1. LDAP Linkage/Setting Information is set.

Note

Contents of Project /conf/ldap-certification-config.xml of IM-Juggling will bedisplayed initially.Please note that the value of <enable> tag is false.

Warning

LDAP authentication is enabled only when the contents of <enable> tag istrue.In case LDAP authetication is made enabled, please do the correct setting ofautheticated LDAP.

Item Mandatory/Optional Description

intra-mart Accel Platform

28

SettingContents

Mandatory LDAP Authentication Enable/Disable andInformation of Authenticated LDAP are entered.Please refer to the descriptions of [LDAPAuthentication Setting File] for input contents.

Item Mandatory/Optional Description

Apache Cassandra Connection Information

1. Apache Cassandra Connection Information is entered.

Warning

Apache Cassandra connection information is diplayed onlywhen IMBox is used.Before you execute tenant environment setup, it is necessarythat Apache Cassandra is set and launched.For the details of Apache Cassandra setting, please refer to[IMBox Cassandra Administrator Guide].

IMBox Cassandra Administrator Guide (Japanese)

IMBox Cassandra Administrator Guide (English)

IMBox Cassandra Administrator Guide (Chinese)

Item Mandatory/Optional DescriptionCluster Name Mandatory Enter cluster name of Cassandra

server.Key Space Mandatory Enter key space of Cassandra server.ConnectionDestination

Mandatory Enter IP address and port number ofthe server Cassandra is operated on.Connection destination is entered by[IP addess] or [IP address:portaddress]. (In case port number isomitted, use 9160.)In case port number other than 9160is specified, error will occur in the newnode detection function.If multiple Cassandra’s are operatedin the distributed configuration, pleaseenter every connection destination ineach line one by one.

intra-mart Accel Platform

29

ReplicationFactor

Mandatory Enter the number of Replicas of datainside the cluster.Replication factor is used only whenthe key space is created.

AuthenticationInformationSetting

Optional Select authentication usage inCassandra connection.In case authentication information isset, it is necessary to create the keyspace in advance to check the writeauthority.

AuthenticationUser Name

It is mandatory onlywhen authenticationsetting is used.

Enter connection user name inCassandra authentication connection.It is displayed only whenauthentication setting is used.

AuthenticationPassword

It is mandatory onlywhen authenticationsetting is used.

Enter password in Cassandraauthentication connection.It is displayed only whenauthentication setting is used.

TestConnection

You can test if Cassandra connectioncan be established with the contentsentered.It is recommended that you alwaysperform it when any tenant is created.

Item Mandatory/Optional Description

Note

Initial value of Cassandra connection information at registrationtime will be the setting value of Cassandra server connectionsetting (cassandra-config.xml).For the details of cassandra-config.xml, please refer toCassandra Server Connection Setting(cassandra-config.xml) .

Apache Solr Connection Information

1. Apache Solr Connection Information is entered.

Warning

Apache Solr connection information is displayed, only when IM-ContentsSearch for Accel Platform is used.In case IM-ContentsSearch for Accel Platform is used, it isnecessary to set up Apache Solr.For the details about setup of Apache Solr, please refer to[Apache Solr].

intra-mart Accel Platform

30

Item Mandatory/Optional DescriptionSet Solrconnectioninformation.

Optional When tenant environment setup ismade, this button switches if ApacheSolr connection information is set ornot.

Group ID Fixed (“default”) Group ID of standard connectiondestination may not be changed from“default”.

StandardConnectionDestination

Mandatory (onlywhen [SolrConnectionInformation] button isenabled)

Select connection destination.It can be selected only when [SolrConnection Information] button isenabled.Connection destination which is set asthe standard connection destination foranother tenant will not be displayed.If this is the initial tenant environmentsetup or if there is no setting for Solrconnection,Solr connection setting (“default”)which is defined in Solr ServerConnection Configuration file (solr-config.xm) is displayed in the selectionitems.

Note

By making the items to non-display by [Set Solr ConnectionInformation] button, tenant environment setup can be executedwithout setting the Apache Solrconnection information.On the Tenant Management Screen of System AdministratorMenu, Apache Solr connection information can be set to thecreated tenant.If the Solr Server Connection Configuration file (solr-config.xml)does not exist or cannot be loaded, items are not displayed.They are always skipped.

Note

If the setting value (“default”) of Solr Server ConnectionConfiguration file (solr-config.xml) is selected and tenantenvironment setup is executed,setting value which is set in the setting value of solr-config.xml(<group name=”default”>) is registered to the system databaseas Solr connection information.For the details about solr-config.xml, please refer to [ SolrServer Connection Setting (solr-config.xml) ].

Registration

1. When the setting of each step has been completed, please click [Register].

intra-mart Accel Platform

31

Warning

Number of steps of wizard will vary depending on the module which was selected in [ Project Creationand Module Creation ].

Note

Please refer to Tenant Environment Setup on or before intra-mart Accel Platform 2013 Winterfor Tenant Environment Setup in earlier updated version.

Uninstallation

Uninstallation of all files and data related to intra-mart Accel Platform is performed in this chapter.Please refer to the respective product manuals for the uninstallation of middleware products etc.

Warning

In case you delete the arbitrary tenant created in Multi-Tenant by Virtual Tenant,please refer to [System Administrator Guide ]-[Update the tenant information ].

Topics

WAR File UndeploymentApplication DeletionStorage Area DeletionMiddleware Product Deletion

WAR File Undeployment

1. Execute the following command.

In case of Windows (start Command Prompt)

> cd <%RESIN_HOME%>> resin undeploy application name (directory name which is the same name with the WAR file expanded under <%RESIN_HOME%>/webapps)

In case of Linux

# <%RESIN_HOME%>/bin/resinctl undeploy application name (directory name which is the same name with the WAR file expanded under <%RESIN_HOME%>/webapps)

intra-mart Accel Platform

32

2. After undeployment, delete the following file manually.

Directory which is the same name with the WAR file under <%RESIN_HOME%/webapps>.

Note

If you use multi-tenants, please repeat the operation above for each WAR file which is subject toundeployment.

Warning

Resin should be started for WAR file undeployment.

Application Deletion

1. Delete the following file directory which is expanded on Resin.

File directory under <%RESIN_HOME%/resin-data>

Directory under <%RESIN_HOME%/webapps>

Warning

Resin should be stopped.Please refer to Web Application Server Startup for how to stop.

Storage Area Deletion

1. Delete the file directory under <%STORAGE_PATH%>.

2. Delete the file directory under <%PUBLIC_STORAGE_PATH%>.

Middleware Product Deletion

Resin

Delete <%RESIN_HOME%> directory.

Database

Refer to Database manual that you are using.

Web Server

Please refer to Web Server manual that you are using.

Warning

Delete the file directory under <%WEB_PATH%> directory which places static file.

Apache Cassandra

Delete directory which sets up Apache Cassandra.

Apache Solr

Delete the directory which sets up Web Application Server ( Jetty, Resin, tomcat ) that operates Apache Solr.

Please proceed to [ Introduction ].

Copyright © 2014 NTT DATA INTRAMART CORPORATION

intra-mart Accel Platform

33