You can use Ant to build and install the FHoSS.
- Build
- First of all use the "compile" target to compile the source code:
ant compile
- Installation
- Installation is also done using ant
- With the "deploy" target you can install the FHoSS
ant deploy
- To modify the destination, change the
install.dest property in the "build.properties" file.
- Configuration after deploy Default configuration is made for all the needed files to run FHoSS on the localhost. However, you should see these files and modify some parameters as appropriate for your installation. Configure the required configuration files located in the root of the deployment directory.
- "DiameterPeerHSS.xml": You should modify the peer configuration here: like the FQDN, Realm, Acceptor Port or Authorized identifiers. (See the JavaDiameterPeer documentation for details on how to set up the Diameter peer.)
- "hibernate.properties": You should configure the main properties for hibernate; implicitly is configured to connect to the mysql on the localhost (127.0.0.1:3306). The most relevant properties are: hibernate.connection.url=jdbc:mysql://127.0.0.1:3306/hss_db hibernate.connection.username=hss hibernate.connection.password=hss Please refer to the hibernate documentation to get further information about the hibernate configuration.
- "hss.properties": Specify configuration like: on which address the tomcat is listening (e.g. host=localhost). Other parameters like: operatorId, amfId or SQN security settings can be specified here. Read the "install.txt" if you need further information.
- "log4j.properties": Contains configuration for the logger. The most relevant things here, are the output file path of the logger and the level of logging. Implicitely the logs are saved in the "logs" folder of the deployment directory.
If you want to change some tomcat configuration files, you will find them in "conf/" folder of the deployment directory ("tomcat-users.xml" contains the "hss" and "hssAdmin" users defined).
- Creating the Database
- You will need a database in order to use the FHoSS. You will find to sql scripts for the MySQL database in the root directory of your installation. Use thes scripts to create a new MySQL database and to populate it with default values.
- to create the database and the tables: mysql -u admin -p <hss_db.sql
- to create two demo users and initial values for service profiles: mysql -u admin -p <userdata.sql
- If you want to use annother DBMS you have to solve two steps:
- Make sure your database is supported by Hibernate. Visit the Hibernate web site to get information about compatibility informations for your DBMS.
- You have to modify the script for your database system.
- Startup
- You will find two shell scripts in the root directory of your installation. Use
startup.cmd to start the FHoSS on a Windows system and startup.sh on Linux/UNIX system.
- Make sure you have your
JAVA_HOME variable is set correctly.
- Management
- You can access the management console using a web browser.
http://localhost:8080
- There are two initial users:
- hssAdmin - password: hss
- hss - password: hss
- Additional users can be configured using the
/conf/tomcat-user.xml. You may also look at server_roles before you start further configuration.
Generated on Tue Oct 7 04:05:15 2008 for Open IMS Core - FHoSS by
1.5.2