Installing BaseEAM

Owned by Tam Le
Last updated: Apr 29, 2018 by Nguyen Le
3 min read

1. Installing applications

MySQL Server

  • Open the downloaded file and install MySQL.

IIS Server

Install IIS Server:

  • Navigate to Start > Control Panel > Programs > Programs and Features
  • Choose Turn Windows features on or off

image

  • Select the Internet Information Services (IIS) check box, and tick the check boxes like image below, click Next, then click Finish

2. Download Resources

Navigate to https://github.com/baseeam to fork BaseEAM repositories


There are five repositories: 

  • baseeam-artifacts: contains artifacts of BaseEAM projects such as: mockups, testing documents, ...

  • baseeam-web-app: contains the source code of BaseEAM web application.

  • baseeam-build: contains build of BaseEAM web app, background service, workflow service, database file (MySQL dump). Normal user can use this repository to deploy BaseEAM without downloading the source code from other repositories.

  • baseeam-background-service: contains the source code of BaseEAM background service.

  • baseeam-workflow-designer: the tools to create new workflows or custimize existing workflows.

To install BaseEAM, we only need the baseeam-build repository.

3. Import database

  • The path of BaseEAM database script file is baseeam-build\Database\EAM\EAM_****.sql

  • Use Data Import/Restore functionality of MySQL Workbench to import/restore BaseEAM database.
  • After importing, the schema/data of BaseEAM database will be in eam database.

4. Deploy BaseEAM web application to IIS Server

  • Open IIS (Internet Information Services): Start > Internet Information Services (IIS) Manager
  • Create New Website: Right-click and choose Add Website...

  • Filling out site information:

  •  
    • Site name: Application name
    • Physical path: point to build directory (baseeam-build\Build\Web). In above example, we create a folder: C:\Sites\baseeam and copy all files in baseeam-build\Build\Web folder
    • Port: you have to define your application port.
  • Click OK to continue
  • Configure permission for application
  • Edit Web.Config file to point application to BaseEAM database: 
    • Uid: username to login MySql (use root by default or you can create new one)
    • Pwd: Password was set in previous steps.

  • Setting up application folder in IIS Server
    • Right BaseEAM folder, then choose Properties
    • Go to the Security tab
    • Find the IUSR account
      (If IUSR is not in the list, add it by clicking Edit, then clic Add, and type "IUSR" in the "Enter the object names to select" field.)
    • Highlight the user in the list, click Edit, and grant the account Modify and Write permissions

5. Install background services for BaseEAM application

BaseEAM application has two background services have to set up

  • BackgroundService: baseeam-build\Build\BackgroundService
  • WorkflowService: baseeam-build\Build\WorkflowService


Steps:

  • Run CMD (command line of Windows) as an Administrator
  • Set up for Background service: in this example, Background Service is located in folder: C:\Sites\BaseEAMServices\BackgroundService. Run the commands below:
cd C:\Sites\BaseEAMServices\BackgroundService



BaseEAM.BackgroundService.exe install

  • Set up for WorkflowService service: in this example, Background Service is located in folder: C:\Sites\BaseEAMServices\WorkflowService. Run the commands below:

    cd C:\Sites\BaseEAMServices\WorkflowService\BaseEAM.WorkflowService.exe
    BaseEAM.WorkflowService.exe install
    Result:

6. Run web application

  • Navigate to http://localhost:8089 (8089 is port number defined in previous steps)
  • The page should be like the image below. Using default SystemAdmin username: milldol and password: 112358 to log in