Installation Instructions
Installation Instructions
Installation Instructions
1 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
INSTALLATION INSTR.
Installation Instructions
IPWorks 6.0
Copyright
Copyright Ericsson AB 2008. All rights reserved.
Disclaimer
No part of this document may be reproduced in any form without the written permission of the copyright owner.
The contents of this document are subject to revision without notice due to continued progress in methodology, design and
manufacturing.
Ericsson shall have no liability for any error or damage of any kind resulting from use of this document.
Trademark List
Copyright 1996-2003 Internet Software Consortium. Portions Copyright 1996-2001 Nominum, Inc. Copyright
1995-2003 by Internet Software Consortium. Copyright 1996, 1998-2000 The Regents of the University of California.
Copyright 2001-2003, Networks Associates Technology, Inc. Portions Copyright 2001-2003, Cambridge Broadband
Ltd. Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. Copyright
2003-2004, Sparta, Inc. Copyright 1995-1998 Eric Young ([email protected]). Other product and company names
mentioned herein may be the trademarks of their respective owners.
UNIX
A registered trademark of The Open Group.
Solaris
A registered trademark of Sun Microsystems, Inc.
SPARC
A registered trademark of SPARC International, Inc.
Java
Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc.
MySQL
A trademark of MySQL AB.
BIND
Copyright 2004 Internet Systems Consortium, Inc. ("ISC").
ISC DHCP Copyright 2004 by Internet Systems Consortium, Inc. ("ISC").
Netsnmp
Copyright 1989, 1991, 1992 by Carnegie Mellon University.
Open SSL
Copyright 1998-2004 The OpenSSL Project.
UnixODBC Copyright 1989, 1991 Free Software Foundation, Inc.
Tomcat
Copyright 1999, 2000 The Apache Software Foundation.
SUDO
Copyright 1994-1996,1998-2005 Todd C. Miller ([email protected]).
Contents
1
1.1
1.2
1.3
Introduction
Scope
Target Groups
Conventions
2
2.1
2.2
2.3
2.4
Installation Prerequisites
Users
System Requirements
Mirror the Local Disk
Build Environment
3
3.1
3.2
Installation Preparations
IPWorks CD Load Modules
Installation and Uninstallation
4
4.1
4.2
4.3
4.4
12/8/2016 8:24 AM
Installation Instructions
2 of 62
5
5.1
5.2
5.3
5.4
5.5
Installation Verification
Verifying the DNS Service
Verifying the ENUM Service
Verifying the DHCPv4 Service
Verifying the Web Application
Verifying Sudo
6
6.1
6.2
6.3
6.4
6.5
Appendix
Displaying IPWorks Component Version Information
Launching the IPWorks Control Panel
Launching the IPWorks Command Line Interface
Launching the Web User Interface
Starting and Stopping the IPWorks Components
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Reference List
12/8/2016 8:24 AM
Installation Instructions
3 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
1 Introduction
This document provides the installation instructions for IPWorks 6.0 on Solaris
systems.
1.1 Scope
This is the installation guide for IPWorks 6.0.
Additional information for any configuration that can be done after the initial installation is available in System
Administration Guide, Reference [1], and Control Panel User Guide, Reference [2]. Instructions to harden the security of
IPWorks are in Solaris Security Hardening for IPWorks 6.0, Reference [3] and Security Hardening for IPWorks 6.0
Application Components, Reference [4].
1.3 Conventions
Table 1 describes the typographical conventions used in this document.
Table 1
Typographical Conventions
Convention
Description
Example
User Input
cd home
Command Variables
GUI Objects
Key Combinations
Key combinations.
Output Information
System Elements
Omission Character
(1) The plus (+) sign indicates that the user must press the keys simultaneously.
Table 2 specifies the prompt expressions for different programs.
Table 2
Program
Prompt
shell
ipwcli
IPWorks>
12/8/2016 8:24 AM
Installation Instructions
4 of 62
mysql
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
mysql>
2 Installation Prerequisites
This section states the prerequisites for installing IPWorks 6.0. Before installing components on any host system, decide if
the network topology, memory resources, and processor speed of the host are suitable. Base this decision on the functional
and system requirements of each component the user intends to install.
2.1 Users
The person installing IPWorks 6.0 must have knowledge of the following:
Sun Solaris and Sun Cluster installation and configuration
Intermediate UNIX skills for the installation process and root privileges
Concepts, terminologies, and abbreviations of telecommunication, such as TCP/IP, packet data networks, Domain
Name System (DNS), Dynamic Host Configuration Protocol (DHCP), and Electronic Numbering (ENUM)
Component Name
DNS Server
DHCPv4 Server
DHCPv6 Server
ASDNS Monitor
DNS-ALG
ENUM Server
Sun Netra 240, 2*1.5 GHz UltraSPARC IIIi processors running Solaris
10, 8 GB RAM
Data Nodes
Sun Netra 240, 2*1.5 GHz UltraSPARC IIIi processors running Solaris
10, 8 GB RAM
12/8/2016 8:24 AM
Installation Instructions
5 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
SQL Node
Sun Netra 240, 2*1.5 GHz UltraSPARC IIIi processors running Solaris
10, 8 GB RAM
Management Node
Sun Netra 240, 2*1.5 GHz UltraSPARC IIIi processors running Solaris
10, 8 GB RAM
Note:
To increase the application availability, it is recommended that each Sun Netra 240 have two local disks
to create a mirror.
If more than one component is installed on the same system, requirements are greater and thus a
system with higher performance capabilities is needed.
Slice
Mount Point
Size (MB)
123575
swap
16384
overlap
3
4
5
6
7
unassigned
32
12/8/2016 8:24 AM
Installation Instructions
6 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
---------------------Checking Prerequisites
---------------------Checking Mirror Disks...Not Present
Root Disk...Your boot disk is c0t0d0.
------------------------------------Making new partitions for mirror disk
------------------------------------fmthard: New volume table of contents now in place.
------------------------Creating new metadevices
------------------------d11: Concat/Stripe is setup
d10: Mirror is setup
d21: Concat/Stripe is setup
d20: Mirror is setup
d12: Concat/Stripe is setup
d22: Concat/Stripe is setup
----------------------Configuring new vfstab
----------------------Done
----NOTE
----Please run "init 0" and configure OBP
Run commands
12/8/2016 8:24 AM
Installation Instructions
7 of 62
ok?
ok?
ok?
ok?
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
5. Make a careful note of the commands listed at the end of the output from the create_mirror_disk script. These are
the commands the user needs to run in step 6 to restart the system.
6. Run init 0 from the system console and enter the commands reported by create_mirror_disk script. For example:
# init 0
ok? nvalias bootdisk /pci@1c,600000/scsi@2/disk@0,0
ok? nvalias mirrordisk /pci@1c,600000/scsi@2/disk@1,0
ok? setenv boot-device bootdisk mirrordisk
ok? boot
7. Use the attach_mirror_disk script to complete the disk mirroring:
# cd /cdrom/cdrom0/solaris/utils
# ./attach_mirror_disk t <mirror-type>
Where <mirror-type> identifies the type of machine to be mirrored, there are two types:
single : Single machine like Protocol Server or Storage Server without Sun Cluster.
medium : Storage Server with Sun Cluster.
For example, in single machine:
# cd /cdrom/cdrom0/solaris/utils
# ./attach_mirror_disk t single
Configuration Type
Node Type
Solaris 10(1)
Single Configuration
Storage Server
Protocol Server
12/8/2016 8:24 AM
Installation Instructions
8 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Medium Configuration
Legacy Configuration
Entry Configuration
Storage Server
Protocol Server
Storage Server
Protocol Server
Storage Server
Protocol Server
3 Installation Preparations
This section describes the preparations that are required prior to the installation.
common
Mandatory None
Backup and
Restore
IPWbackup
backup
Mandatory IPWcommon
Java Runtime
Environment
IPWjre
jre
Mandatory IPWcommon
MySQL
IPWmysql
mysql
Common Line
Interface
IPWcli
cli
Mandatory
(1)
IPWcommon
Optional
IPWcommon,
IPWjre
12/8/2016 8:24 AM
Installation Instructions
9 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
tomcat
Optional
IPWcommon,
IPWjre
Server
Manager
sm
Optional
IPWcommon,
IPWjre
Optional
IPWcommon,
IPWjre,
IPWmysql,
IPWcli
Optional
IPWcommon,
IPWjre,
IPWmysql,
IPWcli, IPWss
Optional
IPWcommon,
IPWjre,
IPWmysql,
IPWcli, IPWss,
IPWtomcat
Optional
IPWcommon,
IPWjre,
IPWsm
IPWcommon,
IPWjre,
IPWsm
DNS-ALG
Server
Optional
IPWcommon,
IPWjre,
IPWsm
Optional
IPWcommon,
IPWjre,
IPWsm
Optional
IPWcommon,
IPWjre,
IPWmysql,
IPWsm
Optional
IPWcommon,
IPWjre,
IPWmysql,
IPWsm
Optional
IPWcommon,
IPWjre,
IPWsm,
IPWdns, EAB
SS7 Stack
IPWsm
Statistics
Collection
Process
Web Interface
(2)
DNS Server
IPWcnoss
IPWwebui
IPWdns
IPWdnsalg
ENUM Server
IPWenum
ERH Server
IPWerh
ss
cnoss
webui
dns
dnsalg
dhcpv4
enum
dhcpv6
erh
12/8/2016 8:24 AM
Installation Instructions
10 of 62
SS7 Stack
(3)
Sun Cluster
Agent (5)
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
EAB SS7
Stack (4)
ss7
IPWscagents scagents
Optional
None
Optional
None
(1) IPWmysql (Innodb Node) is mandatory for the Storage Server, whereas IPWmysql (Mgmt Node), IPWmysql (Data
Node) and IPWmysql (SQL Node) are mandatory for the Protocol Server (Single, Medium and Entry).
(2) Web Interface is installed on the machine hosting the Storage Server if web access to IPWorks is required.
(3) For details on how to install and configure SS7 Stack, refer to SS7 Configuration for IPWorks 6.0, Reference [7].
(4) EAB SS7 Stack includes EABss7017, EABss7019, EABss7020, EABss7022, EABss7023, EABss7024, and EABss7026.
(5) Sun Cluster Agent is exclusively for Sun Cluster Environment.
12/8/2016 8:24 AM
Installation Instructions
11 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
12/8/2016 8:24 AM
Installation Instructions
12 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
3. Start the IPWorks Installation and Upgrade Tool as described in Section 3.2.1.
4. Select the UNINSTALLATION option on the Main Menu.
5. Select an IPWorks release in IPWorks 6.0 Uninstallation Wizard .
6. Select all the load modules to be uninstalled for the selected IPWorks release.
7. Select the UNINSTALL button and press the ENTER key to uninstall the selected load modules.
If the tool displays an error message indicating a dependency failure, go back to Step 6 and add the missing
dependent load modules to the selection (or delete the prerequisite load modules from the selection).
Hardware Prerequisites
Setup Diagram
Figure 1 shows the IPWorks modules that can be installed on a single machine.
12/8/2016 8:24 AM
Installation Instructions
13 of 62
Figure 1
4.1.3
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Installation Overview
Use the IPWorks Installation and Upgrade Tool to install the modules per user requirements, as shown in Table 7.
Table 7
Machine
IPWcommon
IPWbackup
IPWjre
IPWmysql
IPWcli
IPWtomcat
IPWsm
IPWss
IPWcnoss
12/8/2016 8:24 AM
Installation Instructions
14 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
IPWwebui
IPWdns
IPWasdnsmon
IPWdnsalg
IPWdhcpv4
IPWenum
IPWdhcpv6
IPWerh
IPWscagents
Table 8 shows the installation procedure for single configuration. The installation is customized by the user and thus
optional steps can be skipped.
Table 8
Step
Action
Description
Mandatory
Mandatory
Mandatory
Optional
Optional
Optional
Optional
Optional
4.1.4
Machine Installation
This section provides the instructions to set up and configure the machine in the single configuration.
4.1.4.1
12/8/2016 8:24 AM
Installation Instructions
15 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the MySQL InnoDB Master in the single configuration.
1. Start the MySQL InnoDB Master.
Machine-1# /etc/init.d/ipworks.mysql start-master-innodb
Starting IPWorks InnoDB Master....
081111 16:16:02 mysqld_safe Logging to '/etc/ipworks/mysql/innodbnode_data/innodbnode.err'.
081111 16:16:02 mysqld_safe Starting mysqld daemon with databases from /etc/ipworks/mysql
/innodbnode_data/
2. Grant all privileges to localhost and machine.
Machine-1# /usr/local/mysql/bin/mysql
mysql> grant all privileges on *.* to 'ipworks'@'localhost' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
mysql> grant all privileges on *.* to 'ipworks'@'<M1 O&M IP>' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
where <M1 O&M IP> is the IP address of the O&M Ethernet interface card.
Note:
Master innodb IP address configured in Slave SQL Node is included in the table mysql.user in the master
innodb database. Otherwise all privileges are granted to this IP address.
3. Verify the privileges.
mysql> select user, host from mysql.user;
+---------+-----------------+
| user
| host
|
+---------+-----------------+
| ipworks | <M1 O&M IP>
|
| root
| <local host>
|
| root
| <hostname>
|
| ipworks | local host
|
| root
| local host
|
+---------+-----------------+
7 rows in set (0.00 sec)
4. Quit the session.
mysql> quit
4.1.4.3
This section provides the instructions to create the IPWorks databases, start the Storage Server and initialize the Storage
Server database on a single-machine installation.
1. Create the MySQL databases.
Machine-1# /opt/ipworks/IPWss/db/create_mysql_db
Creating Storage Server database ...
12/8/2016 8:24 AM
Installation Instructions
16 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
4.1.4.4
This section provides the instructions to configure and start the Management Node of the NDB Cluster on a single-machine
installation.
1. Start the IPWorks Control Panel.
Machine-1# ipwscp
2. Configure Management Node attributes.
Select MySQL Cluster Node > Managment Node > Configuration > Management Node Parameters .
Configure the following parameter:
HostName
where <M1 O&M IP Address> is the IP address of the machine on which the Management Node is running, for
example, 127.0.0.1.
3. Configure the Data Node common parameters.
Select MySQL Cluster Node > Management Node > Configuration > Data Node Common Parameters .
Configure the following parameters:
Data Memory Size = see Table 9
12/8/2016 8:24 AM
Installation Instructions
17 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Number of Records
1 Million
up to 3 GB
up to 600 MB
5 Million
up to 3.5 GB
up to 800 MB
8 Million
up to 4 GB
up to 1000MB
Note:
If ENUM and DHCP are installed on the same machine, the number of records in ENUM must not exceed 4
million. Otherwise, the performance of the system cannot be ensured.
12/8/2016 8:24 AM
Installation Instructions
18 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
[ndbd(NDB)]
1 node(s)
id=2 (not connected, accepting connect from localhost)
[ndb_mgmd(MGM)] 1 node(s)
id=1 @localhost (mysql-5.1.23 ndb-6.2.15)
[mysqld(API)]
3 node(s)
id=3 (not connected, accepting connect from localhost)
id=4 (not connected, accepting connect from localhost)
id=5 (not connected, accepting connect from localhost)
4.1.4.5
This section provides the instructions to configure and start the Data Node of the NDB Cluster on a single-machine
installation.
1. Start the IPWorks Control Panel.
Machine-1# ipwscp
2. Configure the Data Node parameters.
Select MySQL Cluster Node > Data Node > Configuration .
Configure the following parameter:
where <M1 O&M IP Address> is the IP address of the machine on which the Management Node is running, for
example, 127.0.0.1.
The configuration file used by the Data Node is /etc/ipworks/mysql/confs/ipworks_datanode_my.conf.
3. Depending on whether the Data Node is started for the first time, choose one of the following options.
If the Data Node is started for the first time, select MySQL Cluster Node > Data Node > Start Initial .
Note:
This operation is only performed for the first time setup. The operation erases all the NDB data
from the disk.
If the Data Node is not started for the first time, select MySQL Cluster Node > Data Node > Start .
4. Exit the IPWorks Control Panel.
5. Check that the Data Node has started.
Machine-1# /etc/init.d/ipworks.mysql show-ndb-status
The output in the following example shows that the Data Node is connected to the NDB Cluster. The Data Node is
ready only when starting is not displayed in the string against the id=2.
For example:
Machine-1# /etc/init.d/ipworks.mysql show-ndb-status
12/8/2016 8:24 AM
Installation Instructions
19 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the SQL Node of the NDB Cluster on a single-machine
installation, and to verify the NDB data.
1. Start the IPWorks Control Panel.
Machine-1# ipwscp
2. Configure the SQL Node parameters.
Select MySQL Cluster Node > SQL Node > Configuration .
Configure the following parameters:
Master-Host
where <M1 O&M IP Address> is the IP address of the machine on which the MySQL InnoDB is running.
If the Master Host value is changed by using the Control Panel after the first correct configuration, the changes take
effect after one of the following:
login to the SQL Node and use the CHANGE MASTER TO MASTER_HOST='New MASTER HOST' statement to reset
the SQL Node Master Host. (recommended)
restart of the SQL Node after deleting the master.info file located in /etc/ipworks/mysql/sqlnode1_data/.
ServerID
Port
datadir
3
3307
/etc/ipworks/mysql/sqlnode1_data
where ServerID specifies the server ID for SQL replication process. The value must be an integer greater than 1.
The configuration file used by the NDB SQL Node is /etc/ipworks/mysql/confs/sqlnode1.conf.
3. Go to the IPWorks Control Panel Main Screen and wait for the Data Node status to change to running .
4. Start the SQL Node.
Select MySQL Cluster Node > SQL Node > Start .
Note:
This node starts only when at least one NDB Data Node has successfully started.
5. Exit the IPWorks Control Panel.
6. Check that the SQL Node has started from the Management Server.
Machine-1# /etc/init.d/ipworks.mysql show-ndb-status
12/8/2016 8:24 AM
Installation Instructions
20 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
[mysqld(API)]
3 node(s)
id=3 @127.0.0.1 (mysql-5.1.23 ndb-6.2.15)
id=4 (not connected, accepting connect from localhost)
id=5 (not connected, accepting connect from localhost)
The above output indicates that an SQL daemon has started.
7. Check the status of the SQL Node connections with the NDB Cluster and Master InnoDB node.
Machine-1# /usr/local/mysql/bin/mysql -P 3307 h localhost -protocol=tcp
mysql> show processlist\G
mysql> show slave status\G
mysql> exit
For example:
Machine-1# /usr/local/mysql/bin/mysql -P 3307 h localhost -protocol=tcp
mysql> show processlist\G
12/8/2016 8:24 AM
Installation Instructions
21 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Replicate_Wild_Ignore_Table:
Last_Errno:
Last_Error:
Skip_Counter:
Exec_Master_Log_Pos:
Relay_Log_Space:
Until_Condition:
Until_Log_File:
Until_Log_Pos:
Master_SSL_Allowed:
Master_SSL_CA_File:
Master_SSL_CA_Path:
Master_SSL_Cert:
Master_SSL_Cipher:
Master_SSL_Key:
Seconds_Behind_Master:
Master_SSL_Verify_Server_Cert:
Last_IO_Errno:
Last_IO_Error:
Last_SQL_Errno:
Last_SQL_Error:
1 row in set (0.00 sec)
0
0
209211
525
None
0
No
0
No
0
0
Note:
The fields Master_Log_File and Read_Master_Log_Pos have the same values as those of the Master
InnoDB Server.
8. Quit the session.
mysql> exit
9. Check the status of the Master InnoDB.
Machine-1# /usr/local/mysql/bin/mysql
mysql> show master status;
+--------+----------+--------------+------------------+
| File
| Position | Binlog_Do_DB | Binlog_Ignore_DB |
+--------+----------+--------------+------------------+
| .000009|
209211 |
|
|
+--------+----------+--------------+------------------+
1 row in set (0.00 sec)
mysql> exit
10. Check if the replication has failed.
Machine-1# /usr/local/mysql/bin/mysql -P 3307 --protocol=tcp
mysql> show slave status \G
12/8/2016 8:24 AM
Installation Instructions
22 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Id
type
33
67
9
91
87
75
79
21
5
63
83
46
71
57
42
51
37
95
13
17
29
25
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
UserTable
4.1.4.7
state
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Online
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
def
ENUMDNRANGE
MAPDATA
AINTOLLFREEDATA
INAPNODE
AINNODE
ROUTEBYTOD
RTGSCHED
COUNTRYCODE
AINLNPDATA
INAPDATA
RTGSCHEDENTRY
ENUMVIEW
ROUTEBYORIGIN
ENUMZONE
ENUMSERVER
ENUMZVREL
ENUMDNSCHED
MAPNODE
BULKUPDATE
CALLSERVER
ENUMACL
DESTNODE
This section provides the instructions to configure the DNS Server and its Server Manager on a single-machine installation,
to start the Server Manager, and to update the DNS Server.
1. Edit the /etc/resolv.conf file to add attributes.
nameserver 127.0.0.1
domain localhost
2. Edit the /etc/nsswitch.conf file to append dns to the hosts entry.
hosts: files dns
3. Start the IPWorks Control Panel.
Machine-1# ipwscp
4. Use the IPWorks Control Panel to configure the DNS Server Manager parameters as follows:
Select DNS Services > DNS Server Manager > Configuration Parameters .
12/8/2016 8:24 AM
Installation Instructions
23 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Machine-1# ipwcli
7. Create a dnsserver object.
IPWorks> create dnsserver dns1 set dnsname=dns1.iptelco.com;address=<M1 O&M IP
Address>;option="listen-on port 5300 {any;}"
1 object(s) created.
The names dns1 and iptelco.com are used as examples. The user does not need to configure the DNS Server at this
point in the installation procedure.
Note:
If the dnsserver object is not created using ipwcli, a default dnsserver with the same name as
the primary hostname is created, that is, the name displayed by the hostname system command.
Because of network access security, the IP address of ENUM server is configured by using the
Control Panel if the DNS server interacts with the ENUM server. If these two servers are installed
on the same machine, the default value is 127.0.0.1.
8. Create a masterzone object.
IPWorks> create masterzone dns1 iptelco.com
1 object(s) created.
9. Create an arecord object.
IPWorks> create arecord dns1.iptelco.com <M1 Traffic IP Address>
1 object(s) created.
10. Exit the CLI.
IPWorks> exit.
11. Ensure that the /var/run/dnssm.port file does not exist.
Machine-1# rm f /var/run/dnssm.port
12. Use the IPWorks Control Panel to start the DNS Server Manager.
Machine-1# ipwscp
Select DNS Services > DNS Server Manager > Start Server Manager .
Exit the IPWorks Control Panel.
13. Use the IPWorks CLI to update the dnsserver object.
Machine-1# ipwcli
IPWorks> update dnsserver dns1
Result of performing an export is:
Exported configuration for [DnsServer dns1]
Updated the configuration and started 'DNS' server 'dns1'.
IPWorks> exit
14. Verify that the dnsserver has been updated.
Machine-1# dig -p 5300 @<M1 Traffic IP Address> dns1.iptelco.com
The output from the above command contains the following text:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR,
4.1.4.8
This section provides the instructions to configure and start the ENUM Server and its Server Manager on a single-machine
installation.
1. Start the IPWorks Control Panel.
12/8/2016 8:24 AM
Installation Instructions
24 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Machine-1# ipwscp
2. Configure the ENUM Server parameters as follows:
Select ENUM Services > ENUM Server > Configuration Parameters .
ENUM Server Id
1
ENUM Server Port
53
Enable DNS Resolver
true
DNS Resolver IP Address
127.0.0.1
DNS Resolver UDP Port
5300
Log Destination
file
Log Level
off
Log Directory
/var/ipworks/logs
Name Prefix
enum_server
No. of Logs
1
Log size (1-20) Mb
1
Log start (0-4)
1
ENUM Thread Count
10
Granularity Period for Requests Failed Alarm
10
Threshold Level for Requests Failed Alarm
30
3. Configure the ENUM Server Manager parameters as follows:
Select ENUM Services > ENUM Server Manager > Configuration Parameters .
12/8/2016 8:24 AM
Installation Instructions
25 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides instructions to configure the DHCPv6 Server and its Server Manager, to start the Server Manager, and
to update the server.
1. Use the IPWorks Control Panel to configure the DHCPv6 Server Manager parameters as follows:
lo0: flags=2001000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv4,VIRTUAL> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
bge0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,
IPv4> mtu 1500 index 2
inet 100.0.0.4 netmask ffffff00 broadcast
100.0.0.255
ether 0:3:ba:df:89:7
lo0: flags=2002000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv6,VIRTUAL> mtu 8252 index 1
inet6 ::1/128
bge0: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 fe80::203:baff:fedf:8907/10
ether 0:3:ba:df:89:7
bge0:1: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 3333:3333:3333:3333::104/64
3. Create a new IPv6 interface.
Machine-1# ifconfig <interface-name> inet6 plumb
For example:
Machine-1# ifconfig bge0 inet6 plumb
4. If the IPv6 address is not enabled, or if the user encounters a problem when using ifconfig to create the IPv6
address, edit the file /etc/hostname6.<interface_name> to set the IPv6 address to the IPv6 address of the server.
In the example shown in Step 2, the file /etc/hostname6.bge0 contains the following line:
addif 3333:3333:3333:3333::104/64 up
5. Reboot the machine after changing this file.
6. Create a dhcpv6server object.
Machine-1# ipwcli
IPWorks> create dhcpv6server <DHCPv6 Server Name> -set address=<M1 O&M IP Address>
1 object(s) created.
IPWorks> exit
7. Ensure that the /var/run/dhcpv6.port file does not exist.
12/8/2016 8:24 AM
Installation Instructions
26 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Machine-1# rm -f /var/run/dhcpv6.port
8. Use the IPWorks Control Panel to start the DHCPv6 Server Manager.
9. Update the dhcpv6server object.
Machine-1# ipwcli
IPWorks> update dhcpv6server <DHCPv6 Server Name>
1 object(s) updated.
IPWorks> exit
Hardware Prerequisites
Storage Server Host SS1 and SS2 require 2x SUN Netra 240, each with
Dual 1.5 GHz CPU
Dual SE6140 Disk Arrays (4x146G) with 2 Fiber Connections at 15k RPM
8 GB Memory
1 Ethernet Card with 4 Gigabit Ethernet Ports
2 Fiber Channel Interfaces
Protocol Server PS1 and PS2 require 2x SUN Netra 240, each with
Dual 1.5 GHz CPU
Dual 15k RPM, 73 GB disk drives
8 GB Memory
1 Ethernet Card with 3 Gigabit Ethernet Ports
4.2.2
The Medium Scenario represents a scenario, where the In-Memory cluster databases are collocated with the Protocol
Servers. This limits the ENUM database size to the RAM memory size of the Protocol Server machine. Figure 2 shows the
hardware diagram for medium configuration.
12/8/2016 8:24 AM
Installation Instructions
27 of 62
Figure 2
4.2.3
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Medium Configuration
Setup Diagram
The medium configuration consists of at least four machines: two for Storage Servers and two for Protocol Servers.
Figure 3 shows the IPWorks modules that can be installed on each of the four machines in the medium configuration.
12/8/2016 8:24 AM
Installation Instructions
28 of 62
Figure 3
4.2.4
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Installation Overview
Use the IPWorks Installation and Upgrade Tool to install the modules per user requirements, as shown in Table 10.
Table 10
Machine-SS
Machine-PS
IPWcommon
IPWbackup
IPWjre
IPWmysql
IPWcli
IPWtomcat
12/8/2016 8:24 AM
Installation Instructions
29 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
IPWsm
IPWss
IPWcnoss
IPWwebui
IPWdns
IPWasdnsmon
IPWdnsalg
IPWdhcpv4
IPWenum
IPWdhcpv6
IPWerh
IPWscagents
Table 11 shows the installation procedure for medium configuration. The installation is customized by the user and thus
optional steps can be skipped.
Table 11
Step
Action
Description
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
12/8/2016 8:24 AM
Installation Instructions
30 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Mandatory
10
Optional
11
Mandatory
4.2.5
This section provides the instructions to set up and configure the machine hosting the Storage Server in the medium
configuration. This is machine SS1 in Figure 3. The instructions also apply to SS2.
For IPWorks 6.0, Sun Cluster is introduced to achieve high availability of data protection and automatic failover of Storage
Server. This section guides the user to install the IPWorks under Sun Cluster manually.
4.2.5.1
Before installing the IPWorks 6.0 on Sun Cluster, ensure there is no previous version installed on this Cluster. Otherwise,
refer to Installation and Upgrade Tool User Guide, Reference [8].
1. Check if Sun Cluster has been successfully configured.
Note:
If the machine is configured on the slave node, the installation is rejected.
2. Clean unused links and make sure all the IPWorks load modules have been successfully removed.
Machine-SS1# pkginfo |grep IPW
The system is clean if there is no output. Otherwise remove the modules first.
Machine-SS1# pkgrm <package name>
Use the following commands to remove unnecessary links on both nodes.
Machine-SS1# cd /cdrom/cdrom0/solaris/utils
Machine-SS1# ./unlink.sh
3. Check if previous resource group exists.
scswitch -F -g ipworks_rg
scswitch -n -j tomcat_res
scswitch -n -j ipwss_res
scswitch -n -j mysql_res
scswitch -n -j ipworks_has
scswitch -n -j ipworks_lh
scrgadm -r -j tomcat_res
scrgadm -r -j ipwss_res
scrgadm -r -j mysql_res
scrgadm -r -j ipworks_has
scrgadm -r -j ipworks_lh
scrgadm -r -g ipworks_rg
5. Install the load modules shown in Table 10 on machine SS1 to acquire Sun Cluster Redundancy.
Refer to Section 3.2.2 for details.
During the installation of a common module, it checks whether Sun Cluster and Disk Array have been configured
successfully. If not, the installer cannot install it as the Sun Cluster mode.
12/8/2016 8:24 AM
Installation Instructions
31 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
6. Manually check the /etc/inet/hosts and /etc/inet/ipnodes files on both nodes before registering the Sun Cluster
resource and resource group. Ensure the virtual IP exists and its host name is ipworks.
For example, the hosts file on both machines may be
-------------------------------------------------10.170.4.2
ipw5sc-01 loghost
10.170.4.3
ipw5sc-02
...
10.170.4.50
ipworks
# virtual ip
----------------------------------------------------7. Check if virtual IP has been set successfully.
Machine-SS1# ipwssaddr
Virtual IP must not be used by other hosts that do not belong to this Sun Cluster.
8. Check if the IPMP has been successfully configured.
Online
Online
Online
Online
bge1
bge0
bge1
bge0
Online
Online
Online
Online
done
done
done
done
sourcing /opt/SUNWscmys/util/mysql_config
MySQL version 5 detected on 5.10/SC3.2
please input the password of MySQL User: root
Password:
Add faulmonitor user (fmuser) with password (fmuser123)
with Process-,Select-, Reload- and Shutdown-privileges
to user table for mysql database for host ipw5sc-02
12/8/2016 8:24 AM
Installation Instructions
32 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the MySQL InnoDB Master in the medium configuration.
1. Start the MySQL InnoDB Master:
Machine-SS1# /etc/init.d/ipworks.mysql start-master-innodb
Starting IPWorks InnoDB Master....
081111 16:16:02 mysqld_safe Logging to '/etc/ipworks/mysql/innodbnode_data/innodbnode.err'.
081111 16:16:02 mysqld_safe Starting mysqld daemon with databases from /etc/ipworks/mysql
/innodbnode_data/
2. Grant all privileges to localhost and each Protocol Server.
Machine-SS1# /usr/local/mysql/bin/mysql
mysql> grant all privileges on *.* to 'ipworks'@'localhost' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
mysql> grant all privileges on *.* to 'ipworks'@'<PS1 O&M IP>' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
where <PS1 O&M IP> is the IP address of the O&M Ethernet interface card on machine PS1.
mysql> grant all privileges on *.* to 'ipworks'@'<PS2 O&M IP>' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
where <PS2 O&M IP> is the IP address of the O&M Ethernet interface card on machine PS2.
3. Verify the privileges:
mysql> select user, host from mysql.user;
For example:
mysql> select user, host from mysql.user;
+---------+----------------+
| user
| host
|
+---------+----------------+
| ipworks | <PS1 O&M IP>
|
| ipworks | <PS2 O&M IP>
|
| root
| localhost
|
| fmuser | <SS1 hostname> |
| root
| <SS1 hostname> |
| fmuser | <SS2 hostname> |
12/8/2016 8:24 AM
Installation Instructions
33 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
| ipworks | localhost
|
| root
| localhost
|
+---------+----------------+
8 rows in set (0.00 sec)
4. Quit the session:
mysql> quit
4.2.5.3
This section provides the instructions to set up and configure the machine hosting the NDB Cluster in the medium
configuration. This is machine PS1 in Figure 3. The instructions also apply to PS2.
12/8/2016 8:24 AM
Installation Instructions
34 of 62
4.2.6.1
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the Management Node of the NDB Cluster in the medium
configuration.
The configuration file used by the Management Node is /etc/ipworks/mysql/confs/ipworks_mgm_1.conf.
Table 12 shows the memory requirements for NDB Cluster Management Nodes.
Table 12
Number of Records
1 Million
up to 3 GB
up to 600 MB
5 Million
up to 3.5 GB
up to 800 MB
8 Million
up to 4 GB
up to 1000 MB
Note:
If ENUM and DHCP are installed on the same machine, the number of records in ENUM must not exceed 4
million. Otherwise, the performance of the system cannot be ensured.
HostName
where <PS1 O&M IP Address> is the IP address of the machine on which the Management Node is running.
3. Configure the Data Node common parameters.
Select MySQL Cluster Node > Management Node > Configuration > Data Node Parameters .
Configure the following parameters:
Data Memory Size see Table 12
Index Memory Size see Table 12
No Of Replicas 1
No Of Fragment Log Files 128
Redo Buffer Size 8
12/8/2016 8:24 AM
Installation Instructions
35 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the Data Node of the NDB Cluster in the medium configuration.
The configuration file used by the NDB Data Node is /etc/ipworks/mysql/confs/ipworks_datanode_my.conf.
1. Start the IPWorks Control Panel on machine PS1.
Machine-PS1# ipwscp
2. Configure the Data Node parameters.
Select MySQL Cluster Node > Data Node > Configuration .
Configure the following parameter:
12/8/2016 8:24 AM
Installation Instructions
36 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
where <PS1 O&M IP Address> is the IP address of the machine on which the Management Node is running.
3. Depending on whether the Data Node is started for the first time, choose one of the following options.
If the Data Node is started for the first time, select MySQL Cluster Node > Data Node > Start Initial .
Note:
This operation is only performed for the first time setup. The operation erases all the NDB data
from the disk.
If the Data Node is not started for the first time, select MySQL Cluster Node > Data Node > Start .
4. Exit the IPWorks Control Panel.
5. Check that the Data Node has started.
Machine-PS1# /etc/init.d/ipworks.mysql show-ndb-status
The output in the following example shows that the Data Node is connected to the NDB Cluster. The Data Node is
ready only when starting is not displayed in the string against the id=2.
For example:
Machine-PS1# /etc/init.d/ipworks.mysql show-ndb-status
Configure and start the SQL Node of the first NDB Cluster in the medium configuration.
The configuration file used by the NDB Data Node is /etc/ipworks/mysql/confs/ipworks_datanode_my.conf
1. Start the IPWorks Control Panel on machine PS1.
Machine-PS1# ipwscp
2. Configure the SQL Node parameters.
Select MySQL Cluster Node > SQL Node > Configuration .
Configure the following parameters:
ServerID
Port
datadirectory
3
3307
/etc/ipworks/mysql/sqlnode1_data
where ServerID specifies the server ID for SQL replication process. The value must be an integer greater than 1 and
unique among all the ENUM servers connected to the same Storage Server. This means ENUM server A cannot have
the same SQL Node ServerID as ENUM server B, if A and B are connected to the same Storage Server.
Master-Host
12/8/2016 8:24 AM
Installation Instructions
37 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
where <SC Virtual IP Address> is the virtual IP address of the MySQL InnoDB.
If the Master Host value is changed by using the IPWorks Control Panel after the first correct configuration, it takes
effect after performing one of the following:
login to the SQL Node and use the CHANGE MASTER TO MASTER_HOST='New MASTER HOST' statement to reset
the SQL Node Master Host. (recommended)
restart of the SQL Node after deleting the master.info file located in /etc/ipworks/mysql/sqlnode1_data/.
12/8/2016 8:24 AM
Installation Instructions
38 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
12/8/2016 8:24 AM
Installation Instructions
39 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
The fields Master_Log_File and Read_Master_Log_Pos have the same values as those of the Master InnoDB Server.
8. Quit the session.
mysql> exit
9. Check the status of the Master InnoDB on machine SS1.
Machine-SS1# /usr/local/mysql/bin/mysql
mysql> show master status;
+--------+----------+--------------+------------------+
| File
| Position | Binlog_Do_DB | Binlog_Ignore_DB |
+--------+----------+--------------+------------------+
| .000009|
209211 |
|
|
+--------+----------+--------------+------------------+
1 row in set (0.00 sec)
mysql> exit
10. Check if the replication has failed.
Machine-PS1# /usr/local/mysql/bin/mysql -P 3307 --protocol=tcp
mysql> show slave status \G
This section provides the instructions to configure the DNS Server and its Server Manager in the medium configuration, to
start the Server Manager, and to update the DNS Server.
1. Edit the /etc/resolv.conf file to add nameserver and domain localhost attributes.
nameserver 127.0.0.1
domain localhost
2. Edit the /etc/nsswitch.conf file to append dns to the hosts entry.
hosts: files dns
3. Use the IPWorks Control Panel on machine PS1 to configure the DNS Server Manager parameters.
Machine-PS1# ipwscp
Select DNS Services > DNS Server Manager > Configuration Parameters .
12/8/2016 8:24 AM
Installation Instructions
40 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
12/8/2016 8:24 AM
Installation Instructions
41 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
dns1.iptelco.com
;; global options: printcmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 15
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1,
AUTHORITY: 1, ADDITIONAL: 0
;; QUESTION SECTION:
;dns1.iptelco.com.
IN A
;; ANSWER SECTION:
dns1.iptelco.com. 86400 IN A 100.0.0.41>
;; AUTHORITY SECTION:
iptelco.com.
86400 IN NS dns1.iptelco.com.
;; Query time: 2 msec
;; SERVER: <PS1 Traffic IP address>#5300(100.0.0.41)
;; WHEN: Tue Nov 28 14:54:43 2006
;; MSG SIZE rcvd: 64
4.2.6.6
This section provides the instructions to configure and start the ENUM Server and its Server Manager on the NDB Cluster in
the medium configuration.
1. Start the IPWorks Control Panel on machine PS1.
Machine-PS1# ipwscp
2. Configure the ENUM Server parameters.
Select ENUM Services > ENUM Server > Configuration Parameters .
ENUM Server Id
1
ENUM Server Port
53
Enable DNS Resolver
true
DNS Resolver IP Address
127.0.0.1
DNS Resolver UDP Port
5300
Log Destination
file
Log Level
fatal
Log Directory
/var/ipworks/logs
Name Prefix
ipworks_enum
No. of Logs
1
Log size (1-20) Mb
1
Log start (0-4)
0
ENUM Thread Count
10
Security Log Directory
/var/ipworks/logs/security
Security Logging Level (0-3)
2
No. of Security Log Files
5
Security Log File Size (1-5)Mb 1
Granularity Period for Requests Failed Alarm (Mnts) 10
Threshold Level for Requests Failed Alarm
30
3. Configure the ENUM Server Manager parameters.
Select ENUM Services > ENUM Server Manager > Configuration Parameters .
12/8/2016 8:24 AM
Installation Instructions
42 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the DHCPv6 Server and its Server Manager in the medium
configuration.
1. Use the IPWorks Control Panel on machine SS1 to configure the DHCPv6 Server Manager parameters.
lo0: flags=2001000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv4,VIRTUAL> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
bge0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,
IPv4> mtu 1500 index 2
inet 100.0.0.4 netmask ffffff00 broadcast
100.0.0.255
12/8/2016 8:24 AM
Installation Instructions
43 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
ether 0:3:ba:df:89:7
lo0: flags=2002000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv6,VIRTUAL> mtu 8252 index 1
inet6 ::1/128
bge0: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 fe80::203:baff:fedf:8907/10
ether 0:3:ba:df:89:7
bge0:1: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 3333:3333:3333:3333::104/64
3. Create a new IPv6 interface.
Machine-SS1# ifconfig <interface-name> inet6 plumb
For example:
Machine-SS1# ifconfig bge0 inet6 plumb
4. If the IPv6 address is not enabled, or if the user encounters a problem when using ifconfig to create the IPv6
address, edit the file /etc/hostname6.<interface-name> to set the IPv6 address to the IPv6 address of the server.
In the example shown above, the file /etc/hostname6.bge0 contains the following line:
addif 3333:3333:3333:3333::104/64 up
Reboot the machine after changing this file.
5. Use the IPWorks CLI on machine SS1 to create a dhcpv6server object.
Machine-SS1# ipwcli
IPWorks> create dhcpv6server <DHCPv6 Server Name> -set address=<PS1 O&M IP Address>
1 object(s) created.
IPWorks> exit
6. Ensure that the /var/run/dhcpv6.port file does not exist.
Machine-SS1# rm -f /var/run/dhcpv6.port
7. Use the IPWorks Control Panel on machine SS1 to start the DHCPv6 Server Manager.
8. Update the dhcpv6server object.
Machine-SS1# ipwcli
IPWorks> update dhcpv6server <DHCPv6 Server Name>
1 object(s) updated.
IPWorks> exit
Hardware Prerequisites
The three machines in the legacy configuration must have the following system configuration:
Sun Netra 240
2 X 1.5 GHz UltraSPARC IIIi processors
8 GB RAM
2 X 146 GB Hard Disk
12/8/2016 8:24 AM
Installation Instructions
44 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Interface Cards
1 Ethernet Card with 2 Gigabit Ethernet Ports (one for O&M and the other for traffic)
ISR v2 SS7 interface card (if ERH functionality is required)
4.3.2
Setup Diagram
The legacy configuration consists of three machines: one Storage Server and two Protocol Servers.
Figure 4 shows the IPWorks modules that can be installed on each of the three machines in the legacy configuration.
Figure 4
4.3.3
Installation Overview
Use the IPWorks Installation and Upgrade Tool to install the modules per user requirements, as shown in Table 13.
Table 13
Machine-SS
Machine-PS
IPWcommon
IPWbackup
IPWjre
IPWmysql
IPWcli
IPWtomcat
IPWsm
12/8/2016 8:24 AM
Installation Instructions
45 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
IPWss
IPWcnoss
IPWwebui
IPWdns
IPWasdnsmon
IPWdnsalg
IPWdhcpv4
IPWenum
Only if DHCPv6 functionality is
required
IPWdhcpv6
IPWerh
EAB SS7 Stack
IPWscagents
Table 14 shows the installation procedure for legacy configuration. The installation is customized by the user and thus
optional steps can be skipped.
Table 14
Step
Action
Mandatory
Mandatory
Optional
Mandatory
Mandatory
4.3.4
Description
This section provides the instructions to set up and configure the machine hosting the Storage Server in the legacy
configuration. This is machine SS1 in Figure 4.
12/8/2016 8:24 AM
Installation Instructions
46 of 62
4.3.4.1
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to configure and start the MySQL InnoDB Master in the legacy configuration.
1. Start the MySQL InnoDB Master.
Machine-SS1# /etc/init.d/ipworks.mysql start-master-innodb
Starting IPWorks InnoDB Master....
081111 16:16:02 mysqld_safe Logging to '/etc/ipworks/mysql/innodbnode_data/innodbnode.err'.
081111 16:16:02 mysqld_safe Starting mysqld daemon with databases from /etc/ipworks/mysql
/innodbnode_data/
2. Grant all privileges to localhost.
Machine-SS1# /usr/local/mysql/bin/mysql
mysql> grant all privileges on *.* to 'ipworks'@'localhost' identified by 'ipworks';
Query OK, 0 rows affected (0.00 sec)
3. Quit the session.
mysql> quit
4.3.4.3
This section provides the instructions to create the Storage Server databases in the legacy configuration, to start the
Storage Server and to initialize the Storage Server database.
1. Create the MySQL databases.
Machine-SS1# /opt/ipworks/IPWss/db/create_mysql_db
Creating Storage Server database ...
2. If the DHCPv6 Server is installed, create the DHCPv6 database.
Machine-SS1# /opt/ipworks/IPWdhcpv6/db/create_dhcpv6_db
Creating DHCPv6 database ...
3. Start the Storage Server.
Machine-SS1# /etc/init.d/ipworks.ss start
Starting IPWorks Storage Server ...
4. Use the IPWorks Control Panel on machine SS1 to check that the Storage Server is running.
5. Initialize the MySQL database.
Machine-SS1# /opt/ipworks/IPWss/db/init_mysql_db
Storage Server Username: admin
Password: <password>
Password (again): <password>
where <password> is the password of the admin user.
The objects are displayed during installation. The initialization is complete when the following output is displayed:
12/8/2016 8:24 AM
Installation Instructions
47 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
4.3.4.4
This section provides the instructions to configure and start the DHCPv6 Server and its Server Manager in the legacy
configuration.
1. Use the IPWorks Control Panel on machine SS1 to configure the DHCPv6 Server Manager parameters as follows:
lo0: flags=2001000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv4,VIRTUAL> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
bge0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,
IPv4> mtu 1500 index 2
inet 100.0.0.4 netmask ffffff00 broadcast
100.0.0.255
ether 0:3:ba:df:89:7
lo0: flags=2002000849<UP,LOOPBACK,RUNNING,MULTICAST,
IPv6,VIRTUAL> mtu 8252 index 1
inet6 ::1/128
bge0: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 fe80::203:baff:fedf:8907/10
ether 0:3:ba:df:89:7
bge0:1: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu
1500 index 2
inet6 3333:3333:3333:3333::104/64
3. Create a new IPv6 interface.
Machine-SS1# ifconfig <interface-name> inet6 plumb
For example:
Machine-SS1# ifconfig bge0 inet6 plumb
4. If the IPv6 address is not enabled, or if the user encounters a problem when using ifconfig to create the IPv6
address, edit the file /etc/hostname6.<interface-name> to set the IPv6 address to the IPv6 address of the server.
In the example shown in Step 2, the file /etc/hostname6.bge0 contains the following line:
addif 3333:3333:3333:3333::104/64 up
Reboot the machine after changing this file.
12/8/2016 8:24 AM
Installation Instructions
48 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to set up and configure the machine hosting the first of the two Protocol Servers in
the legacy configuration. This is machine PS1 in Figure 4. The instructions also apply to PS2.
4.3.5.1
This section provides the instructions to configure the DNS Server and its Server Manager in the legacy configuration, to
start the Server Manager, and to update the DNS Server.
1. Edit the /etc/resolv.conf file to add the following attributes:
nameserver 127.0.0.1
domain localhost
2. Edit the /etc/nsswitch.conf file to append dns to the hosts entry.
hosts: files dns
3. Use the IPWorks Control Panel on machine PS1 to configure the DNS Server Manager parameters.
Machine-PS1# ipwscp
Select DNS Services > DNS Server Manager > Configuration Parameters .
12/8/2016 8:24 AM
Installation Instructions
49 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
4. Start the IPWorks CLI from the shell prompt on machine SS1.
Machine-SS1# ipwcli
5. Create a dnsserver object.
IPWorks> create dnsserver dns1 set dnsname=dns1.iptelco.com;address=<PS1 O&M IP Address>
1 object(s) created.
The names dns1 and iptelco.com are used as an example. The user does not need to configure the DNS Server at
this point in the installation procedure.
Note:
If the dnsserver object is not created using ipwcli, a default dnsserver with the same name as the
primary hostname is created, that is, the name displayed by the hostname system command.
6. Create a masterzone object.
IPWorks> create masterzone dns1 iptelco.com
1 object(s) created.
7. Create an arecord object.
IPWorks> create arecord dns1.iptelco.com <PS1 Traffic IP Address>
1 object(s) created.
8. Exit the CLI.
IPWorks> exit
9. Ensure that the /var/run/dnssm.port file does not exist.
Machine-PS1# rm f /var/run/dnssm.port
10. Use the IPWorks Control Panel on machine PS1 to start the DNS Server Manager.
Machine-PS1# ipwscp
Select DNS Services > DNS Server Manager > Start Server Manager .
Exit the IPWorks Control Panel.
11. Update the DNS Server on machine SS1.
Machine-SS1# ipwcli
IPWorks> update dnsserver dns1
1 object(s) updated.
IPWorks> exit
12. Verify that the dnsserver has been updated.
Machine-PS1# dig @<PS1 Traffic IP Address> dns1.iptelco.com
The output from the above command contains the following text:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR,
Example:
12/8/2016 8:24 AM
Installation Instructions
50 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
;; ANSWER SECTION:
dns1.iptelco.com. 86400 IN A 100.0.0.41>
;; AUTHORITY SECTION:
iptelco.com.
86400 IN NS dns1.iptelco.com.
;; Query time: 2 msec
;; SERVER: <PS1 Traffic IP address>#53(100.0.0.41)
;; WHEN: Tue Nov 28 14:54:43 2006
;; MSG SIZE rcvd: 64
Hardware Prerequisites
The three machines in the entry configuration must have the following system configurations:
Sun Netra 240
2 X 1.5 GHz UltraSPARC IIIi processors
8 GB RAM
2 X 146 GB Hard Disk
Interface Cards
1 Ethernet Card with 2 Gigabit Ethernet Ports (one for O&M and the other for traffic)
ISR v2 SS7 interface card (if ERH functionality is required)
4.4.2
Setup Diagram
The entry configuration consists of three machines: one Storage Server and two Protocol Servers. Figure 5 shows the
IPWorks modules that can be installed on each of the three machines in the entry configuration.
12/8/2016 8:24 AM
Installation Instructions
51 of 62
Figure 5
4.4.3
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Installation Overview
Use the IPWorks Installation and Upgrade Tool to install the modules per user requirements, as shown in Table 15.
Table 15
Machine-SS
Machine-PS
IPWcommon
IPWbackup
IPWjre
IPWmysql
IPWcli
IPWtomcat
IPWsm
IPWss
IPWcnoss
IPWwebui
IPWdns
IPWasdnsmon
IPWdnsalg
IPWdhcpv4
IPWenum
IPWdhcpv6
IPWerh
IPWscagents
Table 16 shows the installation procedure for entry configuration. The installation is customized by the user and thus
12/8/2016 8:24 AM
Installation Instructions
52 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Step
Action
Description
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
10
Optional
11
Mandatory
4.4.4
This section provides the instructions to set up and configure the machine hosting the Storage Server in the entry
configuration. This is machine SS1 in Figure 5.
4.4.4.1
This section provides the instructions to start and configure the MySQL InnoDB Master in the entry configuration.
1. Start the MySQL InnoDB Master.
Machine-SS1# /etc/init.d/ipworks.mysql start-master-innodb
Starting IPWorks InnoDB Master....
081111 16:16:02 mysqld_safe Logging to '/etc/ipworks/mysql/innodbnode_data/innodbnode.err'.
081111 16:16:02 mysqld_safe Starting mysqld daemon with databases from /etc/ipworks/mysql
/innodbnode_data/
12/8/2016 8:24 AM
Installation Instructions
53 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
This section provides the instructions to create the Storage Server databases in the entry configuration, to start the Storage
Server, to initialize the Storage Server and the ENUM database.
1. Create the MySQL databases.
Machine-SS1# /opt/ipworks/IPWss/db/create_mysql_db
Creating Storage Server database ...
2. If the ENUM Server is installed, create the ENUM database.
Machine-SS1# /opt/ipworks/IPWss/db/create_enum_db
Creating NDB ENUM database ...
3. If the DHCPv6 Server is installed, create the DHCPv6 database.
Machine-SS1# /opt/ipworks/IPWdhcpv6/db/create_dhcpv6_db
Creating DHCPv6 database ...
4. Start the Storage Server.
Machine-SS1# /etc/init.d/ipworks.ss start
Starting IPWorks Storage Server ...
5. Use the IPWorks Control Panel on machine SS1 to check that the Storage Server is running.
6. Initialize the MySQL database.
Machine-SS1# /opt/ipworks/IPWss/db/init_mysql_db
Storage Server Username: admin
Password: <password>
Password (again): <password>
where <password> is the password of the admin user.
The objects being installed are displayed. The initialization is complete when the following output is displayed:
12/8/2016 8:24 AM
Installation Instructions
54 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
5 Installation Verification
This section describes the installation verification through the Control Panel, CLI, and Web Application. For more
information, see the following documents:
Control Panel User Guide, Reference [2]
Command Line Interface (CLI) User Guide, Reference [9]
Web Interface User Guide, Reference [10]
12/8/2016 8:24 AM
Installation Instructions
55 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
1 object(s) updated.
IPWorks> exit
10. Use dig to verify that the DNS Server is updated and that the test arecord is returned properly. The entry in the
answer section must match the data entered in Step 5.
# dig @10.0.0.1 host.example.com
A
; <<>> DIG 9.3.0 <<>> @10.0.0.1 host.example.com
;; global options: printcmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY,
status: NOERROR, id: 42528
;; flags: qr aa rd ra; QUERY: 1,
ANSWER: 1, AUTHORITY: 1,
ADDITIONAL: 0
;; QUESTION SECTION:
;host.example.com.
IN
;; ANSWER SECTION:
host.example.com.
8640
;; AUTHORITY SECTION:
example.com.
86400
;;
;;
;;
;;
0 IN
IN
10.0.0.1
NS dns.example.com.
11. Use the IPWorks Control Panel to stop the DNS Server Manager.
12. Use the IPWorks CLI to delete the test data:
# ipwcli
IPWorks> delete arecord host.example.com
IPWorks> delete masterzone example.com
IPWorks> delete dnsserver dns
12/8/2016 8:24 AM
Installation Instructions
56 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
8. Use the following command to verify that the ENUM Server can forward the DNS query:
# dig @<ENUM Server Traffic IP Address> dnstest.example.com
The following output is an example.
86400
IN
IN
SOA
12/8/2016 8:24 AM
Installation Instructions
57 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
dnstest.example.com. root.dnstest.example.com.
2 10800 3600 604800 86400
;;
;;
;;
;;
9. Use the IPWorks Control Panel to stop the DNS server, DNS Server Manager, ENUM Server, ENUM Server Manager,
and NDB Cluster. Then use the IPWorks CLI to delete the test data.
# ipwcli
IPWorks>
IPWorks>
IPWorks>
IPWorks>
IPWorks>
delete
delete
delete
delete
exit
enumdnsched 4.3.2.1.4.3.2.1.0.1.4.4.e164.example.com
enumzone 1
enumserver 1
dnsserver dnstest
12/8/2016 8:24 AM
Installation Instructions
58 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
ipconfig /all
6 Appendix
This section provides the instructions to display the versions of the currently installed IPWorks components, to launch the
management interfaces of IPWorks, to start and stop certain IPWorks components, and to configure SS7.
12/8/2016 8:24 AM
Installation Instructions
59 of 62
IPWcommon
IPWjre
IPWmysql
IPWcli
IPWss
IPWbackup
IPWcnoss
IPWtomcat
IPWwebui
IPWsm
IPWdns
IPWenum
IPWasdnsmon
IPWdnsalg
IPWdhcpv4
IPWdhcpv6
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
CXP_901_3879_R1A_LSV1
CXP_901_3878_R1A_LSV1
CXP_901_3877_R1A_LSV1
CXP_901_3876_R1A_LSV1
CXP_901_3875_R1A_LSV1
CXP_901_3881_R1A_LSV1
CXP_901_3880_R1A_LSV1
CXP_901_3873_R1A_LSV1
CXP_901_3874_R1A_LSV1
CXP_901_3883_R1A_LSV1
CXP_901_3885_R1A_LSV1
CXP_901_3889_R1A_LSV1
CXP_901_3882_R1A_LSV1
CXP_901_3884_R1A_LSV1
CXP_901_3886_R1A_LSV1
CXP_901_3887_R1A_LSV1
2. Display the installed data, time and build number associated with the installed IPWorks 6.0 releases.
# ipwversion history
For example:
# ipwversion history
CSH_109_085_R1A_LSV1 *
Installed Date
Build no
: Aug 4 13:34;
: 1001;
-> CXP_901_3879_R1A_LSV1 *
12/8/2016 8:24 AM
Installation Instructions
60 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
Starting Tomcat
Tomcat is a servlet container used to support the service of WebUI. User must start Tomcat before using the Web
Application.
Perform the following commands to start Tomcat on single or legacy configuration.
# cd /etc/init.d/
# ./ipworks.tomcat start
12/8/2016 8:24 AM
Installation Instructions
61 of 62
6.5.2
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
6.5.3
6.5.4
6.5.5
6.5.6
12/8/2016 8:24 AM
Installation Instructions
62 of 62
http://cpistore.internal.ericsson.com/alexserv?ID=243&DB=22939-2219...
# ipwscp
Select MySQL Cluster Node > Data Node > Stop .
Note:
It is recommended to use the method described in Section 6.5.8 to stop the entire NDB cluster instead of
stopping the nodes individually.
In the following scenarios, the user must perform the cluster shutdown to stop the Data Node.
A Data Node is in the starting state.
The NDB Cluster has only one Data Node, or <n> Data Nodes with <n>-1 Data Nodes stopped.
6.5.7
Start the IPWorks Control Panel and select the following Control Panel menu options:
# ipwscp
Select MySQL Cluster Node > Management Node > Cluster Shutdown .
Reference List
Ericsson Documents
[1] System Administration Guide, 1543-CSH 109 085 Uen.
[2] Control Panel User Guide, 4/1553-CSH 109 085 Uen.
[3] Solaris Security Hardening for IPWorks 6.0, 1/1551-CSH 109 085 Uen.
[4] Security Hardening for IPWorks 6.0 Application Components, 2/1551-CSH 109 085 Uen.
[5] Solaris Installation Instructions for IPWorks 6.0, 1/1531-CSH 109 085 Uen.
[6] Sun Cluster Installation Instructions for IPWorks 6.0, 2/1531-CSH 109 085 Uen.
[7] SS7 Configuration for IPWorks 6.0, 2/1543-CSH 109 085 Uen.
[8] Installation and Upgrade Tool User Guide, 1/1553-CSH 109 085 Uen.
[9] Command Line Interface (CLI) User Guide, 3/1553-CSH 109 085 Uen.
[10] Web Interface User Guide, 2/1553-CSH 109 085 Uen.
[11] Troubleshooting User Guide, 1/1543-CSH 109 085 Uen.
12/8/2016 8:24 AM