Sun Open Telecommunications Platform 1.1 Installation and Administration Guide

Chapter 8 Backing Up and Restoring the OTP Provisioning Service and the OTP System Management Service

This chapter provides the procedures for backing up the provisioning service and system management and database and configuration files, restoring the files to a new OTP host, and for enabling the services on a new OTP host.

The following topics are discussed:

Backing Up and Restoring the OTP Provisioning Service Database and Configuration Files

This section provides the procedure for backing up and restoring the provisioning service database and configuration files. Backup of the provisioning service database and configuration files should be performed on a regular basis. Situations that could warrant provisioning service restoration of the service after applying system patches or performing a JumpStart installation.

The following topics are discussed:

Backing Up and Restoring the OTP Provisioning Service on the External OTP Installation Server

This section provides the procedures for backing up and restoring the OTP provisioning service on the external OTP installation server

The following topics are discussed:

ProcedureTo Back Up the Provisioning Service on the External OTP Installation Server

  1. Log in to the external OTP installation server as root.

  2. Type the following command to back up the provisioning service.


    Tip –

    copy and paste the following command to the terminal window.



    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_backup.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -l /var/tmp/backup.log \
    -o /var/tmp -nors -noconfig -nokeystore  -z -shutdown yes

    The compressed backup tar file and the backup log file are created in the directory /var/tmp/. For example, /var/tmp/backup_log.070411145059 and /var/tmp/070411145059.tar.Z where 070411145059 is the system date and time stamp.

ProcedureTo Restore the Provisioning Service on the External OTP Installation Server

Before You Begin

The provisioning service on the external OTP installation server must be backed up as described in To Back Up the Provisioning Service on the External OTP Installation Server

  1. Log in to the external OTP installation server as root.

  2. Type the following command to back up the provisioning service.


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_restore.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -f /var/tmp/backup tar file name \
    -l /var/tmp/log_file_name \
    -t /var/tmp -shutdown yes -nors -noconfig -nokeystore -overwrite yes

    where backup tar file name is the name of the backup tar file created in To Back Up the Provisioning Service on the External OTP Installation Server, and log file name is the name you specify for the log file. The system date and time stamp is automatically appended to the log file name you specify. For example, /var/tmp/restore_log.070411145059

Backing Up the OTP Provisioning Service on an External OTP Installation Server and Restoring to a Clustered OTP Host

This section provides the procedures for backing up the provisioning service on an external OTP installation server and restoring the provisioning service to a clustered OTP host.

Backing up the provisioning service on an external OTP installation server and restoring it to an OTP host is comprised of the following tasks:

ProcedureTo Remove the Remote Agent from the External OTP Installation Server

  1. Open a Web browser and go to URL https://install server:9090 where install server is either the IP address or the fully qualified name of the external OTP installation server.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  8. Scroll to the bottom of the screen and click save.

Next Steps

Remove the remote agent from the restore target OTP host as described in the next procedure.

ProcedureTo Remove the Remote Agent from the Restore Target OTP Host

Before You Begin

The remote agent must be removed from the external OTP installation server as described in To Remove the Remote Agent from the External OTP Installation Server

  1. Open a Web browser and go to URL https://OTP host:9090 where OTP host is either the IP address or the fully qualified name of the OTP host to which the provisioning service is to be restored.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  8. Scroll to the bottom of the screen and click save.

Next Steps

Back up the provisioning service on the external OTP installation server as described in the next procedure.

ProcedureTo Back Up the Provisioning Service on the External OTP Installation Server

Before You Begin
  1. Log in as root to the external OTP installation server.

  2. Type the following command to back up the provisioning service.


    Tip –

    Copy and paste the following command to your root terminal window.



    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_backup.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -o /var/tmp -nors -noconfig -nokeystore  -z -shutdown yes

    The backup tar file is created as /var/tmp/timestamp.tar.Z. For example:

    The compressed backup tar file and the backup log file are created in the directory /var/tmp/. For example, /var/tmp/backup_log.070411145059 and /var/tmp/070411145059.tar.Z where 070411145059 is the system date and time stamp.

Next Steps

Restore the backup from the external OTP installation server to the target OTP host as described in the next procedure.

ProcedureTo Restore the Provisioning Service Backup to the Target OTP Host

Before You Begin
  1. Log in as root to an OTP host in the cluster.

  2. Type /usr/cluster/bin/scstat -g to determine which host in the cluster is online.

    Make note of the host on which the resource group otp-system-rg is online.

    For example:


    # /usr/cluster/bin/scstat -g | grep Online
        Group: otp-system-rg       otp-node17          Online
     Resource: otp-lhn             otp-node17          Online    Online - LogicalHostname online
     Resource: otp-sps-hastorage-plus otp-node17          Online    Online
     Resource: otp-spsms-rs        otp-node17          Online    Online
     Resource: otp-spsra-rs        otp-node17          Online    Online

    In the above example, the resource group otp-system-rg is running on online host otp-node17.

  3. Log in as root on the OTP host on which the resource group is online.

  4. Disable the Provisioning service resource in the resource group.

    Type the following commands:


    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=FALSE
    
    /usr/cluster/bin/scswitch -n -j otp-spsms-rs
  5. Restore the Provisioning service database to the OTP host.

    Type the following command:


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_restore.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -f /var/tmp/backup tar file name \
    -l /var/tmp/log file name \
    -t /var/tmp -shutdown yes -nors -noconfig -nokeystore -overwrite yes

    where backup tar file name is the name of the backup tar file created in To Back Up the Provisioning Service on the External OTP Installation Server, and log file name is the name you specify for the log file. The system date and time stamp is automatically appended to the log file name you specify. For example, /var/tmp/restore_log.070411145059

  6. Drop the tables used by the cluster to poll the resource group.

    Type the following commands. Wait for each command to complete before typing the next command.


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_server start
    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/roxdbcmd psql rox
    drop user sc_test;

    The semicolon at the end of the drop user sc_test; is required.

  7. Press Cntrl-d to terminate the SQL session.

  8. Recreate the tables used by the cluster to poll the resource group.

    Type the following commands. Wait for each command to complete before typing the next command.


    su - spsotp \
    /opt/SUNWscsps/master/util/db_prep_postgres \
     /var/otp/spsotp/N1_Service_Provisioning_System_5.2/
    
    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_server stop
  9. Enable the provisioning service resource in the resource group.

    Type the following commands.


    /usr/cluster/bin/scswitch -e -j otp-spsms-rs
    
    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=TRUE
Next Steps

Add the remote agent to the external OTP installation server as described in the next procedure.

ProcedureTo Add the Remote Agent to the External OTP Installation Server

Before You Begin
  1. Open a Web browser and go to URL http://install server:9090 where install server is either the IP address or the fully qualified name of the external OTP installation server.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the external OTP installation server IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Click Save.

  12. Click master server.

  13. Scroll to the bottom of the screen and click update remote agent.

  14. Click prepare remote agent.

Next Steps

Add the remote agent to the target OTP host as described in the next procedure.

ProcedureTo Add the Remote Agent to the Target OTP Host

Before You Begin
  1. Open a Web browser and go to URL http://OTP host:9090 where OTP host is either the IP address or the fully qualified name of the target OTP host.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the target OTP host IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Scroll to the bottom of the screen and click save.

  12. Click master server.

    Scroll to the bottom of the screen.

  13. Click update remote agent.

  14. Click prepare remote agent.

Backing Up the OTP Provisioning Service on one Clustered OTP Host and Restoring to Another Clustered OTP Host

This section provides the procedures for backing up and restoring the OTP provisioning service from one clustered OTP host and restoring the provisioning service to a different clustered OTP host.

Backing up the provisioning service on one OTP host and restoring it to an OTP host is comprised of the following tasks:

ProcedureTo Remove the Remote Agent from the Backup Source OTP Host

  1. Log in as root to an OTP host in the cluster.

  2. Type /usr/cluster/bin/scstat -g to determine which host in the cluster is online.

    Make note of the host on which the resource group otp-system-rg is active.

    For example:


    # /usr/cluster/bin/scstat -g | grep Online
        Group: otp-system-rg       otp-node17          Online
     Resource: otp-lhn             otp-node17          Online    Online - LogicalHostname online.
     Resource: otp-sps-hastorage-plus otp-node17          Online    Online
     Resource: otp-spsms-rs        otp-node17          Online    Online
     Resource: otp-spsra-rs        otp-node17          Online    Online
     

    In the above example, the resource group online host is otp-node17.

  3. Open a Web browser and go to URL http://backup source OTP host:9090 where backup source OTP host is either the IP address or the fully qualified name of the OTP host on which the resource group is active.

    The OTP provisioning service log in screen appears.

  4. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  5. Click Host Setup in the left panel.

    The host setup screen appears.

  6. Click hosts in the central panel.

    The hosts screen appears.

  7. Click master server.

    The hosts > details screen appears.

  8. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  9. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  10. Scroll to the bottom of the screen and click save.

Next Steps

Remove the remote agent from the restore target OTP host as described in the next procedure.

ProcedureTo Remove the Remote Agent from the Restore Target OTP Host

Before You Begin

The remote agent must be removed from the backup source OTP host as described in To Remove the Remote Agent from the Backup Source OTP Host

  1. Log in as root to an OTP host in the restore target cluster.

  2. Type /usr/cluster/bin/scstat -g to determine which host in the cluster is active.

    Make note of the host on which the resource group otp-system-rg is active.

  3. Open a Web browser and go to URL http://target OTP host:9090 where target OTP host is either the IP address or the fully qualified name of the OTP host on which the resource group is active.

    The OTP provisioning service log in screen appears.

  4. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  5. Click Host Setup in the left panel.

    The host setup screen appears.

  6. Click hosts in the central panel.

    The hosts screen appears.

  7. Click master server.

    The hosts > details screen appears.

  8. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  9. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  10. Scroll to the bottom of the screen and click save.

Next Steps

Back up the provisioning service on the source OTP host as described in the next procedure.

ProcedureTo Back Up the Provisioning Service on the Source OTP Host

Before You Begin
  1. Log in as root on the backup source OTP host you identified in To Remove the Remote Agent from the Backup Source OTP Host.

  2. Disable the provisioning service resource in the resource group

    Type the following commands:


    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=FALSE
    
    /usr/cluster/bin/scswitch -n -j otp-spsms-rs
  3. Backup the provisioning service database

    Type the following command:


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_backup.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -o /var/tmp -nors -noconfig -nokeystore  -z -shutdown yes

    The compressed backup tar file is created as /var/tmp/timestamp.tar.Z where timestamp is the system date and time stamp. For example, /var/tmp/070411145059.tar.Z

  4. Enable the Provisioning service resource in the resource group.

    Type the following commands:


    /usr/cluster/bin/scswitch -e -j otp-spsms-rs
    
    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=TRUE
Next Steps

Restore the provisioning service to the restore target OTP host as described in the next procedure.

ProcedureTo Restore the Provisioning Service Backup To The Restore Target OTP Host

Before You Begin
  1. Log in as root to the restore target OTP host.

    This is the OTP host from which you removed the remote agent as described in To Remove the Remote Agent from the Restore Target OTP Host.

  2. Disable the provisioning service resource in the resource group.

    Type the following commands:


    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=FALSE
    
    /usr/cluster/bin/scswitch -n -j otp-spsms-rs
  3. Restore the Provisioning service database.

    Type the following command


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_restore.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -f /var/tmp/backup tar file name \
    -l /var/tmp/log file name \
    -t /var/tmp -shutdown yes -nors -noconfig -nokeystore -overwrite yes

    Where backup tar file name is the name of the backup file you created in To Back Up the Provisioning Service on the Source OTP Host, and log file name is the name you specify for the log file.

  4. Drop and recreate the tables used by the cluster to poll the resource group.

    Type the following commands:


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_server start
    
    cd /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/
    
    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/roxdbcmd psql rox
    
    drop user sc_test;
    
    drop table sc_test;

    The semicolon at the end of the drop user sc_test; and drop table sc_test;is required.

  5. Type Ctrl-d to terminate the SQL session.

  6. Recreate the tables used by the cluster to poll the resource group.


    su - spsotp \
    /opt/SUNWscsps/master/util/db_prep_postgres \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/
    
    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_server stop
  7. Enable the provisioning service resource in the resource group.


    /usr/cluster/bin/scswitch -e -j otp-spsms-rs
    
    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=TRUE
Next Steps

Add the remote agent to the backup source OTP host as described in the next procedure.

ProcedureTo Add the Remote Agent To The Backup Source OTP Host

Before You Begin
  1. Open a Web browser and go to URL http://backup source OTP host:9090 where backup source OTP host is either the IP address or the fully qualified name of the OTP host you identified in To Remove the Remote Agent from the Backup Source OTP Host.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the backup source OTP host IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Scroll to the bottom of the screen and click save.

  12. Click master server.

  13. Click update remote agent.

  14. Click prepare remote agent.

Next Steps

Add the remote agent to the restore target OTP host as described in the next procedure.

ProcedureTo Add the Remote Agent To The Restore Target OTP Host

Before You Begin
  1. Open a Web browser and go to URL http://restore target OTP host:9090 where restore targetOTP host is either the IP address or the fully qualified name of the target OTP host to which you restored the provisioning service in To Restore the Provisioning Service Backup To The Restore Target OTP Host.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the restore target OTP host IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Scroll to the bottom of the screen and click save.

  12. Click master server.

  13. Click update remote agent.

  14. Click prepare remote agent.

Backing Up the OTP Provisioning Service on a Clustered OTP Host and Restoring to the External OTP Installation Server

This section provides the procedures for backing up and restoring the OTP provisioning service from one clustered OTP host and restoring the provisioning service to the external OTP installation server.

Backing up the provisioning service on an OTP host and restoring it to the external OTP installation server is comprised of the following tasks:

ProcedureTo Remove the Remote Agent from the Backup Source OTP Host

  1. Log in as root to an OTP host in the cluster.

  2. Type /usr/cluster/bin/scstat -g | grep Online to determine which host in the cluster is active.

    Make note of the host on which the resource group otp-system-rg is active.

  3. Open a Web browser and go to URL http://backup source OTP host:9090 where backup source OTP host is either the IP address or the fully qualified name of the OTP host on which the resource group is active.

    The OTP provisioning service log in screen appears.

  4. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  5. Click Host Setup in the left panel.

    The host setup screen appears.

  6. Click hosts in the central panel.

    The hosts screen appears.

  7. Click master server.

    The hosts > details screen appears.

  8. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  9. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  10. Scroll to the bottom of the screen and click save.

Next Steps

Remove the remote agent from the External OTP Installation Server as described in the next procedure.

ProcedureTo Remove the Remote Agent from the External OTP installation server

Before You Begin

The remote agent must be removed from the backup source OTP host as described in To Remove the Remote Agent from the Backup Source OTP Host

  1. Open a Web browser and go to URL http://external OTP installation server:9090 where external OTP installation server is either the IP address or the fully qualified name of the external OTP installation server.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host has a check mark in it, click the check box to remove the check mark.

  8. Scroll to the bottom of the screen and click save.

Next Steps

Back up the provisioning service on the source OTP host as described in the next procedure.

ProcedureTo Back Up the Provisioning Service on the Source OTP Host

Before You Begin
  1. Log in as root on the backup source OTP host you identified in To Remove the Remote Agent from the Backup Source OTP Host.

  2. Disable the provisioning service resource in the resource group

    Type the following commands:


    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=FALSE
    
    /usr/cluster/bin/scswitch -n -j otp-spsms-rs
  3. Backup the provisioning service database

    Type the following command:


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_backup.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -o /var/tmp -nors -noconfig -nokeystore  -z -shutdown yes

    The compressed backup tar file is created as /var/tmp/timestamp.tar.Z where timestamp is the system date and time stamp. For example, /var/tmp/070411145059.tar.Z

  4. Enable the Provisioning service resource in the resource group.

    Type the following commands:


    /usr/cluster/bin/scswitch -e -j otp-spsms-rs
    
    /usr/cluster/bin/scrgadm -c -g otp-system-rg -y RG_system=TRUE
Next Steps

Restore the provisioning service to the external OTP installation server as described in the next procedure.

ProcedureTo Restore the Provisioning Service Backup To The External OTP Installation Server

Before You Begin
  1. Log in as root to the external OTP installation server.

  2. Restore the provisioning service database.

    Type the following command


    su - spsotp \
    /var/otp/spsotp/N1_Service_Provisioning_System_5.2/server/bin/cr_restore.sh \
    -b /var/otp/spsotp/N1_Service_Provisioning_System_5.2 \
    -f /var/tmp/backup tar file name \
    -l /var/tmp/log file name \
    -t /var/tmp -shutdown yes -nors -noconfig -nokeystore -overwrite yes

    Where backup tar file name is the name of the backup file you created in To Back Up the Provisioning Service on the Source OTP Host, and log file name is the name you specify for the log file.

Next Steps

Add the remote agent to the backup source OTP host as described in the next procedure.

ProcedureTo Add the Remote Agent To The Backup Source OTP Host

Before You Begin
  1. Open a Web browser and go to URL http://backup source OTP host:9090 where backup source OTP host is either the IP address or the fully qualified name of the OTP host you identified in To Remove the Remote Agent from the Backup Source OTP Host.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the backup source OTP host IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Scroll to the bottom of the screen and click save.

  12. Click master server.

  13. Click update remote agent.

  14. Click prepare remote agent.

Next Steps

Add the remote agent to the restore external OTP installation server as described in the next procedure.

ProcedureTo Add the Remote Agent To External OTP Installation Server

Before You Begin
  1. Open a Web browser and go to URL http://external OTP installation server:9090 where external OTP installation server is either the IP address or the fully qualified name of the external OTP installation server.

    The OTP provisioning service log in screen appears.

  2. Log in to the OTP provisioning service.

    The Service Provisioning System screen appears.

  3. Click Host Setup in the left panel.

    The host setup screen appears.

  4. Click hosts in the central panel.

    The hosts screen appears.

  5. Click master server.

    The hosts > details screen appears.

  6. Scroll to the bottom of the screen and click edit.

    The hosts > details > edit screen appears.

  7. If the checkbox labeled include remote agent on this physical host does not have a check mark in it, click the check box to add the check mark.

  8. In connection type, choose TCP/IP (unencrypted).

  9. Type the external OTP installation server IP address in the ip address or name field.

  10. Type 7010 in the port field.

  11. Scroll to the bottom of the screen and click save.

  12. Click master server.

  13. Click update remote agent.

  14. Click prepare remote agent.

Backing Up and Restoring the OTP System Management Service

This section provides the procedure for backing up and restoring the system management database and configuration files. Backup of the system management database and configuration files should be performed on a regular basis.

If the OTP host on which the OTP system management service is installed fails, you can restore the management services to any other standalone OTP host or clustered OTP host as described in this section.


Note –

Because the backup process does not back up the Solaris 10 Update 2 OS image and OS profile to conserve space in the backup file, you must either recreate the OS image and OS profile on the new OTP host, or manually backup and restore the OS image and OS profiles as described in theBacking Up and Restoring OS Images and OS Profiles


The following topics are discussed:

Backing Up The OTP System Management Service Database and Configuration Files

This section provides the procedure for backing up the system management database and configuration files.

ProcedureTo Back Up the OTP System Management Service Database and Configuration Files

This procedure describes how to back up the system management database and configuration files. The system management is restarted several times during this process. Therefore, perform these steps only when the system management service is not currently running jobs.

Do not change the configuration or OS usage of the standalone OTP host or of the clustered OTP hosts during the period between executing the backup and restore procedures.

Before You Begin

Choose a server that is external to the standalone OTP host or the clustered OTP hosts on which to save the backup files.

  1. Log in as root (su - root) to the OTP host on which the system management service is installed.

  2. Type /opt/sun/n1gc/bin/n1smbackup.sh to start the backup process.

    For example:


    # /opt/sun/n1gc/bin/n1smbackup.sh
    This program will back up Sun N1SM on this Linux/SunOS machine.
    
    The N1SM services will be restarted and N1SM will be interrupted during 
    the process.
    
    All files related to N1SM, including network interface 
    configuration, will be backed up. Therefore, it is recommended 
    that these files are restored to an identical hardware setup. 
    
    Verify that N1SM does not have outstanding jobs before proceeding.
    
    The backup process will take about 8 minutes.
    
    Would you like to continue? [y/N] y
    
    Backing up configuration files (done)
    Backing up SCS database (done)
    Backing up SPS database (done)
    N1SM restarted.
    N1SM backup completed. Backup saved to file 
    /var/tmp/n1smbackup/n1smbackup.tgz.

    The backup file is /var/tmp/n1smbackup/n1smbackup.tgz.

  3. Copy the file /var/tmp/n1smbackup/n1smbackup.tgz a server external to the OTP system.

Restoring the OTP System Management Service Database and Configuration Files to Another OTP Host

This section provides the procedures for restoring and enabling the system management service on another OTP host. Restoring and enabling the system management service on another OTP host is comprised of the following two tasks:

ProcedureTo Configure the OTP System Management Service on Another OTP Host

This procedure describes how to configure the OTP system management service on another OTP host within the clustered OTP system.

Before You Begin
  1. Log in as root to the OTP host you have chosen for OTP system management service database and configuration file restoration.

  2. Type n1smconfig to configure the system management service.


    # /usr/bin/n1smconfig
    

    The current system configuration appears, and lists the network interfaces. You are then asked to specify the DHCP server.

    For example:


    # /usr/bin/n1smconfig
    
    - - - - - - CURRENT CONFIGURATION - - - - - - -
    
       Provisioning Interface = ce0 : 10.11.52.79
       DHCP IP range: none
       Management Interface = ce0 : 10.11.52.79
    
      Logging values:
          job.plan-timeout = 1440
          job.step-timeout = 120
          filter.topic = all
          filter.severity = 0
          Days before deleting log entries = 365
    
        DNS settings = none.
    
       Web console auto login enabled = no
       Serial console with SSHv1 enabled = no
    
    Current SSH policy:
    accept CHANGED host keys for Management IP address = yes
    accept CHANGED host keys for Platform IP address = yes
    accept UNKNOWN host keys for Management IP address = yes
    accept UNKNOWN host keys for Platform IP address = yes
    
    ALOM email server = internal server
    
    DHCP server = Solaris
    
    Discover servers by the OS IP addresses = no
    
    CURRENT RIS Servers:
    
    
    - - - - - - - - - - - - - - - - - - - - - - - -
    This program configures the N1SM Management Server.
    Only options that can be changed will be displayed.
    Would you like to continue? ([n]/y) y 
  3. Choose the Solaris DHCP server.

    Type s to choose the Solaris DHCP server. The Open Telecommunications Platform does not support ISC DHCP.

    A description of the tasks you can perform at this point appears. You are then asked whether you want to modify the interface that is to be used by the provisioning network.

  4. Type y to specify the provisioning network interface.


    Note –

    Even if the provisioning interface shown matches the current provisioning interface, type y to rebind the provisioning interface IP addresst of the new system management host.


    The available interfaces are listed. You are asked to specify the provisioning network interface port.

  5. Type the interface name that is to be used for the provisioning interface.

    Type the interface name that is to be used for the provisioning interface, for example ce0, eth0, hme0, bge0 and so on depending on the host architecture and installed OS.

    You are asked if you want the DHCP server to use a specific IP address range.

  6. Type n to disable DHCP IP address range use.

    You are asked if you want to modify the interface that is to be used by the management network.

  7. Type y to specify for the management network interface.


    Note –

    Even if the provisioning interface shown matches the current provisioning interface, type y to rebind the management interface IP addresst of the new system management host.


    A description of the management network appears, followed by a list of the network interfaces that have been detected. You are then prompted to specify the interface that is to be used by the management network.

  8. Type the interface name that is to be used for the management interface.

    Type the interface name that is to be used for the management interface, for example ce0, eth0, hme0, bge0 and so on depending on the host architecture and installed OS.

    You are asked whether you want to configure the DNS name servers and search list entry.

  9. Type n.

    The OTP system management restore process will restore the OTP DNS and search list configuration data.

    You are asked whether you want to configure the SMTP server for event notification.

  10. Type n.

    The restore process will restore the SMTP configuration data.

    You are asked whether you want to modify the logging configuration.

  11. Type n.

    The restore process will restore the logging configuration data.

    You are asked whether you want to enable auto-login for the ILOM Web GUI.

  12. Type n.

    The restore process will restore the auto—login configuration data.

    You are asked whether you want to enable SSHv1 protocol.

  13. Type n.

    The restore process will restore the SSHv1 configuration data.

    You are asked whether you want to modify SSH policies for changed and unknown host keys.

  14. Type n.

    The restore process will restore the SSH configuration data.

    The current status of the ALOM email server is displayed. You are asked whether you want to modify the ALOM email server.

  15. Type n.

    The restore process will restore the ALOM email configuration data.

    You are asked whether you want to add, delete, or modify the WindowsTM RIS server.

  16. Type n.

    This release of the Open Telecommunications Platform does not support Windows.

    A description of OS Discovery appears. You are asked whether you want to enable OS discovery.

  17. Type n.

    The Open Telecommunications Platform requires IP address-based discovery.

    You are asked whether you want to modify the default password on the execution server.

  18. Type n.

    The restore process will restore the execution server password.

    The configuration process then displays the settings you have specified, and asks whether you want to apply the settings.

  19. Review the proposed settings.

    • Type y to apply the settings.

      The settings are applied, and the OTP system management service is restarted.

    • Type n if the settings are not correct.

      You are notified that you must reconfigure and apply settings for the system managementservice to work properly. The configuration process then exits to the system prompt. To configure the system management service, run the n1smconfig command again.

Next Steps

Restore the system management database and files to the OTP host as described in the next procedure.

ProcedureTo Restore the OTP System Management Service to Another OTP Host

This procedure describes how to restore the OTP system management service on another OTP host within the clustered OTP system.

Before You Begin
  1. Log in as root on the target OTP host.

  2. Type mkdir -p /var/tmp/n1smbackup.

  3. Copy the n1smbackup.tgz backup file you created in To Back Up the OTP System Management Service Database and Configuration Files to the /var/tmp/n1smbackup directory.

  4. Type /opt/sun/n1gc/bin/n1smrestore.sh -f /var/tmp/n1smbackup/n1smbackup.tgz to restore the system management database and files.

    For example:


    # /opt/sun/n1gc/bin/n1smrestore.sh -f /var/tmp/n1smbackup/n1smbackup.tgz
    
    This program will restore Sun N1SM from backup files.
    
    The N1SM services will be restarted and N1SM will be interrupted during 
    the process.
    
    All files related to N1SM, including network interface 
    configuration, will be restored. Therefore, it is recommended 
    that these files are restored to an identical hardware setup. 
    
    The restore process will take about 8 minutes.
    
    Would you like to continue? [y/N] y
    
    Restoring configuration files (done)
    Restoring SCS database (done)
    Restoring SCS database (done)
    N1SM restarted.
    N1SM restore completed.Run n1smconfig and verify that N1SM settings are correct.
  5. Type n1smconfig to reconfigure the system management services.

    The current configuration is displayed, and you are asked whether you want to continue.

    Type y to continue. Reconfigure the system management as described in To Configure the OTP System Management Service on Another OTP Host.

  6. Verify that the OTP System Management Service is working properly.

    1. Open a web browser and log in to the system management service on the OTP host.

      Go to URL https://OTP host:6789 where OTP host is either the IP address or the fully qualified name of the OTP host.

      The Java Web console log in page is appears. Type your system management user name and password to log in.

      The system management page appears.

    2. Type /opt/sun/n1gc/bin/n1sh to open the OTP command shell. For example:


      # /opt/sun/n1gc/bin/n1sh
      N1-ok>

    Successful display of the system management web page and of the N1–ok> prompt signifies successful configuration and restoration of the system management service to the OTP host.

    If the system management Web page or the N1–ok> prompt fail to appear, log in as root to the OTP host and type the command svcadm disable n1sm. Wait for the services to stop, and then type the command svcadm enable n1sm. Wait for the services to complete startup, and then retry verification.

  7. (Optional) Remove any OS distributions or OS profiles that exist on the OTP host before creating new OS distributions and OS profiles.


    N1-ok> show os all
    ID     Name                  Type          Version
    2      s10                   solaris       solaris10x86
    
    N1-ok> show osprofile
    ID     Name                       Distribution
    2      s10                        s10
    
    N1-ok> delete osprofile s10
    N1-ok> delete os s10
    N1-ok> show os
    No items found.
    N1-ok> show osprofile
    No items found.

Backing Up and Restoring OS Images and OS Profiles

This section provides the procedure for backing up and restoring OS images and profiles.

ProcedureTo Backup and Restore OS Images and OS Profiles

  1. Using any file level backup and restore program, back up the following directories to a server that is not a member of the clustered OTP system.

    • /var/opt/sun/scs/share/allstart

    • /tftpboot

  2. Restore the directories to the target OTP host.