The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes how to install, upgrade, back up, and restore a WAE Live datastore.
If you need to migrate a WAE Live datastore from 5.4 or an earlier release, contact your support representative.
Many references in the documentation explicitly identify directories in which the software is installed. Otherwise, references to where the software resides are as follows:
If the defaults were used during installation, $CARIDEN_ROOT
is the same as /opt/cariden
.
$CARIDEN_HOME
—Sub-directory of $CARIDEN_ROOT
that contains the WAE Design, WAE Live, and WAE Collector executables and binaries. If the defaults were used during installation, $CARIDEN_HOME
is the same as /opt/cariden/software/mate/current
.
Note The mld server is started, restarted, and stopped as the wae-mld
service. However, it is not monitored like the other WAE services are. For information on services, see the Cisco WAE System Administration Guide.
Note Before starting, restarting, upgrading, or installing the mld server, you must stop other services. If you chose to migrate the Collector server files during the installation process, verify those files have been copied before stopping the web server. For information on the migration process and which files to check, see the Cisco WAE Server Installation Guide.
The mld
tool installs both the mld server and an empty datastore directory, and it automatically starts the mld server.
-size
option is required. The values are D (demo), S (small), M (medium), and L (large). For assistance in which value to use, contact your support representative. – Use the -backup
option to change the default backup directory to one that is on a different physical disk.
– For better performance, create a separate ext2 partition for the directory specified with the -datastore
option.
Step 1 Stop the web server and all other services.
service <service_name> stop
Example: service wae-web-server stop
Step 2 Enter the following command to install the datastore. To change the default directories, use the options described in Table 2-1 .
Minimal requirement: mld -action install -size <D,S,M,L>
Best practice: mld -action install -size <D,S,M,L> -backup <backup_directory>
Step 3 Start the web server and if needed, start other services.
service <service_name> start
Example: service wae-web-server start
|
|
|
---|---|---|
|
||
|
||
Directory where all application data is stored. This includes the datastore, report output, and other application data. |
||
Directory where the datastore is initialized. Once set, this directory cannot be changed. You can, however, use symbolic links. |
||
Number of CPUs reserved for the datastore and the mld server. If using |
||
|
||
Directory where the mld server is installed. Once set, this directory cannot be changed. You can, however, use symbolic links. |
||
Directory for saving datastore backups. You can override this for a single backup. See the Back Up Datastore section. |
The mld
tool upgrades the WAE Live datastore from one release to another, and also starts the mld server.
Note To upgrade the datastore, you must use the same username as when you installed the mld server.
Step 1 Stop the web server and all other services.
service <service_name> stop
Example: service wae-web-server stop
service wae-mld stop
Step 3 Enter the following command to upgrade the datastore. To change the default mld server directory or backup directory, use the options described in Table 2-1 .
Minimal requirement: mld -action upgrade
Step 4 Start the web server and if needed, start other services.
service <service_name> start
Example: service wae-web-server start
Start and restart the mld server as the wae-mld
service. Upgrading and installing the mld server also start it.
Note To start or restart the mld server, you must use the same username as when you installed it.
Step 1 Stop the web server and all other services.
service <service_name> stop
Example: service wae-web-server stop
Step 2 To start or restart the mld server, enter these service
commands.
Restart: service wae-mld restart
Step 3 Start the web server and if needed, start other services.
service <service_name> start
Example: service wae-web-server start
To stop the datastore or get its current status, enter these service commands:
WAE Live backs up the time-series derived data from plan files. It does not back up transaction logs or other WAE Live data, such as application data and report data.
Backups require approximately 1 TB of space.
mld -action install -backup <backup_directory>
ml_backup
from a cron job.Note Keep both the datastore (wae-mld
) and the web server (wae-web-server
) running.
You can execute ml_backup
to run a manual backup at any time.
The default backup directory is $CARIDEN_ROOT/data/mldata/backup
unless this was changed when installing the datastore.
The ml_backup
tool enables you to perform multiple levels of backups to save disk space, though the first time using these levels, you must perform backups in this sequence.
|
|
|
---|---|---|
Back up everything since the most recent level 0 backup was performed. |
||
Back up everything since the most recent level 1 backup was performed. |
To run a backup using all defaults, you need only enter the following. This uses the default backup directory, and creates a full backup.
ml_backup
-directory
option. -L
option. Example: This example sets the backup directory to $CARIDEN_ROOT/data/waelive/backups
and backs up only data that is new since the last level 0 backup was run. This assumes that you have run ml_backup
one time using the default level of 0.
ml_backup -directory /data/waelive/backups -L 1
A best practice is to back up the following directories by making copies of them. By default, these are located in $CARIDEN_ROOT/data/mldata
. Otherwise, they are stored in the directory specified upon installation ( mld -mldata <
directory>).
Note Before copying, stop the mld server. Remember to immediately restart the mld server when you are finished copying.
Additionally, it is a best practice to make copies of the following:
Note This section references collection methods. For information on collecting data from WAE Collector, see the Cisco WAE Platform Configuration Guide.
– The username and user ID (uid) of both devices must be the same.
– The backup datastore name uses a hostname as a portion of its name. This hostname portion of the backup datastore name must be changed to be the same as the hostname on the device to which it is being restored.
Example: The backup datastore name is akdobi.acme.com_1_L0. The hostname on the device on which the datastore is being restored is akgudei.acme.com. In this case, change the backup datastore name to akgudei.acme.com_1_L0.
Figure 2-1 Datastore Restoration Workflow
Step 1 Determine the version of the mld software package. If you have only one version, it is listed in /opt/cariden/software/mld
. If you have multiple versions, determine which one is currently being used by entering the following from /opt/cariden/software/mld
.
ls -l | grep current
Step 2 Stop the insertion of data.
ml_insert_ctl -disable-scheduler
Step 3 Stop the collection of data.
$CARIDEN_ROOT/logs
.service wae-web-server stop
If the mld server will start, skip to step 5.
Step 4 If the mld server will not start, follow these steps.
a. If you have data, delete the data files. If there is no data, such as when restoring to a new disk, skip to step 4b.
rm -rf /opt/cariden/data/mldata/datastore/*
b. If using the same mld version that was used to generate the restored datastore, delete the current mld package. If using a newer mld version than was used to generate the datastore, skip to step 4c.
rm -rf /opt/cariden/software/mld/<package_name>
c. Install a new mld server and datastore. This action also starts the mld server.
mld -action install -size <D,S,M,L>
service wae-mld stop
Step 6 Restore the datastore data.
-directory
a value. -directory
value must be the same as configured when installing the datastore or the same as configured in the config.xml file (in $CARIDEN_ROOT/etc/configs
).ml_restore -directory <backup_datastore_directory>
Step 7 If you used a newer mld version than was used to generate the datastore, follow these steps.
a. Delete the current mld package.
rm -rf /opt/cariden/software/mld/<package_name>
c. Upgrade the mld server. See Table 2-1 for information on the two available options: -mld <directory>
and -backup <directory>
.
mld -action upgrade
Step 8 Restart the collection of data.
Augmented: snapshot -config-file /opt/cariden/etc/snapshot_augment_collector.txt
Manual: snapshot -config-file /opt/cariden/etc/snapshot.txt
If you are satisfied that the data is valid, restart the cron job. To determine if a snapshot has finished, check the system process table or check the log file, which by default is in $CARIDEN_ROOT/logs
.
Open the WAE Collector UI, and start the collection from the Collection > Schedule page.
Step 9 Restart the insertion of data.
ml_insert_ctl -enable-scheduler