Professional Documents
Culture Documents
Cloning A Maximo Asset Management 7.5
Cloning A Maximo Asset Management 7.5
iii
iv Cloning a Maximo Asset Management 7.5 environment
Cloning a Maximo Asset Management 7.5 environment
Maximo Asset Management 7.5 deployments can be copied into multiple
environments. This allows you to duplicate environments for the purposes of
development, testing, and prototyping.
You can refine best practices for your product in development and test
environments. You can then apply the best practices to the production
environment.
For the purposes of cloning, the currently installed product is referred to as the
source environment. A parallel environment is created that is the same as the source
environment in structure. The parallel environment is referred to as the target
environment. The database is copied from the source environment and deployed in
the target environment.
Install and configure WebSphere Application Server, DB2, and optionally Tivoli
Directory Server, as described in the installation information for the 7.5 version of
your product.
The target environment administrative workstation must have the same operating
system, major version, and be of the same hardware type as the source
environment administrative workstation. The user ID used to install the product on
the source environment administrative workstation must also exist on the target
environment administrative workstation. This user ID must have the same
permissions defined for it in both environments. If you prefer, you can also reuse
the source environment administrative workstation system to serve as the target
environment administrative workstation.
1
This procedure is for an installation of version 7.5 of your product that was
installed in a local deployment engine environment.
This procedure references c:\ibm\smp as the installation home directory. If you did
not use the default installation path during installation, use the custom value in
place of c:\ibm\smp.
1. Log on to the source environment administrative workstation with the user ID
that was used to install the product.
2. Create a copy of the 7.5 installation directory. Ensure that all file permissions
are preserved. For default installations, this directory is C:\IBM\SMP.
3. If you are using DB2, log on to the target environment administrative
workstation using a user ID with the authority to create new system users, and
create a user named maximo. The newly created user must be a member of the
DB2 administrator group.
4. Move the copy of the 7.5 installation directory to the target environment
administrative workstation file system. Ensure that you maintain the same
drive letter and directory structure of the source environment installation. For
example, if the 7.5 installation directory on the source environment
administrative workstation is c:\ibm\smp, you cannot copy those files to
c:\NewAdminWS\ibm\smp directory on the target environment administrative
workstation. If you are reusing the source administrative workstation system to
host the target administrative workstation, the directories must be different. For
example, c:\ibm\smp\TargetAdminWS
5. Log on to the target environment administrative workstation with the same
user ID you used in step 1.
6. Update the deployment engine host name. This step is required if the target
environment administrative workstation is hosted on a different system from
the source environment administrative workstation.
c:\ibm\smp\ctg_de\acsi\setenv
c:\ibm\smp\ctg_de\acsi\bin\de_chghostname
For detailed information about enabling archive logging, see the IBM® DB2
Database for Linux, UNIX, and Windows information center (https://
publib.boulder.ibm.com/infocenter/db2luw/v9r7/topic/com.ibm.db2.luw.doc/
welcome.html). Search for "Configuring database logging options.
1. Log on to the system that hosts the source environment database.
2. Set the DB2INSTANCE environment variable:
Windows
set DB2INSTANCE=CTGINST1
Linux and UNIX
/home/db2admin> export DB2INSTANCE=CTGINST1
3. Start the DB2 command line processor.
4. Check whether archive logging is already enabled on the source database with
the following command:
db2 get database configuration for maxdatabase
Replace maxdatabase with the name of your database, for example, MAXDB71.
A backup of the source environment database must be created and then copied to
the target environment.
For detailed information about creating database backups, see the IBM DB2
Database for Linux, UNIX, and Windows information center (https://
publib.boulder.ibm.com/infocenter/db2luw/v9r7/topic/com.ibm.db2.luw.doc/
welcome.html), and search for BACKUP DATABASE.
1. Log on to the system that hosts the source environment database.
2. Set the DB2INSTANCE environment variable:
Windows
set DB2INSTANCE=CTGINST1
Linux and UNIX
/home/db2admin> export DB2INSTANCE=CTGINST1
3. Start the DB2 command line processor.
4. Create a backup of the source database with the following command:
db2 backup database maxdatabase ONLINE to backupdir INCLUDE LOGS;
Replace maxdatabase with the name of your database, for example, MAXDB75.
Replace backupdir with the full path to the destination of the backup image file.
After you install DB2 in the target environment, you can restore the backup image
that you created of the source environment database.
When you run the RESTORE DATABASE command with the backup image, the source
environment database is re-created on the target environment database. During the
restoration process, you also use the rollforward command which applies
transactions recorded in the database log files. This process includes transactions
that occurred after the database backup image has been restored.
For detailed information about creating database backups, see the IBM DB2
Database for Linux, UNIX, and Windows information center (https://
publib.boulder.ibm.com/infocenter/db2luw/v9r7/topic/com.ibm.db2.luw.doc/
welcome.html), and search for RESTORE DATABASE.
1. Log on to the system that hosts the target environment database.
2. Set the DB2INSTANCE environment variable:
Windows
set DB2INSTANCE=CTGINST1
Replace maxdatabase with the name of your database, for example, MAXDB75.
6. Create a new temporary directory, for example, tmpdir, and extract the
database archive logs that are bundled with the backup image.
db2 restore database maxdatabase LOGS from . LOGTARGET tmpdir
Replace maxdatabase with the name of your database, for example, MAXDB75.
7. Apply all the transactions stored in the database archive log files to the restored
database.
db2 rollforward database maxdatabase to end of logs and complete overflow log path
(tmpdir)
Replace maxdatabase with the name of your database, for example, MAXDB75. If
you run this command on a Linux or UNIX system, you must precede the
parentheses with escape characters. For example,
db2 rollforward database maxdatabase to end of logs and complete overflow log path
\(/home/ctginst1/tmpdir\)
You can update configuration values for the target environment manually, or you
can use the reconfiguration command line interface tool to update them. Properties
specified when using the reconfiguration command line interface tool, either as
parameters, or in an input properties file, replace existing properties in the
maximo.properties and install.properties files. Properties are encrypted upon
saving.
The reconfiguration command line interface tool can be downloaded from the
Integrated Service Management Library located at https://www.ibm.com/
software/brandcatalog/ismlibrary/.
Uncompress the appropriate zipped file into the product installation directory.
Within the newly created reconfig directory. The reconfiguration command line
interface tool are launched on the administrative workstation:
Windows
reconfigurePae.bat command-line-parameters
Four input sample files are found in the reconfig/samples directory of the
reconfiguration command line interface tool packages.
v DB2_Sample_input.properties
v Oracle_Sample_input.properties
v SQLServer_Sample_input.properties
v WebSphere_App_Server_Sample_input.properties
Each of these sample files contain properties associated with a specific database or
application server type. You must define configuration property values for a new
database and new application server to be used with the deployment in the target
environment.
To manually rebuild Maximo Asset Management EAR files, complete the following
steps:
1. Build the maximo EAR file:
Windows
install_home\maximo\deployment\buildmaximoear.cmd
2. Build the maximo help system EAR file:
Windows
install_home\maximo\deployment\buildmxiehsear.cmd