SME in a BOX Installation Guide

convertingtownSoftware and s/w Development

Nov 4, 2013 (3 years and 11 months ago)

102 views

SME in a BOX Installation Guide


Terminology:

1. SME server

SME Server

is a Linux distribution based on CentOs offering an operating system for computers
used as web, file, e
-
mail and database servers. It employs a comprehensive user interface for all
management
-
related tasks and is extensible through templates. SME stand
s

for Small to Medium
Enterprise
s
,
and this

is the target market of the software
.


2. Java

Java

is a general
-
purpose, concurrent, object
-
oriented programming language. Java application
s
are typically compiled to bytecode (class file) that can run on any Java Virtual Machine (JVM)
regardless of computer architecture. It is intended to let application developers "write once, run
anywhere.” meaning that code that runs on Windows
,

does not
need to be edited to run on a Mac.

3. MySQL

MySQL

is a
relational database management system

(RDBMS) that runs as a server providing
multi
-
user access to a number of databases
.

4. Liferay


Liferay Portal

is a
portal

(a module capable to work in multip
le Liferay environments)

written in
Java. Liferay Portal allows users to set up features common to websites. It is fundamentally
constructed of functional units called portlets. Liferay is sometimes described as a content
management framework or a web appl
ication framework. Liferay's support for plugins extends
into multiple programming languages.

Although Liferay offers a sophisticated programmi
ng interface for developers, no
p
rogramming skills are required for basic website installation and administration. Liferay is
available bundled with a servlet container such as Apache Tomcat


5. CAS server.

Central Authentication Service

(CAS)

is a single sign
-
on protocol for the web. I
ts purpose is to
permit a user to access multiple applications while providing their credentials (such as userid and
password) only once. It also allows web applications to authenticate users without gaining access
to a user's security credentials, such as

a password


6. SSL certificates

SSL Certificates

are small data file
s

that digitally bind a cryptographic key to an organization’s
details. When installed on a web
server, it
allows secure connections from a web server to a
browser. Typically SSL is u
sed to secure credit card transactions, data transfer, and logins and
more recently
, it

is becoming the norm when securing browsing of social media sites.

7. User Provisioning

User provisioning

refers to the creation, maintenance and deactivation of user
objects and user
attributes, as they exist in one or more systems, directories or applications, in response to
automated or interactive business processes. User provisioning software may include one or more
of the following processes: change propagation, s
elf service workflow, consolidated user
administration, delegated user administration.

8. Mantis, Roundcubemail and OrangeHRM.

Mantis

Bug Tracker

is a web
-
based bug tracking system. The most common use of MantisBT is
to track software defects.

Roundcube

is a web
-
based IMAP email client written in the PHP programming language.
Roundcube's most prominent feature is the pervasive use of Ajax technology to present a more
fluid and responsive user interface than that of traditional webmail clients.

OrangeHRM

aims to be the world’s leading HRM solution for small and medium sized
enterprises by providing a flexible and easy to use HRM system affordable for any company
worldwide
.


















The following diagram illustrates contents of ‘SME in a box’
software
package
.



Installation:

The software installation

process

has

the following

two parts.

1.

Part 1:
Download and in
stall SME Server using the download link

:


ftp://microenterprise.silatech.com/Silatech/Package2/smeserver
-
8.0beta6
-
i386.iso


2.

Part 2:
Start the installation scripts by copy and paste the following command

in the terminal:


wget
ftp://microenterprise.silatech.com/Silatech/Package2/installer.sh





Part 1:

1.

SME Server

Installation

Download the SME iso from


ftp://microenterprise.silatech.com/Silatech/Package2/smeserver
-
8.0beta6
-
i386.iso


and burn the DVD/CD with it.


1.

Press
Enter

to start the Setup of the SME Server
.



2.

Select
Skip

and Press enter to proceed further to Installation


3.

Select
Install Anyway

and click on Enter to proceed.This Screen indicates that the SME
Server that is being used is in beta version.




4.

Select the
Language

and click on
OK



5.

Select
the Keyboard Type(preferable us) and press OK



6.

Select Time
-
Zone and proceed by selecting OK


7.

Select
YES

to proceed Forward
.This will format your Disk.



8.

Select
OK
to proceed




9.

Installation Begins



10.


Installation is Complete. Press
Enter

to
REBOOT

the system

After the Reboot, the Configuration of the SME
-
Server has to be done as shown in the screenshots
below.

2.

Configuring SME Server


1.

Select
No
to proceed if it’s a fresh installation. Select
YES
if you want to restore the SME Server
from a backup


2.

Enter your SME Server administrator Password and Select
Next
to proceed


3.

Enter the Domain Name of your SME
-
Server



4.

Enter your System Name and Select Next to proceed




5.

Enter the IP Address of the SME Server and Select
Next

to proceed



6.

Enter the Subnet Mask and Select
Next

to proceed



7.

Select the Server
-
Only Mode and proceed



8.

Enter the Gateway IP Address


9.

Select the OFF option and Proceed



10.

Provide nothing in the DNS Server Address and Proceed by Selecting
Next




11.

Save your changes and Activate it by selecting
Yes



12.

Your SME Server is Setup according t
o your
-
configuration and login
using the root user and the
password that you have provided.

13.

E
nable SSL. Go to
http://<ip address >/server
-
manager. L
ogin using admin credentials and select

Remote access
’. S
elect
‘A
llow public access

. M
ore info
on this can be found at the following
link:

http://web.me.com/cgbosntom/putty/putty_howto
.html

14.

Enter the admin c
redentials to
login.



15.

Configurations
with respect to

the Hostname and mail servers etc. can be done by entering into
the Server Manager

16.

After selecting the options which

are

marked below, please save the settings by clicking on sav
e
button.


17.

Enable email configurations.
(SMTP,IMAP daemons for roundcubemail)
. Select Email on the left
side and click on the Change email access settings

as shown below.





18.

Use a
dmin user account in

web user interface to change configuration settings
. S
imilarly for
command terminal based session use root account.

19.

Login using root to system command terminal via direct login on physical machine or ssl (PuTTy
-
ssl
client , check your internet conne
ctions)

Part 2:

Auto installer

script

20
. After login please copy the command
s

one by one

into your prompt
,

mentioned below and
press
ENTER
.



Step1.
wget ftp://
microenterprise.silatech.com
/Silatech/Package2/installer.sh



Step2.

chmod +x
install
er.sh


Step3.

./

installer
.sh

<your host’s IP address>


Eg: ./

installer
.sh 192.168.0.36

21. Please wait for few minutes, the script will download the necessary
software

for setup and it will
reboot.

22.
After reboot ,

start the application by logging into the system as root and type the command


cd setup/


./tomcatservice.sh start


NOTE: to restart


./tomcatservice.sh restart and

to

stop

./tomcatservice.sh stop

23. Open browser and the type URL as
http://<ip

addres
s>:8080/UserProvisioning/


Login as Username

mifos and password


testmifos

Congratulations!, now you are ready to use the ‘SME in a box’ Software package.

NOTE:

1.

P
lease clear your browser cache before login to the application
.


2.

If are using Email (
roundcubemail) inside the application, login using the system users rather
than application users (admin user).

3.

If you want to change the ip address of your server than login to the server using admin
credentials follow the same steps (choosing 2 option co
nfigure this server) as mentioned in the
installation to configure ip addres
s
.